Skip to main content

XTM Connect – Sitecore User Guide for Administrators

  • XTM Connect – Sitecore User Guide for Administrators
  • Using a bespoke XML configuration file

Using a bespoke XML configuration file

When you install XTM Connect – Sitecore in a complex deployment environment, it then needs to be configured. Two approaches are possible:

Potential benefits of using a bespoke XML file to configure the Sitecore installation:

  1. It requires less manual configuration work, once it has been created and implemented.

  2. Automated configuration is usually less error-prone than manual configuration work.

  3. This approach should enable configuration settings to be applied more quickly, and so make the configuration process more efficient.

To use a bespoke XML file to configure the Sitecore installation, and apply it:

  1. On the server where the Sitecore instance is located, use Windows Explorer to find the App_Config\Include\Xtm folder, which contains some (but not all) Sitecore configuration files.

  2. Using an editor, create a new file called Connector.Settings.config in this folder.

  3. Enter the required data in the file. Example contents shown below.

  4. Close the Connector.Settings.config file. Save your changes at the prompt, if required.

  5. Close the editor, if it is still open.

  6. Once you have added the Connector.Settings.config file, or if you edit it, restart Sitecore.

    Result: the configuration settings in the file are applied automatically in the Sitecore installation.

Note

The Connector.Settings.config file is not included in the XTM Connect – Sitecore installation package. Correct installation and maintenance are the client's responsibility.

Example of correct file structure and content for the Connector.Settings.config file:

<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:set="http://www.sitecore.net/xmlconfig/set/">
  <sitecore> 
    <settings> 
      <setting name="XTMTemplates"> 
        <xtmTemplate name="template1" id="1111" /> 
        <xtmTemplate name="template2" id="2222" /> 
        <xtmTemplate name="11707 opis" id="11707" isDefault="true" /> 
        <xtmTemplate name="template4" id="11650" /> 
      </setting>        
      <setting name="XTMBaseSitecoreURL" value="https://medyk-BaseSitecoreURL.cm/"/>
      <setting name="XTMTranslationsiteURL" value="https://medyk-web.cm/"/>        
      <setting name="XTMclient" value="medyk"/>
      <setting name="XTMuserID" value="20"/>
      <setting name="XTMpassword" value="xtm123"/>
      <setting name="XTMcustomerID" value="3364"/>
      <setting name="XTMAPIURL" value="https://api-test.xtm-intl.com/project-manager-gui/services/v2/projectmanager/XTMWebService?wsdl"/>
      <setting name="XTMCallbackURL" value=""/>
    </settings>
</sitecore>
</configuration>
In this section: