Описание: Импортировать данные из ранее загруженного на портал файла-вложения в список. Метод — единая точка входа для нескольких форматов: конкретный обработчик (провайдер импорта) выбирается автоматически по расширению файла. На данный момент есть два провайдера:
.xlsx) — построчный импорт/обновление элементов списка (см. ниже). Параметр parentId этим провайдером не используется..mpp, .mpt, .mpx, .mpd, .xml, .xer, .pmxml — файлы MS Project и Primavera) — импорт иерархии задач проекта в дерево элементов списка, с использованием parentId как точки вставки (см. ниже).Метод возвращает элемент файла-отчёта с результатом построчной/потасковой обработки (что успешно импортировано, что — с ошибкой и почему).
🌐 HTTP-информация
POST/import/api/file/Import/{listId}/{parentId}/{fileId}Authorization: <UserSessionToken>📥 Параметры запроса (URL Path)
| Параметр | Тип | Описание |
|---|---|---|
listId | Guid | ID списка, в который импортируются данные. |
parentId | Guid | ID родительского элемента, относительно которого выполняется импорт. Смысл зависит от провайдера — см. ниже. |
fileId | Guid | ID ранее загруженного файла-вложения, из которого выполняется импорт. |
Провайдер Excel: parentId не используется — можно передавать любое значение, например 00000000-0000-0000-0000-000000000000 или такое же значение, как в listId. Тип содержимого для новых строк определяется по колонке content_type_id внутри самого файла; строки сопоставляются с элементами списка по колонке id (если пусто — создаётся новый элемент, если заполнено — обновляется существующий).
Провайдер MPXJ: parentId определяет точку вставки импортируемых задач в дерево списка:
parentId == listId — импортируется вся структура задач проекта как корневой уровень списка.parentId — ID уже существующего в списке элемента-задачи (созданного при более раннем импорте того же файла, хранящего исходный идентификатор задачи проекта) — импортируется только соответствующее ему поддерево задач из файла (сама задача и её потомки), то есть возможен частичный повторный импорт отдельной ветки WBS.📦 Тело запроса (Request Body)
Метод не принимает тела запроса.
📤 Тело ответа (Response Body)
IItem — элемент файла-отчёта об импорте (созданный на основе исходного файла или в дополнение к нему, с результатом по каждой строке/задаче: успех / текст ошибки, а для новых элементов — присвоенный id). Сам отчёт нужно дополнительно скачать как файл (см. группу "Файлы и документы", будет описана отдельно).