Connector Properties table

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:

{"CharacterEncoding":"UTF8"}

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 com.businesspartner.project.ClassName

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 com.businesspartner.project.ClassName

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

Actions

Copyright © 1984-2015, ARCHIBUS, Inc. All rights reserved.