Skip to content

Update Mode

The Xtract DeltaQ component is primarily used for delta extractions. This means that only recently added or changed data is extracted, instead of a full load. The data that is extracted is defined by the Update Mode setting in the main window of the component.

Update-Mode2

Update Modes

The Xtract DeltaQ component offers the following update modes:

Mode Parameter Value Description
Full Full Extracts all data that match the set selection criteria.
Delta Update Delta Only extracts data added or changed on the SAP system since the last delta request. Initialize a delta process before running a delta update. To prevent errors, aborts and gaps in your data during a delta run, run the next extraction in the update mode Repeat.
Delta Initialization Init Extracts all data as full load and initializes the delta process. When re-initializing a delta process, first delete any existing Inits using the [Maintenance] button in the settings menu.
Repeat Repeat Repeats the last delta run and updates and any delta data accumulated since the last run. Deletes any data from the last (unsuccessful) delta update before running a repeat. You can run a repeat multiple times.
Delta Init (without data) InitNoData Initializes the delta process without extracting any data from the SAP DataSources. The result of the Delta Init on the SAP side. When re-initializing a delta process, first delete any existing Inits using the [Maintenance] button in the settings menu.
Non-cumulative init InitNoncumulative Relevant for DataSources like 2LIS_03_BX.
Activate (don't extract) Activate Activates a DataSource similar to the [Activate] button, but it is more practical when activating DataSources in a batch. No data is extracted.

Tip

Update mode can be set dynamically at runtime using the parameters values to overwrite the custom property updateType.

For more information about when to use which update mode, see Initialize a Delta Process

Initialize a Delta Process

To start a delta process with the Xtract DeltaQ component, the delta must be initialized first. The following delta process shows when to use which Update Modes.

Step 1: Delta Initialization [C]

This mode requests all data that meets the selection criteria.

Set Update Mode to Delta Initialization and run the extraction.
The initialization selections are copied to load the delta records. You can now use Delta Update.

Note

When re-initializing a delta process, first delete any existing Inits (initialization requests) by clicking [Maintenance] in the settings.

Alternative Step 1: Delta Init (without data) [S]

This mode is similar to Delta Initialization, but no data is extracted from the SAP DataSource.

Set Update Mode to Delta Init (without data) and run the extraction.
You can now use Delta Update.

Note

When re-initializing a delta process, first delete any existing Inits (initialization requests) by clicking [Maintenance] in the extraction settings.

Step 2: Delta Update [D]

Delta Update only extracts data added or changed on the SAP system since the last delta request.

Run the extraction with Delta Initialization or Delta Init (without data) once before setting the Update Mode to Delta Update.

Note

To prevent errors, aborts and gaps run the next extraction in the update mode Repeat.

Optional: Repeat [R]

This mode repeats the last delta run and updates all data accumulated since the last run. If the last run was unsuccessful, all data from the last delta update are deleted before a new run is started.
A Repeat can be started several times.

Many DataSources have the field ROCANCEL. This field defines if records are added or overwritten depending on the delta process type of the DataSource. It defines how a record is updated in the delta process.
In an ABR mode:

  • blank returns an after image
  • 'X' returns a before image
  • 'D' deletes the record
  • 'R' returns a reverse image

Optional: Delta Queue - RSA7

Once delta is activated, you can view the queued datasets in the Delta queue in SAP transaction RSA7.
If there is no new data to be transferred, a corresponding protocol message is displayed and the data pipeline is empty.

Note

Before initiating the next update, make sure that a delta update has been executed successfully. Running a new delta update removes the last one.



Last update: July 1, 2024