Creating Streams

Create an import stream and define its source connection, keys, and target entity type.

A stream connects one source record type to a target entity type in Emporix. You can have multiple streams in one import.

Before you create a stream, complete the prerequisites and set up a connection to the source system.

1

Open the import

In Imports, choose Edit on an existing import.

If you do not have an import yet, first create an import, then continue from its details view.

2

Add a stream

Choose + New stream.

3

Enter the stream details

• Name – a label for the stream

• Connection – the connection that points to the source system

• Source record or Resource name – the record type to import. Celonis connections use Source record. HTTP / REST API connections use Resource name, plus Method, Path, Records path, Response format, and Pagination method.

• Key field and optional Candidate key fields – choose the fields used to match records. See Key resolution.

• Target – the target kind in Emporix, for example emporix.customEntity

• Target type – an existing type, or a new type you enter

For an HTTP stream, the Path is appended to the connection Base URL. If the Base URL is only the host, enter the list path here, for example /countries/v5. Set Records path to the array in the JSON response, for example data.objects, or (response is the array) when the body is the array.

After you save your setup, the stream appears in the list.

New Stream dialog where you set the connection, source record, key fields, and target type

4

Continue with stream configuration

Open the stream row and continue with stream configuration. Then define how fields are written in Field Mapping.

Use a clear stream name that describes the source and target, for example Payment Intents or AP Invoice -> PO/NON_PO. This makes it easier to monitor status and errors later.