Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
Yandex Tracker
  • Начало работы
    • Подключить Tracker
    • Войти в Tracker
    • Управление пользователями
    • Настроить доступ в Tracker
    • Настроить Tracker
    • Как работать в Tracker
      • Стартовая страница
      • Мои задачи
      • Как работать с задачей
      • Избранные задачи, доски, дашборды
      • Персональные настройки
    • Мигрировать в Tracker
    • Отключить платные услуги
  • Мобильное приложение Tracker
  • Практические руководства
    • Настроить Tracker для команды разработки
      • Обзор
      • Создать очередь для команды разработки
      • Структурировать задачи
      • Использовать гибкие методологии (Agile)
      • Настроить шаблоны задач
      • Подключить репозиторий
      • Автоматизировать рутинные действия
      • Интегрировать Tracker с другими системами
    • Настроить Tracker для службы поддержки
      • Обзор
      • Создать очередь для службы поддержки
      • Принимать обращения по почте и через форму
      • Настроить многоуровневую структуру поддержки
      • Отправлять письма со страницы задачи
      • Группировать обращения по темам
      • Отслеживать время обработки обращений
      • Собирать статистику по обращениям
      • Настроить интеграцию со сторонними системами
  • Концепции
    • Обзор сервиса
    • Основные понятия
    • Роли и права доступа
  • Настроить очередь
    • Обзор
    • Создать очередь
    • Шаблоны очередей
    • Просмотреть задачи очереди
    • Изменить основные параметры очереди
    • Настроить типы и статусы задач
      • Обзор
      • Настроить типы задач
      • Создать воркфлоу
      • Настроить статусы
      • Настроить переходы
      • Настроить резолюции
    • Локальные поля задач
    • Добавить команду очереди
    • Настроить доступ к очереди
    • Расширенные возможности очереди
    • Посмотреть историю изменений очереди
    • Удалить очередь
  • Работать с задачами
    • Создать задачу
      • Обзор
      • Создать задачу по почте
      • Создать задачу из формы
      • Клонировать задачу
    • Редактировать задачу
      • Обзор
      • Добавить комментарии к задаче
      • Создать чеклист
      • Изменить связи задачи
      • Прикрепить к задаче изображения и файлы
      • Форматировать текст в задаче
      • Проголосовать за задачу
      • Перенести задачу в другую очередь
      • Изменить несколько задач
    • Настроить напоминание о задаче
    • Указать затраченное время
    • Добавить поле задачи
    • Посмотреть историю изменений задачи
    • Получить доступ к задаче
    • Удалить задачу
  • Структурировать задачи
    • Обзор
    • Связи между задачами
    • Компоненты
    • Версии
  • Проекты
    • Обзор
    • Мои проекты
    • Создать проект
    • Список задач проекта
    • Диаграмма Ганта
    • Доска задач
  • Инструменты гибкой разработки
    • Обзор
    • Создать доску
    • Работать с доской
    • Изменить и удалить доску
    • Бэклог
    • Спринты
    • Эпики
    • Командная оценка задач
    • Диаграмма сгорания задач
  • Доски задач (бета)
    • Обзор
    • Создать доску
    • Работать с доской
    • Настроить доску
  • Найти задачи
    • Найти задачу по ключу или названию
    • Найти мои задачи
    • Найти задачи в очереди
    • Создать фильтр задач
    • Язык запросов
  • Уведомления и подписки
    • Обзор
    • Подписаться на уведомления
    • Получать отчет об изменениях
    • Подписать пользователей на изменения очереди
    • Настройки почтовых уведомлений
      • Обзор
      • Уведомления о ваших задачах
      • Уведомления о ваших подписках
    • Отправлять уведомления на почтовые ящики в вашем домене
  • Статистика и дашборды
    • Дашборды
      • Обзор
      • Как создать дашборд
      • Виджеты
      • Как изменить дашборд
      • Общий доступ к дашборду
      • Как сделать дашборд стартовой страницей
    • Статистика очереди
    • Диаграмма Ганта
  • Автоматизация и шаблоны
    • Обзор
    • Триггеры
      • Обзор
      • Создать триггер
      • Задать условие срабатывания триггера
      • Настроить действие триггера
      • Изменить и удалить триггер
      • Примеры
    • Автодействия
      • Обзор
      • Автоматическое обновление задач
      • Создание задач по расписанию
      • Изменить и удалить автодействие
    • Макросы
    • Шаблоны
      • Обзор
      • Создать шаблон в Yandex Forms (бета)
      • Создать шаблон
      • Изменить шаблон
      • Удалить шаблон
      • Использовать общие шаблоны
    • Переменные
    • Использовать форму как шаблон для создания задач
  • Настроить SLA для задач
    • Обзор
    • Настроить правила
    • Графики работы
  • Интеграция с другими сервисами
    • Почта
    • Yandex Forms
    • Yandex Wiki
    • Мессенджеры
      • Обзор
      • Slack
      • Telegram
    • Настроить связи с внешним приложением
      • Обзор
      • Подготовить внешнее приложение
      • Передать данные приложения команде Tracker
  • Инструменты разработчика
    • API
    • Python клиент
    • Подключить репозиторий
  • Правила тарификации
    • Тарифы
    • Настроить платежный аккаунт
    • Оплатить услуги
    • Посмотреть детализацию услуг
  • Справочник API
    • Обзор
    • Доступ к API
    • Общий формат запросов
    • Задачи
      • Получить параметры задачи
      • Редактировать задачу
      • Создать задачу
      • Перенести задачу в другую очередь
      • Узнать количество задач
      • Найти задачи
      • Освободить ресурсы просмотра прокрутки
      • Получить приоритеты
      • Получить переходы
      • Выполнить переход в статус
      • Получить историю изменений задачи
      • Связи задачи
        • Связать задачи
        • Получить связи задачи
        • Удалить связь с задачей
    • Чеклисты
      • Создать чеклист или добавить в него пункты
      • Получить параметры чеклиста
      • Редактировать чеклист
      • Удалить чеклист
      • Удалить пункт чеклиста
    • Проекты
      • Создать проект
      • Получить параметры проекта
      • Получить список всех проектов
      • Получить список очередей проекта
      • Изменить проект
      • Удалить проект
    • Комментарии
      • Добавить комментарий
      • Получить комментарии к задаче
      • Редактировать комментарий
      • Удалить комментарий
    • Макросы
      • Получить макросы очереди
      • Получить макрос
      • Создать макрос
      • Редактировать макрос
      • Удалить макрос
    • Внешние связи
      • Получить список внешних приложений
      • Получить список внешних связей задачи
      • Добавить внешнюю связь
      • Удалить внешнюю связь
    • Прикрепленные файлы
      • Получить список прикрепленных файлов
      • Скачать файл
      • Скачать миниатюру
      • Прикрепить файл
      • Загрузить временный файл
      • Удалить файл
    • Очереди
      • Создать очередь
      • Получить параметры очереди
      • Получить список очередей
      • Получить версии очереди
      • Получить обязательные поля очереди
      • Удалить очередь
      • Восстановить очередь
      • Удалить тег из очереди
      • Автоматизация
        • Автодействия
          • Создать автодействие
          • Получить параметры автодействия
        • Триггеры
          • Создать триггер
          • Получить параметры триггера
    • Доски задач
      • Получить параметры всех досок
      • Получить параметры доски
      • Создать доску
      • Редактировать доску
      • Удалить доску
      • Колонки
        • Получить параметры всех колонок
        • Получить параметры колонки
        • Создать колонку
        • Редактировать колонку
        • Удалить колонку
      • Спринты
        • Получить все спринты доски
        • Получить спринт
        • Создать спринт
    • Компоненты
      • Получить список компонентов
    • Импорт
      • Импортировать задачу
      • Импортировать файлы
      • Импортировать комментарии
      • Импортировать связи
    • Пакетные операции
      • Массовый перенос задач в другую очередь
      • Массовое редактирование задач
      • Массовое изменение статуса задач
    • Учет времени
      • Добавить запись о затраченном времени
      • Редактировать запись о затраченном времени
      • Удалить запись о затраченном времени
      • Получить записи о затраченном времени
        • Получить все записи по задаче
        • Отобрать записи по параметрам
    • Поля задачи
      • Получить глобальные поля
      • Создать поле задачи
      • Получить параметры поля задачи
      • Изменить название поля задачи
      • Изменить возможные значения поля задачи
      • Создать категорию поля задачи
      • Локальные поля
        • Создать локальное поле очереди
        • Получить локальные поля очереди
        • Получить информацию о локальном поле очереди
        • Редактировать локальное поле очереди
    • Пользователи
      • Получить информацию о текущем пользователе
      • Получить информацию о пользователях
      • Получить информацию о пользователе
    • Возможные коды ответа
  • Вопросы и ответы
    • Общие вопросы
    • Оплата
  • История изменений
    • Декабрь 2022
    • Ноябрь 2022
    • Октябрь 2022
    • Сентябрь 2022
    • Август 2022
  • Служба поддержки
  1. Интеграция с другими сервисами
  2. Настроить связи с внешним приложением
  3. Подготовить внешнее приложение

Подготовить внешнее приложение

Статья создана
Yandex Cloud
,
улучшена
Dmitry A.
  • Сетевой доступ
  • Аутентификация
  • Получение информации о связанном объекте
  • Создание связей в приложении по запросу из Tracker
  • Удаление связей в приложении по запросу из Tracker

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

Чтобы в Tracker была доступна расширенная функциональность связей с вашим приложением, например отображение подробной информации о связанных объектах или создание связей во внешнем приложении по запросу из Tracker, нужно реализовать поддержку этих возможностей в приложении.

Сетевой доступ

Ваше приложение должно быть доступно по публичному адресу через интернет.

Аутентификация

Для аутентификации запросов из Tracker к внешнему приложению можно использовать один из вариантов:

  • Без аутентификации

  • OAuth

    В заголовке передается токен пользователя, от имени которого выполняется запрос к приложению.

Получение информации о связанном объекте

Чтобы отображать в интерфейсе Tracker подробную информацию о связанном объекте, приложение должно передавать эту информацию по запросу:

  • Метод: GET

  • URL: scheme://host:port*{{remoteKey}}*

    где

    • remoteKey — ключ связанного объекта в приложении;
    • * — любая последовательность символов.

    Например: https://my-app.ru:8080/1234/info

Ожидаемый формат ответа: список параметров в формате JSON

Параметр Тип Описание
key Строка Ключ объекта. Обязательный.
summary Строка Название объекта. Обязательный.
iconUrl Строка URL иконки. Необязательный.
Используется в том случае, если для объектов в определенном статусе нужно отображать другую иконку.
status Объект Статус объекта. Необязательный.
Содержит поля:
  • name (строка) — название;
  • description (строка, необязательно) — описание.
resolution Объект Резолюция. Необязательный.
Содержит поля:
  • name (строка) — название;
  • description (строка, необязательно) — описание.
assignee Объект Исполнитель. Необязательный.
Содержит поля:
  • trackerUid(длинное целое число, необязательно) — идентификатор пользователя Tracker;
  • passportUid (длинное целое число, необязательно) — идентификатор пользователя Яндекс ID (бывшего Паспорта);
  • login (строка, необязательно) — логин.
updated Строка Дата и время обновления в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Необязательный.
deadline Строка Дедлайн в формате YYYY-MM-DDThh:mm:ss.sss±hhmm. Необязательный.

Создание связей в приложении по запросу из Tracker

Когда в Tracker создается связь с внешним объектом, Tracker может отправить в приложение запрос, чтобы создать в приложении дублирующую связь. Для этого приложение должно поддерживать создание связи по запросу:

  • Метод: POST.

  • URL: определяет разработчик приложения.

  • Тело запроса: список параметров в формате JSON

    Параметр Тип Описание
    issueKey Строка Ключ задачи в Tracker.
    entityIds Массив строк Идентификаторы объектов в приложении, связанных с задачей.

Удаление связей в приложении по запросу из Tracker

Когда в Tracker удаляется связь с внешним объектом, Tracker может отправить в приложение запрос, чтобы удалить эту связь из приложения. Для этого приложение должно поддерживать удаление связи по запросу:

  • Метод: DELETE

  • URL: scheme://host:port*{{issueKey}}*{{remoteKey}}|{{remoteKey}}*{{issueKey}}*

    где:

    • issueKey — ключ задачи в Tracker;

    • remoteKey — ключ связанного объекта в приложении;

    • * — любая последовательность символов.

    Ключ задачи и ключ объекта могут быть указаны в любом порядке.

    Например: https://my-app.ru:8080/links/?action=del&ticket=TEST-123&obj=1234

Была ли статья полезна?

Language / Region
Проект Яндекса
© 2023 ООО «Яндекс.Облако»
В этой статье:
  • Сетевой доступ
  • Аутентификация
  • Получение информации о связанном объекте
  • Создание связей в приложении по запросу из Tracker
  • Удаление связей в приложении по запросу из Tracker