Documentation Center

Admin.XMLExtensionConfiguration.xml

The Admin.XMLExtensionConfiguration.xml file contains the configuration for extensions like integrations with external sources (e.g. taxonomy system,...)

Changelog

File versionContent Manager versionNotes
1.012.0.0n/a

Introduction

The extension configuration is accessible from the Content Manager web client using Settings > XML Extension Settings

This configuration file contains:

  • the configuration of the metadata bindings which link a metadata field with an external source
  • the configuration of the search extensions
  • the configuration of the translation management extension
  • the source definitions specifying for each source the configuration which is required by the handler

MetadataBindings

XML elements
NameDescription
metadatabindingsContains the configuration for linking metadata fields with (external) sources
metadatabindingLinks a metadata field with an (external) source
metadatabinding @ishfieldnameThe element name of the metadata field
metadatabinding @sourcerefThe reference to the source definition
Example
<metadatabindings>
  <metadatabinding ishfieldname="FCONTINENTS" sourceref="CitiesConnector" />
  <metadatabinding ishfieldname="FCOUNTRIES" sourceref="CitiesConnector" />
  <metadatabinding ishfieldname="FCITIES" sourceref="CitiesConnector" />
</metadatabindings>

Search

The configuration of the search extensions lists the sources that will enhance the search query
XML elements
NameDescription
searchContains the configuration for the (external) sources extending the search
queryenhanceContains the configuration for the (external) source enhancing the search query
queryenhance @sourcerefThe reference to the source definition
Example
<search>
  <queryenhance sourceref="CitiesConnector" />
</search>

Translation Management

The configuration of the translation management extensions specifies the handler which will generate the file for the target language during translation management.
XML elements
NameDescription
translationmanagementContains the configuration for the (external) sources which will generate the file of the target language
targetxmlfilegenerationContains the configuration for the (external) source generating the xml file for the target languages
targetxmlfilegeneration @sourcerefThe reference to the source definition
Example
<translationmanagement>
    <targetxmlfilegeneration sourceref="PreTranslation"/>
</translationmanagement>

Source definition

XML elements
NameDescription
sourcesContains the source definitions specifying for each source the configuration which is required by the handler
sourceContains the source definition with the configuration for a specific handler
source @idThe name of the source
source @handlerThe reference to the handler implementation
initializeContains all information for the handler which is passed to the handler during initialization
parametersContains parameters required by the handler
parameter

Contains a value for a single parameter required by the handler

parameter @nameSpecifies the name of the parameter required by the handler
Example
<sources>
    <source id="CitiesConnector" handler="CitiesConnector">
      <initialize>
        <parameters>
          <parameter name="continentsfieldname">FCONTINENTS</parameter>
          <parameter name="continentsfieldlevel">logical</parameter>
          <parameter name="countriesfieldname">FCOUNTRIES</parameter>
          <parameter name="countriesfieldlevel">logical</parameter>
          <parameter name="citiesfieldname">FCITIES</parameter>
          <parameter name="citiesfieldlevel">logical</parameter>
          ...
        </parameters>
      </initialize>
    </source>
  </sources>