MERGEFORM
Overview
The MERGEFORM workflow application takes multiple form data files and merges them into one file. It can also merge form archives into a target form archive by merging the HTML sections from both files.
How it works
All parameters are optional, and parameter names can be set by the process designer. To copy a data from one to another, the only action required is to set the default value as the data to copy and set the data into which you want to retrieve it. There is no limit to the number of parameters.
Parameters
Required parameters
Parameter
Type
Direction
Description
FORM_DATA
File
INOUT
The merge target FORM_DATA
. All FORM_DATA_SOURCE
parameters will merge into this parameter’s default value (IN) and will update the specified data (OUT) with the result.
FORM_DATA_SOURCE1
File
IN
Specific form data to merge into the target form data.
FORM_FIELDS_MERGE1
Text
IN
The fields to merge from FORM_DATA_SOURCE1
to FORM_DATA
, separated by commas. It supports the asterisk (*
) wildcard character to select all fields starting with the prefix.
✏️ Note: If you don’t specify a FORM_FIELDS_MERGE[N]
parameter, all of the fields in FORM_DATA_SOURCE[N]
will be merged.
Optional parameters
Parameter
Type
Direction
Description
FORM_DATA_SOURCE[2..N]
File
IN
Specific form data to merge into the target form data.
FORM_FIELDS_MERGE[2..N]
Text
IN
The fields to merge from FORM_DATA_SOURCE[2..N]
to FORM_DATA
. It also supports the wildcard character.
FORM_ARCHIVE
File
INOUT
The merge target FORM_ARCHIVE
. All FORM_ARCHIVE_SOURCE
parameters will merge into this parameter’s default value (IN) and will update the specified data (OUT) with the result.
FORM_ARCHIVE_SOURCE[1..N]
File
IN
Specific form archive to merge into the target form archive.
FORM_FIELDS_ARCHIVE[1..N]
Text
IN
Section IDs to merge from FORM_ARCHIVE_SOURCE[1..N]
to FORM_ARCHIVE
, separated by commas. It does not support the asterisk wildcard parameter; instead, you must specify the exact IDs of each section to merge.
Examples of parameters
Parameter
Type
Direction
Description
FORM_DATA
File
INOUT
Send value of FORM_DATA
Receive value of FORM_DATA
FORM_DATA_SOURCE1
File
IN
Send value of FORM_DATA_VALIDATES_ACCOUNTING
FORM_FIELDS_MERGE1
Text
IN
Send value of ACCOUNT_*
FORM_DATA_SOURCE2
File
IN
Send value of FORM_DATA_VALIDATES_SALES
FORM_FIELDS_MERGE2
Text
IN
Send value of SALES_DECISION,SALES_COMMENT
FORM_ARCHIVE
File
INOUT
Send value of FORM_ARCHIVE
Receive value into FORM_ARCHIVE
FORM_ARCHIVE_SOURCE1
File
IN
Send value of FORM_DATA_VALIDATES_ACCOUNTING
FORM_FIELDS_ARCHIVE1
Text
IN
Send value of ACCOUNT
FORM_ARCHIVE_SOURCE2
File
IN
Send value of FORM_ARCHIVE_VALIDATES_SALES
FORM_FIELDS_ARCHIVE2
File
IN
Send value of SALES