1 Layout preparation & import
Add placeholders to your layout
Add black QR-Code placeholder
Requirements
- The placeholder text must be located in a single text frame (not linked with any other)
- The text frame must be a square (same height and width)
- The placeholder text including tags must be the only content of the text frame (be careful with spaces)
- You can choose any text you like (a-z, 0-9, _-)
- If you want to use Autolink you can add # to identify the placeholder as QR-Code, e.g. <<#qrcode>>
- For a black QR-Code you should choose a black font color
Note: For better performance also give the textframe a background color, even if it is the same then the underlying content. This allows MyDataMerge to choose a more efficient process of generating QR-Codes.
Add image placeholder
Requirements
- The placeholder text must be located in a single text frame (not linked with any other)
- The frame can have any proportions
- You can choose any text you like (a-z, 0-9, _-)
- The placeholder text including tags must be the only content of the text frame (be careful with spaces)
- If you want to use Autolink you can add @ to identify the placeholder as image, e.g. <<@image>> (for using Autolink you also have to make sure that the label of the placeholder and the title of your datasource colum must match (in the example above, the datasource column title must be “image”)
Note: The position/alignment of the text inside the frame is not taken into account. You can control the alignment and fitting in the configuration.
2 MyDataMerge configuration
Configurations
Add hyperlinks to setups
You can add Hyperlinks dynamically to your placeholders, no matter if its a text, image or QR-Code placeholder. After applying hyperlinks, a reader can click on the element to open the hyperlink.
Note: Hyperlinks will only work if you export to InDesign files or interactive PDF files.
How to add Hyperlinks
Hyperlinks are part of a setup – this gives you the full advantage of a setups flexibility (e.g. to apply different hyperlinks to the same placeholder based on conditions). To add a hyperlink, open the placeholder in the editor and click the hyperlink icon [1] to open the hyperlink panel. Then enable the hyperlink [2] and start with your configuration:
Shared Hyperlink destination
This is only useful if you have multiple hyperlinks with the same target and need to continue working with your InDesign layout. With this option turned on, only one hyperlink target will be created in your layout document and be shared for multiple hyperlinks. With this option turned off, a new target will be created for each hyperlink.
Highlight
Selects the highlight effect of the hyperlink
PDF Display
Selects the kind of frame around the hyperlink. Selecting “Visible Rectangle” will unlock the options below to further style the frame.
Width
The width of the rectangle (thin, medium or thick)
Format
The format of the rectangle (solid or dashed)
Color
The RGB color of the rectangle. All RGB swatches (and only RGB) from your document are imported automatically and will be selectable next to “Document default”.
Configuration
The configuration button opens another editor to configure the hyperlinks content. You can select a hyperlink type and edit every item like a text placeholder to inject data into a hyperlink.
Editing image placeholders
Setup image placeholders
An image placeholder will inject images based on file paths from various sources into your layout in the merge process.
These sources can be one or a combination of:
- Datasource content (Changes for each record)
- Static text (Always the same)
- Sequence (Different types of counting numbers)
- Automator workflow (for editing outside of MyDataMerge – learn more here)
- Custom (java-)script (learn more here)
Open the placeholder by double clicking it (or click the pen icon), then the editor will open. First of all, make sure that “Replace with image” is selected [1]. Then add one or more elements to get file paths to your images. In the below example [2] a datasource element is added, where column “Image” is selected (as this column contains paths to the image files). If the element is valid (green check) and a valid image path is given, you will see a preview on the right [3]. If the preview doesn’t appear, you might need to grant access to the image folder for MyDataMerge – click the “Grant access” button in this case. By deactivating the switch “Show image”, MyDataMerge will output the file path in the preview instead.
After access is granted, you will see the image appear in the preview on the right:
3 Export
Filetypes
Export to interactive PDF files
If you want to export to interactive PDF files go to export > filetype and select the preferred filetype from the dropdown.
Use a static filename with counting number
You can set a static filename in Export > Filetype > “Static filename” field.
With static filenames, every file will get the same name and a counting number will be attached. For example if you define static filename to be “mydatamerge” then files will be named like this:
- mydatamerge_1
- mydatamerge_2
- mydatamerge_3
- and so on
Please note that static filenames only allow a-z, 0-9, – and _ characters. Other characters will be removed or replaced.
Extras
Setup GREP replacements
GREP text actions allow you to search and replace specific strings matching custom search patterns with other strings or patterns AFTER the merge process is completed. They are applied to all documents generated.
Go to Export > Extras > GREP text
Here you can activate or deactivate your configured GREP text replacements. To edit them click on the pen icon of each row, to add new ones click on the gear icon in the bottom right. This will take you to the preferences where you can add new actions or delete existing ones (Note: Predefined actions cannot be deleted. They are flagged with [System] at the end of the name):
GREP text actions are stored locally on your machine. Only activated actions will be added to project files.