Разбирайте этапы продаж BPMSoft прямо по данным OData

Агент работает с BPMSoft по OData 4: запросы уходят на адрес вашего сервера в раздел /0/odata, откуда читаются контакты, контрагенты, лиды, продажи, активности, счета, заказы, обращения, продукты и документы. На этих данных считаются суммы и вероятности по этапам продаж, сделки, стоящие дольше обычного, дубли в справочниках по телефону и почте и просроченная дебиторка в разрезе контрагентов.

Первым делом агент читает $metadata и разбирается в схеме именно вашего внедрения: набор сущностей и полей в BPMSoft дописывается под заказчика, и колонки, появившиеся при внедрении, для отчёта нередко важнее типовых. Оттуда же берутся связи: ссылочные поля приходят идентификаторами, и без разворачивания связи вместо названия контрагента в таблице останется GUID. Ответ сервера ограничен 20 000 строк, поэтому большие выборки агент забирает постранично.

По умолчанию агент работает на чтение: считает, сверяет, показывает. Запись он умеет — создать и обновить запись, запустить бизнес-процесс по имени схемы, — но делает это по вашему запросу и проговаривая, что именно изменится. Запуск процесса опаснее обычной правки: за ним тянутся уведомления, задачи и переходы по этапам, поэтому схему и объект, к которому она применяется, агент называет до старта, а не после.

Границы агента — это права пользователя интеграции: сущность, закрытая ролью, не появится ни в одном отчёте, и агент назовёт причину, а не покажет пустую таблицу. Отбор и сортировку он отдаёт серверу параметрами $filter, $orderby и $select, чтобы не тянуть лишние колонки, а даты приводит к формату OData — иначе отфильтруется не тот период. Частоту обращений держит умеренной: постраничная выборка идёт с паузами, а не занимает сервер целиком.