Introduction

This page explains the two available import modes (full- and delta-mode) and what to consider when configuring them.

If you intend to run the module in delta-mode you should read the documentation about timestamps carefully as these topics are closely related.

Full- and Delta-Imports

There are two "import-modes" the output-module can run with. The mode influences which documents are included in the next flow execution:

  • A full-import handles every document from the transfer database (timestamps are completely ignored)
  • A delta-import handles all entities that have been modified since the last flow-execution

You can configure which mode to use by setting the field lastSync of the module configuration. In general a document is ignored, if all of its timestamp-values (createdAt, updatedAt or deletedAt) are before the value of lastSync.

Delta-Import

By using the placeholders %LAST_EXECUTION_UPDATED_AT% or %LAST_EXECUTION_CREATED_AT% the module handles all entities that have been modified since the last update or creation of the previous flow-execution:

{
  "lastSync": "%LAST_EXECUTION_UPDATED_AT%"
}

It is also possible to set a custom time via configuration:

{
  "lastSync": "2022-01-01 08:40:10.000000"
}

Full-Import

A full-import creates, updates or deletes every document from the transfer database during the next execution of the module. All timestamps are completely ignored. You can activate full-imports by setting the value @0 in the lastSync field of the configuration:

{
  "lastSync": "@0"
}