This is helpful in several different scenarios:
- When you want to combine various x9 files with different test cases into a single file that can be used for ongoing testing.
- When you want to combine multiple x9 files to create a single larger file, possibly to be used for stress testing purposes.
- When you purposefully want to create invalid data conditions (eg, ICLR bundles within an ICL file).
Merge can be run repetitively to include more and more data into a single x9 file. This is helpful when you are pulling in files from multiple input folders. Note that the resulting x9 file remains only in memory and must be written after construction and review.
Merge can automatically renumber the bundles to ensure that the bundle identifiers are unique.
As part of the merge process, you have the option to either merge as bundles or merge as cash letter(s).
- When you merge as bundles, the bundles from the selected x9 file will be appended to the last cash letter that exists within the currently loaded x9 file.
- When you merge as cash letters, the cash letter(s) from the selected x9 file will be appended to the end of the currently loaded x9 file.
- When merging as bundles, you have the additional option to copy the origination / destination RT from the cash letter header record to the merged bundles. This is a validation requirement per UCD rules. This option will only be applied when merging bundles is selected.
Regardless of which merge process is selected, you have a common option to assign new item sequence numbers to all output items. When this option is selected, new sequence numbers are assigned to both the current and the inserted (merged) items. Selecting this option will ensure that your new x9 file does not have duplicate item sequence numbers.
You can select multiple x9 files as input to a single merge operation. This is done in a standard way based on your OS platform. For example:
You can select multiple files by holding down the CTRL key as you select individual files.
You can select a range of files by selecting the first file within the range and then holding down both the CTRL and SHIFT keys as you select the last file.
You can select all files within a folder by using the CTRL A key combination.
Your selected files will be displayed in the “Selected Files” panel on the right.
Initiating the Merge
Once you have selected files, press the Merge button to initiate the merge process.
Merge will launch a new x9 file validation process for the resulting merged file. The merged file remains in memory after the merge process has been run. You must save the results to an external x9 file if you determine that the results are beneficial per your requirements.