Documentation Center

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. Sign in to Organize Space as a user with administrator-level credentials.
  2. On the top tab level, select the Settings tab.
  3. On the second tab level, select the XML Settings tab.
  4. On the third tab level, select the Translations tab.
  5. In the translation configuration that appears, 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>
  6. 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>
  7. 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>