IQconnect-Prinergy
The IQconnect-Prinergy module allows you to establish communication from printIQ's Production Integration with a Kodak Prinergy Connect workflow system
Prinergy Connect's Rules Based Automation must be licensed on your Prinergy system. See your Kodak representative for further information.
Production Integration is a call-and-response between printIQ and a 3rd party system. printIQ will send Job XML and Quote Artwork files to a local FTP server. Prinergy Connect will monitor directories on the FTP to initiate automation for prepress processing. As processing occurs, Prinergy's Rules Based Automation sends SOAP calls of EventTypes back to printIQ to continue automation.
For supported EventTypes, please see following article here.
Coordinate with IQ support staff to configure FTP server access from your printIQ system.
Understand Job Operations
It is important to understand your Job Operation choices as these will be mapped to Prinergy workflow Process Templates. Go to Start Order / Custom and choose any Template. Note under initial Section specifications area, there are Job Operations. See example below:
By clicking Select against Job Operations, you may see more available, such as Proof operations. See example below:
Any Job Operations you configure for your quote, and therefore Accepted Order, may be mapped later to Events and Actions in Prinergy RBA.
Accessing printIQ Job XML
printIQ Job XML will have been configured by IQ support staff to automatically send to a local network share via FTP (see note above).
printIQ Job XML may also be manually triggered by viewing any Job on the All Jobs Production Board, selecting a desired Jobs magnifying glass icon and choosing the Export Job Xml function:
However, this action will send the XML file to a local network share. See your printIQ administrator for further details.
printIQ Job XML is also viewable through your web browser. Simply navigate to a desired Job Bag and enter
&format=xml
on the end of the Job Bag URL. See example:
You can save the resultant page as an XML file to your local workstation.
Understanding printIQ Job XML
printIQ Job XML contains a lot of data; elements and their values you may not be concerned with. However, a small number of elements will require an understanding of their place within the scheme to automate Prinergy Job processing. You will recieve a printIQ schema (.xsd) file during your integration, and it’s this schema you will navigate through as you configure a Prinergy Rule (Rules Based Automation).
- Job Number - Line 6:3 is the <JobNumber> element
- Job Title - Line 11:3 is the <Title> element
- Product Trim Size - Under the <Product> element, you’ll find the child elements <FinishedWidthMM> and <FinishedHeightMM> elements
- QUANTITY - Under the <Product> element, you’ll find the child element <Quantity>
MORE THAN ONE SECTION?
Your Job, and subsequent XML, may contain more than one Section. Therefore, please note the <Sections> parent element, and any <Section> children elements therein. These individual <Section> elements will also contain finished trim size elements. Each <Section> element will also denote:
- <Pages> = page quantity
- <Printing>
- <Machine> = output device
- <Stock> = media to print on
- <SheetWidthMM> = layout or impositon sheet size
- <SheetDepthMM> = layout or impositon sheet size
- <NumberUp> = quantity of artwork placed on layout
- <ProcessFront> = printing separations
- <ProcessReverse> = printing separations
The <Section> element may also contain it’s own <Operations> child element and a number of <Operation> elements therein. You may reference these later for automation purposes.
WHERE’S THE ARTWORK?
Each <Sections/Sections> element will contain a <Artowrk> element. This is broken down into <Files>, as their may be numerous artwork files, and one or more <File> elements.The <Name> of each <File> will be important and referred to later. Conversely, the originally uploaded file can be referenced via <OriginalName> under each <File>.
INTEGRATING THE JOB OPERATIONS
Lastly, the Job’s Operations (noted on Page 1) are located at the end of the XML after the closing </Product> element.
Initially, each Job Operation will be listed by name and description under the <Operations> parent element and one or many <Operation> children elements therein. In future iterations of printIQ Link to Kodak Prinergy Connect, these <Operations/Operation> elements may be referenced for easier Prinergy Rule configuration.
For now, please note the <IntegrationOperations> final element after the </Operations> closing element. Each named operation noted above will become it’s own unique element, named similiarly but without spacing. Each uniquely named job operation will contain a binary value. This value will be referenced later when configuring a Prinergy Rule. See example below
Further information on XML can be found here.
CONFIGURING A PRINERGY RULE - ADDING THE SCHEMA
Have the printIQ ProductionDetails.xsd schema file available to your local workstation. It will import automatically when importing Prinergy RBA provided by IQ. Launch a Prinergy Workshop application / program and log in with credentials wherein Prinergy Rules Based Automation may be accessed.
Generally, Prinergy Rules are built, edited or removed within the Rule Set Manager, and these controls will be covered later.
Additionally, launching the Rule Set Manager from the Prinergy Job Finder will bring you into the System Rules area. Enabling any Rules here will be enabled on the entire system. Refer to your Prinergy adminstrator before enabling system Rules. It’s always considered best practise to launch the Rule Set Manager from within specific Prinergy Jobs and enabling Rules at specific Job level.
While in the Rule Set Manager, go to Tools / RBA XML Schema Manager
A web browser will open and the XML Schema Manager is where you add the printIQ ProductionDetails.xsd (if not already present). You can create a specific group for the schema, or simply add to the root level.
You may add the schema to the root level or create a Group and place there. Provide your schema a Name, and any Description you like. Browse to the XSD file on your local workstation. Do not worry about specifying a Root element or referencing additional transform (XSLT) file.
Once the schema addition is successful, it’s good to test the element visibility within a quick Prinergy Connect Rule.
QUICK TEST THE SCHEMA
In the Prinergy Rule Set Manager, create a New Rule Set
Drag a Job Hot Folder Drop Event from the Events tab. Join with a Read XML Action from the Actions tab. Lastly, drag an Email Action to the Success of the Read XML Action.
Double-click the red connection between Job Hot Folder Drop and Read XML to configure the Read XML action. Navigate and select your recently added schema.
’OK’ that action and do the same for the Email action. Edit the Parameter for email To. If you can see various elements like JobNumber, Product, etc., the schema addition was successful.
BASIC PRINERGY RULE DESIGN
Two sample Prinergy Rule Sets may be Imported into your Prinergy System. These Rule Sets will handle reading the incoming printIQ Produciton Details XML file for Prinergy Job Creation, and interpreting the Production Details XML for Adding Input Files and sending SOAP calls back to printIQ.
The printIQ_XML_Drop_2017v3.zip
Once the printIQ_XML_Drop_2017v3.zip Prinergy Rule Set is Imported into your Prinergy system make the adjustments below:
Adjust the Create Job Action to reflect your local Prinergy server / share / group / template Job. The template Job will be configured in the next step
The printIQ_JobCreated_AddInputFiles_2017v3.zip
Once the printIQ_JobCreated_AddInputFiles_2017v3.zip Prinergy Rule Set is Imported into your Prinergy system, make the adjustments below:
Adjust any of the User Defined Actions (SOAP calls to printIQ) to reflect your printIQ URL
Adjust the Add Input Files Action to reflect your local FTP / ArtworkIn share your printIQ is placing supplied artwork files in.
Ensure the Rule has it’s Rule Set Variables configured as per below
Enabling the printIQ Rules
Enable the printIQ_XML_Drop_2017v3 rule to a Prinergy Job wherein:
- The Jobs Hot Folder is the ‘xml_in’ FTP directory printIQ is placing Production Details.xml
Enable the printIQ_JobCreated_AddInputFiles_2017v3 rule to a Prinergy Job wherein:
- The Job is the Template Job for printIQ_XML_Drop_2017v3 is referenced
Related Articles
IQconnect-XMPie
IQconnect-XMPie Overview IQconnect-XMPie allows you to connect XMPie directly to printIQ via an XML push. With this seamless integration printIQ will consume the XMPie XML and generate a Job or Sales Order (pick & pack) directly in printIQ. printIQ ...IQconnect OnlineWidget Setup
IQCONNECT SMARTSITE MODULE OVERVIEW IQconnect SmartSite solves the age old problem of how to take your complex print business online and offer print products with all their diversity. With SmartSite you use the right tool for the right job. This ...IQconnect-Enfocus SWITCH on Simplified and Custom Quoting
High Level Overview The IQconnect-enfocus SWITCH module allows administrators to integrate an Enfocus workflow within printIQ. By combining printIQ with the Enfocus product bundle you have the framework to build a dedicated workflow to match a range ...IQconnect-Enfocus SWITCH Pre-Production Details
To print or download this document click here Pre-Production Details Once a Job enters the SWITCH automation flow, you may determine the flow status by viewing the Job’s Pre-Production Details. Navigate to the Job in question, and from a Job Details ...IQconnect-Esko Product Setup scenario
High level overview of workflow scenario Static Products may be ordered via the Simplified Products screen. Users may filter by specific Site or Customer, and then navigate via categories down to Product Ordering level. Users may also Search via the ...