Импорт из Trello

Документ описывает инструкцию по переносу доски из Trello в TeamStorm.

Исходные данные

Для переноса проекта из Jira потребуются следующие данные:

архив со скриптами импорта
URL сервера TeamStorm
токен аутентификации пользователя TeamStorm
ключ существующего пространства TeamStorm, в который будет выполнен импорт
файл экспорта доски Trello в формате JSON

Подготовка запуска

Установите среду выполнения Python 3.11.

Установите следующие модули:

    pip install \
        Markdown==3.4.4
        requests==2.31.0
        jira2markdown==0.3.4
        dataclasses-json==0.5.7
        future==0.18.2
        pytz==2023.3
        jsonpickle==3.0.2

Распакуйте архив со скриптами миграции
Добавьте пользователей в TeamStorm перед запуском импорта. Отображаемое имя пользователей TeamStorm должны совпадать с пользователями Trello для автоматического маппинга.

Получение токена аутентификации TeamStorm

Для аутентификации в API TeamStorm необходимо выбрать учетную запись пользователя, у которого есть системные роли "Администратор Core" и "Пользователь TeamStorm".

Авторизуйтесь в TeamStorm в браузере с выбранной учетной записью.
Откройте веб-инспектор браузера.
Откройте любой запрос TeamStorm.
Скопируйте из заголовка запроса Authorization токен авторизации (символы без "Bearer").

Экспорт доски в Trello

Авторизуйтесь в Trello
Выполните экспорт доски Trello согласно документации Exporting data from Trello
Сохраните полученный JSON-файл

Основные параметры скрипта

- URL сервера TeamStorm
```
"https:\\teamstorm.io"
```
- токен аутентификации пользователя TeamStorm
```
"EzLCJzaWQiOiJh...vwmAVsK0ewQ"
```
- ключ существующего пространства TeamStorm, в который будет выполнен импорт
```
"DEV"
```
- путь к JSON-файлу экспорта доски
```
"../../export.json"
```

Дополнительные параметры скрипта

Импорт нескольких досок в одно пространство

По умолчанию при импорте доски в существующее пространство или при повторном импорте существующие настройки (созданные в пространстве типы, атрибуты, процессы) не обновляются. Для того, чтобы обновить настройки укажите параметр:

--update_settings

Запуск скрипта

Перейдите в папку со скриптами

Выполните команду c необходимыми параметрами

python3 trello_migration.py <teamstorm_url> <teamstorm_token> <teamstorm_space_key> <json_export_path>

Пример вызова скрипта:

python3 trello_migration.py "http://teamstorm.ru"
"EzLCJzaWQiOiJh...vwmAVsK0ewQ"
"TEMP"
"../../export.json"

Дождитесь выполнения скрипта и проверьте импортированные данные

Результат переноса

В результате будет выполнен перенос данных доски:

Доска в виде папки в пространстве TeamStorm
Списки задач на доске в виде статусов в процессе
Поля карточек в виде атрибутов
Метки как атрибут типа "Тег"
Участники как атрибут типа "Тег"
Карточки, как задачи типа "Задача"
Чеклисты карточки как задачи типа "Чеклист"
Задачи чеклиста как задачи типа "Подзадача"
Комментарии карточек