Импорт из Trello
Документ описывает перенос доски из Trello в TeamStorm.
Исходные данные
Для переноса проекта из Jira потребуются следующие данные:
- архив со скриптами импорта;
- URL сервера TeamStorm;
- токен аутентификации пользователя TeamStorm;
- ключ существующего пространства TeamStorm, в который будет выполнен импорт;
- файл экспорта доски Trello в формате JSON.
Подготовка запуска
- Установите среду выполнения Python 3.11.
-
Установите следующие модули:
-
Распакуйте архив со скриптами миграции
- Добавьте пользователей в TeamStorm перед запуском импорта. Отображаемое имя пользователей TeamStorm должны совпадать с пользователями Trello для автоматического маппинга.
Получение токена аутентификации TeamStorm
Для аутентификации в API TeamStorm необходимо выбрать учетную запись пользователя, у которого есть системные роли Администратор Core и Пользователь TeamStorm.
- Авторизуйтесь в TeamStorm в браузере с выбранной учетной записью.
- Откройте веб-инспектор браузера.
- Откройте любой запрос TeamStorm.
-
Скопируйте из заголовка запроса Authorization токен авторизации (символы без "Bearer").
Экспорт доски в Trello
- Авторизуйтесь в Trello.
- Выполните экспорт доски Trello согласно документации. Exporting data from Trello
- Сохраните полученный JSON-файл.
Основные параметры скрипта
-
<teamstorm_url>
- URL сервера TeamStorm: -
<teamstorm_token>
- токен аутентификации пользователя TeamStorm: -
<teamstorm_space_key>
- ключ существующего пространства TeamStorm, в который будет выполнен импорт: -
<json_export_path>
- путь к JSON-файлу экспорта доски:
Дополнительные параметры скрипта
Импорт нескольких досок в одно пространство
По умолчанию при импорте доски в существующее пространство или при повторном импорте существующие настройки (созданные в пространстве типы, атрибуты, процессы) не обновляются.
Для того, чтобы обновить настройки укажите параметр:
Запуск скрипта
- Перейдите в папку со скриптами.
-
Выполните команду c необходимыми параметрами:
python3 trello_migration.py <teamstorm_url> <teamstorm_login> <teamstorm_password> <teamstorm_space_key> <json_export_path>
Пример вызова скрипта:
-
Дождитесь выполнения скрипта и проверьте импортированные данные.
Результат переноса
В результате будет выполнен перенос данных доски:
- доска в виде папки в пространстве TeamStorm;
- списки задач на доске в виде статусов в процессе;
- поля карточек в виде атрибутов;
- метки как атрибут типа "Тег";
- участники как атрибут типа "Тег";
- карточки, как задачи типа "Задача";
- чеклисты карточки как задачи типа "Чеклист";
- задачи чеклиста как задачи типа "Подзадача";
- комментарии карточек.