Импорт из другого инстанса TeamStorm

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

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

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

• архив со скриптами импорта
• URL серверов TeamStorm - исходный и целевой
• логины и пароли пользователей TeamStorm в исходном и целевом инстансах
• ключ пространства в исходном инстансе, которое необходимо скопировать
• ключ пространства в целевом инстансе, в который будет выполнено копирование

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

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

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

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

3. Распакуйте архив со скриптами миграции

4. Добавьте пользователей в TeamStorm в целевом инстансе перед запуском импорта. E-mail или отображаемое имя пользователей TeamStorm должны совпадать для автоматического маппинга.

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

1. - URL исходного сервера TeamStorm

       "https:\\source.teamstorm.io"
   

2. - логин пользователя TeamStorm в исходном инстансе

       "ivan.ivanov"
   

3. - пароль пользователя TeamStorm в исходном инстансе

       "EzL...ewQ"
   

4. - ключ пространства TeamStorm, который необходимо скопировать

       "SOURCE"
   

5. - URL целевого сервера TeamStorm

       "https:\\target.teamstorm.io"
   

6. - логин пользователя TeamStorm в целевом инстансе

       "ivan.ivanov"
   

7. - пароль пользователя TeamStorm в целевом инстансе

       "EzL...ewQ"
   

8. - ключ пространства TeamStorm в целевом инстансе, в который необходимо скопировать

       "TARGET"
   

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

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

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

--update_settings

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

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

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

       python3 copy_space.py <teamstorm_from_url> <teamstorm_from_login> <teamstorm_from_password> <teamstorm_from_key> <teamstorm_to_url> <teamstorm_to_login> <teamstorm_to_password> <teamstorm_to_key>
   

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

       python3 copy_space.py "http://source.teamstorm.ru" \
       "ivan.ivanov" "EzL...ewQ"  \
       "SOURCE" \
       "http://target.teamstorm.ru" \
       "ivan.ivanov" "EzL...ewQ"  \
       "TARGET"
   

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

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

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

1. Настройки пространства (типы, процессы, атрибуты)
2. Структура папок
3. Задачи и их иерархия
4. Описание и атрибуты задач
5. Ответственные
6. Связи задач
7. Вложения
8. Расширения Портфель - элементы портфеля
9. Расширения Agile - бэклог и спринты (без настроек команд)