Sam Webster
Created Dec 01, 2022Sending Additional Job Reference Data
We support the ability to send additional Job Information with every job using printIQs Job Reference fields.
This tutorial will demonstrate how to set up the mapping so this data can be exchanged.
Type "connect"

Click on Connect Plugins

Click on Configure next to the Connect:PrintIQ plugin

Check Send additional Reference fields
Once enabled you will be presented with a mapping UI that will allow you to determine what Job Reference field in printIQ information is passed into, and what value we pass for that reference.

Click on Add new item

Explore inputs
You will be presented with two paired text fields.
The 'Key' which is the name of the Job Reference Field as it appears in printIQ exactly.
The 'Value' which you should populate with an Infigo placeholder(s) to build up the value you want to be passed.

There is a complete list of placeholders in admin where you can search for Order specific or Orderline specific placeholders.
Type "placeholder"

Open Placeholder Overview in a new tab

Search for relevant placeholders
Order-specific placeholders are officially supported for things like Invoices and Packing Slips (which are at an Order context) and Orderline specific placeholders are officially supported for things like Job Tickets (which are at an Order line item context).
Note: Some Order specific placeholders will still work on job tickets, and some Orderline specific placeholders will work on Invoices and Packing Slips, however this would not be an officially supported configuration and may not work as expected.

Click on > button
If you click the > next to a placeholder in the list, you will see that it expands to give you an example of how to use the placeholder, as well as a brief description of what it's for.
A placeholder when used throughout the system should be included within a starting and ending percentage symbol. For example:
%JobId% - is the correct way to use a placeholder that will be replaced with the Job ID value
%CustomName% - is the correct way to use a placeholder that will be replaced with the Job Custom Name value.

Click on Copy

Paste Placeholder into Value field
The 'Value' which you should populate with an Infigo placeholder(s) to build up the value you want to be passed.

Type a job reference from PrintIQ into the Key field
The 'Key' which is the name of the Job Reference Field as it appears in printIQ exactly.
