Подключиться
Yandex Tracker

Мигрировать в Tracker из других сервисов

Статья создана

Если вы ведете задачи и проекты с помощью какого-либо сервиса и хотите перейти на использование Yandex Tracker, вы можете перенести в Tracker данные о ваших проектах и задачах:

  • Если вы используете Jira, наши специалисты помогут перенести данные в Tracker. Для этого подготовьте данные для миграции по инструкции ниже и напишите в службу технической поддержки.

  • Если вы используете какую-либо другую систему (Asana, Wrike, YouTrack и так далее), мы поможем подобрать компанию-партнера, которая перенесет ваши данные в Tracker. Для этого оставьте заявку с помощью формы.

  • Если вы хотите выполнить миграцию своими силами, можно импортировать данные в Tracker с помощью API или загрузить список задач из таблицы Excel с помощью Python клиента.

Перенести данные из Jira

  1. Подключите Yandex Tracker.

  2. Добавьте в Tracker сотрудников вашей компании.

  3. Создайте технический аккаунт для доступа к Yandex Tracker API:

    1. Создайте новый аккаунт на Яндексе (вида login@yandex.ru).

    2. Добавьте созданный аккаунт в Tracker.

    3. Перейдите в сервис Яндекс 360 для бизнеса и дайте созданному аккаунту права администратора. Подробнее читайте в Справке Яндекс 360.

    После выполнения миграции аккаунт можно будет удалить или отозвать права администратора.

  4. Экспортируйте ваши данные из Jira.

    Как экспортировать данные

    1. В Jira выберите Settings (Настройки) > System (Система).

    2. В разделе IMPORT AND EXPORT (ИМПОРТ И ЭКСПОРТ) выберите Backup manager (Управление резервным копированием).

    3. В разделе Backup for Server (Резервная копия сервера) включите опцию Include additional files (Включить в резервную копию дополнительные файлы...) и выберите Create backup for server (Создать резервную копию сервера).

      Важно

      Даже если вы используете облачную версии Jira, создайте резервную копию для сервера (Backup for Server).

      Только если создание резервной копия для сервера недоступно, создайте резервную копию для облака (Backup for cloud).

    4. Когда резервная копия будет создана, нажмите ссылку Download backup file (Скачать резервную копию).

    Подробнее об экспорте данных читайте в документации Jira.

  5. Составьте таблицу соответствия между пользователями Jira и пользователями Tracker.

  6. Загрузите архив с экспортированным данными и таблицу соответствия пользователей на Яндекс Диск или другой подобный сервис.

    Примечание

    Если вы не используете облачные сервисы для хранения файлов и не знаете, куда загрузить данные, сообщите об этом при обращении в техническую поддержку. Сотрудники поддержки проинструктируют вас, как передать данные.

  7. Напишите в техническую поддержку запрос на миграцию из Jira в Tracker. В запросе укажите:

    • ссылки на архив с экспортированными данными и таблицу соответствия пользователей;

    • учетные данные технического аккаунта с правами администратора.

  8. Дождитесь, пока сотрудники технической поддержки сообщат о завершении миграции.

    Если для миграции потребуется дополнительная информация или действия с вашей стороны, сотрудники технической поддержки свяжутся с вами.

  9. После завершения миграции выдайте сотрудникам полный доступ в Tracker, назначьте права доступа к очередям, удалите технический аккаунт с правами администратора.

Перенести данные из Excel

Если у вас есть список задач в таблице Excel, вы можете перенести данные в Tracker с помощью Python клиента.

Таблица должна содержать столбцы, в которых будут указаны параметры задач. Такие же заголовки столбцов должны быть прописаны в скрипте, который обрабатывает файл Excel.

  1. Подключите Yandex Tracker.

  2. Добавьте в Tracker сотрудников вашей компании.

  3. Получите доступ к API.

  4. Создайте очереди, в которые вы будете импортировать задачи.

  5. Настройте очередь:

  6. При необходимости создайте доски задач и спринты.

  7. Подготовьте таблицу Excel с данными о задачах.

  8. Подготовьте Python клиент:

    1. Установите Python клиент.

    2. Инициализируйте клиент.

      from yandex_tracker_client import TrackerClient
client = TrackerClient(token='<token>', org_id='<org_id>')

      Здесь <token> — ваш OAuth-токен, а <org_id> — идентификатор организации. Чтобы узнать идентификатор организации, перейдите на страницу настроек Tracker. Идентификатор указан в поле ID организации для API.

    3. Подключите библиотеки.

      from datetime import datetime 
import pandas as pd
import numpy as np

  9. Выполните скрипт для загрузки данных из таблицы.

    Python скрипт загружает задачи из файла в заданную очередь. В скрипте полям задачи присвойте значение из столбцов таблицы.

    Рассмотрим работу со скриптом на примере импорта таблицы с заголовками Задача, Описание, Дата завершения, Исполнитель. Вы можете дополнить таблицу и скрипт другими полями.

    Как выполнить скрипт

    1. Загрузите файл с данными.

      df = pd.read_excel(r'C:\<путь к файлу>\<имя файла>.xls')

    2. Проверьте, что в скрипт подставляются заголовки столбцов таблицы.

      for i, row in df.iterrows():
   print(f"Index: {i}")
   print(f"{row['Задача']}")
   print(f"{row['Описание']}")
   print(f"{row['Дата завершения']}")
   print(f"{row['Исполнитель']}")

    3. Создайте задачи, при необходимости обновите имя автора или измените другие атрибуты задачи.

      for i, row in df.iterrows():

      try:
          end=row['Дата завершения'].strftime("%Y-%m-%d")
      except Exception as e:
          end=""
    
      issue=client.issues.create(
          queue='TEST', 
          summary=row['Задача'], 
          type={'name': 'Задача'}, 
          description=row['Описание']+"\n\nДополнительное описание :\n\nhttps://tracker.yandex.ru/",
          assignee=row['Исполнитель'], 
          end=end
 )
      issue.update(author='<логин>')
      issue.update(<ключ поля>='<значение>')

Перенести данные с помощью API

Для миграции в Tracker потребуется выгрузить данные из вашей текущей системы и конвертировать их в формат, который поддерживает Tracker. Для автоматизации переноса данных вам потребуется привлечь разработчика или компанию, которая оказывает услуги системной интеграции.

Подробнее о формате данных, который используется в Yandex Tracker API, читайте в справочнике API.

Чтобы импортировать данные:

  1. Подключите Yandex Tracker.

  2. Добавьте в Tracker сотрудников вашей компании.

  3. Получите доступ к API.

  4. Создайте очереди, в которые вы будете импортировать задачи.

  5. Настройте очередь:

  6. При необходимости создайте доски задач и спринты.

  7. Импортируйте данные в Tracker с помощью API.

Важно

Импортировать данные в Tracker может только администратор.

В этой статье: