Running and Monitoring Imports

Schedule, run, and monitor imports, then review run history, stream dependencies, and imported records.

After you configure streams and publish their field mappings, run the import on demand or schedule automated runs.

Publish the stream mapping before a real run. If Field Mapping shows Never published, that stream is not imported when you use Run options. You can still use Dry run with Draft mappings to preview before you publish.

Schedule an import

1

Open the schedule

At the top of the import details view, choose the schedule summary.

2

Configure the schedule

In the Schedule dialog, turn on Active, then set:

• Preset – choose a schedule preset, for example Hourly (on the hour)

• Cron expression – define or adjust the schedule with a cron expression

• Timezone – set the timezone for the schedule

3

Save the schedule

Choose Save. The schedule summary shows the preset, cron expression, and timezone.

Schedule configuration for automated DELTA runs

Scheduled runs always use DELTA mode.

Run an import

1

Optionally preview the import

Choose Dry run to preview how the data will be mapped without writing it to Emporix. Choose a sample size, then select which mappings to preview:

• Draft – preview the saved draft before you publish

• Published – preview the last published version that real runs use

Choose Run dry run.

After a dry run finishes, open Dry run again and choose View mapped sample to review the mapped output. View mapped sample is unavailable until you run a dry run first. Dry runs do not write target records.

2

Open the run options

Choose Run options.

3

Choose the run mode and start the run

Choose the required mode:

• Delta – run all enabled streams and import only records that changed, based on each stream's delta field

• Full – run all enabled streams and respect any configured record limit

• Full, Force – run a full import and rewrite every record, even when unchanged

Confirm the stream selection, then choose Run streams.

Runs follow the sequence defined by Depends on and Run order. Select Refresh in Imports after a run to update status, last run time, next run time, and error counts. Use the Dashboard to monitor health and failures across imports.

Run history

Open Run history from the import actions menu to review previous runs. Each row shows Status, Import as, Origin, Started, Duration, and counts for Read, Created, Updated, Skipped, Failed, and Deleted records. The table also includes a Retry failed column.

Expand a row to review per-stream logs and errors for that run.

Run history for an import with an expanded run and per-stream results

Run order and dependencies

Open Run order from the import actions menu. The dialog has two tabs:

• Run order – shows the sequence, stream type, and the preceding stream in Runs after. Drag streams to adjust their order. A stream cannot move above a stream on which it depends.

• Dependency graph – visualizes the same relationships. Streams run left to right. An arrow means one stream must run before another. Green is standalone, blue is composite child, orange is merge, and dashed or grey is disabled.

Set stream dependencies on the Target tab with Depends on, or through composite parent and child links. Confirm the resulting sequence here before you run.

Run order with stream types and dependency sequence

Dependency graph tab showing which streams must run before others

Review imported data

After a run, select View imported data for the stream to inspect record outcomes. See Imported Data for filters, result fields, and troubleshooting.

If a run or stream fails, check Run history and error counts. Follow the troubleshooting guidance in Imported Data, then review the stream configuration before you run again. Use the Dashboard to see which streams are unhealthy.