For the complete documentation index, see llms.txt. This page is also available as Markdown.

Import Tool

Learn how the Emporix Import Tool brings data from external systems into Emporix with connections, streams, and import monitoring.

The Import Tool runs as part of Autonomous Commerce Execution® (ACE™). You can access it from the Management Dashboard, enable it through the Commerce Engine, and manage who can use it with standard identity and access management. It's a data ingestion capability that you can use to run full and delta imports of large datasets from external systems, for example Celonis, SAP, a CRM, or an HTTP source, into Emporix. During import, the Import Tool applies schema rules and validation so that imported data stays consistent with the source.

The Import Tool is available as its own perspective. Authorized users open it to configure connections, define streams, monitor run health, and review imported records. The tool includes Dashboard, Imports, Connections, Imported Data, and Extensions views where you can configure and manage data imports.

New to the Import Tool? Walk through Running Your First Import in the product, then use the other guides for options and examples.

How it works

The Import Tool connects to an external source, maps records in streams, then upserts them into Emporix. You monitor results on the Dashboard and in Imported Data.

Key features:

  • Configure source connections and store credentials for external systems.

  • Create streams that map source data to target entities in Emporix.

  • Run streams on a schedule or on demand, including full, delta, force, and dry-run modes.

  • Monitor import health, success rate, failures, and freshness on the Dashboard.

  • Search and filter imported records by status, key, or field values.

  • Control who can manage and trigger imports through user groups and access controls.

Typical use cases

Dashboard

Dashboard is the first view when you open the Import Tool. Use it to monitor KPIs, run outcomes, stream health, and failures over a selected time range.

For filters, charts, stream health, and health thresholds, see Dashboard.

Import Tool Dashboard with KPI cards and charts
Dashboard with KPI cards, time-range filters, and import charts

Imports

Imports lists your import jobs. From here you create imports, review source, targets, last and next run times, status, and errors, and open an import with Edit to manage its streams.

For creating imports and managing the job list, see Imports. For the complete stream workflow, start with Streams.

Imports list with status and actions
Imports list with run status and run, edit, and delete actions

Connections

Before you run an import, you need to set up a connection to the external source. On Connections you add a connection, select the Source type, store credentials, and test that the connection works.

For the full connection setup procedure, see Connections.

Connections page listing configured sources with credential status
Connections page showing configured sources, credential status, and Test, Edit, and Delete actions

Imported Data

The Import Tool keeps a change ledger of all records it imports. After an import runs, you can use Imported Data to inspect what items were expected together with their source and Emporix key. Filter by target type and status, then search by key or field value to review record outcomes and import times.

For the global and stream-scoped views, see Imported Data.

Imported Data view with target type, status, search, and results
Imported Data with record keys, Emporix IDs, outcomes, and import times

Before you use the Import Tool, set up the required access controls, user group, and perspective. For details, see the Prerequisites guide.

Last updated

Was this helpful?