Массовый экспорт и импорт

Назначение

Сервис обеспечивает загрузку, выгрузку и массовое обновление данных с использованием файлового обмена. Включает Data Import , Data Export (exporter), документацию Dinext по импорту и экспорту, а также типовые сценарии выгрузки в Excel/CSV и загрузки из шаблонов.

Цели и задачи

Выгружать данные списков и отчетов в Excel/CSV для анализа и архивирования.
Загружать данные из файлов (импорт новых записей или обновление существующих).
Использовать шаблоны импорта с валидацией и сопоставлением полей.
Массово обновлять атрибуты документов при поддержке импорта обновлений.
Обеспечивать контроль ошибок импорта и откат при необходимости.

Для кого

Аналитики и контролеры, выгружающие данные для отчетов.
Администраторы и ключевые пользователи, выполняющие импорт и миграции.
Интеграторы при обмене данными с внешними системами через файлы.
Все пользователи при экспорте списков в Excel (кнопка Export в списках).

Основные понятия

Data Export — выгрузка данных тип документа или отчета в файл (Excel, CSV); через экспортер (exporter.py) или кнопку Export в списке.
Data Import — загрузка данных из файла: выбор тип документа, загрузка файла, сопоставление колонок с полями, валидация, импорт. Поддержка новых записей и при настройке — обновление существующих по ключу.
Шаблон импорта — файл с заголовками колонок, соответствующими полям тип документа; пользователь заполняет данные и загружает.
Валидация — проверка типов, обязательных полей и связей перед записью; ошибки отображаются в отчете импорта.

Основные сущности / объекты

Data Import — мастер импорта и журнал импортов.
exporter.py — выгрузка данных.

Основные сценарии / процессов

Экспорт данных

Открыть список документов (тип документа) или отчет; применить нужные фильтры.
Нажать Export; выбрать формат (Excel, CSV) и при необходимости поля.
Файл скачается; использовать для анализа, передачи или архива.
Для выгрузки по API или по расписанию использовать экспортер в коде или фоновую задачу с вызовом экспорта.

Импорт данных (новые записи)

Подготовить файл: первая строка — заголовки, совпадающие с именами полей тип документа (или скачать шаблон через Data Import).
Открыть Data Import; выбрать тип документа, загрузить файл.
Сопоставить колонки файла с полями (если не совпадают автоматически).
Запустить валидацию; исправить ошибки в файле или в маппинге и повторить.
Выполнить импорт; просмотреть отчет об успешных и ошибочных строках.
Ошибочные строки не импортируются; скорректировать данные и повторить импорт только для них при необходимости.

Массовое обновление (при поддержке)

В Data Import выбрать режим обновления (если доступен): указать ключевое поле (например, name или код).
Загрузить файл с полями для обновления и ключом для сопоставления существующих документов.
Валидация и импорт обновят только указанные поля у найденных документов.
Использовать осторожно: проверить резервную копию и выборочно проверить результат.

Правила и ограничения

Импорт выполняется в рамках прав текущего пользователя; для массового импорта в защищенные тип документа может потребоваться роль с правами на создание/изменение.
Размер файла и количество строк ограничены настройками (timeout, лимиты); очень большие файлы разбивать на части или выполнять импорт в фоне.
Связи (Link, Table) должны указывать существующие документы; при импорте дочерних таблиц порядок импорта родительских записей должен быть соблюден (сначала родитель, потом дочерние со ссылкой на него).
Рекомендуется тестировать импорт на копии данных или на тестовом сайте.

Результаты / отчетность

Выгруженные файлы (Excel/CSV) по спискам и отчетам.
Отчет Data Import: количество импортированных строк, ошибки по строкам с причиной.
Обновленные документы в системе после успешного импорта.

Типовые вопросы и ошибки (FAQ)

Импорт падает с таймаутом

Уменьшите количество строк в одном файле (например, до 1000–2000) или выполните импорт в несколько заходов. Для очень больших объемов рассмотрите импорт через скрипт/фоновую задачу с пакетной вставкой.

Ошибка «Link must be valid» при импорте

Поле типа Link ссылается на документ, которого нет в системе (например, клиент или проект). Сначала импортируйте справочники, затем документы со связями. Либо укажите в файле существующие имена документов (name) в связанном тип документа.

Как скачать шаблон для импорта?

В Data Import после выбора тип документа обычно есть кнопка «Download Template» или «Скачать шаблон»; файл будет с заголовками полей. Заполните данные, сохраните в CSV/Excel и загрузите обратно.

Docs

Массовый экспорт / импорт