The merge task allows you to merge multiple DAT files into a single file. A common expression is used for this purpose, which must return the same value for all files involved. This allows multiple DAT files to be opened simultaneously and combined into a new file.
A license for ibaDatCoordinator-File-Extract or ibaAnlayzer-File-Extract is required to use this task, see Licenses.
The merge task is triggered by a new DAT file in a configured directory folder. The configured expression is applied to this file, and ibaDatCoordinator searches other configured directories for matching accompanying files where the expression yields the same value. These files are then automatically merged.
The task-specific settings are explained below. For all other settings, see General task settings.
Tip |
|
|---|---|
 |
Here is an example of how to use the merge task: Example: Using the merge task for multistation |
Merge settings
Analysis file
Enter the analysis file (PDO) that contains the configuration for the extraction here. Enter the path name and file name of the PDO file or select the file using the browser button. For creating this analysis file, note that all files are opened in parallel in the order configured in the table “Directories”.
Expression to merge
This expression is evaluated for all files to find the right companion files. You can also define the expression in the analysis file.
Text expression settings
If the expression is a text channel there are options to evaluate only parts of the string. Enter at least the Start and Length of the string.
Directories
Select the directories from which the files to be merged are taken from. The main directory in the first line corresponds to the directory from the job configuration and is read-only.
The order in the table corresponds to the order in which the files are opened by ibaAnalyzer during the processing. You can use the controls on the right to add or delete directories or move lines. You can also move the lines using drag & drop. You can also create new lines by editing the empty line at the very bottom.
If the directories or files are password-protected, also enter the user name and password.
Scan subdirectories
If activated, the system also searches for suitable companion files in the subdirectories of the folders.
Pause before merge: ... seconds
When the job is triggered, the specified time should be waited before searching the suitable companion files.
Fail task if not all companion files are found
If activated, the task fails if one or more files are missing. If you disable this option, the merge will be performed without the missing files and a warning will be issued.
Control elements
 |
Checks whether all configured directories are accessible for ibaDatCoordinator. |
 |
Removes the markers from the DAT files that they have already been processed. After the marking has been deleted, ibaDatCoordinator treats these files as newly created files. |
Test
You can check the expression in advance using a test file. To do this, select a DAT file and click the <?> button to execute the expression and display the result. If the DAT file is password-protected, you will need to enter the corresponding password.