---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
- property: og:type
content: article
- property: article:section
content: Подключить и настроить доступ
- property: og:title
content: Как перенести задачи в Трекер из других сервисов
- property: article:tag
content: Техническая инструкция
alternate:
- https://yandex.ru/support/tracker/en/import.md
- https://yandex.ru/support/tracker/ru/import.md
title: Как мигрировать в Яндекс Трекер из других сервисов
description: На этой странице можно узнать, как перенести задачи в Яндекс Трекер из других сервисов.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt
# Как перенести задачи в Трекер из других сервисов
Если до подключения Яндекс Трекера вы использовали другой сервис для управления задачами, например Jira или Asana, вы можете перенести в Трекер задачи, которые создали в прежнем сервисе. Это поможет продолжить работу над текущими задачами и сохранить историю выполненной работы.
## Этап 1. Подготовьте Трекер к переносу данных {#prepare-tracker}
Чтобы подготовиться к переносу данных, подключите Трекер, добавьте в него ваших сотрудников и настройте очереди, в которые вы будете импортировать задачи.
1. Создайте организацию Яндекс 360 для бизнеса.
Трекер — это сервис в составе Яндекс 360 для бизнеса. Для работы в Трекере вы можете использовать существующую организацию или создать новую.
Как создать организацию, читайте в [Справке Яндекс 360 для бизнеса](https://yandex.ru/support/yandex-360/business/purchase/ru/set-up/direct).
{% note tip "" %}
Чтобы добавить пользователей и подключить Трекер, вам понадобятся права администратора организации. Если вы создадите новую организацию, вы станете ее администратором.
{% endnote %}
1. Добавьте в организацию сотрудников вашей компании.
Для работы в Трекере сотрудники будут использовать аккаунты, добавленные в организацию Яндекс 360 для бизнеса. Рекомендуем добавить всех сотрудников, которые работали в прежнем сервисе управления задачами.
[Как добавить сотрудников в организацию](https://yandex.ru/support/tracker/ru/add-users.md#invite-user)
1. Подключите Трекер
В организации Яндекс 360 для бизнеса подключите тариф с Трекером.
Если вы планируете, что все сотрудники будут работать с задачами в Трекере, выберите тариф для всей организации. Если работать с задачами должны только некоторые пользователи, включите Трекер как опцию для отдельных сотрудников или подразделений.
[Как выбрать тариф с Трекером](https://yandex.ru/support/tracker/ru/pricing.md)
1. Создайте [очереди](*queue), в которые вы будете импортировать задачи.
Все задачи в Трекере должны находиться в очередях. Перед переносом данных создайте одну или несколько очередей, в которые вы будете импортировать задачи.
В каждой очереди настройте [рабочие процессы](*workflow) — типы задач, статусы и резолюции.
[Как создать очередь](https://yandex.ru/support/tracker/ru/manager/create-queue.md)
[Как настроить рабочий процесс](https://yandex.ru/support/tracker/ru/manager/workflow.md)
{% note tip "" %}
Очереди и рабочие процессы также можно создать с помощью инструмента импорта данных от команды Трекера: [Что такое импортер данных](#importer).
{% endnote %}
## Этап 2. Перенесите данные в Трекер {#transfer}
Для переноса данных рекомендуем обратиться за помощью к специалистам Яндекса или компаний-партнеров:
- Если вы используете Jira, обратитесь для переноса данных к специалистам Яндекса: [Как перенести данные из Jira](#jira).
- Если вы используете Asana, Wrike, YouTrack или подобный сервис управления задачами, обратитесь в одну из компаний-партнеров Яндекса, которая поможет внедрить Трекер и перенести в него ваши данные. Чтобы выбрать компанию, перейдите на страницу [Партнеры Яндекс 360 для бизнеса](https://360.yandex.ru/business/partners/).
- Если вы не хотите обращаться к услугам сторонних подрядчиков и в вашей компании есть технические специалисты с нужными навыками, вы можете перенести задачи в Трекер самостоятельно с помощью универсального инструмента импорта или API: [Как перенести данные самостоятельно](#diy).
### Перенести данные из Jira с помощью специалистов Яндекса {#jira}
Если вы используете Jira, специалисты Яндекса помогут перенести ваши задачи в Трекер. Для этого подготовьте данные для миграции и передайте их специалистам Яндекса.
1. Экспортируйте ваши данные из Jira.
{% cut "Как экспортировать данные" %}
1. В Jira выберите **Settings** (**Настройки**) > **System** (**Система**).
1. В разделе **IMPORT AND EXPORT** (**ИМПОРТ И ЭКСПОРТ**) выберите **Backup manager** (**Управление резервным копированием**).
1. В разделе **Backup for Server** (**Резервная копия сервера**) включите опцию **Include additional files** (**Включить в резервную копию дополнительные файлы...**) и выберите **Create backup for server** (**Создать резервную копию сервера**).
{% note warning "" %}
Даже если вы используете облачную версии Jira, создайте резервную копию для сервера (**Backup for Server**).
Только если создание резервной копии для сервера недоступно, создайте резервную копию для облака (**Backup for cloud**).
{% endnote %}
1. Когда резервная копия будет создана, нажмите ссылку **Download backup file** (**Скачать резервную копию**).
Если инструкции на этой странице будет недостаточно, чтобы выполнить экспорт данных, воспользуйтесь инструкцией в [документации Jira](https://support.atlassian.com/jira-cloud-administration/docs/export-issues/).
{% endcut %}
1. Составьте список пользователей Jira и укажите, каким пользователям вашей организации с Трекером они будут соответствовать. Например, в виде таблицы.
1. Добавьте в организацию технический аккаунт, который сотрудники Яндекса смогут использовать для доступа к Трекеру вашей организации.
Это может быть аккаунт на Яндексе (вида `login@yandex.ru`) или аккаунт на домене вашей организации. Как добавить сотрудников в организацию, читайте в [Справке Яндекс 360](https://yandex.ru/support/yandex-360/business/admin/ru/users.html).
{% note tip "" %}
Чтобы добавить сотрудника, вам понадобятся права администратора в организации Яндекс 360 для бизнеса.
{% endnote %}
1. Выдайте добавленному аккаунту права администратора в организации Яндекс 360 для бизнеса. Как это сделать, читайте в [Справке Яндекс 360](https://yandex.ru/support/yandex-360/business/admin/ru/admin.html).
1. Загрузите архив с экспортированным данными и таблицу соответствия пользователей на Яндекс Диск или другой подобный сервис.
1. Напишите в поддержку Трекера через [форму обратной связи](https://forms.yandex.ru/surveys/6767/). В форме укажите:
* тема обращения — «Мигрировать в Трекер из Jira или других сервисов»;
* ссылки на архив с экспортированными данными и таблицу соответствия пользователей;
* логин и пароль технического аккаунта с правами администратора.
1. Дождитесь, пока сотрудники технической поддержки свяжутся с вами и сообщат о завершении переноса данных. Перенос может занять несколько недель.
1. После переноса данных удалите или исключите из организации технический аккаунт с правами администратора, который вы передавали сотрудникам Яндекса.
Теперь можно приступить к работе с задачами в Трекере.
### Перенести данные самостоятельно {#diy}
Если в вашей компании есть технические специалисты, которые имеют навыки обработки данных и использования API, вы можете самостоятельно перенести задачи в Трекер.
#### Шаг 1. Экспортируйте данные из текущего сервиса управления задачами {#diy-step-1}
Способ экспорта данных зависит от того, какой сервис вы используете. Многие сервисы поддерживают экспорт данных в различные форматы, такие как JSON или XLSX.
Чтобы преобразовать экспортированные данные в формат, который подходит для импорта в Трекер, вам может потребоваться участие разработчиков из вашей компании или услуги компании-интегратора.
#### Шаг 2. Получите OAuth-токен для доступа к API Яндекс Трекера {#diy-step-2}
Чтобы импортировать данные, потребуются токен для доступа к API Яндекс Трекера, привязанный к вашему аккаунту пользователя, и идентификатор организации:
*
Чтобы узнать идентификатор организации, перейдите на страницу **Администрирование** → [**Организации**](https://tracker.yandex.ru/admin/orgs) и скопируйте значение поля **идентификатор**.
* Чтобы получить токен для вашего аккаунта, выполните инструкции из раздела [Получить доступ к API по протоколу OAuth 2.0](https://yandex.ru/support/tracker/ru/api-ref/access.md#about_OAuth).
Возможности использования API будут ограничены правами доступа, которые есть у вашего аккаунта:
- Чтобы запускать инструмент импорта данных и использовать методы API для импорта, потребуются права администратора: [О правах доступа в Трекере](https://yandex.ru/support/tracker/ru/role-model.md#roles).
- Чтобы создавать новые задачи с заданными параметрами (например, с помощью Python-клиента) потребуются права на создание задач в [очереди](*queue), куда вы будете импортировать данные: [О правах доступа в очереди](https://yandex.ru/support/tracker/ru/manager/queue-access.md).
#### Шаг 3. Импортируйте данные в Трекер {#diy-step-3}
Для самостоятельного импорта данных в Трекер можно использовать один из способов: универсальный инструмент импорта или вызов методов API Яндекс Трекера.
{% list tabs %}
- Универсальный инструмент импорта
Команда Трекера разработала инструмент, который позволяет импортировать задачи c комментариями и вложениями, [проекты](*project), портфели и [цели](*goal). Также с помощью этого импортера можно перенести в Трекер настройки [очередей](*queue), поля задач, типы задач, [статусы](*status) и [резолюции](*resolution). {#importer}
Исходные файлы импортера, инструкция по использованию и описание структуры данных доступны на GitHub: .
Если вам нужна помощь в подготовке данных для импорта, воспользуйтесь услугами специализированных компаний. Список компаний-партнеров Яндекса можно найти на странице [Партнеры Яндекс 360 для бизнеса](https://360.yandex.ru/business/partners/).
- Использование методов API
Для импорта данных вам потребуется создать скрипт или приложение, которое будет вызывать методы API. Для работы с API Яндекс Трекера можно использовать один из способов:
* Напрямую отправлять HTTP-запросы к API Яндекс Трекера
Для импорта задач в API Яндекс Трекера используется метод, описанный в разделе [Импортировать задачу](https://yandex.ru/support/tracker/ru/api-ref/import/import-ticket.md). Формат запросов описан в [справочнике API](https://yandex.ru/support/tracker/ru/api-ref/common-format.md).
В результате импорта вы можете получить задачу с произвольными [статусом](*status), датами создания, завершения и другими параметрами. Например, можно импортировать задачу, которая была завершена год назад.
* Использовать Python-клиент
Для разработчиков на языке Python доступен Python-клиент Трекера, который упрощает работу с API: [Как установить клиент](https://yandex.ru/support/tracker/ru/user/API.md#python).
Клиент содержит функции для создания и редактирования задач в Трекере — вы можете создавать задачи, заполнив их параметры данными из вашего прежнего сервиса управления задачами. [Пример использования Python-клиента](#python-script)
{% note warning "" %}
В Python-клиенте нет возможности импортировать задачи с произвольными [статусами](*status) и датой создания, все задачи будут считаться новыми и иметь начальный статус, заданный в вашей очереди.
{% endnote %}
{% endlist %}
### Пример Python-скрипта для импорта данных {#python-script}
Предположим, что данные о задачах, которые нужно перенести в Трекер, хранятся в таблице Excel. Рассмотрим пример Python-скрипта, который считывает данные из таблицы и создает в Трекере задачи с заданными параметрами.
Чтобы адаптировать пример для импорта ваших задач:
1. Создайте свою таблицу Excel с данными. Например, экспортируйте данные из вашего прежнего сервиса управления задачами в формате таблицы (если сервис это позволяет) или преобразуйте данные в формат XLSX.
{% cut "Пример таблицы" %}
Пример таблицы содержит информацию о параметрах задач: «Название», «Описание», «Дата завершения», «Исполнитель».
#|
|| Название | Описание | Исполнитель | Дата завершения ||
|| Настроить VPN | Настроить доступ к корпоративной сети | ivanov | 9.08.2025 ||
|| Проверить отчётность | Просмотреть и подтвердить данные | petrov | ||
|| Обновить версию сервиса | Обновление до версии 2.1.3 | sidorov | 15.08.2025 ||
|#
{% note tip %}
Чтобы передать имена пользователей, укажите аккаунты в вашей организации Яндекс 360 для бизнеса в формате логинов (а не почтовых адресов). Например, для пользователя с адресом `ivanov@yandex.ru` укажите `ivanov`.
{% endnote %}
{% endcut %}
1. Установите Python-клиент, как описано в разделе [Python-клиент](https://yandex.ru/support/tracker/ru/user/API.md#python).
1. Установите библиотеки pandas и openpyxl, которые потребуются для работы скрипта, если они не установлены. Для этого выполните команды:
```bash
pip install pandas
pip install openpyxl
```
1. Скопируйте пример скрипта и подставьте в него ваши данные:
{% cut "Текст скрипта" %}
Пример скрипта, который создает в Трекере задачи с параметрами, которые указаны в приведенном примере таблицы Excel:
```python
from datetime import datetime
from pandas import read_excel, to_datetime, isna
from yandex_tracker_client import TrackerClient
# Настройка клиента Яндекс.Трекера
client = TrackerClient(
token='ABC-def12GH_******',
org_id='123**'
)
# Загрузка Excel-файла с задачами
excel_file_path = 'tasks.xlsx'
task_rows = read_excel(excel_file_path)
# Обработка и импорт задач
for _, row in task_rows.iterrows():
# Считывание параметров из таблицы
summary = str(row['Название']).strip()
description = str(row['Описание']).strip()
assignee = str(row['Исполнитель']).strip()
end_date = None
if row['Дата завершения'] is not None and not isna(row['Дата завершения']):
end_date = row['Дата завершения'].strftime('%Y-%m-%d')
# Создание задачи с заданными параметрами
issue = client.issues.create(
queue='TEST',
summary=summary,
type={'name': 'Задача'},
description=f"{description}\n\n*Задача импортирована из Excel.*",
assignee=assignee,
end=end_date,
tags=['import'],
)
print(f"Создана задача: {issue.key}")
print("Импорт завершён.")
```
{% endcut %}
* В блоке настройки Python-клиента укажите ваш OAuth-токен и идентификатор организации:
```python
client = TrackerClient(
token='',
org_id='<идентификатор_организации>'
)
```
Здесь `` — ваш OAuth-токен, а `<идентификатор_организации>` — идентификатор организации.
Чтобы узнать идентификатор организации, перейдите на страницу **Администрирование** → [**Организации**](https://tracker.yandex.ru/admin/orgs) и скопируйте значение поля **идентификатор**.
* В качестве значения переменной `excel_file_path` укажите путь к вашему файлу Excel.
* В блоке считывания данных из таблицы добавьте переменные для параметров задач и укажите, из каких столбцов вашей таблицы считывать значения этих переменных.
Полный список параметров задачи можно найти на странице [https://tracker.yandex.ru/admin/fields](https://tracker.yandex.ru/admin/fields).
* В качестве параметров функции `client.issues.create` укажите имена параметров задачи в Трекере и присвойте им значения, считанные из таблицы.
В качестве значения параметра `queue` укажите [ключ очереди](*queuekey), в которую хотите импортировать задачи. Например, `TEST`.
[*goal]: Цель — это стратегия развития или желаемый итог работы команды. Прогресс цели оценивают в количественных показателях. К цели можно привязать проекты, портфели и задачи, чтобы видеть, какая работа ведется для ее достижения.
[*project]: Проект — это набор задач из разных очередей, в которых работают над общим результатом. Это может быть запуск мобильного приложения или редизайн главной страницы сайта.
Проект помогает отслеживать: сколько задач сделано, сколько осталось, укладывается ли команда в сроки.
[*queue]: Очередь — это пространство для задач, которые относятся к одному процессу, продукту, команде или отделу. Очередь помогает хранить задачи в одном месте и управлять работой по общим правилам.
[*queuekey]: Ключ очереди — это уникальный код очереди из латинских букв, например `TEST`. Ключ содержится в ссылке на очередь и ее задачи, его нужно указывать в API-запросах и в настройках автодействий. Изменить ключ после создания очереди нельзя.
[*resolution]: Резолюция — параметр задачи, который показывает, почему задачу закрыли. Например: **Решен**, **Неактуально** или **Дубликат**. Резолюции можно добавить в настройках очереди.
[*status]: Статус — это параметр задачи, который показывает, на каком этапе находится задача. Например , , .
[*workflow]: Рабочий процесс — это набор статусов задачи и правил перехода между ними. В каждой очереди можно настроить несколько рабочих процессов.