Интеллектуальные значения для полей
Когда мы создавали Automation for Jira, нашей основной целью было создание простого, но мощного приложения для Jira, которым мог бы пользоваться каждый. Не требуется знаний API или сценариев.
Мы ввели интеллектуальные значения , чтобы решить эту проблему и усилить правила. В подавляющем большинстве случаев использования вы можете просто выбрать нужные интеллектуальные значения из имеющихся значений.
Однако, если вы хотите вникнуть и найти правильное значение в своем экземпляре Jira, продолжайте читать.
Найдите свое интеллектуальное значение
Синтаксис следует за JSON-представлением задачи в Jira, доступ к которому можно получить с помощью REST API Jira. Во-первых, чтобы упростить себе жизнь, вы можете загрузить расширение для улучшения вашего JSON. Мы используем расширение JSONView для Chrome, которое помогает извлекать интеллектуальные значения из REST API и упрощает просмотр полей и их значений.
Используйте следующий URL-адрес, чтобы просмотреть JSON-представление вашей проблемы:
https://<yourinstanceurl>/rest/api/2/issue/<issuekey>?expand=names
Перейдите к значению поля, которое вы хотите отобразить в своем правиле, и щелкните поле. Затем скопируйте «точечную запись» в нижний колонтитул:
В этом примере выбрано поле приоритета, что означает, что интеллектуальным значением является {{issue.fields.priority.name}}, однако раздел полей не требуется, поэтому вы можете просто использовать {{issue.priority.name}} или сократите его до {{priority.name}}.
Трюк с пользовательскими полями
Иногда пользовательские поля в Jira могут быть сложными. В приведенном выше URL-адресе обратите внимание на параметр ? expand = names? Это дает следующее удобное руководство в начале вывода:
Вы можете видеть, что поле «Статус AT&T» является пользовательским, а имя поля не используется:
Из этого вы можете видеть, что вы можете ссылаться на это поле в интеллектуальном значении, используя {{customfield_11200.value}}, однако вы также можете заменить customfield_11200 на фактическое имя поля (что также упрощает чтение) {{Status AT&T.value}}.
Если сомневаетесь, попробуйте!
Настоятельно рекомендуется использовать действие «Журнал» (“Log action”), чтобы помочь вам определить и отладить интеллектуальные значения, см. «Отладка правила». Вы также можете окружить интеллектуальные значения функцией отладки, чтобы сделать то же самое. Если вы соедините это действие с ручным триггером, то его будет действительно легко протестировать. Перейдите к задаче, для которой задано значение для набора полей, и вручную активируйте правило – после этого вы можете сразу найти результаты в журнале аудита.
По материалам Automation for Jira – Server: Smart values for fields