Location, Naming, and Structure of OpenText PPM Adapter Configuration Files

Each OpenText PPM adapter configuration file must follow specific conventions for its location, naming, and structure, as described in the following sections.

Location and Naming of the OpenText PPM Adapter Configuration File

The adapter configuration files are located in the <PPM_Home>/conf/sdi directory of the PPM Server. This directory contains the following:

• Configuration file for the adapter (or one for each adapter if there are multiple adapters).

  In this configuration file, you define a name for the adapter. The configuration file must have a .settings file extension.

• Subdirectory (or one for each adapter configuration file if there are multiple files).

  The subdirectory contains the conversion scripts, which are called by the converter to map the fields between and to filter the tickets and requests. The name of the subdirectory must be the same as the <adapter name> (for a description, see Structure of the OpenText PPM Adapter Configuration File and Table 4-4) followed by .ext.

  For example, if the adapter name is ppm-adapter, the <PPM_Home>/conf/sdi directory must contain a subdirectory named ppm-adapter.ext to hold all the conversion script files for the adapter.

Structure of the OpenText PPM Adapter Configuration File

ALM provides, as a template, a default OpenText PPM adapter configuration file named ppm-sm-adapter.settings1. The adapter file you configure and use must have a .settings file extension.

Copy the default adapter file (to preserve the original), and rename the copy with a .settings file extension and, if desired, a different file name.

As detailed in subsequent sections, the adapter file has the following basic structure, including adapter attributes, and properties for its connector, converter, and sender:

<?xml version="1.0" encoding="UTF-8"?>
<settings>

<adapter adapter-name="<adapter name>">
    <service-desk-application><SD application>
	</service-desk-application>
    <number-of-tickets><number of tickets></number-of-tickets>
    <polling-schedules><schedule></polling-schedules>
    <polling-frequency><frequency></polling-frequency>

    <request-types>
    <request-type level="1">
    <polling-operation>

    <connector>
    <connector-type>PPMRequest</connector-type>
	<properties>
	     sdSystemName=
	     requestType=
	     datePattern=
	     userName=
	     password=
	     sdSystemFieldName=
	     idProperty=
	     updateTimeField=
	     createTimeField=
	     requestStatusNames=
	</properties>
    </connector>

    <converter>
    <converter-type>scriptConverter</converter-type>
	<properties>
	     scripts=<convert1>.js,<convert2>.js,...
	</properties>
    </converter>

    </polling-operation>   
    </request-type>
    </request-types>

    <sender>
    <sender-type>serviceManagerSender</sender-type>
	<properties>
	     userName=
	     password=
	     queryDateFormatPattern=
	     timeZone=
	     keyMethodName=
	     serviceUrl=
	     staticFieldNames=
	     idProperty=
	</properties>
    </sender>

</adapter>

</settings>

The following sections describe how to configure the adapter attributes, the connector properties, the converter property (scripts), and the sender properties.