The Execute operation allows:

1) setting up the order of sequences processing within one datamap
2) looping integrations
3) calling a 3rd-party application as part of a datamap

Ordering

To order processing of several integration sequences within one datamap file:

1) drag and drop the Execute operation to the work panel

2) connect the target connector of the sequence to be processed first to the input point of the Execute operation

3) connect the output point of the Execute operation to the source connector of the sequence that should be processed next

If the second (or any other subsequent) sequence has two sources (if you are joining or aggregating data), connect the output point of the Execute operation to the top source connector of this sequence

Looping

To have the integration start over again once one cycle is completed:

1) drag and drop the Execute operation

2) connect the target connector to the Execute operation input point

If you have multiple integration sequences within one datamap file, these sequences should be ordered using the Execute operation. Otherwise, sequences that are not linked together will only be processed once or might not be processed at all.

3) connect the output point of the Execute operation to the source connector of the first integration sequence

If the first sequence of the looped datamaps has two sources (if you are joining or aggregating data), connect the output point of the Execute operation to the top source connector of this sequence

 
Stopping a looped datamap

There are several ways to stop the looped datamap:

1) in Apatar application: click File>Stop

2) via command line: change directory to apatar folder and enter application.bat stop

3) create stop_cycling.txt in in Apatar folder (the folder Apatar is installed to). The contents of the file are not important, it can be an empty file

When using this feature keep in mind that Apatar will finish processing one loop and only stop when it gets to the last node of the datamap.

Calling a 3rd-party application

To have a 3rd-party application run as part of an integration:

1) drag and drop the Execute operation to the work panel

2) connect the target connector of the sequence after which the 3rd-party application should be run to the input point of Execute (if the application should be run after an integration sequence)

3) connect the output point of the Execute operation to the source connector of the next sequence (if the application should be run after an integration sequence)

4) double click the Execute operation (or right click it and select 'Configure')

5) enter the path to the 3rd-party application executable file to the pathToApplication field

It's the exit code returned by the 3rd-party application that triggers further datamap processing. If the application started by the Execute operation returns exit code when it starts and not when it actually stopped working, Apatar will move to the next sequence of your datamap right away without waiting for the 3rd party app to complete performance.