Настройка заданий преобразования XML

Можно создать задание преобразования XML для преобразования файла XML в требуемый выходной формат, а также назначить значения полей "Метаданные захвата" из XML. Это можно сделать, настроив поддерживаемые комбинации определений обработчиков XSLT и указав свой пользовательский файл XSLT. Кроме того, выражение XPath можно сопоставить с полями "Метаданные захвата". После этого преобразованный XML-файл может использоваться приложениями сторонних производителей для удовлетворения бизнес-потребностей других сторон.

Примечание.:

В версии Oracle Content Management Starter невозможно создать задания преобразования XML. Для использования этой функции необходимо выполните обновление до версии Oracle Content Management Premium. Дополнительную информацию см. в разделе Версия Starter и версия Premium.

  1. На панели процедур слева выберите процедуру.

    Страницы конфигурации для выбранной процедуры отображаются справа.

  2. Откройте вкладку Обработка.

  3. В таблице Задания преобразования XML нажмите Добавление задания преобразования XML. Чтобы изменить существующее задание, нажмите Редактирование задания преобразования XML.

    Кроме того, задание преобразования XML можно скопировать, выбрав его, нажав Копирование задания преобразования и введя новое имя при запросе. Копирование заданий позволяет быстро дублировать и изменять их.

  4. На странице Выбор документа:

    1. В разделе Выбор документа выполните указанные ниже действия.

      • Введите название и описание задания.

      • Чтобы обработать задание преобразования XML для определенных профилей документов, выберите один или несколько профилей документов, перечисленных в поле Ограничить профилями документов, или выберите Все, чтобы обработать документы для всех определенных профилей документов.

    2. В раскрывающемся списке Место назначения вывода преобразования выберите подходящий вариант.
      • Документ. Замена исходного документа результатами преобразования. При необходимости можно также изменить профиль документа.
      • Документ, сохранить копию. Сохранение исходной копии. При выборе этого параметра можно также выбрать профиль документа. При этом в раскрывающемся списке Сохранить тип вложения необходимо выбрать тип вложения.
      • Вложение. Сохранение результатов преобразования в виде вложения. В раскрывающемся списке Тип нового вложения необходимо выбрать тип вложения.
      • Поле захвата. Сохранение результатов преобразования в поле "Захват". В раскрывающемся списке Поле захвата необходимо выбрать Текстовое поле.
    3. В разделе Выбор вложения выполните указанные ниже действия.
      1. Установите флажок Вложения процесса, если это применимо к вариантам, выбранным на предыдущих этапах.
      2. Ограничьте типы вложений, установив флажки для доступных типов вложений. Можно также выбрать все типы.
      3. Выберите место назначения вывода преобразования.
        • Вложение. Можно изменить тип вложения.
        • Вложение, сохранить копию. Можно выбрать тип вложения. При этом в раскрывающемся списке Сохранить тип вложения необходимо выбрать тип вложения.
        • Поле захвата. Необходимо выбрать Текстовое поле или Поле XML.
  5. На странице Преобразование — Определение преобразования выполните указанные ниже действия.
    1. Если флажок Выполнить преобразование XML еще не установлен, установите его, чтобы включить редактирование значений полей на этой странице. Если снять этот флажок, редактирование при сохранении последних сохраненных значений в полях будет отключено. Этот флажок можно снять, если преобразование XML не требуется.
    2. В разделе Механизм преобразования выполните указанные ниже действия.
      • Выберите совместимые Версию XSLT, Обработчик и Версию обработчика. Выберите системные настройки по умолчанию или доступные версии XSLT, совместимые с обработчиками Xalan и Saxon-HE и их версиями.
      • Укажите Расширение файла вывода, например XML, HTML, JSON, текст.

        Примечание.:

        Если расширение выходного файла не соответствует XML, страница "Сопоставление полей" будет отключена.
    3. Чтобы выполнить преобразование, загрузите или введите XSLT в разделе Таблица стилей XML.
    4. Параметры, включенные в XSLT, должны быть определены в таблице параметров. Для этого выполните указанные ниже действия.
      1. В таблице Параметры нажмите Добавить параметры.
      2. В диалоговом окне Добавить параметры XSLT добавьте имя параметра и присвойте ему значение. Можно добавить текстовое значение или собрать значение метаданных для параметров.
      3. Повторите шаги i и ii, чтобы определить требуемые параметры.

        Примечание.:

        Если параметрам, определенным в XSLT, значения не присвоены или если значения присвоены параметрам, которые не существуют в XSLT, невозможно будет сохранить задание преобразования XML и получить уведомление об этом при попытке сохранить задание преобразования.
    5. В разделе Тестирование преобразования загрузите и протестируйте преобразованный XML, чтобы убедиться, что он создан правильно, а затем нажмите кнопку Далее. Можно также просмотреть контент этого раздела, нажав Предварительный просмотр в правой верхней части этого раздела.
  6. На странице Сопоставление полей определите навигацию к определенным элементам или атрибутам, чтобы пользователи могли извлечь их значения из документа XML.
    1. Установите флажок Выполнить сопоставление полей XPath, чтобы включить редактирование таблицы "Сопоставление полей XPath". Если этот флажок снят, редактирование таблицы будет невозможно. Однако последние сохраненные значения остаются.
    2. Установите флажок Сбой пакета при ошибках разбора, если должен строго соблюдаться формат разбора, который будет выбран на следующем этапе.
    3. В правом верхнем углу таблицы Сопоставление полей XPath нажмите Редактировать сопоставление полей XPath
    4. В диалоговом окне Редактирование сопоставления поля XPath выполните указанные ниже действия.
      1. В поле Выражение XPath укажите выражение XPath для выбранного поля метаданных и выберите формат разбора.

        Выражение XPath оценивается на выходе преобразования, если оно существует. Если преобразование не выполнено, выражение XPath оценивается в документе или во вложении.

      2. В раскрывающемся списке Формат разбора даты выберите формат разбора. Если в поле "Захват" указано число, вместо него появится раскрывающийся список Формат разбора чисел. При необходимости в раскрывающемся списке можно выбрать пользовательский формат разбора.
      3. Нажмите ОК.

        Разбор значения, добавляемого в столбец Выражение XPath таблицы Сопоставление полей XPath, выполняется до даты в выбранном формате.

    5. Нажмите ОК.
  7. На странице Постобработка укажите, что происходит после завершения задания преобразования XML:
    • Если выполнены все критерии, указанные на предыдущей странице, системные ошибки не возникают. Успешная трансформация может привести к фиксации.
    • Если преобразование завершается неудачно, возникают системные ошибки: записи не найдены, найдено слишком много записей и т. д. В случае неудачного преобразования пакет возвращается Content Capture Client для восстановления.
    См. Настройка постобработки и мониторинга задания преобразования XML

  8. Проверьте настройки на странице Сводка и нажмите Отправить, чтобы сохранить задание.

  9. Настройте способ передачи пакетов в задания преобразования XML. См. Настройка потока пакетов для задания преобразования XML.

  10. Протестируйте созданное вами задание преобразования XML.

Настройка постобработки и мониторинга задания преобразования XML

Используя варианты постобработки для задания преобразования XML, укажите, что происходит после завершения обработки.

Чтобы настроить постобработку и мониторинг задания преобразования XML, выполните указанные ниже действия.
  1. На панели процедур слева выберите процедуру.
    Страницы конфигурации для выбранной процедуры отображаются справа.
  2. Откройте вкладку Обработчик.
  3. В таблице Задания преобразования XML добавьте или отредактируйте задание преобразования XML.
  4. Нажмите страницу Постобработка, чтобы отобразить варианты обработки для успешной обработки (без системных ошибок) и неудачной обработки (одна или несколько системных ошибок). Следующие действия относятся к обоим разделам: Когда нет системных ошибок и Когда есть системные ошибки.
  5. В полях Обработчик пакетов и Задание обработчика пакетов укажите, какой этап обработки (если он выполняется) наступает после завершения задания преобразования XML. Можно выбрать один из следующих вариантов: Нет, Обработчик фиксации, Обработчик распознавания, Преобразование в TIFF, Преобразования в PDF, Обработчик поиска активов или Обработчик преобразования XML.
  6. В поле адреса электронной почты можно ввести адрес, на который отправляется сообщение электронной почты после успешного или неудачного завершения обработки. При настройке и тестировании задания преобразования XML можно настроить получение по электронной почте уведомлений о системных ошибках с последующим автоматическим уведомлением администратора об ошибках обработки.
  7. В остальных полях укажите способ изменения обработанных пакетов.

    • Переименуйте пакеты, добавив префикс. Например, пакеты, которые не удалось обработать, переименуйте, указав префикс ERR, для последующего наблюдения.

    • Измените статус или приоритет пакета. Например, можно изменить статус пакетов с системными ошибками, а затем создать профиль клиента с фильтрацией пакетов, настроенной на этот статус, чтобы позволить квалифицированным пользователям вручную редактировать и завершать обработку пакетов, в которых обнаружены ошибки.

  8. Нажмите Отправить, чтобы сохранить задание.

Настройка потока пакетов для задания преобразования XML

Чтобы выполнить задание преобразования XML, необходимо настроить пакеты для передачи в задание на обработку. Это можно сделать, настроив задание преобразования XML в профиле клиента в качестве действия постобработки.

Для настройки потоков пакетов можно использовать следующее:

Деактивация или удаление задания преобразования XML

Если удалить задание преобразования XML, оно больше не будет доступно для пакетов, для которых оно задано в качестве этапа постобработки. Если задание, указанное для постобработки, недоступно, для пакета отображается ошибка. Перед удалением задания можно перевести его в автономный режим, что позволит устранить непредвиденные проблемы, связанные с его удалением. Задания преобразования XML в онлайн-режиме выполняются, когда они выбраны в профиле клиента или на странице постобработки задания обработчика. Можно временно остановить задание (перевести его в автономный режим) или изменить деактивированное задание для повторного выполнения.

Для деактивации или удаления задания преобразования XML выполните указанные ниже действия.
  1. На панели процедур слева выберите процедуру.
    Страницы конфигурации для выбранной процедуры отображаются справа.
  2. Откройте вкладку Обработка.
  3. Чтобы деактивировать задание, выберите его в таблице Задание преобразования XML и нажмите Деактивация или активация задания преобразования XML.

    Задание преобразования XML также можно деактивировать или активировать, установив или сняв флажок Онлайн на странице "Выбор документа".

  4. Выберите деактивированные задания в таблице Задания преобразования XML и нажмите Удаление задания преобразования XML.
  5. При появлении запроса нажмите Да, чтобы подтвердить удаление этого задания.