News YouTrack

Состояние API для рабочих процессов в YouTrack

Read this post in other languages:
English, Français, 日本語, 한국어, Deutsch, 简体中文

Недавно мы писали, что прекращаем поддерживать устаревшие рабочие процессы в YouTrack, начиная с версии 2019.1.

Устаревшими считаются рабочие процессы, для описания которых использовался внешний редактор Workflow Editor, не поддерживаемый в YouTrack с версии 2018.3.

Мы знаем, что некоторые пользователи по-прежнему используют устаревшие рабочие процессы: согласно нашей статистике, более чем на 6% серверов YouTrack InCloud присутствует хотя бы один такой процесс. Мы решили продлить поддержку устаревших рабочих процессов на полгода, то есть она будет полностью отключена, начиная с версии 2019.3.

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

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

1. Проверьте, есть ли у вас устаревшие процессы в активном состоянии. Для этого перейдите на страницу «Рабочие процессы» вашего сервера YouTrack и просмотрите список процессов: названия устаревших процессов будут отображены в виде обычного текста — без гиперссылки:

LegacyWorkflows

2. Некоторые устаревшие процессы могли попасть к вам автоматически при установке версий YouTrack, предшествующих 2017.3. Названия таких процессов содержат префикс «jetbrains-youtrack-». Мы выполнили автоматическое обновление рабочих процессов во всех случаях, когда это было возможно. Обновления не могли быть применены лишь к тем процессам, которые были отредактированы при помощи старого Workflow Editor.

Определите, в какие процессы вы точно не вносили изменений, выделите их и нажмите кнопку «Восстановить выбранные»:

RestoreWorkflow

3. Если вы редактировали какие-либо из рабочих процессов, предоставленных по умолчанию, вам необходимо обновить соответствующие JS-процессы, содержащиеся в разделе Default Workflows документации.

К примеру, если вы используете правило, запрещающее создавать задачи без указания срока выполнения (из процесса «Срок»), для которого вы заменили текст сообщения, то вам нужно:

  • Создать рабочий процесс в нашем веб-редакторе.
  • Добавить новый модуль.
  • Скопировать правило, приведенное ниже.
  • Отредактировать текст сообщения.
  • Сохранить рабочий процесс и добавить его в нужные проекты.

DueDateDefaultWorkflow

4. Также устаревшие процессы могли попасть к вам из нашего открытого репозитория рабочих процессов. Чтобы обновить их, нужно зайти в репозиторий, найти все такие процессы и заменить устаревшие экземпляры на новые версии из репозитория:

Repository

5. Если оставшиеся устаревшие процессы не попадают под описанные выше категории, необходимо переписать их под новый API. Чтобы узнать, как это сделать, посмотрите запись вебинара и ознакомьтесь с кратким руководством.

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

Чтобы обновить устаревший рабочий процесс:

  • Экспортируйте его.
  • Откройте JetBrains YouTrack Workflow Converter.
  • Загрузите экспортированный ZIP-архив и дождитесь окончания процесса.

WorkflowConverter

Если у вас есть вопросы или вам нужна помощь в обновлении рабочих процессов, свяжитесь с нашей службой поддержки или присоединитесь к YouTrack-сообществу в Slack. Мы всегда рады помочь!

Ваша команда YouTrack
The Drive to Develop

Discover more