8 Appendix - DAM v4.6.1

Includes information on various plug-ins, as well as examples of XML, searches and more.

8.1 Adaptive Bitrate

Digizuite™ DAM Center comes with support for Adaptive Bitrate for video playback. This is done using industry standard Synchronized Multimedia Integration Language (SMIL) files. You can setup any quality combination in the Adaptive Bitrate HQ profile or create your own. The system comes predefined with the following bitrates that matches current industry recommendations:

Video width is calculated to keep aspect ratio and frame-rate is defined by the source.

8.2 Plug-ins

Digizuite™ DAM Center contains a number of different plug-ins which increase automation and make the workflow easier.

8.3 Examples

8.3.1 Format XML for mapping metadata to job properties.

This example covers the XML format field. The following XML shows how the XML format on media format pages could appear.

The XML shows how you map metadata. In the first mapping the system maps the property CanPrint to the metafield with ID 225 and in the language determined by the user's metadata language setting. The next line maps the property CanCopy to a metafield with a predetermined language (determined by the metafield label id). The last mapping specifies labelid=0 which means that the system doesn't take metadata, but the values are specified directly in the XML. The example here shows that the PLOP string will be sent to the job in the MasterPassword property.

Note that this mapping requires you to specify asset_datatype.

If the XML format is not to be exported with the manifests and/or portal publish XML, you must specify manifest=0 attribute in the mediaformat node as in the example here. The following attributes apply to the <fieldmapping> tag:

• active, bool: 1=mapping included, 0=mapping omitted.
• asset_metafield, whole number: Indicates which language independent metafield the values are mapped in. Valid if the asset_metafield_label is not indicated.
• asset_metafield_label, whole number: Which language dependent metafield values are mapped. Always overrides asset_metafield.
• asset_datatype, enum: indicates the datatype for a mapping. Applies if the asset_metafield==0 and the asset_metafield_label==0. Only standard support for whole numbers and strings.Enum: Digieyez.Digizuite.Utility.MetafieldDataType
• jobident, string: Indicates the name of the property that is mapped in the given job.
• defaultvalue, CDATA: Indicates the default value that will be mapped for a property.

The following words/strings are reserved by the system and can be used to replace property values in the example:

• %#assetid#% - Insert system ident.
• %#asset_metafield_groupid#% - Insert asset_metafield_groupid.
• %#media_formatid#% - Insert media_formatid.
• %#reference#% - Insert reference ident.
• %#description#% - Insert the description (user selected language).
• %#name#% - Insert name/title (user selected language).
• %#sortindex#% - Insert sortindex.
• %#asset_type#% - Insert assettype ID.
• %#prevref#% - Insert prevref ID.
• %#location#% - Insert location (asset store).
• %#assetcode#% - Insert assetcode (intern).
• %#start_date#% - Insert start date.
• %#end_date#% - Insert end date.
• %#upload_computer#% - Insert upload computer.
• %#upload_user#% - Insert upload user.
• %#upload_date#% - Insert upload date.

All reserved words are case sensitive, which means that the above examples must be written in lowercase as shown.

8.3.1.1 Setting up Master/Slave Item Reference

For this example, we would like to be able to reference which employees appear in an image (also known as tagging people in an image). We start off with creating a new Master Item Reference field called Employees on Picture. For the sake of this test, let us say that we have a CompanyPhoto metagroup, a metagroup that is applied to all company pictures. We will be creating the field on this metagroup. The below screenshot shows the create dialog:

After creating the field, the right panel will look like below (left is Metafield tab, right is Metafield label tab):

Under the Metafield Label tab, we change the Item Type to member (because our employees are members in the DAM Center and we want to reference them):

8.3.1.1.1 Filter on Metagroup

This field is changed to point to the EmployeeInfo metagroup, as our Employee members belongs to this metagroup. This will make sure that we cannot select members that are not employees.

8.3.1.1.2 Lookup label

This field controls what will be displayed when a reference is selected in the metadata. If nothing is selected here, the title of the referenced item will be displayed. In this example with our employees, their Username will be displayed if we do not choose otherwise in the combo field.

8.3.1.1.3 Max selected items

We keep this value as 0 (unlimited), as we do not have a requirement for how many employees that can be tagged in a picture. If we were instead doing this for profile images (where we know that there will ever only be one employee on a picture), it would make sense to set the Max selected items to 1.

8.3.1.2 Setting up Master/Slave Item Reference

Now we have the possibility to reference employees when editing the metadata for images. But we also want to be able to look up a member (an employee) and see all the images that this employee is referenced in. To do this we need the Slave Item Reference. First we create a Slave Item Reference on our "EmployeeInfo" metagroup:

The Metafield tab will look like this. In this case we decide that we do not want the references to be editable from the employee metadata, so we check the Read only field.

Now that we have the general setup done, we switch to the language tab and enter the following (if a field is not mentioned it means that there was no need to change it). 

8.3.1.2.1 Item Type

Here we choose Asset as the Item Type, as we are referencing the images that the employees appear in:

8.3.1.2.2 Related ItemReference field

Here we choose the Master Item Reference that we created previously called "Employees on Picture". For the Slave Item Reference, this field is required, as they cannot exist without a Master Item Reference.

8.3.1.2.3 Lookup label

This label governs what will be displayed, when a reference is selected. If nothing is selected, the title of the item selected is displayed (asset title in this case). We choose to display the "Image Title" instead, which is a custom metafield we created for company photos:
This is the end of the configuration of our Master/Slave Item Reference fields and it is now possible to add references to employees in all company photos.

8.3.2 Text search

8.3.2.1 Free text search

You should generally avoid free text searches as the metadata structure allows you to easily specify more accurate searches with more accurate and therefore also more useable results. If more than one word is indicated in a free text search the system will assume that you want to search for the combination in all metadata fields. If, for example, you use 'Hollywood Greats' in the free text field, the search will only return assets that have these two words in a given metadata, as the title or description. It will therefore not return assets which have the words 'Greats' in the title and 'Hollywood' in the description. You are then required to be more specific, e.g. search for the word 'Greats' in the free text field and the word 'Hollywood' in the description field.

There are also two different search engines in Digizuite™. Both methods are case-insensitive. The difference between the two methods is explained using these three examples:

Example 1:

• Requires: Assets with the word 'Film':
• Search string: 'film'
• Example of results: 'Film no 1 of 2'
• Example not found in the results: 'Hollywood films'

Example 2:

• Requires: Assets that start with the string 'film':
• Search string: 'film*'
• Example of results: 'Films from Hollywood'
• Example not found in the results: 'Hollywood B-films'

Example 3:

• Requires: Assets that use the string 'film':
• Search string: 'film'
• Example of results: 'Hollywood action films', 'Hollywood films'

8.3.3 Full Text Indexing

This engine is based on a full text catalog defined by the SQL server. Therefore, we refer you to documentation for Microsoft SQL server Full-Text index search.

This can usually be provided using these DZ constants:

1. ENABLE_FULLTEXT_ASTERISK_PREFIX_VIA_TABLEINDEXStandard = "0". In other words, the search in example 3 will not be possible and simply returns the same result as in example 2. This is one limitation of the indexing. By setting this constant to '1', the search routine will change to Table Indexing, with exactly the same search parameters the result will then be as required. Note however, that based on the assets and/or the size of the metadata structure, this emulation can make the search extremely sluggish.
2. ENABLE_AUTOASTERISK_PREPOST_FULLTEXTINDEXINGStandard = "0". This constant can have two meanings: By combining this constant with the constant in point 1), you can search as in example 3, without using ''. This implicitly means that the searches in examples 1 and 2 cannot be done. If only this constant is '1', it would mean that the search only automatically runs '' after the search text. Therefore, example two can be run, but not 1 or 3.