PT JIRA Connector for bpm'online
Руководство пользователя
Содержание
Обзор PT JIRA Connector for bpm'online 3
Установка PT JIRA Connector 4
Установка PT JIRA Connector через интерфейс установки пакетов 4
Установка PT JIRA Connector for bpm'online через svn 5
Добавление нового хранилища 5
Установка пакета 6
Установка компонентов пакета 7
Установка PT JIRA Connector с помощью WorkSpaceConsole 8
Первоначальная настройка WorkSpaceConsole в Bpm'online 7.x 8
Установка пакетов 8
Настройка интеграции 10
Просмотр идентификаторов полей в JIRA 10
Настройка параметров подключения к Jira 12
Интеграция справочников JIRA 13
Запуск процесса из командной строки 13
Запуск процесса из боковой панели 13
Автоматический запуск интеграции 14
Настройка соответствия пользователей систем 15
Выполнение интеграции JIRA и bpm’online 16
Обзор PT JIRA Connector for bpm'online
PT JIRA Connector for bpm'online позволяет пользователям организовать совместную работу в двух системах, уменьшить трудозатраты и сэкономить время на выполнение определенных задач. Также при помощи коннектора можно рассчитать финансовые показатели проекта и маржинальность, связать проекты с продажами и управлять ресурсами в портфеле проектов.
Установка PT JIRA Connector
Установку пакетов PT JIRA Connector можно осуществить несколькими способами:
Загрузка и установка пакетов через интерфейс приложения (Установка PT JIRA Connector через интерфейс установки пакетов).Наиболее простой и предпочтительный способ установки. Установка пакетов из хранилища SVN (Установка PT JIRA Connector for bpm'online через svn). Установка с помощью WorkSpaceConsole (Установка PT JIRA Connector с помощью WorkSpaceConsole).
Используется для системы bpm'online, установленной On-Site.
Установка PT JIRA Connector через интерфейс установки пакетов
Примечание
Функциональность установки пакетов через интерфейс приложения реализована в версии bpm'online 7.10 и выше.
Перед установкой необходимо скачать архивы актуальных пакетов по адресу ftp://ftp. samarasoft. ru/_products/jira_connector/7.9/
PT. JiraConnector. Case – архив с пакетами для интеграции обращений в Jira PT. JiraConnector – архив пакетов для интеграции задач из Jira в пректы
Рисунок 1 - Пакеты PT Jira Connector на ftp
Примечание
При повторном скачивании файла пакета браузер добавляет номер копии в конец названия файла. Например, PT. JiraConnector (2).gz. Перед установкой пакета рекомендуется удалить добавленные символы и привести название к виду PT. JiraConnector. gz
Для установки пакетов перейдите в дизайнер системы и выберите [Установка пакетов]
Рисунок 2 - Установка пакетов
На странице [Установка пакетов] нажмите [Выбрать файл], укажите путь до архива с пакетом и выполните установку.
Рисунок 3 - Выбор файла установки
Примечание
Установка пакета занимает около 10 минут.
Установка PT JIRA Connector for bpm'online через svn
Добавление нового хранилища
Для добавления нового хранилища необходимо перейти в дизайнере системы в раздел [Управление конфигурацией] системы.
Чтобы открыть список доступных хранилищ, на вкладке [Действия] во вкладке [Конфигурация] выберите действие [Открыть список хранилищ].
Для добавления нового хранилища необходимо нажать на кнопку [Добавить] на панели инструментов реестра. В карточке нового хранилища требуется заполнить поля:
• [Имя] – [PTJIRAConnector];
• [Адрес хранилища] – [http://svn. ptsoft. ru/public/jira_connector/7.9/] - для bpm’online версии 7.9.0 и старше;
• [Активный] – [Да].
Рисунок 4 - Добавление хранилища
После добавления хранилища авторизация не требуется.
Установка пакета
Необходимо добавить пользовательский пакет с базовыми настройками PT JIRA Connector – PT. JiraConnector.
Для этого в контекстном меню конфигурации на вкладке [Пакеты] (Управление конфигурацией-> Конфигурация-> Пакеты) кликните правой кнопкой мыши на любой из пакетов и выберите действие [Установить пакет из хранилища], как показано на рисунке 5.
Рисунок 5 - Действие [Установить пакет из хранилища] вкладки [Пакеты]
В результате откроется карточка пакета. Выберите последовательно значения полей [Хранилище системы контроля версий], [Название пакета] и [Версия] (версия может отличаться в зависимости от сборки), как показано на рисунке 3.
Рисунок 6 - Заполнение полей пакета
При нажатии кнопки [Установить] выбранный пакет будет установлен в рабочее пространство.
Установка компонентов пакета
В реестре пакетов выберите установленный пакет и выполните следующие действия:
Перейти в [Конфигурация] на вкладку [Схемы]. В реестре выполнить действие [Структура БД] -> [Обновить для требующих обновления] (кликнуть правой кнопкой мыши в реестре и выбрать нужное действие). Перейти в [Конфигурация] на вкладку [Данные] и в реестре выполнить действие [Данные] -> [Установить для требующих установки]. Перейти на вкладку [Действия] и нажать на кнопку [Компилировать все].
Рисунок 7 - Обновление структуры БД
Установка PT JIRA Connector с помощью WorkSpaceConsole
Первоначальная настройка WorkSpaceConsole в Bpm'online 7.x
После установки bpm'online:
В папке Terrasoft. WebApp\DesktopBIN\WorkSpaceConsole запустите файл PrepareWorkSpaceConsole. x64 Если файл не выполняет никакой работы, то из папки Terrasoft. WebApp\Bin скопируйте все содержимое в папку Terrasoft. WebApp\DesktopBin\WorkspaceConsole, а после из папки X64 (X32) туда же скопируйте файл Terrasoft. Tool. WorkSpaceConsole. exe Для настройки программы в любом редакторе откройте файл Terrasoft. Tool. WorkSpaceConsole. exe. Config. Там, в раздел <Configuration><ConnectionStrings> добавьте:<add name="SamaraSoft" connectionString="Data Source=%SQLServerName%;Initial Catalog=%DBName%;Persist Security Info=True; MultipleActiveResultSets=True; user id=%SQLUser%; password=%SQLPassword%; Pooling = true; Max Pool Size = 100; Async = true" />
Далее в <Configuration><Terrasoft><DB> поменяйте значение параметра ConnectionStringName на SamaraSoftУстановка пакетов
Перед установкой необходимо скачать архивы актуальных пакетов PT Docs по адресу ftp://ftp.samarasoft.ru/_products/jira_connector/7.9/ - для версии 7.9.0 и выше
PT. JiraConnector. Case – архив с пакетами для интеграции обращений в Jira PT. JiraConnector – архив пакетов для интеграции задач из Jira в пректыДля того, чтобы выполнить перенос пользовательских пакетов в новую конфигурацию:
На стенде в командной строке Windows выполните команду:Terrasoft. Toosl. WorkSpaceConsole. exe - workspaceName=Default - operation=InstallFromRepository - sourcePath=[SourcePath] - destinationPath=[DestinationPath] - continueIfError=true - logPath=[LogPath]
Где:
- [SourcePath] – папка, в которой находится устанавливаемый пакет [DestinationPath] - папка для временных файлов [LogPath] - путь к файлу журнала ошибок
Пример.
Terrasoft. Toosl. WorkSpaceConsole. exe - workspaceName=Default - operation=InstallFromRepository - sourcePath=C:\Docs\Packages\ - destinationPath=C:\Docs\Temp - continueIfError=true - logPath=C:\Docs\Log
В конфигурации bpm’online на вкладке действия нажать Компилировать всё В пакет Custom добавить пустой клиентский модуль и сохранить его.
Настройка интеграции
Примечание
Вы можете выполнять интеграцию с любым количеством серверов JIRA.
Просмотр идентификаторов полей в JIRA
Для выполнения настройки справочника [Сервер JIRA] необходимо указать ключ проекта и идентификаторы поле [Estimate] и [Epic]. Значения данных полей может получить пользователь JIRA с правами администратора.
Значение поля [Key] проекта определяется следующим образом:
Перейдите в список проектов по команде [Projects – View All Projects].
Рисунок 8 - Переход к списку проектов в JIRA
В перечне проектов для каждой записи указан ключ проекта.
Рисунок 9 - Просмотр списка проектов в JIRA
Значение идентификатора полей [Estimate] и [Epic] не указано в JIRA явным образом и определяетcя в консоли браузера. Например, при работе в браузере Google Chrome необходимо выполнить следующие действия:
Откройте страницу задачи в JIRA.
Рисунок 10 - Страница задачи в JIRA
Наведите курсор на заголовок поля [Story Points], нажмите на него правой кнопкой мыши и выберите пункт [Inspect].
Рисунок 11 - Вызов окна консоли браузера
В консоли браузера для выбранного поля отображается идентификатор поля в JIRA.
Рисунок 12 - Идентификатор поля JIRA в консоли браузера
Аналогично выполняется просмотр идентификаторов остальных полей в JIRA.
Настройка параметров подключения к Jira
Перед началом работы необходимо выполнить настройку интеграции. Для этого требуется заполнить значения следующих системных настроек:
- [Jira server URI] – идентификатор сайта системы Jira в сети интернет (например, https://samarasoft. ) [Jira login] – логин учетной записи Jira, от имени которой будет выполняться интеграция [Jira password] – пароль учетной записи Jira, от имени которой будет выполняться интеграция
Рисунок 13 – Параметры подключения к Jira
Интеграция справочников JIRA
Перед выполнением импорта задач из JIRA необходимо передать наполнение справочников JIRA в bpm’online. Для интеграции наполнения справочников JIRA запустите бизнес-процесс [Заполнить справочники Jira].
Запуск процесса из командной строки
Чтобы запустить процесс из командной строки:
Введите команду [Запустить процесс Заполнить справочники Jira].
Рисунок 14 - Запуск бизнес-процесса из командной строки
Нажмите на кнопку выполнения команды
. Запуск процесса из боковой панели
Чтобы запустить процесс из боковой панели:
Нажмите на кнопку запуска процесса
боковой панели системы. Выберите из списка процесс [Заполнить справочники Jira]. 
Рисунок 15 - Запуск процесса из боковой панели
После выполнения интеграции заполняются следующие справочники:
- [Пользователь JIRA] – перечень пользователей JIRA, добавленных в указанных серверах JIRA. На основании данных этого справочника выполняется настройка соответствия пользователей JIRA и контактов bpm’online (см. Настройка соответствия пользователей систем); [Эпики JIRA] – перечень эпиков JIRA, добавленных в указанных серверах JIRA.
Примечание
При добавлении новых эпиков и пользователей в JIRA необходимо запускать процесс интеграции справочников для актуализации данных в bpm’online.
Автоматический запуск интеграции
Интеграция с JIRA выполняется автоматически каждые 4 часа.
Настройка соответствия пользователей систем
Для корректного отображения участников в проекте необходимо настроить соответствие пользователей JIRA и контактов bpm’online.
Добавьте записи в справочник [Пользователи JIRA], заполнив следующие колонки:
- [Контакт] – запись раздела [Контакты]; [Пользователь JIRA] – пользователь JIRA, загруженный после выполнения процесса [Интеграция справочников JIRA].
Рисунок 16 - Справочник [Пользователи JIRA]
Выполнение интеграции JIRA и bpm’online
PT JIRA Connector for bpm'online позволяет интегрировать в bpm’online перечень задач из JIRA с указанием их трудозатрат, исполнителей и текущего статуса.
Для того, чтобы передать задачи из JIRA, выполните следующие действия:
Заполните информацию о сервере JIRA (см. Настройка интеграции). Выполните интеграцию справочников JIRA (см. Интеграция справочников JIRA). Перейдите в раздел [Проекты] и откройте запись проекта. На странице редактирования проекта на вкладке [Основная информация] перейдите к группе полей [JIRA] и заполните колонки:- [Проект Jira] – проект из указанной в настройках интеграции системы JIRA; [Эпик] – эпик из указанной в настройках интеграции JIRA, соответствующий данному проекту (если при запуске интеграции будет заполнено поле [Эпик], то в систему bpm’online будут импортированы все задачи из выбранного эпика, иначе при интеграции будут импортированы все эпики из выбранного в настройках проекта); [Время последней интеграции с Jira] – дата и время последней выполненной интеграции с JIRA данного проекта. Значение данной колонки автоматически обновляется после завершения очередной интеграции.
Рисунок 17 - Указание сервиса и эпика JIRA в проекте
Выполните действие [Синхронизация с JIRA].
Рисунок 18 - Действие [Синхронизация с JIRA]
После завершения интеграции перейдите на вкладку [Структура] страницы проекта. На детали [Работы Jira] отображаются работы с указанным эпиком, полученные из JIRA. Записи на детали сгруппированы по релизам и исполнителям. Для каждой работы указан текущий статус и трудоемкость.
Рисунок 19 - Деталь [Работы Jira]
Записи детали [Работы Jira] недоступны для редактирования. После каждой интеграции содержимое детали обновляется.
Кликните на название задачи, колонка [Ключ]. Откроется страница редактирования задачи, на которой отображается лог работ:
Рисунок 20 – Страница редактирования задачи
Перейдите на вкладку [Основная информация] на деталь [Лист ресурсов]. После каждой интеграции список ресурсов проекта обновляется: добавляются записи, для которых установлен признак [Из Jira].В записях ресурсов проекта, для которых работы добавлены на деталь [Структура], признак [Из Jira] снят.
Рисунок 21 - Деталь [Лист ресурсов]
Для каждого элемента листа ресурсов после интеграции заполнены поля, используемые для расчета показателей выполнения проекта:
- [Плановые трудозатраты] – суммарные трудозатраты участника проекта по работам из JIRA, независимо от статуса; [Выполнено, Jira] – фактические трудозатраты, рассчитанные как суммарная трудоемкость по всем работам участника со статусом [Done].
В проекте обновляются следующие поля:
- [Плановые трудозатраты] – суммарные трудозатраты всех участников проекта, рассчитанные как сумма значений поля [Estimate] по всем записям [Работы Jira]; [Выполнено] – фактические трудозатраты, рассчитанные как сумма значений поля [Estimate] записям [Работы Jira] со статусом [Done].
