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' your 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.

Predefined Keys

In the pulldown menu at Key we show the following predefined Keys.
  1. Name                       
    1. Will use the Key value to overrule the Name of the file name of your XML in the Job list in Workflow
  2. Copies                     
    1. Will use the Key value to apply Copies to be produced on the Document
  3. DateCreated
    1. Will use the Key value to overrule the automatic generated CreationDate of the Document. Is only used in the Nester for Stack methode 'Job Order'. DateTime stamp ISO8061 is only allowed and validated
  4. Barcode
    1. Will use the Key value to create a barcode from. Only used on Job Part Labels Design 3 for Jobs created by the cloud nester
  5. BarcodeType
    1. Will use the Key value to define the barcode type which needs to be generated
      1. Allowed values
        1. QR
        2. DataMatrix
        3. PDF417
        4. Code128
        5. Code39
        6. Ean13
        7. Ean8
        8. AddOn
        9. Code25l
  6. SplitAB
    1. Will use the Key value 'true' or 'false' to Split Double Sided Jobs into a ~A and ~B side Job when the Print Driver used for the Job also supports Multi Layer printing


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>
            <YourCopies>1</YourCopies>
            <YourBleed top="3" bottom="5" left="7" right="9" />
        </YourDocument>
        <YourDocument>
            <YourCopies>3</YourCopies>
            <YourBleed top="5" bottom="7" left="9" right="11" />
        </YourDocument>
        <YourDocument>
            <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

    • 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 ...

    • Creating a new Workflow

      To create a new Workflow you first need to open the Workflow application. On a Windows PC, you will find it here: C:\Program Files\PrintFactory, and on macOS, here: HD/Applications/PrintFactory. After opening the application you need to click the ...

    • Creating Keywords using RegEx

      Workflow allows you to parameterize the settings of each component in the flow and make decisions optional using variables. You can read extended information about variables and their format in the article [here]. This article will explain in close ...

    • Workflow Debug mode

      Debug mode can be enabled in your Workflow to enable you to check the Job XML & file at each step in the Workflow. To enable debug mode, right click the Workflow name and click "Enable Debugging" When the debugging is enabled, you will see the little ...

    • Input Properties

      To set the input properties of a PrintFactory Queue Proceed as follows: Double-click the PrintFactory Queue of your choice. Make sure that the correct Queue type is selected. Click the Input tab. Set the input properties of the PrintFactory Queue: ...