XML входный компонент

XML входный компонент

Сохранённые элементы

/Job и /NestParts — это сохранённые элементы в корневой части XML. Эти XML-файлы не поддерживаются и не будут корректно работать в XML-компоненте.

Пример XML-файла для одного документа

В вашем XML-файле можно использовать как элементы, так и атрибуты. Обязательным является указание прямого пути для скачивания документа. Это может быть путь к файлу в хранилище или HTTPS-ссылка.

Пример:

Notes
<YourXML>
    <YourDocumentPath>https://s3.amazonaws.com/workflow/15.jpg</YourDocumentPath>
    <YourCopies>7</YourCopies>
    <YourCustomerName>PrintFactory</YourCustomerName>
    <YourBleed top="3" bottom="5" left="7" right="9" />
</YourXML>

Сопоставление элементов и атрибутов с ключами в Workflow

Начните создание нового Workflow, перетащив XML-компонент из меню ввода на рабочее поле.

На экране появится следующее окно, и ваш файловый проводник (Finder/Explorer) откроется для выбора или создания папки, которая будет использоваться в качестве входной папки Hotfolder.



Нажав «Load sample», вы можете выбрать свой пример XML и сопоставить XPaths с ключами. Просто выберите элемент или атрибут, который хотите использовать, и нажмите «OK».


При нажатии на символ «+» ваш пример откроется снова, позволяя сопоставить дополнительные XPaths с ключами. Повторяйте этот процесс столько раз, сколько необходимо, чтобы создать все нужные ключи.


Используйте кнопку выбора под значком PDF, чтобы установить ключ, содержащий путь к документу.

Если вы не хотите использовать ключ, сопоставленный с XPath, для определенного рабочего процесса, вы можете снять флажок перед ключом.



AlertПримечание: Сопоставленные XPaths всегда должны присутствовать в вашем XML-файле, иначе произойдет ошибка во время проверки. Значения этих XPaths могут быть пустыми.

Ключи и предопределенные ключи

Имена ключей можно изменить при необходимости. По умолчанию используются названия элементов или атрибутов из XPath.

В выпадающем меню в столбце Key доступны предопределенные ключи, которые можно выбрать. Здесь также представлена их функциональность.




Пример XML с несколькими документами

Этот вариант поддерживается, если пути к документам указаны в повторяющемся массиве внутри XML.

  • XPaths, сопоставленные с ключами внутри массива, применяются только к документу в этом массиве.
  • XPaths, сопоставленные с ключами вне массива, применяются ко всем документам.

Доступно с версии PF 6.8.2.

Пример XML:

Notes
<YourXML>
    <YourCustomerName>PrintFactory</YourCustomerName>
    <YourCustomerContactName>John Doo</YourCustomerContactName>
    <YourDocuments>
        <YourDocument>
            <YourDocumentPath>https://s3.amazonaws.com/workflow/16.jpg</YourDocumentPath>
            <YourCopies>1</YourCopies>
            <YourBleed top="3" bottom="5" left="7" right="9" />
        </YourDocument>
        <YourDocument>
            <YourDocumentPath>https://s3.amazonaws.com/workflow/1600.jpg</YourDocumentPath>
            <YourCopies>3</YourCopies>
            <YourBleed top="5" bottom="7" left="9" right="11" />
        </YourDocument>
        <YourDocument>
            <YourDocumentPath>https://s3.amazonaws.com/workflow/160000.jpg</YourDocumentPath>
            <YourCopies>5</YourCopies>
            <YourBleed top="7" bottom="9" left="11" right="13" />
        </YourDocument>
    </YourDocuments>
</YourXML>

В этом примере:

  • /YourCustomerName и /YourCustomerContactName применяются ко всем документам.
  • /YourCopies и /YourBleed, находящиеся внутри массива /YourDocument, применяются только к соответствующему документу.

Настройка в XML Input Component

При настройке компонента XML Input вам нужно сопоставить XPaths с ключами для одного из массивов. Остальные массивы будут обработаны автоматически.

Важно!

Некоторые компоненты в Workflow должны проверять, совпадают ли ключи у разных документов из одного входного XML.

Из-за этого использование XML с несколькими документами может вызвать ошибки в некоторых компонентах.

Решение:
Используйте Split Component и выберите опцию "Documents to Jobs". Это разделит входной XML на отдельные задания, устраняя потенциальные ошибки.