Configuring metadata for target languages

Metadata fields do not contain data when a target language object is created unless the fields are configured to be copied from the source language object in the translation configuration file.

About this task

When a target language object is created, the metadata of the new language object is assembled using the following input:
  • First the metadata fields specified in the translation configuration file will be copied from the source language object,
  • then Metadata fields specified in the UI are added,
  • and finally you can use a write metadata plugin to adapt or add a value on a specific field.

The following procedure describes how to extend the default configuration with one extra metadata field for illustrations and how to add a metadata field specific to a user group (ISHUserGroup).

Procedure

  1. Login to the Content Manager web client as a user with an Administrator user role.
  2. Select Settings > XML Translation Settings
    The translation configuration file is displayed in the right-side pane.
  3. Locate the section that begins with <copyfromsource> in the file.
    This contains something like:
    <ishfields ishcondition="ISHType in ('ISHMasterDoc', 'ISHModule', 'ISHLibrary')">
      <!-- Copy system fields -->
      ...
      <!-- Copy mandatory fields -->
      <ishfield name="FAUTHOR" level="lng"/>
    </ishfields>
    <ishfields ishcondition="ISHType in ('ISHIllustration', 'ISHTemplate')">
      <!-- Copy mandatory fields -->
      <ishfield name="FAUTHOR" level="lng"/>
    </ishfields>
  4. Extend the default configuration with one extra metadata field for illustrations.
    1. Locate the ishfields where the condition ISHType contains ISHIllustration.
    2. Split the ishfields containing both ISHIllustration and ISHTemplate.
      <ishfields ishcondition="ISHType in ('ISHMasterDoc', 'ISHModule', 'ISHLibrary')">
        <!-- Copy system fields -->
        ...
        <!-- Copy mandatory fields -->
        <ishfield name="FAUTHOR" level="lng"/>
      </ishfields>
      <ishfields ishcondition="ISHType ='ISHIllustration'">
        <!-- Copy mandatory fields -->
        <ishfield name="FAUTHOR" level="lng"/>
      </ishfields>
      <ishfields ishcondition="ISHType ='ISHTemplate'">
        <!-- Copy mandatory fields -->
        <ishfield name="FAUTHOR" level="lng"/>
      </ishfields>
    3. Add the extra metadata field FCUSTOMIMAGEFIELD.
      <ishfields ishcondition="ISHType ='ISHIllustration'">
        <!-- Copy mandatory fields -->
        <ishfield name="FAUTHOR" level="lng"/>
        <ishfield name="FCUSTOMIMAGEFIELD" level="lng"/>
      </ishfields>
  5. Introduce a configuration for a specific user group. For example: VUSERGROUPSYSTEMMANAGEMENT.
    1. Copy the default configuration.
    2. Add the specific configuration above the default configuration.
    3. Add the extra condition ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT' to each of the <ishfields>.
      • The configuration without ISHUserGroup condition will be used for all other user groups.
      • The ISHUserGroup condition is the element name of the user group. For example: VUSERGROUPSYSTEMMANAGEMENT.
      <copyfromsource>
        <ishfields ishcondition="ISHType in ('ISHMasterDoc', 'ISHModule', 'ISHLibrary') and ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT'">
          <!-- Copy system fields -->
          ...
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHIllustration' and ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
          <ishfield name="FCUSTOMIMAGEFIELD" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHTemplate' and ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType in ('ISHMasterDoc', 'ISHModule', 'ISHLibrary')">
          <!-- Copy system fields -->
          ...
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHIllustration'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
          <ishfield name="FCUSTOMIMAGEFIELD" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHTemplate'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
        </ishfields>
      </copyfromsource>
    4. Add the extra field which is specific for this user group. For example: FSYSTEMFIELD.
      <copyfromsource>
        <ishfields ishcondition="ISHType in ('ISHMasterDoc', 'ISHModule', 'ISHLibrary') and ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT'">
          <!-- Copy system fields -->
          ...
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
          <ishfield name="FSYSTEMFIELD" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHIllustration' and ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
          <ishfield name="FCUSTOMIMAGEFIELD" level="lng"/>
          <ishfield name="FSYSTEMFIELD" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHTemplate' and ISHUserGroup='VUSERGROUPSYSTEMMANAGEMENT'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
          <ishfield name="FSYSTEMFIELD" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType in ('ISHMasterDoc', 'ISHModule', 'ISHLibrary')">
          <!-- Copy system fields -->
          ...
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHIllustration'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
          <ishfield name="FCUSTOMIMAGEFIELD" level="lng"/>
        </ishfields>
        <ishfields ishcondition="ISHType ='ISHTemplate'">
          <!-- Copy mandatory fields -->
          <ishfield name="FAUTHOR" level="lng"/>
        </ishfields>
      </copyfromsource>