XML input Component

XML input Component

Preserved elements

/Job and /NestParts are preserved elements in the Root of the XML. These XML's aren't supported won't work properly in the XML Component.


Single Document XML example

You can use Elements and Attributes in your XML. Mandatory is a direct downloadable path to your Document. This can be a file path to a storage or https url. 
Notes
<YourXML>
    <YourCopies>7</YourCopies>
    <YourCustomerName>PrintFactory</YourCustomerName>
    <YourBleed top="3" bottom="5" left="7" right="9" />
</YourXML>

Mapping the elements and attributes to Keys in Workflow

Start your new Workflow by dragging the XML component from the Input Menu onto the canvas.

The screen below will appear and your finder/explorer will be shown to select or create a folder which will be used for the Hotfolder input.


By clicking 'Load sample' you can select your example XML and map XPaths to Keys. Just select the Element or Attribute you want to use. and click OK.

When clicking the '+' symbol it will open your example again to map more XPaths to Keys. Repeat this as many times you want to create your Keys.


Use the select button below the PDF icon to set your Key which contains the Document path.

If you don't want to use Key which are mapped to an XPath for a certain Workflow your can uncheck the box in front of the Key


Alert
Note: Mapped XPaths must always be available in your XML otherwise it will fail on validation and Error. Values of these XPaths can be empty.

Keys and Predefined Keys

Key names can be changed if you wish. By default it will use Element or Attribute from XPath.
In the pulldown menu at Key column you can find Predefined Keys from which you can choose. Here you can find the functionality of Predefined Keys


Multiple Documents XML example

This is supported when by placing the Document paths in a returning Array in XML. XPaths mapped to Keys within the Array where the Document path is stated are only applied on the Document in that Array. XPaths mapped to Keys outside of the Array are applied on all the Documents. 
Option available from PF 6.8.2.

Notes
<YourXML>
    <YourCustomerName>PrintFactory</YourCustomerName>
    <YourCustomerContactName>John Doo</YourCustomerContactName>
    <YourDocuments>
        <YourDocument>
            <YourDocumentPath>https://s3.amazonaws.com/workflow/16.jpg</File>
            <YourCopies>1</YourCopies>
            <YourBleed top="3" bottom="5" left="7" right="9" />
        </YourDocument>
        <YourDocument>
            <YourDocumentPath>https://s3.amazonaws.com/workflow/1600.jpg</File>
            <YourCopies>3</YourCopies>
            <YourBleed top="5" bottom="7" left="9" right="11" />
        </YourDocument>
        <YourDocument>
            <YourDocumentPath>https://s3.amazonaws.com/workflow/160000.jpg</File>
            <YourCopies>5</YourCopies>
            <YourBleed top="7" bottom="9" left="11" right="13" />
        </YourDocument>
    </YourDocuments>
</YourXML>
In this example /CustomerName and /CustomerContactName are applied to all Documents. /YourCopies and /YourBleed from the Array /YourDocument are applied on the Document in that same Array.

In the XML input Component you map the XPaths to Keys of one of the Arrays. The other Array will be handled automatic.

Alert
Note: Some Components in Workflow have to validate that Keys of different Documents from one Input XML are the same. Therefore Multiple Documents XML could Error on some Components. This can be solves be using the Split Component  and selecting the option 'Documents to Jobs'



    • Related Articles

    • Excel / CSV input Component

      General Excel or CSV files can be used in a Hotfolder to inject Documents into Workflow. Each row in a Excel / CSV file will be handled as a individual Job. Mandatory is a direct downloadable path to your Document. This can be a file path to a ...
    • Workflow - Working with Variables

      Workflow allows you to parameterize the settings of each component in the flow and make decisions optional using variables: There are 3 different types of variables: Keywords: User data generated from XML, JSON, XLSX, CSV, Database or RegEx Job ...
    • Predefined Keys

      Predefined Keys in Input Components in Workflow Excel / CSV, XML and Hotfolder (when using RegEx) Input Components have predefined Keys selectable from the pulldown menu in the Key column. When your Key has this predefined Key name or you select it ...
    • Hotfolder input Component

      Supported file types pdf, tif, eps, jpg, png and aur are supported file types. The Hotfolder also support PrintFactory format xml's. This means that xml's that start with /Job and /NestParts, they are supported because of legacy created xml's for ...
    • Database input Component

      Setup Setting up a connection to your DB are out of scope of Support Start a new Workflow by dragging the Database Component from the Input menu onto the canvas. Following screen will appear. DB type ODBC, SQlite and PostgreSQL are supported DB ...