3. Описание MCP-сервера › 3.3 Движок › Файлы элементов › engine_files_load

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

Право

«Прямой доступ → Файлы магазина → Загрузить» (AGENT_ENGINE_FILES_LOAD).

Параметры

Параметр Тип Что это
files список объектов что скачать

Поля объекта:

Поле Тип Что это
entity строка сущность — таблица-владелец — см. «Файлы элементов»
[id] число один файл по id его строки
[elem_id] число все файлы строки-владельца — вместо id

За один вызов приходит столько файлов, сколько помещается в предел размера пачки; остальные получают skipped, и их запрашивают снова по id.

Ответ

{"folder": "D:\\Melbis\\shop.example.com", "total": 1, "sent": 1,
 "files": {"columns": ["entity", "id", "elem_id", "kind_key", "real_name", "pos", "size", "path", "state"],
           "rows": [["store", 1, 1, "kBase", "photo.png", 1, 73,
                     "files/2026/09_17/00_53/files_store_1_1.png", "ok"]]}}
Поле Что это
folder папка магазина на этом компьютере: файл лежит в folder + path
total сколько строк файлов найдено
sent сколько файлов пришло
files строки файлов: entity, id, elem_id, kind_key, real_name, pos, size, path и state
state Что значит
ok файл скачан
missing строка есть, а файла на диске сервера нет
skipped не поместился в пачку — запросить снова по id

Несуществующий id отказа не даёт: total равен нулю, а rows пуст.

Отказы

Ответ Когда
Unknown element entity: … у такой сущности нет таблицы файлов
files is required: …, Every entry needs entity. не указаны файлы или сущность

Общие отказы — «Ответы и отказы».