Previous Topic: Install the Sample ConnectorNext Topic: Enable the Sample Connector

Building a Custom Connector Using the Sample Connector › How to Install and Run the Sample Connector › Install the Sample Connector › Installed Components

Installed Components

The Sample connector installs the following components:

Note: The string SOI_HOME refers to the CA SOI installation directory. The default is C:\Program Files (x86)\CA\SOI. If you install the Sample connector on a machine that already contains CA SOI components, the connector is installed into the existing directory.

SOI_HOME\lib\sample.catalyst.connector.jar

Contains the code that runs the Sample connector in CA SOI.

SOI_HOME\resources\Configurations\
sampleConnector_connectorserver.xml

Contains the following Sample connector configuration information for use by the SA Manager:

The file also contains configuration information used by the Sample connector, such as the names of the provided sample data files and connection information for the mock domain manager.

SOI_HOME\resources\Core\Catalogpolicy\sampleconnector_policy.xml and sampleconnector_policySB.xml

Contains the policy for transforming Sample connector data to and from the USM format. The sampleconnector_policy.xml file transforms outbound data from the format produced by the Java code to the USM format. The sampleconnector_policySB.xml file transforms inbound data from the USM format to the format consumed by the connector Java code.

SOI_HOME\resources\SampleConnector\data

Contains sample data files used by the Sample connector.

SOI_HOME\SampleConnector

Contains the files that implement the Sample connector. The SampleConnector folder contains the Eclipse project files (.project and .classpath) and the following subfolders:

src\java

Contains the Java source files.

src\resources

Contains same sample data and policy files included in the SOI_HOME\resources directory.

test\java

Contains SampleConnectorUTest, the main class for testing the connector using the test harness.

test\resources

Contains data files used by the Sample connector when running with the test harness.

lib

Contains libraries required to run connectors with the test harness that are not required to run connectors with CA SOI.

docs

Contains the Javadoc generated from the Sample connector Java source.

InstallKit

Contains template files for creating a connector configuration file, connector policy files, and a connector installer.

Important! If you make changes to the sample data or policy files and want to view the effect on a Sample connector running with CA SOI, you must make the changes in the SOI_HOME\resources\SampleConnector\data directory and restart the CA SAM Integration Services service (you do not have to restart the service if changing the sample-ci-changes.xml file). Changing the files in SOI_HOME\SampleConnector has no effect on a Sample connector running with CA SOI. However, when running the Sample connector with the test harness, the files in SOI_HOME\SampleConnector are used.