Документация/Работа с импортом Miro

Работа с импортом Miro

Это эксплуатационная инструкция для раздела Доски из Miro. Описание возможностей, ограничений и ответы перед началом переноса собраны на странице «Импорт из Miro».

Перед началом

Для импорта нужны:

аккаунт Астар-доски с доступным пространством;
действующий access token Miro;
доступ токена к доскам, которые требуется перенести.

Access token создаётся на стороне Miro Developer Platform. Не публикуйте токен и не отправляйте его в чатах. После окончания миграции токен можно отозвать в настройках Miro.

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

В личном кабинете откройте пункт Доски из Miro.
Вставьте access token в поле с защищённым вводом.
При необходимости оставьте включённым параметр Уведомить на email по завершении.
Нажмите Импортировать доски.

Текущая версия получает все доски, доступные указанному токену. Выбор отдельной команды или нескольких конкретных досок перед запуском пока не предусмотрен.

Ход обработки

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

Состояние	Значение
В очереди	Задание ожидает обработки
Импорт…	Сервис получает объекты и создаёт доску
Перенесена	Доска создана и доступна по ссылке Открыть
Готово	Обработка запуска завершена
Частично	Часть досок перенесена, для остальных показана причина ошибки
Ошибка	Токен, доступ к доске или обработка объекта завершились ошибкой

Доски создаются в доступном пространстве аккаунта. Для каждой перенесённой доски в истории показывается число поддержанных объектов и ссылка Открыть.

Поддерживаемые объекты

Импорт преобразует следующие типы Miro:

стикеры;
текстовые блоки;
базовые фигуры;
коннекторы;
обычные и app-карточки;
фреймы.

По возможности сохраняются положение, размеры, поворот, текст, базовое HTML-форматирование, ближайшие цвета, заливка, обводка, тип линии, размер и тип шрифта, а также выравнивание. Коннекторы переносятся вместе с наконечниками и подписями. Карточки преобразуются в прямоугольные блоки. Фреймы сохраняют размер, название и расположение вложенных поддерживаемых объектов.

Пока пропускаются:

изображения;
документы;
embed-объекты;
структура Kanban, майндмэпов и сложных таблиц, которую Miro API не возвращает полностью.

Стандартные фигуры tldraw используют фиксированную палитру и четыре градации толщины/размера, поэтому произвольные значения Miro заменяются ближайшими доступными. Для объектов из некоторых шаблонов Miro REST API может не вернуть стиль или внутреннюю структуру — такие данные невозможно восстановить только по access token.

Текущая версия переносит до 10 000 объектов Miro API на одну доску. Если Miro сообщает о большем количестве, доска не обрезается молча: в истории появится ошибка с просьбой предварительно разделить исходную доску.

Защита access token

Токен передаётся API по HTTPS. Для фоновой очереди он шифруется AES-256-GCM отдельным серверным ключом, не записывается в PostgreSQL и удаляется из BullMQ сразу после завершения или окончательной ошибки задания. Общий серверный токен Miro не используется.

Если импорт не запускается

Проверьте, что access token вставлен полностью и не был отозван.
Убедитесь, что токен видит нужные доски в Miro.
Убедитесь, что в Астар-доске существует хотя бы одно пространство.
Перезагрузите страницу и проверьте историю импортов: задание могло уже попасть в очередь.
Если отдельная доска получила статус Ошибка, прочитайте причину под её названием.
При ошибке лимита разделите доску Miro так, чтобы в каждой части было не более 10 000 объектов.

Связанные материалы

Поддержка

Телефон: +7 (351) 220-99-41
Форма обращения: astar-it.com

Астар-доска · публичная документация для пользователей и экспертизы реестра российского ПО