Inbound Integration Endpoints

Inbound Integration Endpoints (IIEPs) offer a centralized interface for monitoring and maintaining integrations with systems that send data to STEP in the form of files or messages.

IIEPs can poll different data sources for new files or messages to import on scheduled intervals–the minimum interval being one minute. As such, IIEPs offer functionality for 'near real-time' integrations. However, when the data source is REST, a POST will invoke the endpoint. For alternative real-time integrations with STEP, click the STEP API Documentation button on the Start Page for information on SOAP and REST APIs.

IIEPs provide a way to automatically manage the functionality for the standard STEP import functionality. Without any extensions, files, or messages being imported, data is handled by the STEP Importer, and the same options for mapping and manipulation are available as when importing manually.

Setup Requirements

Setting up and using an inbound integration endpoint involves the following steps:

  1. Create a setup group to hold the endpoint as described in Initial Setup for an Inbound Integration Endpoint here.
  2. Launch the inbound integrations endpoint wizard as described in Creating an Inbound Integration Endpoint here.
  3. In the wizard, add an ID, name, description, and user as described in IIEP - Identify Endpoint here.
  4. In the wizard, select the receiver of the data as described in IIEP - Choose Receiver here.
  5. In the wizard, specify processing, context, and recommended priority or legacy queue settings for the endpoint as described in IIEP - Configure Endpoint here.
  6. In the wizard, if available, configure defined preprocessors for customer-specific solutions as described in IIEP - Configure PreProcessor here.
  7. In the wizard, specify the data format and map the data, among other options as described in IIEP - Configure Processing Engine here.
  8. In the wizard, if available, configure defined postprocessors for customer-specific solutions as described in IIEP - Configure PostProcessor here.
  9. In the wizard, specify how often the endpoint should search for data to be processed as described in IIEP - Schedule Endpoint here.
  10. In the wizard, specify, select, and configure an error reporter that is activated if an endpoint-related background process fails as described in IIEP - Configure Error Reporter here.
  11. Enable the endpoint and invoke it as described in Running an Inbound Integration Endpoint here.

Additional Information

The following information is useful once an inbound integration endpoint is set up:

  1. Understand each element of an IIEP as described in Inbound Integration Endpoint Structure here.
  2. Understand the effects of the transactional setting on an IIEP as described in Integration Endpoint Transactional Settings here.
  3. Maintain or modify the endpoint as described in Maintaining an Inbound Integration Endpoint here.
  4. Monitor the endpoint as described in Monitoring an IIEP via Background Process here.
  5. Monitor the endpoint as described in Monitoring an IIEP via External System here.
  6. Resolve failed background processes as described in Handing Failed IIEP Background Processes here.
  7. Export inbound integration endpoint definition for comparison purposes in an external source control system in Exporting Inbound Integration Endpoint Definitions as Comments here.
  8. Parallel imports involving multiple references on object types as described in Reference Target Lock Policy on Object Types here.