Configuring the mapping of metadata fields between Studio Server and Assets Server

Info: The described steps can only be performed on the on-premise version of Assets Server, not on the cloud version.

When Studio Server is integrated with Assets Server it is important that metadata information is shared between the two systems so that information about how and where files are used in Studio Server can be verified and searched on.

For this purpose, various metadata fields are mapped, thereby making it possible for metadata changes in Assets Server to appear in Studio Server and the other way round.

An overview of the standard fields that are mapped are described in Metadata mapping between Studio Server and Assets Server.

However, you could also have created custom fields that need to be mapped or perhaps you want to make changes to the mapping of the standard fields.

This article explains how this is done.

A distinction is made between the standard metadata fields of Studio Server and custom metadata fields of Studio Server.

Note: We do not recommend to make changes to the mapping of standard fields but advise to create custom fields instead and to configure the mapping between that custom field and another field.

Standard metadata fields

Step 1. Open the <Studio Server location>/config/config_overrule.php file and verify if the following function exists. If it does not exist, add it. When done, leave the file open.

function Elvis_Config_GetAdditionalFieldHandlers()
{
  // Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
  $cfgFieldHandlers = array();
  
  // Paste the lines here ...
  return $cfgFieldHandlers;

}

Step 2. Open the <Studio Server location>/config/config_elvis.php file and look up the following code fragment under ADVANCED config.

 ....
if( !function_exists( 'Elvis_Config_GetFieldHandlers' ) ) {
 function Elvis_Config_GetFieldHandlers()
 {
 // Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
 $cfgFieldHandlers = array();

 // Read Write Handlers
 $cfgFieldHandlers['Comment'] = new Elvis_FieldHandlers_ReadWrite( "versionDescription", false, "text", "Comment" );
 $cfgFieldHandlers['Rating'] = new Elvis_FieldHandlers_ReadWrite( "rating", false, "number", "Rating" );
 $cfgFieldHandlers['Copyright'] = new Elvis_FieldHandlers_ReadWrite( "copyright", false, "text", "Copyright" );
 $cfgFieldHandlers['CopyrightURL'] = new Elvis_FieldHandlers_ReadWrite( "licensorWebsite", false, "text", "CopyrightURL" );
 $cfgFieldHandlers['Author'] = new Elvis_FieldHandlers_ReadWrite( "creatorName", false, "text", "Author" );
 $cfgFieldHandlers['Credit'] = new Elvis_FieldHandlers_ReadWrite( "credit", false, "text", "Credit" );
 $cfgFieldHandlers['Source'] = new Elvis_FieldHandlers_ReadWrite( "source", false, "text", "Source" );
 $cfgFieldHandlers['Description'] = new Elvis_FieldHandlers_ReadWrite( "description", false, "text", "Description" );
 $cfgFieldHandlers['DescriptionAuthor'] = new Elvis_FieldHandlers_ReadWrite( "captionWriter", false, "text", "DescriptionAuthor" );

 // Read only Handlers
 $cfgFieldHandlers['AspectRatio'] = new Elvis_FieldHandlers_ReadOnly( "aspectRatio", false, "decimal", "AspectRatio" );
 $cfgFieldHandlers['Channels'] = new Elvis_FieldHandlers_ReadOnly( "audioChannels", false, "text", "Channels" );
 $cfgFieldHandlers['ColorSpace'] = new Elvis_FieldHandlers_ReadOnly( "colorSpace", false, "text", "ColorSpace" );
 $cfgFieldHandlers['Dpi'] = new Elvis_FieldHandlers_Resolution( "resolutionX", false, "number", "Dpi" );
 $cfgFieldHandlers['Encoding'] = new Elvis_FieldHandlers_ReadOnly( "videoCodec", false, "text", "Encoding" );
 $cfgFieldHandlers['Width'] = new Elvis_FieldHandlers_ReadOnly( "width", false, "number", "Width" );
 $cfgFieldHandlers['Height'] = new Elvis_FieldHandlers_ReadOnly( "height", false, "number", "Height" );
 $cfgFieldHandlers['Orientation'] = new Elvis_FieldHandlers_ReadOnly( "orientation", false, "number", "Orientation" );
 $cfgFieldHandlers['LengthChars'] = new Elvis_FieldHandlers_ReadOnly( "numberOfCharacters", false, "number", "LengthChars" );
 $cfgFieldHandlers['LengthLines'] = new Elvis_FieldHandlers_ReadOnly( "numberOfLines", false, "number", "LengthLines" );
 $cfgFieldHandlers['LengthParas'] = new Elvis_FieldHandlers_ReadOnly( "numberOfParagraphs", false, "number", "LengthParas" );
 $cfgFieldHandlers['LengthWords'] = new Elvis_FieldHandlers_ReadOnly( "wordCount", false, "number", "LengthWords" );
 
 ...
 
 return $cfgFieldHandlers;
 }
}
...

Step 3. Copy any of the fields for which you want to change the mapping to the Elvis_Config_GetAdditionalFieldHandlers function in the <Studio Server location>/config/config_overrule.php file of step 1.

function Elvis_Config_GetAdditionalFieldHandlers()
{
// Field handler parameters: Elvis fieldname, multivalue field, Elvis data type, Studio Server fieldname
$cfgFieldHandlers = array();

$cfgFieldHandlers['Author'] = new Elvis_FieldHandlers_ReadWrite( "creatorName", false, "text", "Author" );
}

Step 4. Modify the mapping by changing the parameters.

Note: For a list of all Assets Server metadata fields, see Metadata field information for Assets Server. For a list of all Studio Server metadata fields, see Overview of metadata properties used in Studio Server.

function Elvis_Config_GetAdditionalFieldHandlers()
{
// Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
$cfgFieldHandlers = array();
$cfgFieldHandlers['Author'] = new Elvis_FieldHandlers_ReadWrite( "creatorName", false, "text", "C_INVENTOR" );
return $cfgFieldHandlers;
}

Step 5. Save the file.

Custom metadata fields

Tip: For more examples, see the comments in the configuration file.

Step 1. Open the <Studio Server location>/config/config_overrule.php file and verify if the following function exists. If it does not exist, add it. When done, leave the file open.

function Elvis_Config_GetAdditionalFieldHandlers()
{
  // Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
  $cfgFieldHandlers = array();  
  
  // Paste the lines here ...
  return $cfgFieldHandlers;
}

Step 2. Open the <Studio Server location>/config/config_elvis.php file and look up the section named 'ADVANCED config'. The comments contain various examples for mapping custom fields.

/**
 * Mapping between Studio Server fields and Assets Server fields
 *
 * Note: Custom Studio Server fields and multi-value Assets Server fields cannot be mapped with other fields.
 *
 * .........
 *
 * It is recommended to add the custom field handlers to the config_overrule.php file.
 * Add them in a function named Elvis_Config_GetAdditionalFieldHandlers. This can be achived by copying the example
 * function as shown below to the config_overrule.php file and uncomment it. Replace the sample handlers with the desired
 * custom field handlers.
 *
 *    function Elvis_Config_GetAdditionalFieldHandlers()
 *    {
 *       // Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
 *       $cfgFieldHandlers = array();
 *       $cfgFieldHandlers['C_BooleanTest']   = new Elvis_FieldHandlers_ReadWrite( "cf_BooleanTest", false, "boolean", "C_BooleanTest" );
 *       $cfgFieldHandlers['C_DateTest']      = new Elvis_FieldHandlers_ReadWrite( "cf_DateTest", false, "datetime", "C_DateTest" );
 *       $cfgFieldHandlers['C_DateTimeTest']  = new Elvis_FieldHandlers_ReadWrite( "cf_DateTimeTest", false, "datetime", "C_DateTimeTest" );
 *       $cfgFieldHandlers['C_DoubleTest']    = new Elvis_FieldHandlers_ReadWrite( "cf_DoubleTest", false, "decimal", "C_DoubleTest" );
 *       $cfgFieldHandlers['C_IntegerTest']   = new Elvis_FieldHandlers_ReadWrite( "cf_IntegerTest", false, "number", "C_IntegerTest" );
 *       $cfgFieldHandlers['C_ListTest']      = new Elvis_FieldHandlers_ReadWrite( "cf_ListTest", false, "text", "C_ListTest" );
 *       $cfgFieldHandlers['C_MultiLineTest'] = new Elvis_FieldHandlers_ReadWrite( "cf_MultiLineTest", false, "text", "C_MultiLineTest" );
 *       $cfgFieldHandlers['C_MultiListTestElvisMultiField']   = new Elvis_FieldHandlers_ReadWrite( "cf_MultiListTestElvisMultiField", true, "text", "C_MultiListTestElvisMultiField" );
 *       $cfgFieldHandlers['C_MultiStringTestElvisMultiField'] = new Elvis_FieldHandlers_ReadWrite( "cf_MultiStringTestElvisMultiField", true, "text", "C_MultiStringTestElvisMultiField" );
 *       $cfgFieldHandlers['C_StringTest']    = new Elvis_FieldHandlers_ReadWrite( "cf_StringTest", false, "text", "C_StringTest" );
 *       // In case the mapping is only applicable for a specific brand, the brand Id ( e.g. 1) can be added.
 *       $cfgFieldHandlers['C_StringTest']    = new Elvis_FieldHandlers_ReadWrite( "cf_StringTest", false, "text", "C_StringTest", 1 );
 *       return $cfgFieldHandlers;
 *    }
 *
 * ......
 *
 */
if( !function_exists( 'Elvis_Config_GetFieldHandlers' ) ) {
  function Elvis_Config_GetFieldHandlers()
  {
    ...
  }
}

Step 3. Copy any of the fields for which you want to change the mapping to the Elvis_Config_GetAdditionalFieldHandlers function in the <Studio Server location>/config/config_overrule.php file of step 1.

function Elvis_Config_GetAdditionalFieldHandlers()
{
// Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
$cfgFieldHandlers = array();  
$cfgFieldHandlers['C_DateTest'] = new Elvis_FieldHandlers_ReadWrite("cf_DateTest", false, "datetime", "C_DateTest");
return $cfgFieldHandlers;
}

Step 4. Modify the mapping by changing the parameters. (See also Mapping on Brand level below.)

Note: For a list of all Assets Server metadata fields, see Metadata field information for Assets Server. For a list of all Studio Server metadata fields, see Overview of metadata properties used in Studio Server.

function Elvis_Config_GetAdditionalFieldHandlers()
{
// Field handler parameters: Assets Server fieldname, multivalue field, Assets Server data type, Studio Server fieldname
$cfgFieldHandlers = array();  

$cfgFieldHandlers['C_MyCustomField'] = new Elvis_FieldHandlers_ReadWrite("cf_myCustomField", false, "text", "C_MyCustomField");
return $cfgFieldHandlers;
}

Step 5. Save the file.

Mapping on Brand level

By default, the mapped field is available across all Brands in Studio Server. To make it available to specific Brands only, add the Brand ID to the mapping (see examples below).

Show me where to get the Brand ID from

Step 1. Open a Web browser and log in to Studio Server.

Step 2. In the Maintenance menu or on the Home page, click Brands. A page showing a list of all Brands appears.

Step 3. Click on the Brand for which you need the ID.

The Brand Maintenance page appears. The Brand ID is shown at the end of the URL in the address bar of the browser.

Example: Here, the Brand ID is 1: http://localhost/StudioServer/server/admin/hppublications.php?id=1

Note: The mapping applies to all object types; it is not possible to map the custom field to a specific object type (meaning: not on Dossiers only, articles only, and so on).

Examples

Tip: More example mappings can be found in the configuration file.

$cfgFieldHandlers['C_MyCustomField'] = new Elvis_FieldHandlers_ReadWrite("cf_myCustomField", false, "text", "C_MyCustomField");

$cfgFieldHandlers['C_MyCustomField'] = new Elvis_FieldHandlers_ReadWrite("cf_myCustomField", false, "text", "C_MyCustomField", 1);

$cfgFieldHandlers['C_Instructions'] = new Elvis_FieldHandlers_ReadWrite("instructions", false, "text", "C_Instructions");