Описание: Импортировать строки Excel-файла (ранее загруженного на портал как файл-вложение) в список как новые или обновляемые элементы. Строки сопоставляются с элементами списка по столбцу id: если id пуст — создаётся новый элемент, если заполнен — обновляется существующий. Метод возвращает элемент файла-отчёта с результатом построчной обработки (какие строки успешно импортированы, какие — с ошибкой и почему).
🌐 HTTP-информация
POST/import/api/excel/Import/{listId}/{contentTypeId}/{fileId}Authorization: <UserSessionToken>📥 Параметры запроса (URL Path)
| Параметр | Тип | Описание |
|---|---|---|
listId | Guid | ID списка, в который импортируются данные. |
contentTypeId | Guid | Присутствует в шаблоне маршрута, но текущей реализацией контроллера не используется (тип содержимого определяется по колонке файла, см. ниже). Значение можно передать любым, например 00000000-0000-0000-0000-000000000000. |
fileId | Guid | ID ранее загруженного файла-вложения (Excel), из которого выполняется импорт. |
📦 Тело запроса (Request Body)
Метод не принимает тела запроса.
ℹ️ Тип содержимого для новых строк определяется не параметром URL, а значением колонки
content_type_id(по имени) внутри самого Excel-файла; для существующих элементов (когда в строке указанid) содержимое обновляется без учёта типа.
📤 Тело ответа (Response Body)
IItem — элемент файла-отчёта об импорте (созданный на основе исходного файла, с добавленной колонкой результата по каждой строке: успех / текст ошибки, а для новых строк — присвоенный id). Сам отчёт нужно дополнительно скачать как файл (см. группу "Файлы и документы", будет описана отдельно).