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

Oksana Mandryka

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

State of YouTrack Workflow APIs

Mariya Davydova

Some time ago we wrote that support for legacy workflows would cease in YouTrack 2019.1.

By “legacy” workflows we mean those written in the old Workflow Editor, which was an external application discontinued in version 2018.3.

We see that some of our customers are still using these legacy workflows. According to our feature usage statistics, almost 6.5% of YouTrack InCloud instances have one or more legacy workflows enabled. We’ve decided to keep them afloat for another 6 months, meaning that these workflows will stop working as of version 2019.3.

That said, we strongly encourage you to upgrade your legacy workflows as soon as possible. Not only is the old editor unavailable (meaning that you can’t change anything in your old rules), but the new API is also way more powerful and convenient. Some new features are unsupported in the old API; for example, you can’t implement action rules there.

(more…)