§ 9.1

Экспорт и календарь

Выгрузка в CSV, JSON и подписка на задачи в календаре (ICS).

обновлено 10 сентября 20266 мин чтения

Данные в DoneBy — ваши. Рабочее пространство можно выгрузить целиком в CSV или JSON в любой момент, а задачи со сроком — показать в своём календаре по ссылке-подписке.

Выгрузка в CSV и JSON

  1. Откройте Настройки → Данные.
  2. Выберите формат: CSV — для таблиц и отчётов, JSON — для резервной копии и переноса в свою систему.
  3. Отметьте, что выгрузить: всё пространство или отдельные списки, с выполненными задачами и архивными списками или без них.
  4. Нажмите «Выгрузить». Небольшое пространство скачается сразу. Если задач много, архив соберётся в фоне, и ссылка на него придёт на почту.

Всё пространство выгружают владелец и администраторы. Участник может выгрузить списки, в которых состоит, гость — только то, чем с ним поделились.

Что входит в выгрузку

ДанныеCSVJSON
Задачи: название, описание, срок, часовой пояс, приоритет, повтор, исполнители, статусtasks.csvtasks
Подзадачистроки в tasks.csv с parent_idотдельные задачи с parent_id
Чек-листыchecklists.csvвнутри задачи
Комментарииcomments.csvвнутри задачи
Списки и разделыlists.csv, sections.csvlists, sections
Участники и ролиmembers.csvmembers
Вложенияимя, размер, ссылкаимя, размер, ссылка
Токены API и секреты вебхуковне выгружаютсяне выгружаются

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

Формат CSV

  • Архив ZIP, по файлу на сущность. Кодировка — UTF-8 с BOM: Excel и Numbers открывают кириллицу без настройки.
  • Разделитель — запятая. Значения с запятыми, кавычками и переносами строк заключены в двойные кавычки.
  • Даты — YYYY-MM-DD, время — HH:MM, метки времени — ISO 8601 в UTC.
  • Исполнители в колонке assignees — почты участников через точку с запятой.
  • Колонки совпадают с полями объекта задачи, так что выгрузку можно сопоставить с данными из API.
tasks.csv
id,title,list,section,parent_id,due_date,due_time,timezone,priority,assignees,repeat,completed,completed_at,created_at
tsk_8Kd2Lq,Подготовить отчёт за сентябрь,Клиент: магазин чая,Отчёты,,2026-09-30,15:00,Europe/Moscow,2,oleg@example.com,,false,,2026-09-14T07:12:40Z
tsk_9Lm3Wr,Выгрузить продажи,Клиент: магазин чая,Отчёты,tsk_8Kd2Lq,2026-09-28,,Europe/Moscow,0,oleg@example.com,,true,2026-09-27T16:20:03Z,2026-09-14T07:13:02Z
tsk_2Fd9Ue,Собрать дайджест обновлений,Контент-план · октябрь,,,2026-09-25,12:00,Europe/Moscow,0,marina@example.com,FREQ=WEEKLY;BYDAY=FR,false,2026-09-18T09:14:52Z,2026-08-29T10:00:00Z

Формат JSON

Один файл workspace.json. Объекты — в том же формате, что в REST API, плюс комментарии и вложения внутри задач. Поле format_version меняется, только если структура файла меняется несовместимо.

workspace.json · сокращено
{
  "format_version": 1,
  "exported_at": "2026-09-10T06:00:00Z",
  "workspace": {
    "id": "wsp_9Dn4Tz",
    "name": "Команда продукта",
    "timezone": "Europe/Moscow"
  },
  "lists": [
    { "id": "lst_R4m2Vx", "name": "Релиз 2.4", "color": "violet" }
  ],
  "sections": [
    { "id": "sec_Wq3Hn5", "list_id": "lst_R4m2Vx", "name": "Тесты", "position": 1 }
  ],
  "members": [
    {
      "id": "usr_Ma1nL6",
      "name": "Марина Лаптева",
      "email": "marina@example.com",
      "role": "admin"
    }
  ],
  "tasks": [
    {
      "id": "tsk_5Rb1Tc",
      "title": "Выкатить релиз 2.4",
      "list_id": "lst_R4m2Vx",
      "due_date": "2026-09-17",
      "due_time": "15:00",
      "priority": 1,
      "completed": false,
      "comments": [
        {
          "id": "cmt_3Ke9",
          "author_id": "usr_Ma1nL6",
          "text": "Заметки к релизу готовы.",
          "created_at": "2026-09-09T14:22:05Z"
        }
      ],
      "attachments": [
        {
          "name": "release-notes.pdf",
          "size": 284120,
          "url": "https://doneby.app/files/att_7Lp2Qw"
        }
      ]
    }
  ]
}

Совет

Для регулярной синхронизации с вашей системой удобнее API: GET /tasks?updated_since=… отдаёт только изменения, а вебхуки сообщают о них сразу. Выгрузка хороша для резервных копий и разовых переносов.

Подписка на календарь (ICS)

Календарь на экране — расписание на неделю
Задачи со сроком — в том же календаре, что и встречи. Подписка только для чтения.

Задачи со сроком можно видеть в Яндекс Календаре, Google Календаре, Apple Календаре или Outlook — рядом со встречами и без переключения между вкладками. Календарь получает их по ссылке-подписке такого вида:

Ссылка-подписка
https://doneby.app/ics/<токен>.ics
  • Только чтение. Изменения в календаре в DoneBy не возвращаются. Двусторонняя синхронизация через CalDAV — в разработке.
  • Обновление каждые 15 минут на стороне DoneBy. Как часто календарь перечитывает подписку, решает он сам: Google Календарь, например, может делать это раз в несколько часов.
  • Задача со временем становится событием в это время, задача на весь день — событием на весь день. Выполненные задачи из ленты пропадают.
  • В названии события — название задачи, в описании — список, исполнители и ссылка на задачу в DoneBy.

Как подключить

  1. В DoneBy откройте Настройки → Календарь и нажмите «Создать ссылку».
  2. Выберите, что попадёт в ленту: задачи, где вы исполнитель, или задачи отдельного списка. Для разных списков можно завести разные ссылки.
  3. Скопируйте ссылку и добавьте её в календарь — где это сделать, смотрите в таблице.
КалендарьГде добавить подписку
Яндекс КалендарьСлева в блоке «Подписки» нажмите «+» и вставьте ссылку.
Google Календарь«Другие календари» → «+» → «Добавить по URL».
Apple КалендарьНа Mac: «Файл» → «Новая подписка на календарь». На iPhone: Настройки → Календарь → Учётные записи → Новая учётная запись → Другое → Подписной календарь.
Outlook«Добавить календарь» → «Подписаться из Интернета».

Отзыв ссылки

Ссылка работает без входа в аккаунт: это удобно для календаря и рискованно, если она попадёт не туда. Чтобы отозвать её, откройте Настройки → Календарь и нажмите «Отозвать». Старая ссылка сразу перестаёт отвечать, а календари, подписанные на неё, больше не получают обновлений. Новую ссылку можно создать там же.

Важно

Не публикуйте ссылку-подписку в общих чатах и документах: любой, у кого она есть, видит названия и сроки ваших задач. Когда участника удаляют из пространства, его ссылки отзываются автоматически.

Выгрузка по расписанию

На тарифе Бизнес выгрузку можно поставить на расписание — для резервных копий в собственном хранилище и для отчётности.

  • Частота — ежедневно или еженедельно, в выбранное время по часовому поясу пространства.
  • Формат — CSV или JSON, состав — как у ручной выгрузки.
  • Готовый архив приходит ссылкой на почту выбранным администраторам.
  • История выгрузок с датой и размером архива — в Настройки → Данные.

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

Хранение и удаление

ЧтоКак устроено
Где хранятся данныеНа серверах в России
Резервные копииЕжедневно, хранятся 30 дней
УдалениеПо запросу — в течение 30 дней, включая копии

Чтобы удалить данные пространства, напишите с почты владельца на privacy@doneby.app. Свой аккаунт можно удалить и самостоятельно — в личном кабинете, раздел Безопасность. Перед удалением сделайте выгрузку — после удаления восстановить данные будет невозможно. Подробнее — на странице Данные и безопасность.

см. также
Статья помогла?Отметьте галочкой — так мы понимаем, какие статьи дописать первыми.