Настройка Jira

Создание учетной записи для интеграции

В Jira создайте служебную учетную запись, от имени которой R-Vision VM будет выполнять запросы к API Jira и Jira Assets. Для этого:

  1. Откройте административный интерфейс Jira.

  2. Перейдите в раздел управления пользователями.

  3. Нажмите на кнопку создания пользователя. Отобразится форма создания учетной записи.

  4. Укажите следующие параметры учетной записи:

    • Отображаемое имя — произвольное, например: R-Vision EVO Integration.

    • Имя входа — технический логин пользователя.

      Сохраните имя входа служебной учетной записи. Оно понадобится при добавлении интеграции в R-Vision VM.

    • Адрес электронной почты — служебный адрес электронной почты, если он обязателен для вашей инсталляции Jira.

    • Пароль — произвольный, соответствующий парольной политике вашей инсталляции Jira.

      Интеграция с Jira в текущей версии использует аутентификацию по логину и паролю. Сохраните пароль служебной учетной записи — он понадобится при добавлении интеграции в R-Vision VM.

  5. Нажмите на кнопку создания пользователя. Новая учетная запись отобразится в списке пользователей.

Назначение прав для служебной учетной записи

Назначьте служебной учетной записи права, необходимые для чтения задач Jira, активов Jira Assets и связей между ними. Для этого:

  1. Откройте созданную служебную учетную запись в административном интерфейсе Jira.

  2. Добавьте пользователя в группы или роли, имеющие доступ к проектам Jira, из которых должны загружаться задачи.

  3. Убедитесь, что учетная запись имеет доступ на чтение к активам Jira Assets, которые должны загружаться в R-Vision VM.

  4. Убедитесь, что учетная запись имеет доступ к пользовательским полям задач и атрибутам активов Assets, которые будут использоваться в маппинге полей.

    Для корректной работы интеграции служебная учетная запись должна иметь права на просмотр задач Jira, активов Jira Assets и выполнение API-запросов. Этого набора прав достаточно для работы интеграций с Jira Assets и Jira Issues.

Подготовка данных для выборки через API

Подготовьте в Jira данные, которые будут использоваться для выборки задач и активов Jira при настройке интеграции. Для этого:

  1. Определите перечень проектов Jira, задачи из которых должны быть загружены в R-Vision VM.

  2. Подготовьте JQL-выражение для выборки задач Jira.

    Примеры JQL-выражений:

    • Выбор всех открытых задач в проекте DEMO:

      project = DEMO AND resolution = "Unresolved"

    • Выбор задач в проекте DEMO, имеющих тип Task и высокий или критический приоритет:

      project = DEMO AND type = Task AND priority IN (Must, Critical)
      Сохраните JQL-выражение. Оно понадобится при добавлении интеграции в R-Vision VM для настройки выборки задач Jira.

  3. Определите перечень схем, типов активов или иных сущностей Jira Assets, данные из которых должны быть загружены в R-Vision VM.

  4. Подготовьте IQL-выражение для выборки активов Jira Assets.

    Примеры IQL-выражений:

    • Выбор всех активов (объектов) типа "Сервер":

      objectType = "Server"

    • Выбор активных серверов, относящихся к сервису CRM:

      objectType = "Server" AND Status = "Active" AND "Business Service" = "CRM"
      Сохраните IQL-выражение. Оно понадобится при добавлении интеграции в R-Vision VM для настройки выборки активов Jira Assets.

  5. Убедитесь, что JQL- и IQL-выражения возвращают только те данные, которые должны быть доступны интеграции.

    Использование избыточно широких JQL- и IQL-выражений может привести к загрузке лишних задач и активов в R-Vision VM.

Подготовка данных для маппинга полей

Подготовьте идентификаторы полей и атрибутов, которые будут использоваться для маппинга данных из Jira в R-Vision VM. Для этого:

  1. Определите, какие поля задач и активов Jira должны передаваться в R-Vision VM.

  2. Для каждого используемого поля сохраните его идентификатор или имя, которое используется API Jira.

    Для атрибутов активов Jira Assets могут использоваться значения objectTypeAttributeId и objectTypeAttributeName. Сохраните эти значения для всех атрибутов, которые должны участвовать в маппинге.

  3. Убедитесь, что служебная учетная запись имеет доступ ко всем полям и атрибутам, выбранным для маппинга.

    Для интеграций с Jira Assets и Jira Issues не определен фиксированный перечень обязательных полей и атрибутов, которые всегда должны передаваться в R-Vision VM. Набор используемых полей и атрибутов определяется конкретной моделью данных и правилами нормализации в вашей инсталляции.

  4. Создайте одно или несколько правил нормализации для обработки выбранных полей и атрибутов, используя инструкцию в разделе Настройка правил нормализации для интеграций.

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь