Интеграция с Jira

Интегрировать проекты с Jira могут только владельцы проектов и администраторы Apiary.
Необходимо предварительно добавить сервер Jira в Apiary.

Примечание: один проект Apiary можно синхронизировать сразу с несколькими проектами Jira. В этом случае вы сможете отправлять иши во все подключенные проекты Jira и читать комментарии из них в одной ише.

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

  1. Откройте свой проект или зайдите в Apiary в качестве администратора.

  2. В меню слева выберите Проекты > Настройки > Интеграции.

  3. Выберите Jira:

    Integration

  4. В окне Настроить Jira выберите сервер Jira, а затем нажмите Далее (Next):

    Integration settings

  5. В зависимости от настроек вашего сервера Jira заполните следующие поля:

    • соединение через веб-хуки — заполните поля Адрес (Web URL), Логин (Login), Пароль (Password) и Имя соединения с Jira (Connect name):
      Jira webhooks

    • соединение через токены — заполните поля Адрес (Web URL), Эл. почта (E-mail), Токен (Token) и Имя соединения с Jira (Connect name). О том, как сгенерировать API-токен, смотрите статью Manage API tokens.

    Jira token

    Примечание: вы можете использовать API-токен для аутентификации скрипта или любого другого процесса в облачном продукте Atlassian. Можно сгенерировать API-токен из своей учетной записи Atlassian, затем скопировать и вставить его в скрипт.

    Token from Jira

  6. Нажмите Далее (Next).

  7. В поле Проект (Project) укажите ваш проект в Jira, для которого необходимо создать соединение с Apiary.

  8. В поле Тип задач (Issue Type) выберите тип задачи, которая будет создана для иши в вашем проекте Jira.
    По желанию активируйте следующие опции:

    • Обратная синхронизация (Reverse synchronization) — выберите для синхронизации статусов ишей в Apiary со статусами задач в Jira.
    • Синхронизировать комментарии (Sync comments) — выберите для синхронизации комментариев к ишам в Apiary и Jira.

    Jira project sets

  9. Выберите, какие статусы Apiary будут соответствовать статусам задач в Jira:

    Jira statuses

    Примечание: вы можете указать пользовательские статусы для ишей проекта в Jira. Но помните, что пользовательские статусы задач в Apiary не синхронизируются со статусами задач в Hive.

  10. По желанию выберите дополнительные опции. Введенные значения будут по умолчанию добавляться в соответствующие поля задач Jira:

    Jira optional fields

  11. Нажмите Сохранить (Save), чтобы сохранить настройки.

Новое соединение с Jira будет добавлено на страницу Интеграции (Integration):

Integrated Jira server