Help > Federator > Creating Connectors > Configuration File

Configuration File

There is one configuration file per connector; it is a simple XML file that contains the connector properties and the location when the connector is implemented. Perceptive Enterprise Search looks for the connector configuration files in the Perceptive Enterprise Search\WebFederator folder. 

<ISYSfederator name=”NameOfConnector” description=”text”>

       <properties>

            <property name=”PropertyA” value=”ValueA” caption=”” type=””/>

            <property name=”PropertyB” value=”ValueB” />

</properties>

<driver type=”.net|COM” class=”{GUID}” module=”module.dll” />

</ISYSfederator>

 

Elements

The configuration file contains the following elements.

ISYSfederator

The root element of the XML file, has the following attributes:
name – the name of the connector as shown in the Perceptive Enterprise Search Administration Console.
description – an optional description shown in the Perceptive Enterprise Search Administration Console.

properties

Contains the set of connector properties of the connector, there can be only one <properties> node in the configuration file.

property

Each property node contains configuration options for the connector, the <property> node must appear within a <properties> node. Properties can have the following attributes:
name – the property is accessed via this name in the connector logic
value – the stored value, this can be overwritten when the connector is added to the Perceptive Enterprise Search Administration Console.
caption – an optional caption to use when configuring the connector in the Perceptive Enterprise Search Administration Console.

driver

Contains the location of the federated connector logic, there can be only one <driver> node in the configuration file. The driver can have the following attributes:
type – indicates the driver type, can be “COM”, “.net” or “script”.

class – this attribute is dependent on the type. When set to “COM”, class indicates the CLSID of the COM object to create. When set of “.net”, class indicates the class name of the .net object to create.

module – only required for .net, indicates the .dll that contains the class indicated in the class attribute.

 

The connector logic is stored in a DLL implemented in either .net or a language that supports the creation of COM objects. This DLL is referenced in the configuration file under the <driver> section. You must provide the information about the type, class and module of the connector logic.