Formatting uImage Output Filename
During production, each uImage content object is replaced with uImage output files: personalized image files created per recipient. The names of these output files are set by the File Name row in the Rule Editor’s Rule Designer mode.
The output filename plays an important role in production optimization: when uImage tag values are reflected by the names of the output files, identical output files receive the same name. Files with duplicate names can then be detected, enabling the Skip duplicates option (in Advanced uImage Settings) to avoid producing the same file twice.
By default, the File Name row reads Automatic, and the filename uses this format:
<uImage Template Name>_<uImage Tag 1 Value><uImage Tag 2 Value>…<uImage Tag n Value>.<Format Extension>
To accurately reflect the image’s values, the filename must include all uImage tags used in the image.
For example, the following personalized images
were created using a uImage template named Balloon - HighRes.psd. This template includes the first uImage tag, whose content is <First Name>. The output filename of this template is:
Balloon - HighRes.psd_<First Name>.jpg
This format creates different filenames for two of the recipients, Ernest and Faith: Balloon - HighRes.psd_Ernest.jpg versus Balloon - HighRes.psd_Faith.jpg. Since these filenames are different, uImage produces both files.
For any other recipient whose first name is "Ernest" or "Faith", the filename will be identical. If Skip duplicates is on, the personalized image will not be produced again, resulting in significantly quicker production times, especially for large recipient lists with many duplicate names.
Customize the output filename
To use a custom filename format instead of the automatic one, replace Automatic in the File Name row with your own expression.
To customize the uImage output filename:
-
Right-click the uImage graphic content object and select Edit Rule.
The Rule Editor opens in Rule Designer mode.
-
In the File Name row, click Automatic and use the context menu to build the filename expression.
Make sure the filename includes all uImage tags used in the template, so that two recipients with the same tag values produce the same output filename.
-
Click OK to save your changes.
Note: Rule Designer shows the filename on a single row, so it cannot display conditional code. If your filename expression includes an If or Switch — or if any uImage tag rule does — the rule opens in Rule Builder instead of Rule Designer. You can continue editing it there, or in the Code Editor.
Continue your design work, using the uImage graphic content object to tag the relevant graphic(s) in your document. When you produce this document, the output filenames will use the format you specified. If Skip duplicates is on (in Advanced uImage Settings), duplicate filenames will be detected and existing output will not be produced again.