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

Прикрепляет файлы с этого компьютера к строкам магазина. Остальное делает движок: id, имя, папку и строку файла.

Право

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

Параметры

Параметр Тип Что это
files список объектов файлы, по объекту на файл

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

Поле Тип Что это
entity строка сущность — таблица-владелец: store, info, brand… — см. «Файлы элементов»
elem_id число id строки, которой принадлежит файл
file строка файл на этом компьютере — абсолютный путь или путь от папки магазина
[kind_key] строка вид файла; по умолчанию kBase
[real_name] строка имя для людей; по умолчанию имя файла

Пачки. Длинный список уходит несколькими запросами по размеру — MaxFileSize в Shop.ini на этом компьютере, по умолчанию 8192 КБ. Движок проверяет всю пачку до записи — сущности, строки-владельцы, виды, — и отказ проверки не оставляет от пачки ничего. Пачки, ушедшие раньше, остаются добавленными.

Число файлов в запросе ограничивает и PHP сервера, параметр max_file_uploads: в пачку помещается на один файл меньше, потому что сам вызов тоже считается.

Ответ

{"files": {"columns": ["entity", "elem_id", "id", "kind_key", "real_name", "path", "size", "pos"],
           "rows": [["store", 1, 1, "kBase", "photo.png",
                     "files/2026/09_17/00_53/files_store_1_1.png", 73, 1]]}}
Колонка Что это
entity, elem_id чей файл
id id строки файла — по нему файл загружают и удаляют
kind_key вид файла
real_name имя для людей
path путь файла на сайте
size размер в байтах
pos место в группе своего вида

Отказы

Ответ Когда
Unknown element entity: … у такой сущности нет таблицы файлов
Element not found: … id … строки elem_id нет
No group […] among the files of a … - it keeps: … вида нет в реестре таблицы; перечислены допустимые
The table files_… is in work right now, and nothing was written… таблицу файлов держит кто-то другой
This php takes … upload(s) in one request… в пачке больше файлов, чем принимает PHP сервера
No such file: … файла file нет на этом компьютере
files is required: …, Every entry needs entity and file. не указаны файлы или их поля

Если отказ пришёл после того, как ушли первые пачки, он начинается с Added before this: и перечисляет уже добавленные файлы.

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