Описание: Мост между процессом на UI (карточкой рабочего процесса/автоматизации) и модулем "Импорт": запускает импорт файла, приложенного к элементу-процессу, используя тот же универсальный механизм импорта, что и метод Import модуля "Импорт" (/import/api/file/Import/...) — то есть поддерживаются все форматы, которые поддерживает модуль "Импорт": Excel (.xlsx), а также MS Project и Primavera (.mpp, .mpt, .mpx, .mpd, .xml, .xer, .pmxml через MPXJ). Конкретный обработчик выбирается автоматически по расширению приложенного файла.
Целевой список и точка вставки (parentId, см. страницу метода Import модуля "Импорт") определяются по ссылке-назначению, указанной на элементе-процессе (поле-ссылка "ReferenceWorkflow"):
- Если элемент-назначение сам является списком — импорт идёт в корень этого списка (
listId = parentId= ID списка). - Если элемент-назначение — конкретный элемент внутри списка (например, ранее импортированная задача) — импорт выполняется в список этого элемента, а сам элемент передаётся как
parentId(актуально для иерархического импорта MPXJ — импортируется только его поддерево).
Получившийся файл-отчёт добавляется в список вложений элемента-процесса (не заменяет прежние вложения из файла Excel, MS Project или Primavera, приложенного к элементу-процессу, в список, на который процесс ссылается, и записывает получившийся файл-отчёт обратно в элемент процесса (поле вложений). Ошибки импорта не выбрасываются наружу — они записываются дописываются в текстовое поле описания элемента-процесса.
...
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
itemIdList | Guid[] | Да | ID элемента-процесса, для которого запускается импорт (используется только первый элемент массива); файл берётся из первого вложения этого элемента, список/точка вставки — из его ссылки-назначения |
actionId | Guid | Да | ID элемента действия автоматизации (можно указать пустой 00000000-0000-0000-0000-000000000000) |
...
Метод ничего не возвращает (void, HTTP 200 OK без тела в случае успеха). Результат импорта отражается в самом элементе-процессе (обновлённое поле вложений с файлом-отчётомфайл-отчёт добавлен в список вложений, либо текст ошибки дописан в описанииописание).