Использование XML для создания рабочего процесса

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

После того, как рабочий процесс XML был импортирован, редактор рабочего процесса JIRA должен иметь возможность отображать большинство определений OSWorkflow, даже если он не поддерживает их создание или редактирование.

Например, условные результаты переходов рабочего процесса отображаются на вкладке «Другие» (Other) на странице «Переход к рабочему процессу» (View Workflow Transition).

Вкладка «Другие» (Other) отображается только в том случае, если в элементе перехода есть элементы, которые редактор не поддерживает напрямую.

Импорт XML-рабочего процесса в JIRA

Чтобы импортировать XML-рабочий процесс в JIRA. необходимо выполнить следующие шаги:

  1. Войдите в систему как пользователь с глобальными разрешениями системных администраторов JIRA.
  2. Выберите «Задачи» (Issues). Выберите «Рабочие процессы» (Workflows), чтобы открыть страницу «Рабочие процессы», в которой отображаются все рабочие процессы в вашей системе.
  3. Нажмите кнопку «Импортировать из XML» ( Import from XML), чтобы открыть диалоговое окно «Импорт рабочего процесса» (Import Workflow).
  4. В поле «Имя» (Name) введите имя (обычно 2-3 слова), чтобы определить новый рабочий процесс.
  5. (Необязательно) В поле «Описание» (Description) введите подробное описание нового рабочего процесса.
  6. Для параметра «Определение рабочего процесса» (Workflow Definition) вы можете выполнить одно из следующих действий:
  • Загрузите файл определения рабочего процесса XML (Upload an XML workflow definition file) - для этого выберите опцию «Предоставить полный путь к файлу XML ...» (Provide a full path to an XML file...) и в поле «Путь к файлу» (File Path) введите полный путь к файлу определения рабочего процесса XML.

 Этот путь должен быть локальным, поэтому файл определения рабочего процесса XML должен быть расположен на вашем сервере JIRA.

  • Вставьте содержимое файла определения рабочего процесса XML в JIRA (Paste the contents of an XML workflow definition file into JIRA) - для этого выберите параметр «Вставить параметр XML- описания рабочего процесса» (Paste the workflow XML definition), скопируйте содержимое файла определения рабочего процесса XML и в поле «Определение рабочего процесса» (XML) (Workflow Definition (XML)), вставьте этот скопированный контент.
  1. Нажмите кнопку «Импорт» (Import).

Копирование рабочего процесса между системами

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

Чтобы копировать рабочий процесс между системами, выполните следующие шаги: 

  1. В тестовой системе экспортируйте рабочий процесс в XML, щелкнув ссылку XML рядом с рабочим процессом в списке, показанном на странице «Просмотр рабочих процессов» (View Workflows), и сохраните вывод в файл.
  2. В производственной системе импортируйте файл через ссылку «импортировать поток из XML» (import a workflow from XML), как описано выше.

При импорте XML-рабочего процесса  в JIRA:

Определения XML-рабочего процесса  JIRA содержат ссылки на мета атрибуты JIRA. Например, идентификатор связанного состояния JIRA каждого шага рабочего процесса хранится как мета-атрибут 'jira.status.id' в определении шага. Поэтому при ручном создании рабочих процессов в XML убедитесь, что все внешние внешние объекты существуют до импорта рабочего процесса в JIRA.

При копировании рабочего процесса между системами:

Обратите внимание, что условия, валидаторы и почтовые функции могут иметь параметры, которые могут быть действительными в одной системе, а не в другой. Например, разные системы могут содержать разные наборы значений для поля «Разрешение» (Resolution). Это было бы проблемой, если функция post «Обновить   поле задачи» (Update Issue Field) была использована для установки поля «Разрешение» (Resolution) в значение, которое существует в одной системе, но не другое.

 

По материалам Atlassian JIRA Administrator's Guide: Using XML to create a workflow