The Connector Properties table (afm_connectors) stores the principle properties for the Connector. This includes the name, description, the source and destination of the data, the connection string to access or write the data and several other properties to define the characteristics of each Connector.
Access this table from the Properties tab on the System Administration / ARCHIBUS System Administration / System Administrator / Configure Connectors task.
This topic lists the properties, global parameters, and actions.
Property Name | Description | Value |
---|---|---|
Connector Code (code) |
Uniquely identifies the connector |
String |
Description - XML Template (description) |
Description of the connector’s function. In the case of XML exports this field is used to hold a record XML template. |
Memo |
Connector Parameters (conn_params) |
Some Connector types, such as MS Excel or Custom Connectors may have additional optional configuration parameters. These parameters are defined in this field using JavaScript Object Notation (JSON). |
String - JSON Ex:
|
Connector Type (type) |
Type of foreign data system and data format the connector will integrate ARCHIBUS with such as a delimited text file, database, XML, etc. |
Integer – Enumeration List |
Import/Export (import_export) |
Data direction – import or export |
Integer – Enumeration List |
ARCHIBUS Table (destination_table) |
The ARCHIBUS table to import/export data to/from. This field always represents the ARCHIBUS table, whether importing or exporting. |
String, validated on afm_tbls |
Remote Source (Table, XML, etc.) (source_table) |
Fortable, XML root element, Microsoft Excel Worksheet Name, etc., to import/export data to/from |
String, non-validated |
Delimiter (delimiter) |
Delimiter character found in the source or output text file. Typically comma, tilde, pipe or fixed length. Can be overridden by "overrideDelimiter" parameter. |
Enumeration list |
Text Qualifier (text_qaulifier) |
Used to wrap string data elements in a delimited text file (CSV) for example. Can be overridden by "overrideTextQualifier" parameter. |
Enumeration List |
Skip First Line? (skip_first_row) |
Interpreted as a number, skip N lines, where N is the number entered. |
Integer |
Connection String (conn_string) |
Defines the connection parameters (path, jdbc, ldap, etc.) to the foreign data system for the selected connector type. |
String |
Connection Username (conn_user) |
Enter the username required to connect to the data source defined in the Connection String. |
String |
Connection Password (conn_password) |
Enter the password required to connect to the data source defined in the Connection String. NOTE: Password is encrypted by the server when the form is saved. The password is stored on the database in an encrypted format. It |
String |
Restriction Clause (where_clause) |
Holds ‘WHERE’ keyword for database connectors – applies to import or export. Do not include the "WHERE" keyword in the restriction clause. |
Memo |
Pre Process (pre_process) |
Defines a Java Class and Method that should be executed prior to the Connector execution. The method must accept a single String as a parameter (the connection string). A fully qualified class name is required, such as |
String: “Class|Method” |
Post Process (post_process) |
Defines a Java Class and Method that should be executed upon completion of the Connector execution. The method must accept a single String as a parameter (the connection string). A fully qualified class name is required, such as |
String: “Class|Method” |
Assigned Connector (assigned_connector) |
Not implemented in this release. |
N/A |
Notifications (notify_user) |
Determines whether and when email notifications are sent as Connectors execute. Valid options are None (never email), Errors Only (only email when a Connector completes with errors), Connector Execution (every execution), or Both (errors and at completion). |
Enumeration List |
Notification Email Address (notify_email_address) |
List of email addresses to send messages to on Error and/or Completion. |
String - comma separated list of email addresses |
FTP Host (ftp_string) |
Defines the connection parameters to a remote FTP site where the Connector should copy the remote file to/from depending on the type of Connector. The Connector will load the File to/from the location in the Connection String property before/after the Connector runs. |
String FTP Host address/url |
FTP Remote Folder (ftp_folder) |
Specify the folder - relative to the root location of the Host address - to where files should be accessed. |
String |
Secure FTP (ftp_secure) |
Select whether or not SFTP (SSH) protocol is used to connect and transmit files. |
Yes/No |
FTP Port (ftp_port) |
Enter the network port number to which the FTP connection should be made. |
Integer |
FTP Username (ftp_user) |
Enter the username that should be used to connect to the FTP Host |
String
|
FTP Password (ftp_password) |
Enter the password that should be used to connect to the FTP Host. NOTE: Password is encrypted when the form is saved. The password is stored on the database in an encrypted format. |
String |
Execute Flag (exec_flag) |
Status flag, set to ‘EXECUTE’ to have the connector executed. Some systems control scheduled jobs via an external scheduler—configure the scheduler to set this flag to have connector run at prescribed interval. |
Enumeration List: READY, EXECUTE, RUNNING |
Run Connector
- Once all of the Connector properties and field mappings have been defined, the user can test or run the Connector from the Properties tab by executing the Run Connector action.Save
- The Save action saves the Connector properties entered into the form fields. Just before saving the record, the form checks the password fields and encrypts the passwords before saving the record only if the passwords have not already been encrypted.Copyright © 1984-2015, ARCHIBUS, Inc. All rights reserved. |