Pull Connectors

Pull connectors allow you to query an external application or service for data. Typical pull connectors are CRM, eCommerce or web services.

Connector > File Layout

Select System Dropdown

Select the systems to query.

When multiple connectors are selected, each will be queried and the records are be fed into a single IMan dataset.

See Action on Transform Error on how errors are handled.

Top Level Entity Dropdown

The entity drop down lists each of the datatypes which can be queried from the application.

For applications, such as CRM, with customisable data schemas, this drop down would be obtained by querying the applications meta data.

Other applications such as eCommerce platforms may present a static list, where each item represents an integration or touchpoint.

Optional Configuration

Immediately following the System dropdown is an area where settings are defined for retrieving the data from the application/webservice. Each connector has an independent set of options, so please see the relevant application guide for more details.

Connector > Field Mapping

The field mapping tab defines which fields are included (or imported) into the IMan dataset.

By default every field is included. Deselecting the field not needed to be processed by IMan will yield better performance particularly on entities with a large number of fields.

Entity

Each entity for the selected entity from the File Layout tab will be displayed here. Changing the selected option will alter the field list grid.

Parent Entity

A read only field indicating the selected entities parent entity.

Field Name

The field name.

Import

When selected will include the field within the IMan dataset, where deselected will not include the field within the dataset.

Type

The field's type.

Connector > Audit

Auditing & Error Handling

Supported Counters

• PROCESSED
  • Incremented for each record being processed.
• INSERTED, UPDATED, DELETED
  • Each record read by the pull connector will increment the INSERTED counter.

Action on Transform Error

• Abort
  • The transform will stop at the first error.
• Reject Record or Continue
  • If an error occurs the system being queried will stop and the next select system will be queried. If there is only a single system selected then no records will be included in the IMan dataset.