Appendix H - Unique Suffix
The File System and Ftp connectors provide several options to dynamically generate file names. This is useful in situations where you expect files to exist in the destination folder and you want to avoid file name conflicts. The file naming option are tabulated below:
| Tag Name | Description |
|---|---|
| UNIQUESUFFIX | Append to or insert into the file name the first available number starting at 0 |
| UNIQUESUFFIX+1 | Append to or insert into the file name the first available number starting at 1 |
| UNIQUESUFFIX2+1 | Append to or insert into the file name the first available number starting at 01 |
| UNIQUESUFFIX3+1 | Append to or insert into the file name the first available number starting at 001 |
| UNIQUESUFFIX4+1 | Append to or insert into the file name the first available number starting at 0001 |
Windows File System Connector Only
When a “?” is added to the end of the unique suffix tag e.g. [UNIQUESUFFIX?], [UNIQUESUFFIX3+1?], the unique suffix is applied only if there is an existing file(s) in the destination.
The uniqueness of a file name is guaranteed by putting a number in the position where the tag is specified. Here are a couple of examples:
Document-[UNIQUESUFFIX] = Document-0, Document-1, Document-2 etc.
Document-[UNIQUESUFFIX2+50] = Document-50, Document-51, Document-52 etc.
Invoice[UNIQUESUFFIX4] = Invoice0001, Invoice0002, Invoice0003 etc.
The number after the word UNIQUESUFFIX e.g. UNIQUESUFFIX2 represents the number of zeros with which to pad the number. So if you specify UNIQUESUFFIX2 the number below 10 will be padded with 1 zero e.g. 01, 02 etc. If you specify UNIQUESUFFIX3 the numbers below 100 will be padded with 2 zeros e.g. 001, 002 and the numbers from 10 up to 99 will be padded with 1 zero e.g. 010, 011…098, 099. The same pattern holds for UNIQUESUFFIX4 except that 3 zeros are added to numbers below 1000, 2 zeros for numbers 10 to 99 e.g. 0010 and 0011.
If you don’t include a “plus number” in the tag name the numbering starts at 0. The plus number indicates where numbering should start. When specifying “+1” the numbering starts at 1 e.g.:
| 1 | UNIQUESUFFIX+1 |
| 01 | UNIQUESUFFIX2+1 |
| 001 | UNIQUESUFFIX3+1 |
| 0001 | UNIQUESUFFIX4+1 |
For “+25” the numbering would start at 25 e.g.:
| 25 | UNIQUESUFFIX+25 |
| 25 | UNIQUESUFFIX2+25 |
| 025 | UNIQUESUFFIX3+25 |
| 0025 | UNIQUESUFFIX4+25 |