Бипиум позволяет импортировать данные из вашей системы Atlassian Jira. Импортировать возможно следующие сущности:
- Доски
- Задачи
- Подзадачи
Импорт производится с автоматическим созданием структуры, напоминающим решение Jira. Все импортируемые сущности так же автоматически создаются в Бипиуме.
Как это будет работать у вас
Создается запись в каталоге «Импорт из Jira» с указанием названия переносимой системы. После создания записи запускается процесс импортирования: создаются новые каталоги и заполняются данными из Jira. Отслеживать процесс импорта можно прямо из записи:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de3a9a68a4085a54a1_OvTXwLt5QS7sZz3bFyWhVK7g4BKOSVkEFGwFC56pi8HEbxMEWbvpy-Qa_SZBIUmSGygIyAnLeqvdYBz0779wAqwSA7HAW_OWGW2_sZFR0-i3aNZkBTLKUYrFC3-PKptZVzmqFIv9kHfbeOsdwGjdz5xVTtVqzw1UCjq6t_5rtwFk2cruZrhXlPt80-zzkw.png)
После окончания процесса импорта все данные из Jira будут перенесены в Бипиум. Перенесенные сущности выглядят следующим образом:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6dee580703305ab8f7b_TQp4AxLx3IFwBQ7Sj-dnUIDMVPycRUuOAtVdR3SqzRDtTDQAUtEU8yDOihLGtm1MBIg0T3hSzZRYGYVidUkwLdYdRJqYoH9hRa19BU1UtBb1fBT1s4U1cXUWjKNkOu5FMkS8R_2svi8ylXG3nfwn88ESiSy7YWz0uedqytW5OzDEHlGKxo83K80Dfd7p7g.png)
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de18b01b088afc3471_62m-BagoFmGb6raQODApiN4wHHJ4zFSKB9ebcvJRaf8WJu6KApudzRCI7u5YHA9Mnz5QZgs4duE1zn3afkkpbjnWa1bi24xjOTg5k1xys6aXTJBuDnuNBUcIsVQK_QmE-B65cCz01b6JqHjGmKLZDnixmS_Y09CTqJD99LX_opmnDl6jy8EGIlk8XiPxVw.png)
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de8774f6db785239ee_RVnF1fyX-aKCRZSscn_5VEA5olMobUobf7EwalAzq7_oRs0711w9-LPEkmF5d7H-HoiKc1-WXG7-G_ThWnqv7AOKvKwnPlZRJHa_n7SKFP0nhyxipzH7J7V7R9hsrjqHgZ9IoL6s6E7GaSMKZIGEcHC_jCs-FVoFGoUfVQwDKWJPpywWTofMLDyRAqhe0Q.png)
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de8df82b65cbd9e095_3ZPmefzo1WrjVzjtQrgzFtPKNkJeq8_mRnYhdytlz2H1S39nnczmHxnei2AKmvo_tqcfvhfc_baW1oR4KqK-hKr8p3X4IKjS2Eig5d8LLDPUvzJZ3gPj4yxLKYTm9gcB81CIv8lNcDQaIeFqNk9ITmg-wRWglOCslvTpjFYJR1vmebfIsXHUYlCjrpuiGw.png)
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6dea548c0b68707f64c_uCaSs2QQttpIErZVTzXTA5idZ9P9fZ5vXE1k5aGS_kbr4_OdsWkd3dVs4B8nsR9sq9U23ZCQVloghcRSKhhpBXDk0zN_7YhcphjFpzIMK7vsB8lHN_rFnBIUjzmvlhlR9bBi4QMFOKZR18_Fq-bcZjiPL2ubv5BeqrlVKOx7yyLJkga6jFBCBc3uyzXbdA.png)
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de5fde9472128d5e36_K3NRKupjpLTQvNoBcJR8Ma6_k75mPb-giKJDE-pn4Sl4owNmGCV8pJmQqxgWMF0mTNS7CQlbTgxwAyEaYatC0igjGc43JpCSIROyzjYPZe3ym2Q6_e2aWIj95OD7cl5BfsvvncunV3RIbAPAhzLPuBKLOFmqPK-feWBcZUAfw_smXm4Z8ErG54f0Vy6VzA.png)
Для удобства и большей схожести с Jira вы можете использовать режим отображения каталога в виде плитки. Например, так выглядят перенесенные в Бипиум задачи в плиточном режиме с разбиением по статусам и приоритетам:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de629df34083562bf8_ikA1Q_0DJaB-tt5-ICj0z_I5X-RGljyjs7bNg-NiBiIRRi0Bwew9TFLapY7GnmtAMApsdfXUQks7evr10bvz1GYEDb5vlDMUW6CjUJcAmElaUBtd1FT9h2Mz_5jy2pSynh4xpll_zzLIWuHwQTaZOZesGOZMMrJmWzH81Jyl4KYzGoypem7XGu3SV74Svw.png)
Принцип работы
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6dffe81aa79ec2292e3_NMslOkRxjh1tjsPfnJlScNx03SzX8GPKafnFJkXAjSnt1d7ZFU5kyQ8isxAenAAeXvNf8F74xlwduzRPhg45JJ12wk6-H_sKpKzF6zeVUG5hEHfpQ_1A6-oNFSTwDUT4Lgid3P3c1Z1RIUaBgIzieLEoQ6t9WM18-4I_Fc6LrXDIEae3k4IzfIAwCiDojQ.jpeg)
При создании записи в каталоге «Импорт из Jira» запускается сценарий создания каталогов в Бипиуме. Этот сценарий создает каталоги «Доски (JIRA)», «Задачи (JIRA)» и «Подзадачи (JIRA)». Далее запускается сценарий переноса данных, который переносит все одноименные сущности (доски, задачи и подзадачи) в Бипиум. В перенесенных сущностях есть односторонняя связь с родителем, то есть каждая задача связана с доской, а каждая подзадача связана с задачей.
Реализация
Подготовка системы Jira
Для импорта системы Jira в Бипиум у вас должны быть права администратора в системе Jira. Если прав администратора нет, то предварительно получите их.
Для выгрузки данных в Бипиум необходимо настроить необходимые разрешения на выгрузку данных. Для этого перейдите в консоль разработчика Jira по этой ссылке и выполните инструкции, описанные ниже:
Создание приложения OAuth 2.0
Создайте новое приложения типа «OAuth 2.0 Integration» и назовите его Bpium:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6defe81aafa502292e2_fLWFaD_E2MyY2L0JY_R_NSRt_CAqOZCr6QwMgpgk7fXHD4zAVKydwy_HNTCfzq2SOHJM9sbCp3FiVXwrbzo4RCQQAZT3rnCe2X1fhW_ivyZ9HDstynhSVFv5S6UzkzlLy49kbxp48AQ2Uw1oSmAtjINMtOHIuFeLc4K97i7ruUdwg4aV5KHLoQFHtfd2kA.png)
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df629df3763e562bf9_H7tD1HIRIMjvAVxHRq3VTvIj5M-3Jan53nNJu029uionmT6RlKgcspROF3ynFYaZriiATUuuYw573Eb89zl1NhdP7wZhkSXYkOWFZE8igOlneLk03GASgcb_YQ4QjOLOHj48LAD6KRlL2sVa_Az4k5jB-ejxIDxwqvBp2vyO73WTlmgLWBfjKVxhHXRhoQ.png)
После создания приложения перейдите на вкладку «Permissions»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df794799cdb8d06e83_2thKzFRWmiJrAcmRVgh9C0MyCSWDtAdv1f0BuptAs8a66e_5gUuldALhJ_FKOYq4wNHfwprH81ygvQqM-1asAYKTY7FLVGknaWqcw30K3h1ygBwwEd9PDpfT-Fuu9Z0OfEOSwE1rDHXYAUGZTtxK4SsvAnLgm0QCYofhv2-2pGe49kMlUeolkDjT5YIkxA.png)
У параметра «Jira API» нажмите на кнопку «Add», затем нажмите на кнопку «Configure»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df629df33b67562c03_kv71USc-smcy9ZW8tjM3HOwV4tl2nLgDBjmJHGDSOVyVlL9c-xm6hTdOn_07GdXw2GT_f0-Oqiogw8UHsKMBmfDIy-TeAfPf2ND-bfx6ROLYnIkZ6P3LFG_vgAqNa3Lmfs3Dx7gidZHA6WWZdyrwVfucwjd4LWplq2PfXePYqxDuohQjKVkNxPxqfZYlSQ.png)
Перейдите на вкладку «Granular Scopes» и нажмите на кнопку «Edit Scopes»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df8df82b9ef5d9e09f_ldcs7cB2I2ze4Vp5_K7Fy4ODpUaq0frqThj6iXe4ZdjS8DJv7mZ8xH90vKKeimN4zliB-jw9KL1Wep1ox02SPj8bJbxYSbUViPtQ7TKa5QpFkrwLxRavG4w12HiUeM95s4XAhpLvZSjixHNeLYSH97g8BBKqkehFrdHhKec-z7izzWzpO0alsQybiaLrrw.png)
Добавьте все следующие разрешения:
- read:application-role:jira
- read:avatar:jira
- read:group:jira
- read:issue:jira
- read:issue-meta:jira
- read:attachment:jira
- read:field-configuration:jira
- read:issue-details:jira
- read:issue-security-level:jira
- read:issue.changelog:jira
- read:issue.vote:jira
- read:user:jira
- read:status:jira
- read:board-scope:jira-software
- read:sprint:jira-software
Перейдите на вкладку «Classic Scopes» и добавьте разрешение вышеоописанным способом:
- read:servicedesk-request
Получение ссылки на генерацию токена авторизации
Перейдите на вкладку «Authorization» и нажмите на кнопку «Add»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df6a0f542c9c15dd01_nn7GQTSPyKb4HpQRlUDsAVaTABQjPrPdxAWUr13os7xIa-unmw7_MSGXdv07-xQYGb4KAXWtl3euOJDRe5Senlxv0RxJoD8cuG0CX6qKcE45TDFdIwt1DnvXEI4PttStOKFttrsI1dMlyL1rQhClT_xTD-SD5DQSQttpB6DO7C8KV7prbsKUCI_IdWfWZw.png)
В поле «Callback URL» введите адрес по следующему шаблону:
https://ваш_домен.bpium.ru/api.webrequest/jira_token (ЭТО В КОД)
Например:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df3a9a681db95a54a8_QPSbcVnZ8-dmA4PPTslNv6PywG_uv0a4O7LX3F3lprMn-DcCb5qXgNxjxj_CLVGd_9v04mlmCcug3Q2Y0hpyP80GDfJIW7otIXawEWUvrGgCWNmxlxq4XGVq5BvsYJeIefeqqtytNpin7ZIZjcyvsnAsbLsXRDGKgxHTrAJvQdQIxHX8kAigpJIYAqC__w.png)
Нажмите на кнопку «Save changes».
После сохранения должна появиться ссылка в поле «Granular Jira API authorization URL». Если появятся ссылки в других полях – игнорируйте их, нужна ссылка именно в поле «Granular Jira API authorization URL». Скопируйте эту ссылку и сохраните, она пригодится в дальнейшем:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df5fde94cfcf8d5e66_ndKSq06QkD7k66EjaESqR1snPyy1I_-uMzLzm-Za8k2Ls7yT0t5PtYiMv14h70n2f10oZnlk5hmlG9Kqcba1R-b7SujTXO1tRYnPFcSbu8Lpy7eoVIFZ0TH1kZmFfHLp8RfBBF_RefpL9CUfhXPiy0rlc0XBrxE94-jY3VOCuc-fyvpT_l_9i_lb5Bfmeg.png)
Создание структуры для импорта
Каталог «Импорт из JIRA»
Создайте каталог «Импорт из JIRA». Это основной каталог для реализации импорта. Структура каталог выглядит следующим образом:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6dfb84b241faddbf894_v2w_ZbO3ozkV11pVWMRp50DFy5b1X7mqW-SIWpARUcxdUhFBO7zoA7Nphl0dq5x2x1NhTw1hF2mJ6-eyk704idtB3F3OkJRo48QSONA8mdCVGJM7isteW8ApJQpEHCe5z_iCsGXzh9U0msSAlb5BSVbm6p9KG5f5nzgSAo6jpTbKcaZCXMwJg65WGe0_5w.png)
- Входный данные (секция)
- Наименование (текст)
Описание: Хранит наименование вашей системы Jira.
Настройки: Текст, Обязательное поле.
- Кнопка запуска (статус)
Описание: Кнопка для запуска процесса импортирования.
Значения: Добавьте единственное значение «[ ЗАПУСТИТЬ ИМПОРТ ]»
- Выполнение (секция)
- Время запуска (дата)
Описание: Дата и время запуска процесса импортирования.
Настройки: Со временем, Редактируемое только через API.
- Статус (статус)
Описание: Этап, на котором находится импорт.
Значения: «Создание структуры», «Структура создана», «Подключение выполнено», «Перенос досок», «Завершено», «Ошибка».
Настройки: Редактируемое только через API.
- Время завершения (дата)
Описание: Дата и время завершения процесса импортирования.
Настройки: Со временем, Редактируемое только через API.
- Лог (Текст)
Описание: Хранит логи процесса импортирования.
Настройки: Многострочный текст, Редактируемое только через API.
- Служебная информация (секция)
- Создано (Дата)
Описание: Дата создания записи
Настройки: Со временем, По умолчанию: текущая дата, Редактируемое только через API.
- Создал (Сотрудник)
Описание: Сотрудник, создавший запись
Настройки: По умолчанию: текущий сотрудник, Редактируемое только через API
Каталог «Jira API»
Создайте каталог «Jira API». Этот каталог – служебный и хранит ключ (токен) для авторизации к система Jira. Авторизация необходима для переноса данных.
Структура каталога выглядит следующим образом:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df10990d5341fcbbbc_i5ip4KXUhUydIXR0HHM5_uLPxqspThWXFCAU9t2vANn82AqmW68y1qXrtO3ZtlON3O16VFR_cCuCJC6rQFwijjCbZ1oKtznBTQHnG35levZ13DH9jTv4Pv1SItrBwwglDwsPpktaY_pvYc-R-KF2aD7ErdWqn-H1dNfotekE-QpbMJ5ect4pdKsy_0tzhA.png)
- Тип токена (текст)
Описание: Тип OAuth 2.0 токена.
Настройки: Текст.
- Токен (текст)
Описание: OAuth 2.0 токен.
Настройки: Многострочный текст, Редактируемое только через API.
Создание автоматизаций
Актуализация токена авторизации
В каталоге «Внешние запросы» создайте новую запись и заполните ее следующим образом:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6dfccd80e396f0aeada_f3f4bMbTgp6dtNee6GK5gdADdB3o7_1dS5dDvgLEKRbKsrWcz5oFRRZ5oml_lVHZeA63k6MUPS4DsrJlhOBgyzCrZT9BvsmYAcYT8N3xbG13XTGAej9yruVI6VmFuA8ZLZ38dYFB6F5E1AF_k3QFUroNil88uLN8GnZfinztSzN5Yu1BPGQFjEjoubSUTA.png)
Обратите внимание, что наименование в поле «URL идентификатор» должно быть именно «jira_token».
В качестве сценария загрузите следующий файл.
В сценарии отредактируйте компонент fields, согласно его описанию:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6df10990d0eb5fcbbbb_bTbS9uvxiE7uqUu66bdowbkWm9U-4F-Z1I-wrrCm0pWgqCyvIPcSsGiJNRXWF4sGF0mgTv6pIxVXAEBzz0GcN-KQeW-TY32XKZkyQ43_s4qnZ6210K3LGIV9X0cBx9POmoen-iPZI5_AtBeqLIpFmIOMk410ui8GDtnLsTF3fQxqCkZkuB8zbelv-5Fvww.png)
Client Id и Client Secret вы можете получить из панели разработчика в Jira во вкладке «Settings» приложения «Bpium». Эти значения так же нужно вставить в компонент «fields»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6e073801c07c1bdfa97_dMy4ed2Dety1b0BJm9Di9e-wyTRbEuEXPKEJ8ru2l356Z6GOiv6rOqZMVmjwJbD0IySKCoBlyXYOOBOMevA7Q6Q_zDq5DJPBJtLpvNC7LiOtlOWGBtYjnpbs3fS9YH9pedbrCq91pugreBRhILOtylQfFiBf45YTfHJHCtmUQS-tsf7VPzkgsdZDWqC6iQ.png)
Создание сценария импорта
В каталоге «Сценарии» создайте новую запись и назовите её «Сценарий импорта из Jira». Это основной сценарий импорта, который переносит доски, задачи и подзадачи из системы Jira в Бипиум. В качестве сценария загрузите следующий файл.
В сценарии отредактируйте компонент fields, согласно его описанию:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6e06d8290e615c9a2c0__B_eHl-_O1Gy5_sNw9VX0KfKQrZ81SZmvemyRCXoqtjYALLbICfqahllBTupMZ-i18ECgkQ-j10rjQqi6pOjfwFlwYvbKVeFPQILXE9NByTO0zSrJUic7vJR3-JR6ODrPRYcmElCvntQxz4J5D9MeFh_eEcYIAZXD126DWAahD7RLk61TVfrg94WdVsRqw.png)
Создание сценария настройки структуры системы
В каталоге «Сценарии» создайте новую запись и назовите её «Сценарий создания структуры для импорта». Это сценарий, создающий в Бипиуме необходимую структуру данных для импортирования. В качестве сценария загрузите следующий файл.
В сценарии отредактируйте компонент fields, согласно его описанию:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6e018b01beaa1fc3474_5cB8cemNY88Y2lX9jKvjN5nOlgYQD6FnbSqY7xTRF80FhcGVGQbgLVjykcBuMr2bGP-sG9oI5djl2zA5OIPkTKRCp6DhQPJXHXD2ZfZ5EWcQY4plm3VmDZbqeCINA7Xq6IFTuPBb9FFK1mGbrERJ5Cb_Gv2rjZtxLaKBf796A1flgD0swVNBW3SGUKojQQ.png)
Создание события запуска импорта
В каталоге «События» создайте новую запись и заполните ее следующим образом. В качестве отслеживаемого каталога выберите ваш каталог «Импорт из Jira»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6e07947994872d06e89_IFJS3VQlkoC8z3P3XdQMAxcB8QCdtvnTsGlswcmhgqlXStmp2H7wQqloaOACOu3ItmjGMYXLwyTMgM9jy3T-eR4lSdX0IAHGZ5mgm9Qnyh6mYSTEk5v8cu3wvzjmd2HOplmGqghqmKYClOTmTi_zLtqgxKz5s6D8_0iHe3bt6zrfIbYlkz16gycCbamWYQ.png)
Тестирование
- В каталоге «Jira API» создайте новую запись и заполните поле «Тип токена» значением «Bearer» (без кавычек).
- Далее перейдите по ссылке, которую вы получили при настройке авторизации в Jira. При переходе нужно выдать разрешение приложению «Bpium»:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6e0629df30d75562c29_cby9jwADj-hYimKkb9gGumMROVjhesLrZGshwIPyqh6D-MHhYYIEzzcKlaHmhVpjcUDBHPXgjB3w7sM3W2REOkK_mHxgnHoiKwwt-euTepo0EyhLP68nSZzPFM5arLSqfX5wclgEN65oB2DKJInFIjc0X3HOaQRhzccPrpGDsoMzL8OhIlEn-DfeJxpO9w.png)
- Если все настроено верно, то после выдачи разрешения вы должны увидеть следующее сообщение:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6e0629df3b65d562c2a_6Gv72bzzVX4NH5wvG_rThHeIFV9dTDj2eU0cdLf9D1iM7M8DKf6UC8ktZbaSHTykqHEKLow6OGg8XHUtB-szo06je8KVtnIn54q5iZLEFRQQ9WqPEW7Qf8yhyRh6JMeOyMihR_iOhc0FoU_xYJAwXKCXuc_uKhQNTWOVXuyWqg9nz15zTqZIvTyieCl2XA.png)
- Создайте запись в каталоге «Импорт из Jira», вписав название переносимой системы и нажав на кнопку старта импортирования. Если все настроено верно, то вы можете отслеживать процесс импорта из этой же записи, обновляя ее.
- После окончания процесса импорта поле «Статус» принимает значение «Завершено» и данные переносятся в Бипиум:
![](https://cdn.prod.website-files.com/63457bdec59a41792504b512/6392f6de3a9a68a4085a54a1_OvTXwLt5QS7sZz3bFyWhVK7g4BKOSVkEFGwFC56pi8HEbxMEWbvpy-Qa_SZBIUmSGygIyAnLeqvdYBz0779wAqwSA7HAW_OWGW2_sZFR0-i3aNZkBTLKUYrFC3-PKptZVzmqFIv9kHfbeOsdwGjdz5xVTtVqzw1UCjq6t_5rtwFk2cruZrhXlPt80-zzkw.png)
Процесс импорта – многоразовый. Если в вашей системе в Jira произошли изменения (были созданы новые задачи, добавлены вложения и т.д.) вы можете вновь запустить процесс импорта (создать новую запись в каталоге «Импорт из Jira») и все данные в Бипиуме обновятся до актуальных.
Если вы ищете замену Jira, то можете посмотреть наше решение на странице. Мы также можем помочь вам импортировать данные из JIRA, оставляйте заявку.