Changing the XMP Configuration

Where: The Metadata node in the program configuration.

The Metadata Configuration (MDC) is used to manage how XMP metadata fields are configured for documents used in your organization.

XMP sorts metadata fields into namespaces. The MDC configuration file contains several predefined namespaces such as the Dublin Core namespace and the Adobe Photoshop namespace. The configuration doesn’t contain all fields available for all the included namespaces; only fields that are commonly used are included. You might discover that one or more fields that are part of a namespace are not included in the configuration. These fields can then be imported, for example from an image file that contains this field.

We advise you to be cautious when making changes to a schema using the MDC. If you want to add new fields to an existing namespace you must make sure that these new fields are part of that namespace’s specification.

When you are done editing the MDC file, the file must be distributed to all FotoWare products, both server and client applications. All FotoWare products must be using the exact same MDC file to make sure that the products are working, writing and validating metadata in a consistent manner. See the sub topic Distributing the MDC Schema File for more information.

Accessing the Metadata Configuration

To access the MDC, open the FotoStation configuration (File | Configuration) and go to the Metadata node. The click on the Configure button as shown below:

snag-0195.jpg

When opening the MDC, the master XMP schema file (the file that contains the entire XMP field specification in your system) will be loaded and you will see three nodes in the left pane: Languages, Namespaces and XMP Fields, as seen below:

snag-0226.jpg

The Languages Node

The XMP specification and FotoWare’s implementation has support for multi-lingual metadata, and also built in support for multiple languages for the user interface of the metadata editors. You can localize the displayed labels and enter metadata for several different languages. If you require this functionality in your system, you should select all the languages you want to use in the Languages node.

Show all Languages: Only the most common languages are shown by default. If you would like to insert metadata for an additional language that is not on the list, select the Show all languages checkbox to view all available languages.

The Namespaces Node

Here you will find the different namespaces defined in the schema file. A namespace is a way of grouping related fields and avoid name collision between fields with identical names. You can add a namespace either by creating a totally new namespace (right-click on the Namespaces node and select Add namespace from the context menu), or you can import a namespace that somebody else has created (right-click on the Namespaces node, and select Import namespace from file from the pop-up menu). Note, however, that creating a new namespace is normally done to create a new set of fields for a particular purpose. If you need to create one new field, you should create your own namespace if possible, since existing namespaces are locked per se. However, we allow you to add fields (that are missing) to existing namespaces. Make sure that the field you add conforms to the exact specification of the namespace in question. Also, if you discover that you organization needs to create a number of new fields for a use that is not covered in the included namespaces, you should create your own namespace to insert these new fields.

Namespace naming conventions

A namespace will often contain information about who created it and what it should be used for. The namespace is identified by a URI (often on the format http://ns.domain.com/namespace/version/). Note that the URI doesn’t have to be a valid web address, but the identifier must be unique. Use a domain name that you own when creating a new namespace. Alternatively, use purl.org to create vendor-independent URIs.

The XMP Fields Node

When you click on the XMP fields node, you will see a list of all the available XMP fields in the schema file. When expanding the XMP fields node you see the list of groups. Two groups (IPTC Core and FotoWare IPTC) are predefined. A group is a way of making it easier to locate fields that you need to view. The groups will appear in FotoWare applications to make it easier to find the fields you need. A group can consist of fields from multiple different namespaces, as in the case of IPTC Core.

If you wish, you can create new fields and/or new groups (right-click on the XMP Fields node and select Add new field or Add new group, respectively, from the pop-up menu) . Add a field to a group by selecting the field and then dragging and dropping the field into the new group.

Adding or Editing Fields

As described earlier, it is possible both to add new fields and to edit previously created fields. Note that when editing a previously created field, you can only change some of its properties.

Add a field by right-clicking on either a namespace or the XMP fields node and selecting Add field. If you create the field from the namespace node, the namespace is automatically inserted. Please see below for an explanation of the different field properties.

Field Id Page

snag-0197.jpg

Id: This is an identification number. It is used internally in FotoWare applications for text editors, print templates, etc. When you create a new field you can choose an id number from the drop-down list. Only available (i.e. unused) id numbers will be shown in the drop-down list.

Display Name: This is the field label that will be displayed next to the field in text editors, print templates etc.

Localized Display Names: If you need to be able to localize text editors etc, make sure that the desired language is selected in the Languages node. The selected languages will appear in the left column of the Localized display names list. For each of these languages, click in the cell on the right column and enter the translation of the Display name text.

Format Page

snag-0198.jpg

On this page the field’s format can be edited or set. The format type is used to validate field input from a text editor when you add metadata. The field format can be changed at any time, but you should be cautious when making changes to the data format, as this may be in conflict with metadata that is already stored in your files

When the data type is selected, other options may also need to be set.

Data Type

Define what data type the field should be. Your choices are:

Text: This is the data type used earlier for almost all IPTC fields. Selecting this data type means that any type of text can be entered into the field. You must also choose the maximum number of characters that can be entered into this field.

If desired, you can use the Regular expression field to define rules governing the type of text that can be entered into the field. This can for example be used to make sure that the text entered is a valid e-mail address. Test the regular expression in the field below by entering something you think the regular expression should accept. The test field will be green if the text you entered is accepted and red if the text is not accepted.

Integer: Only integers (“whole numbers”) can be entered into the field if this is the data type selected. If desired, you can also enter a minimum and/or maximum number.

Real: Only numbers (integers or decimals) can be entered into the field if this is the data type selected. If desired, you can also enter a minimum and/or maximum number.

Date: Only dates can be entered into the field if this is the data type selected. The date format is defined by your system settings.

Boolean: Only the two values True or False can be entered into the field if this is the data type selected.

Storage (XMP) Page

snag-0199.jpg

On this page you find information about where in the XMP file the field should be saved. If you are editing a previously created metadata field, you are not allowed to edit these properties and they are all disabled. If you created a new metadata field, these properties must be entered.

Field name: Enter a name for the field. This name is only used internally in the XML file, and is not visible anywhere else. The Display name found on the Field Id page is the name that will be displayed in text editors, etc. Use only letters (upper or lower case) and numbers for the Field name. The Field name may not begin with a number or contain spaces.

Namespace: Choose the namespace that this new field should be a part of. Available namespaces appear in the drop-down list. If no namespaces are available in the drop-down list you must first add a new namespace before you can add a new field.

Field type: Define what type the field should be. Your choices are:

Single: A single line of text. This is the format previously used for almost all IPTC fields. Note that the field’s length is set in the window on the Format page.

Single (struct member): Same as for Single, but this field type, together with some other fields, belongs to a group (a “structure”). An example could be a group of address information (the struct would be “address”) where the fields Street name, Street number, Zip code, City, and Country would be Single (struct member).

Sequence: This is a new field type that has not been available in FotoWare products previously. It is a repeatable field where the sequence in which the metadata is entered is saved.

Bag: This field is a repeatable field in the same way as the Sequence type, but where the order in which the metadata is entered is irrelevant. This is the same as for the existing Keywords and Supplemental category fields.

Struct name: If the field is a struct member, you must select what struct the field should be a member of. You can enter the struct name directly into the field or select from available structs shown in the drop-down list.

Language Alternative Page

image16.gif

This window is used if you want to add metadata in several different languages. Note that only languages selected in the Languages node are available in this window.

You have these three options:

No language alternative: This option is selected by default. If you are not going to translate the metadata into other languages, you don’t need any language alternatives. In this case, XMP does not store any information about which language the metadata is entered in.

XMP standard language alternative: This option is only available for editing when you are creating a new field. If metadata that is added to this new field has to be translated, you should select this option. Select the corresponding checkbox for the languages that apply, and choose the Field Id either by entering it directly or by selecting it from the drop-down list. Note that this option is not available if the Field type is Sequence or Bag. If you would like to have language alternatives for these two field types, you must select the next (Language alternative extension) option.

Note that after the schema file is saved (and the FotoWare Metadata Configuration window is closed), you are not able to switch to any of the other two options. You can’t remove any previously selected languages, but you can add other languages by selecting the corresponding checkbox.

Language alternative extension (FotoWare standard): This option is FotoWare’s extension of the XMP standard. It is added because the XMP standard has some limitations when it comes to handling translation of metadata to other languages. Use this option if metadata entered in this field needs to be translated into other languages, and the XMP standard language alternative option is disabled.

 

Importing and Exporting Namespaces

From the Metadata Configuration (MDC for short) you can export complete namespaces to an XML file that can be shared with other users. Exchange of such files can be used for sharing complete namespaces or groups of namespaces with other users or companies.

It is also possible use a file that contains metadata as the basis for importing those fields into the configuration. Note that when using this method you may not get the complete namespace definition, since only the fields that are in use in the file will be imported. Thus, it is recommended to use the import/export file format when you want to make a copy of a complete namespace definition.

Exporting your namespaces to an XML-based namespace file

fw7-sr2-0007.jpg

To export a namespace (or a group containing fields from several namespaces), right-click the namespace you wish to export and choose Export namespace to XML file. Then name the file and save it anywhere. This file can then be imported into the XMP configuration in another FotoWare application.

If you like you can also export a group of fields that belong to a number of different namespaces. This is accomplished by creating a group in the MDC that contains fields from several namespaces and which can then be exported to a single XML file. To export a group, simply right-click it in the MDC and choose Export to XML file.

Importing a namespace from an XML-based namespace file

If you would like to import namespace specifications to your FotoWare system, right-click the Namespaces node in the MDC and choose Import namespace from XML file.

After you have located and selected the file, an Import dialog box will list all the namespaces contained in the file and let you choose how to handle the fields:

600_field_id_conflict.jpg

First off, select the namespaces that you want to import by checking the boxes in the first column.

Fields to import: This column gives you the status of the fields to import per namespace. If some of the fields in the imported namespace already exist in your configuration, the import wizard will report how many fields are new and how many already exist in your MDC.

Action: The default action is to import all fields and overwrite existing fields as necessary. However, it is also possible to only import the new fields and retain any fields in the namespace that are already present on your system.

ID assignment: ID's are used internally by FotoWare applications and as such are not a part of the XMP specification. However, FotoWare applications use them when assigning fields to metadata editors, when referencing fields in macros etc.

By default, if the field numbers in the imported file do not interfere with field numbers already specified in your MDC, the field ID specified in the imported file will be used. However, you may override this and choose to assign new ID's in the Start ID column or to add ID's later on.

However, if duplicate field ID's exist, you don't have a choice - you must then assign new ID's to the fields that are imported and set a starting point for the new ID's in the Start ID column.

Importing namespace information from a file that contains metadata

To import the metadata fields used in a file, right-click on the Namespaces node and select Import namespace from image. Then select the file that contains the XMP namespace definitions that you want to import. You will then see the namespaces and fields available in the file, and you are given the possibility to choose the fields you want to import.

You can also right-click on a namespace in the list and choose Import fields from image. This way, only fields belonging to that namespace are listed. This may be useful if you need to add additional fields to a namespace that is already part of your system's XMP configuration.

Note that this method of importing field definitions is not exhaustive, since only the fields that are used in the file are available for import. Thus, there is no guarantee that new namespaces that are added to your metadata configuration contain all the fields that are part of that namespace.

 

How to Change a Field’s Display Name (Label)

These are the steps needed to ensure that the display name for a field is localized when changing the language in FotoStation or FotoWeb.

1.     Make sure that the language or languages you are going to translate metadata for, are enabled globally. This is done by choosing the Languages node and then selecting the language or languages that apply.

2.     Locate the field you would like to change display name for. This can be done either in the Namespaces node or in the XMP fields node. Since clicking on the XMP fields node shows all available fields, it may be easiest to find the desired field here.

3.     Open the field’s properties by double-clicking on the field. Make sure that the Field Id page is opened. In the Display name field, enter the new field name. If you would also like to change the displayed field name for one or more languages this must be done in the Localized display names list. Simply click inside the field on the right-hand side of the list and enter the new translation.

Preparing Multilanguage Metadata Support

These are the steps needed to prepare a field for multilanguage use:

You should now be able to add localized metadata to the selected field. If you are going to add localized metadata to several languages, these steps must be repeated for each field.

Distributing the XMP Schema File

When you are done editing the MDC file, the file must be distributed to all FotoWare products, i.e. FotoStation, FotoWeb, Index Manager, and Color Factory. If the correct and updated file is not imported in all programs, part of information added to a file may not be available. You may for example discover that even if you added metadata in both English and German to the Caption field (by creating a new localized field), Index Manager won’t give you any hits on the German metadata.

Distribute the MDC file by exporting it and then importing the file in all the FotoWare products available in you organization. If you need to share files with someone outside your organization that uses FotoWare products, the MDC should also be distributed to these persons by performing an export of your MDC. Exporting the MDC will ensure that the recipient cannot change the definition of fields that you have defined.

If your organization needs to import the MDC file to several FotoStations, we recommend using a server-based configuration, which makes it possible for an administrator to configure the MDC and store it on the server for deployment to all FotoStation clients in the network.