1С:ERP

Приложение 1С:ERP подключает стандартный OData-интерфейс комплексной учётной базы. Агент может исследовать опубликованную схему и работать с объектами производства, продаж, закупок, складов, финансов и бюджетирования.

Назначение

ERP обычно содержит сотни или тысячи EntitySet. Приложение даёт агенту контролируемый способ сначала разложить схему по видам объектов, а затем делать узкие выборки и, при необходимости, согласованные изменения.

Подключение

1. Опубликуйте базу на веб-сервере с включённым стандартным интерфейсом OData.
2. В Состав стандартного интерфейса OData добавьте только объекты, нужные для конкретных сценариев.
3. Создайте отдельного пользователя с ролью УдаленныйДоступOData и ограниченными правами.
4. Предоставьте HTTPS-адрес публикации.
5. В приложении укажите адрес, логин и пароль.

Promto нормализует адрес, добавляет /odata/standard.odata/ и читает $metadata. Для полной ERP метаданные могут быть объёмными, поэтому их загрузка имеет отдельный увеличенный тайм-аут. Секреты остаются на сервере.

Интерфейс и данные

Главная страница предлагает сценарии Что доступно в базе, Что опубликовано в ERP, Выборка данных и подключение.

В настройках отображаются адрес, пользователь, маска пароля, количество опубликованных объектов и первые имена EntitySet. В браузер передаётся не более 400 имён; полный список агент получает через list_entities. После изменения состава используйте Обновить состав ($metadata).

Возможности агента

Инструмент — promto_onec_erp. Для большой базы особенно важен порядок:

1. list_entities с prefix, search и ограничением результата.
2. describe_entity для выбранного EntitySet.
3. query с узкими $select и $filter.

Объекты производства, склада и финансов обычно распределены между Document_*, AccumulationRegister_*, InformationRegister_*, AccountingRegister_* и справочниками Catalog_*. Имена конкретной ERP определяются только по $metadata.

Сценарии

Карта опубликованной ERP

Через promto_onec_erp вызови list_entities и разложи объекты по префиксам. Затем предложи по два наиболее вероятных объекта для производства, склада, продаж и финансов, но перед выборкой обязательно проверь их через describe_entity.

Узкий управленческий отчёт

Сначала уточни показатель и период. Через list_entities и describe_entity найди подходящий регистр, затем выполни query только с нужными измерениями и ресурсами.

Ограничения и подтверждения

• Не запрашивайте весь состав ERP одним массивом данных: используйте префикс, поиск и страницы.
• $metadata ограничен 16 МиБ; если публикация превышает лимит, сократите состав OData.
• Ответ обычного запроса ограничен 512 КБ, а query — 1000 объектами.
• Любая запись требует явного согласия и confirm=true.
• Проведение и отмена проведения меняют движения и управленческие итоги.
• Физическое удаление через delete_object необратимо со стороны Promto.

Если что-то не работает

• Метаданные слишком большие или долго загружаются. Уменьшите состав OData до реально используемых объектов.
• Нужный раздел отсутствует. Добавьте его объекты в публикацию и обновите состав в приложении.
• 403. Выдайте пользователю права именно на выбранный объект, не расширяя роль без необходимости.
• Неверные имена. Не переносите названия из демонстрационной или другой ERP; перечитайте list_entities.
• Ответ обрезан. Сузьте $select, $filter и $top.

Связанные материалы

• Интеграции
• Агенты
• Настройки Promto