Изменить триггер с помощью запроса к API

Запрос позволяет изменить триггер.

Формат запросаФормат запроса

Перед выполнением запроса получите доступ к API.

Чтобы изменить триггер, используйте HTTP-запрос с методом PATCH. Параметры запроса передаются в его теле в формате JSON.

PATCH /v2/queues/<ключ_или_идентификатор_очереди>/triggers/<идентификатор_триггера>?version=<текущая_версия_триггера>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
    "name": "<имя_триггера>",
    "actions": [<параметры_действия_триггера>]
}

Примеры:

1. Изменить триггер, срабатывающий при выполнении хотя бы одного из условий.
2. Изменить триггер, срабатывающий при выполнении всех условий.
3. Изменить триггер, срабатывающий при выполнении группы условий.
4. Отключить триггер.
5. Переместить триггер в списке и активировать.

Пример 1: Изменить условия срабатывания триггера. Триггер должен срабатывать при выполнении хотя бы одного из заданных условий.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 1.
• Меняется условие срабатывания триггера: текст комментария совпадает с фразой «Need info» или «Нужна информация».
• Действие триггера: переход задачи в статус «Требуется информация».

PATCH /v2/queues/DESIGN/triggers/16?version=1
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "actions": [
      {
          "type": "Transition",
          "status": {
              "key": "needInfo"
              }
      }
  ],
  "conditions": [
       {
           "type": "Or",
           "conditions": [
               { "type": "CommentFullyMatchCondition", "word": "Need info"},
               { "type": "CommentFullyMatchCondition", "word": "Нужна информация"}
           ]
       }
   ]
}

Пример 2: Изменить условия срабатывания триггера. Триггер должен срабатывать при выполнении всех заданных условий.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 2.
• Меняется условие срабатывания триггера: текст комментария совпадает с фразой «Need info» и статус задачи равен В работе.

PATCH /v2/queues/DESIGN/triggers/16?version=2
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "actions": [
      {
          "type": "Transition",
          "status": {
              "key": "needInfo"
              }
      }
  ],
}

Пример 3: Изменить условия срабатывания и действие триггера. Триггер должен срабатывать при выполнении одной из групп условий.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 2.
• Меняется условие срабатывания триггера — триггер срабатывает, если выполняется одна из групп условий:
• • Текст комментария совпадает с фразой «Need info» и статус задачи равен В работе;
• • Текст комментария совпадает с фразой «No data» ;
• Меняется действие триггера: переход задачи в статус «Требуется информация».

PATCH /v2/queues/DESIGN/triggers/16?version=2
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "actions": [
      {
          "type": "Transition",
          "status": {
              "key": "needInfo"
              }
      }
  ],
  "conditions": [
      {
          "conditions": [
              {
                  "conditions": [
                      {
                          "ignoreCase": false,
                          "noMatchBefore": false,
                          "removeMarkup": false,
                          "type": "CommentFullyMatchCondition",
                          "word": "Need info"
                      },
                      {     "type": "FieldEquals", 
                            "field":"status",
                            "value":"inProgress" 
                      }
                  ],
                  "type": "And"
              },
              {
                  "ignoreCase": false,
                  "noMatchBefore": false,
                  "removeMarkup": false,
                  "type": "CommentFullyMatchCondition",
                  "word": "No data"
              }
          ],
          "type": "Or"
      }
  ]
}

Пример 4: Отключить триггер.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 3.
• Триггер деактивируется.

PATCH /v2/queues/DESIGN/triggers/16?version=3
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "active": false,
}

Пример 5: Переместить триггер в списке и активировать.

• Используется HTTP-метод PATCH.
• Изменяется триггер для очереди DESIGN.
• ID триггера — 16, текущая версия — 4.
• Триггер переносится в позицию перед триггером с идентификатором 6 и активируется.

PATCH /v2/queues/DESIGN/triggers/16?version=4
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
{
  "before": 6,
  "active": true,
}

Формат ответаФормат ответа

{
   "id": 16,
   "self": "https://api.tracker.yandex.net/v2/queues/DESIGN/triggers/16",
   "queue": {
      "self": "https://api.tracker.yandex.net/v2/queues/DESIGN",
      "id": "26",
      "key": "DESIGN",
      "display": "Дизайн"
   },
   "name": "TriggerName",
   "order": "0.0002",
   "actions": [
      {
         "type": "Transition",
         "id": 2,
         "status": {
            "self": "https://api.tracker.yandex.net/v2/statuses/2",
            "id": "2",
            "key": "needInfo",
            "display": "Требуется информация"
         }
      }
   ],
   "conditions": [
      {
         "type": "Or",
         "conditions": [
            { 
               "type": "CommentFullyMatchCondition", 
               "word": "Need info", 
               "ignoreCase": true, 
               "removeMarkup": true, 
               "noMatchBefore": false 
            },
            { 
               "type": "CommentFullyMatchCondition", 
               "word": "Нужна информация", 
               "ignoreCase": true, 
               "removeMarkup": true, 
               "noMatchBefore": false 
            }
         ]
      }
      ],
      "version": 2,
      "active": true
   }