Управление интеграциями с Jira в R-Vision VM

Данный раздел содержит информацию об управлении интеграциями с Jira Assets и Jira Issues в R-Vision VM. Работа осуществляется в разделах Ресурсы → Переменные и Настройки → Интеграции → ИТ-активы веб-интерфейса R-Vision VM.

Доступные интеграции

Работа с каждой из интеграций с Jira описана в соответствующих подразделах:

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

Доступные действия над интеграцией:

Добавление интеграции

Чтобы добавить интеграцию R-Vision VM с Jira Assets, выполните следующие действия:

  1. Перейдите в раздел Ресурсы → Переменные веб-интерфейса R-Vision VM.

  2. Добавьте переменную, которая будет хранить логин пользователя Jira. Для этого:

    1. Нажмите на кнопку Создать (plus). Отобразится окно создания переменной.

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

      • ID — произвольный.

      • Название — произвольное.

      • Организация — организация, в рамках которой будет работать интеграция.

      • Описание — произвольное.

      • Секрет — установите переключатель в активное положение.

      • Тип — String.

      • Значение переменной — логин пользователя в системе Jira, заданный на этапе ее настройки.

    3. Нажмите на кнопку Создать. Переменная будет создана и добавлена в список в разделе Ресурсы → Переменные. Система отобразит соответствующее уведомление.

  3. Аналогичным образом добавьте переменную, которая будет хранить пароль пользователя Jira.

  4. Перейдите в раздел Настройки → Интеграции → ИТ-активы веб-интерфейса R-Vision VM.

  5. Нажмите на кнопку plus и выберите из выпадающего списка опцию Интеграция с Jira Assets. Отобразится окно создания интеграции.

  6. Выберите организацию, в рамках которой будет работать интеграция.

  7. Введите произвольное название интеграции.

  8. Введите URL-адрес сервера Jira.

  9. В поле Логин выберите переменную с логином пользователя Jira, добавленную на шаге 2.

  10. В поле Пароль выберите переменную с паролем пользователя Jira, добавленную на шаге 3.

  11. Для проверки валидности SSL-сертификата Jira установите переключатель Проверять SSL-сертификат.

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

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

  13. В таблицу ID схем объекта добавьте схемы объектов, из которых будут выгружены данные об активах из Jira Assets.

    Если оставить таблицу ID схем объекта пустой, будут выгружены данные об активах из всех схем.

  14. Если требуется импортировать активы вместе со связанными задачами, установите переключатель Импортировать связи в активное положение.

  15. Если требуется импортировать JSON-схему для активов, установите переключатель Импортировать JSON-схему в активное положение.

  16. Чтобы импортировать информацию обо всех активах вне зависимости от того, когда они были созданы или изменены в Jira Assets, установите переключатель Игнорировать дату последнего запуска в активное положение. Если переключатель не установлен, импортируются только данные, созданные или измененные с момента предыдущего запуска интеграции.

    Если установлен переключатель Игнорировать дату последнего запуска, время импорта информации об активах может значительно увеличиться. Выбор этой опции предполагает импорт из Jira Assets всей информации об активах, соответствующих заданному фильтру, независимо от того, когда интеграция запускалась в последний раз. Не рекомендуется использовать эту опцию в штатном режиме работы интеграции.

  17. В поле Тип источника данных оставьте значение по умолчанию.

  18. В поле Группа воркеров укажите all.

  19. В поле Размер выборки оставьте значение по умолчанию.

    Значение в этом поле определяют количество импортируемых объектов, обрабатываемых NATS за один раз. Менять значения этого поля не рекомендуется во избежание проблем с производительностью.

  20. Добавьте одно или несколько правил нормализации импортируемых данных в таблицу Правила нормализации:

    1. Если правило нормализации для импортируемой сущности не существует, создайте его согласно инструкции в разделе Настройка правил нормализации для интеграций.

    2. В таблицу Правила нормализации добавьте следующую строку:

      • Тип сущности — тип импортируемой сущности в NATS. Может быть произвольным, соответствующим бизнес-логике сущности.

      • ID схемы домена — идентификатор схемы домена, в которой определена импортируемая сущность.

      • ID сущности — идентификатор импортируемой сущности в схеме домена.

      • ID правила нормализации — идентификатор правила нормализации для сущности.

      • Зависимые типы — массив идентификаторов сущностей, для которых связь с текущей сущностью обязательна. Указывается как массив строк.

      Например, пусть требуется импортировать сущность Storage из домена storage.custom. Для этой сущности создано правило нормализации Storage.storage.custom. При этом в системе есть сущности Section и Shelf, которые обязательно должны быть связаны со Storage (секции и полки находятся на конкретном складе).

      Тогда строка правила нормализации Storage.storage.custom в таблице Правила нормализации может быть заполнена следующим образом:

      • Тип сущности — StorageType.

      • ID схемы домена — storage.custom.

      • ID сущности — Storage.

      • ID правила нормализации — Storage.storage.custom.

      • Зависимые типы — ["Section", "Shelf"].

  21. Если вы импортируете связи между сущностями, добавьте в таблицу Правила связывания по строке для каждой из связей.

    Строки заполняются следующим образом:

    • ID домена связи — идентификатор схемы домена, в которой определена импортируемая связь.

    • ID связи — идентификатор импортируемой связи в схеме домена.

    • Тип сущности — тип импортируемой сущности в NATS. Может быть произвольным, соответствующим бизнес-логике сущности.

    • ID домена связываемой сущности — идентификатор схемы домена, в котором определена связываемая сущность.

    • ID связываемой сущности — идентификатор связываемой сущности в схеме домена.

    • Тип связываемой сущности — тип связываемой сущности в NATS. Может быть произвольным, соответствующим бизнес-логике сущности.

    • Тип сущности (левая сторона связи) — тип импортируемой сущности в NATS; укажите то же значение, что и в столбце Тип сущности.

    • Тип сущности (правая сторона связи) — тип связываемой сущности в NATS; укажите то же значение, что и в столбце Тип связываемой сущности.

    Например, пусть требуется импортировать сущность Storage из домена storage.custom, связанную с сущностью Device из домена isassets.rvision.ru и с сущностью Shelf из домена storage.custom.

    Тогда в таблицу Правила связывания следует добавить две строки:

    1. Для связи с сущностью Device:

      • ID домена связи — storage.custom.

      • ID связи — Storage_to_Device.

      • Тип сущности — StorageType.

      • ID домена связываемой сущности — isassets.rvision.ru.

      • ID связываемой сущности — Device.

      • Тип связываемой сущности — DeviceType.

      • Тип сущности (левая сторона связи) — StorageType.

      • Тип сущности (правая сторона связи) — DeviceType.

    2. Для связи с сущностью Shelf:

      • ID домена связи — storage.custom.

      • ID связи — Storage_to_Shelf.

      • Тип сущности — StorageType.

      • ID домена связываемой сущности — storage.custom.

      • ID связываемой сущности — Shelf.

      • Тип связываемой сущности — ShelfType.

      • Тип сущности (левая сторона связи) — StorageType.

      • Тип сущности (правая сторона связи) — ShelfType.

  22. Чтобы настроить расписание запуска интеграции, установите переключатель Запуск по расписанию в активное положение и выполните действия ниже.

  23. Выберите часовой пояс из выпадающего списка.

  24. Выберите формат расписания, на основании которого будет запускаться интеграция. Доступные форматы:

    • Cron-выражение;

    • Расписание.

  25. Если была выбрана опция Cron-выражение, задайте cron-выражение для запуска интеграции по расписанию.

    Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.

  26. Если была выбрана опция Расписание, выполните следующие шаги:

    1. Выберите режим запуска интеграции из выпадающего списка Запускать. Доступные режимы:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

    2. Если выбран режим запуска Каждый месяц, укажите следующие параметры:

      1. Интервал между запусками в месяцах.

      2. Дни месяца, в которые будет выполняться запуск, через запятую. Например: 1, 5, 10, 15, 20, 25, 30.

    3. Если выбран режим запуска Каждую неделю, выберите из выпадающего списка день недели, в который будет запускаться интеграция.

    4. Если выбран режим запуска Каждый день, Каждый час или Каждую минуту, укажите интервал между запусками в днях, часах или минутах соответственно.

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

      Доступны интервалы в 15 минут с 00:00 до 23:59.

  27. Нажмите на кнопку Добавить. Система создаст интеграцию и отобразит уведомление об успешном создании.

Просмотр интеграции

Чтобы просмотреть настройки интеграции:

  1. Перейдите в раздел Настройки → Интеграции → ИТ-активы веб-интерфейса R-Vision VM. Система отобразит список существующих интеграций.

  2. Нажмите на строку интеграции в списке. Система отобразит в правой части экрана карточку этой интеграции с подробной информацией о ней.

В верхней части карточки отображается название интеграции. Справа от названия расположена кнопка more vertical, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранной интеграции.

Карточка интеграции содержит следующие вкладки:

  • Основное — основная информация об интеграции.

  • Расширенные параметры — дополнительные параметры интеграции: размер выборки, таблицы правил связывания и нормализации.

  • История — история изменений интеграции.

  • Конфигурация — тип источника данных и группа воркеров интеграции.

Вкладка Основное

  • Кнопка Запустить (play) позволяет запустить интеграцию вручную.

  • Организация — организация, в которой работает интеграция.

  • Название — название интеграции.

  • Статус — статус последнего запуска интеграции:

    • Успешно;

    • Ошибка;

    • В процессе;

    • Отменена.

  • Секция Параметры подключения:

    • URL — URL-адрес сервера Jira.

    • Логин — имя переменной, которая хранит логин пользователя Jira.

    • Пароль — имя переменной, которая хранит пароль пользователя Jira.

    • Проверять SSL-сертификат — поле, которое показывает, используется ли защищенное соединение с Jira.

    • IQL-запрос — запрос для фильтрации активов Jira Assets.

  • ID схем объекта — таблица идентификаторов импортируемых схем объектов.

  • Секция Параметры импорта:

    • Импортировать связи — поле, которое показывает, выполняется ли импорт связей между активами и задачами Jira.

    • Импортировать JSON-схему — поле, которое показывает, выполняется ли импорт JSON-схемы.

    • Игнорировать дату последнего запуска — поле, которое показывает, импортируются ли только данные, изменившиеся с последнего запуска интеграции, или все данные.

  • Секция Расписание:

    • Запуск по расписанию — определяет, происходят ли запуски интеграции по заданному расписанию.

    • Часовой пояс — часовой пояс для времени запуска интеграции.

    • Формат расписания — формат расписания для запуска интеграции. Доступные форматы:

      • Cron-выражение;

      • Расписание.

    • Cron-выражение — cron-выражение для запуска интеграции по расписанию.

      Данное поле отображается, только если в поле Формат расписания выбрана опция Cron-выражение.
      Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.

    • Запускать — режим запуска интеграции. Доступные значения:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

      Это и все последующие поля отображаются, только если в поле Формат расписания выбрана опция Расписание.

    • Интервал повторения — количество единиц времени между последовательными запусками интеграции.

    • Дни повторения (через запятую) — дни месяца, в которые будет выполняться запуск, через запятую. Отображается только для режима запуска Каждый месяц.

    • День недели — день недели, в который будет запускаться интеграция. Отображается только для режима запуска Каждую неделю.

    • Время запуска — время, в которое инициируется выполнение интеграции. Отображается для всех режимов запуска, кроме Каждую минуту.

      Доступны интервалы в 15 минут с 00:00 до 23:59.

Вкладка Расширенные параметры

Вкладка Расширенные параметры содержит дополнительные параметры интеграции:

  • Размер выборки — количество импортируемых объектов, обрабатываемых NATS за один раз.

  • Правила нормализации — таблица правил преобразования исходных данных об объектах в формат, который требуется для добавления информации об объектах в домен.

  • Правила связывания — таблица правил связывания экземпляров разных сущностей.

Вкладка История

Вкладка История отображает сведения о запусках интеграции, а также об изменениях ее настроек.

Вкладка Конфигурация

Вкладка Конфигурация содержит следующие поля:

  • Тип источника данных — в текущей версии интеграции всегда имеет значение integrationJiraAssets.

  • Группа воркеров — группа воркеров, на которой запускается интеграция — all.

Изменение интеграции

Вы можете изменить интеграцию следующими способами:

Удаление интеграции

Вы можете удалить интеграцию следующими способами:

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

Доступные действия над интеграцией:

Добавление интеграции

Чтобы добавить интеграцию R-Vision VM с Jira Issues, выполните следующие действия:

  1. Перейдите в раздел Ресурсы → Переменные веб-интерфейса R-Vision VM.

  2. Добавьте переменную, которая будет хранить логин пользователя Jira. Для этого:

    1. Нажмите на кнопку Создать (plus). Отобразится окно создания переменной.

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

      • ID — произвольный.

      • Название — произвольное.

      • Организация — организация, в рамках которой будет работать интеграция.

      • Описание — произвольное.

      • Секрет — установите переключатель в активное положение.

      • Тип — String.

      • Значение переменной — логин пользователя в системе Jira, заданный на этапе ее настройки.

    3. Нажмите на кнопку Создать. Переменная будет создана и добавлена в список в разделе Ресурсы → Переменные. Система отобразит соответствующее уведомление.

  3. Аналогичным образом добавьте переменную, которая будет хранить пароль пользователя Jira.

  4. Перейдите в раздел Настройки → Интеграции → ИТ-активы веб-интерфейса R-Vision VM.

  5. Нажмите на кнопку plus и выберите из выпадающего списка опцию Интеграция с Jira Issues. Отобразится окно создания интеграции.

  6. Выберите организацию, в рамках которой будет работать интеграция.

  7. Введите произвольное название интеграции.

  8. Введите URL-адрес сервера Jira.

  9. В поле Логин выберите переменную с логином пользователя Jira, добавленную на шаге 2.

  10. В поле Пароль выберите переменную с паролем пользователя Jira, добавленную на шаге 3.

  11. Для проверки валидности SSL-сертификата Jira установите переключатель Проверять SSL-сертификат.

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

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

  13. Если требуется импортировать JSON-схему для задач, установите переключатель Импортировать JSON-схему в активное положение.

  14. Чтобы импортировать информацию обо всех задачах вне зависимости от того, когда они были созданы или изменены в Jira, установите переключатель Игнорировать дату последнего запуска в активное положение. Если переключатель не установлен, импортируются только данные, созданные или измененные с момента предыдущего запуска интеграции.

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

  15. В поле Тип источника данных оставьте значение по умолчанию.

  16. В поле Группа воркеров укажите all.

  17. В поле Размер выборки оставьте значение по умолчанию.

    Значение в этом поле определяют количество импортируемых объектов, обрабатываемых NATS за один раз. Менять значения этого поля не рекомендуется во избежание проблем с производительностью.

  18. Добавьте одно или несколько правил нормализации импортируемых данных в таблицу Правила нормализации:

    1. Если правило нормализации для импортируемой сущности не существует, создайте его согласно инструкции в разделе Настройка правил нормализации для интеграций.

    2. В таблицу Правила нормализации добавьте следующую строку:

      • Тип сущности — тип импортируемой сущности в NATS. Может быть произвольным, соответствующим бизнес-логике сущности.

      • ID схемы домена — идентификатор схемы домена, в которой определена импортируемая сущность.

      • ID сущности — идентификатор импортируемой сущности в схеме домена.

      • ID правила нормализации — идентификатор правила нормализации для сущности.

      • Зависимые типы — массив идентификаторов сущностей, для которых связь с текущей сущностью обязательна. Указывается как массив строк.

      Например, пусть требуется импортировать сущность Storage из домена storage.custom. Для этой сущности создано правило нормализации Storage.storage.custom. При этом в системе есть сущности Section и Shelf, которые обязательно должны быть связаны со Storage (секции и полки находятся на конкретном складе).

      Тогда строка правила нормализации Storage.storage.custom в таблице Правила нормализации может быть заполнена следующим образом:

      • Тип сущности — StorageType.

      • ID схемы домена — storage.custom.

      • ID сущности — Storage.

      • ID правила нормализации — Storage.storage.custom.

      • Зависимые типы — ["Section", "Shelf"].

  19. Чтобы настроить расписание запуска интеграции, установите переключатель Запуск по расписанию в активное положение и выполните действия ниже.

  20. Выберите часовой пояс из выпадающего списка.

  21. Выберите формат расписания, на основании которого будет запускаться интеграция. Доступные форматы:

    • Cron-выражение;

    • Расписание.

  22. Если была выбрана опция Cron-выражение, задайте cron-выражение для запуска интеграции по расписанию.

    Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.

  23. Если была выбрана опция Расписание, выполните следующие шаги:

    1. Выберите режим запуска интеграции из выпадающего списка Запускать. Доступные режимы:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

    2. Если выбран режим запуска Каждый месяц, укажите следующие параметры:

      1. Интервал между запусками в месяцах.

      2. Дни месяца, в которые будет выполняться запуск, через запятую. Например: 1, 5, 10, 15, 20, 25, 30.

    3. Если выбран режим запуска Каждую неделю, выберите из выпадающего списка день недели, в который будет запускаться интеграция.

    4. Если выбран режим запуска Каждый день, Каждый час или Каждую минуту, укажите интервал между запусками в днях, часах или минутах соответственно.

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

      Доступны интервалы в 15 минут с 00:00 до 23:59.

  24. Нажмите на кнопку Добавить. Система создаст интеграцию и отобразит уведомление об успешном создании.

Просмотр интеграции

Чтобы просмотреть настройки интеграции:

  1. Перейдите в раздел Настройки → Интеграции → ИТ-активы веб-интерфейса R-Vision VM. Система отобразит список существующих интеграций.

  2. Нажмите на строку интеграции в списке. Система отобразит в правой части экрана карточку этой интеграции с подробной информацией о ней.

В верхней части карточки отображается название интеграции. Справа от названия расположена кнопка more vertical, при нажатии на которую открывается выпадающее меню с действиями, доступными для выбранной интеграции.

Карточка интеграции содержит следующие вкладки:

  • Основное — основная информация об интеграции.

  • Расширенные параметры — дополнительные параметры интеграции: размер выборки и таблица правил нормализации.

  • История — история изменений интеграции.

  • Конфигурация — тип источника данных и группа воркеров интеграции.

Вкладка Основное

  • Кнопка Запустить (play) позволяет запустить интеграцию вручную.

  • Организация — организация, в которой работает интеграция.

  • Название — название интеграции.

  • Статус — статус последнего запуска интеграции:

    • Успешно;

    • Ошибка;

    • В процессе;

    • Отменена.

  • Секция Параметры подключения:

    • URL — URL-адрес сервера Jira.

    • Логин — имя переменной, которая хранит логин пользователя Jira.

    • Пароль — имя переменной, которая хранит пароль пользователя Jira.

    • Проверять SSL-сертификат — поле, которое показывает, используется ли защищенное соединение с Jira.

    • JQL-запрос — запрос для фильтрации задач Jira.

  • Секция Параметры импорта:

    • Импортировать JSON-схему — поле, которое показывает, выполняется ли импорт JSON-схемы.

    • Игнорировать дату последнего запуска — поле, которое показывает, импортируются ли только данные, изменившиеся с последнего запуска интеграции, или все данные.

  • Секция Расписание:

    • Запуск по расписанию — определяет, происходят ли запуски интеграции по заданному расписанию.

    • Часовой пояс — часовой пояс для времени запуска интеграции.

    • Формат расписания — формат расписания для запуска интеграции. Доступные форматы:

      • Cron-выражение;

      • Расписание.

    • Cron-выражение — cron-выражение для запуска интеграции по расписанию.

      Данное поле отображается, только если в поле Формат расписания выбрана опция Cron-выражение.
      Указанное cron-выражение задает расписание для триггера, по которому выполняется интеграция. Вы можете ознакомиться с синтаксисом cron-выражений в разделе Работа с автоматизациями.

    • Запускать — режим запуска интеграции. Доступные значения:

      • Каждый месяц;

      • Каждую неделю;

      • Каждый день;

      • Каждый час;

      • Каждую минуту.

      Это и все последующие поля отображаются, только если в поле Формат расписания выбрана опция Расписание.

    • Интервал повторения — количество единиц времени между последовательными запусками интеграции.

    • Дни повторения (через запятую) — дни месяца, в которые будет выполняться запуск, через запятую. Отображается только для режима запуска Каждый месяц.

    • День недели — день недели, в который будет запускаться интеграция. Отображается только для режима запуска Каждую неделю.

    • Время запуска — время, в которое инициируется выполнение интеграции. Отображается для всех режимов запуска, кроме Каждую минуту.

      Доступны интервалы в 15 минут с 00:00 до 23:59.

Вкладка Расширенные параметры

Вкладка Расширенные параметры содержит дополнительные параметры интеграции:

  • Размер выборки — количество импортируемых объектов, обрабатываемых NATS за один раз.

  • Правила нормализации — таблица правил преобразования исходных данных об объектах в формат, который требуется для добавления информации об объектах в домен.

Вкладка История

Вкладка История отображает сведения о запусках интеграции, а также об изменениях ее настроек.

Вкладка Конфигурация

Вкладка Конфигурация содержит следующие поля:

  • Тип источника данных — в текущей версии интеграции всегда имеет значение integrationJiraIssues.

  • Группа воркеров — группа воркеров, на которой запускается интеграция — all.

Изменение интеграции

Вы можете изменить интеграцию следующими способами:

Удаление интеграции

Вы можете удалить интеграцию следующими способами:

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

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

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

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