К содержимому журнала

Инженерия

OData или HTTP-сервис 1С: как выбрать способ обмена с внешней системой

Стандартный OData и собственный HTTP-сервис 1С: где разместить правила обмена, как определить результат резерва и проверить ошибки.

Два каменных прохода: открытая сетка объектов и отдельный проход для согласованной операции
Содержание

Внешней системе нужно получать товары из 1С и отправлять заявки на резерв. Для первой задачи может подойти стандартный интерфейс к объектам. Для второй стоит выяснить, кто будет отвечать за проверку наличия, выбор склада и результат операции. Выбор между OData и собственным HTTP-сервисом зависит прежде всего от границы ответственности: клиент работает с устройством базы или передаёт понятное бизнес-намерение.

Оба варианта используют HTTP. Собственный HTTP-сервис тоже можно спроектировать в стиле REST, поэтому противопоставление «REST или HTTP» не объясняет различие. Здесь сравниваем автоматически формируемый интерфейс OData и написанный разработчиком контракт.

Что уже умеет стандартный интерфейс #

Платформа 1С формирует REST-интерфейс автоматически ; он использует OData версии 3. Через него доступны чтение и изменение объектов, а также некоторые действия, включая проведение документа. Это не интерфейс исключительно для чтения. При работе действуют права пользователя; поведение обработчиков и ограничения нужно учитывать по документации конкретной версии.

Такой вариант имеет смысл, если внешняя система понимает модель объектов 1С, а требуемые операции укладываются в доступный интерфейс. Например, внутренний каталог получает ограниченный набор справочных данных. Команда интеграции описывает нужные объекты, отбор, состав полей и способ получить полный набор без пропусков. Создавать отдельный сервис только ради переименования тех же полей может быть лишней работой.

При этом внешний потребитель становится зависимым от модели 1С. Если после обновления изменится нужная структура или прикладное правило, адаптация может потребоваться на стороне клиента. В техническом решении нужно назвать владельца этой совместимости. Автоматическая генерация интерфейса не означает автоматического сохранения всех ожиданий внешней системы.

Когда нужен собственный контракт #

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

Возьмём учебную заявку на резерв товара. В предлагаемой схеме клиент передаёт идентификатор заявки, покупателя, товарные строки и желаемый склад. Сервер проверяет обязательные данные и применяет согласованное правило резерва средствами конкретной конфигурации. Ответ связывает заявку с полученным результатом: резерв принят, отклонён по определённой причине либо принят в обработку. Это проектный контракт, а не готовый метод платформы.

Клиенту тогда не требуется самостоятельно собирать цепочку изменений внутренних объектов. Правило остаётся рядом с учётной системой. Но его реализация, проверка полномочий, журнал и поддержка версии API становятся работой разработчика. Собственный сервис не получает эти свойства только от своего названия.

Одна заявка — два разных распределения работы #

Если резерв реализуется через доступные операции OData, опишите всю последовательность на стороне клиента: какие сведения он читает, что записывает, каким действием подтверждает результат и что делает при изменении остатка между чтением и записью. Возможность провести документ ещё не отвечает на вопрос, соответствует ли полученное состояние правилам именно вашего резерва.

В варианте с собственным сервисом ту же последовательность организует серверная операция. Можно задать общий ответ, не раскрывающий устройство учёта. Цена такого решения — собственный программный код и его сопровождение. Оно оправданно, если перенос правил на сторону 1С убирает существенную неоднозначность или несколько внешних систем иначе реализовали бы одно правило по-разному.

Проверка проста: попросите исполнителя объяснить, где живёт правило и какой объект доказывает его исполнение. Если ответ сводится к «получим HTTP 200», контракт ещё не описан. Успешно принятый запрос может означать только регистрацию задачи, а не готовый резерв.

Согласуйте результат и неполную обработку #

Для заявки из нескольких строк заранее выберите поведение при нехватке одного товара. Можно отклонять заявку целиком или разрешать частичный результат. Во втором случае ответ должен позволять сопоставить каждую исходную строку с принятой и отклонённой частью. Молчаливое сокращение количества создаст расхождение между обещанием покупателю и учётом.

После потери ответа клиент не знает, успел ли сервер выполнить операцию. В контракте нужен способ сверки по устойчивому идентификатору и правило повторного обращения. Ключ, переданный в произвольном поле, не обеспечивает защиту от повторов: принимающая сторона должна действительно использовать его в обработке. Механизм реализуют и испытывают отдельно для выбранной схемы обмена.

Длительную обработку можно вынести в очередь и возвращать идентификатор задания, по которому запрашивается результат. Это отдельное архитектурное решение. Нельзя обещать очередь, повторные попытки и хранение результата как встроенные свойства любого HTTP-сервиса 1С.

Сравнивайте варианты на одном испытании #

Возьмите одну и ту же тестовую заявку. Проверьте обычный резерв, нехватку одной строки, неизвестный товар и потерю ответа после обработки. После каждой попытки смотрите на фактические документы и количества в 1С. По журналу должно быть понятно, какой запрос создал результат и как внешний клиент получил окончательное состояние.

Отдельно испытайте минимальные права интеграционного пользователя. Ему должен быть доступен необходимый обмен, а посторонние данные и действия должны оставаться закрытыми. Публикация на веб-сервере, защищённое соединение и доступность с нужной стороны сети входят в состав интеграции при обоих подходах.

Если стандартный интерфейс покрывает сценарий и зависимость клиента от модели 1С приемлема, начинайте с него. Если требуется устойчивое бизнес-действие с собственными правилами и ответом, сравните стоимость собственного сервиса с ценой этой зависимости. В интеграции 1С с внешними сервисами важно зафиксировать эту границу. Для оценки пришлите NetLabCS пример входного сообщения и желаемого результата в 1С , включая частичный отказ. По ним можно выбрать границу обмена до разработки API.

Был ли материал полезен?

0 полезных · 0 неполезных · 0 оценок

Голосование временно недоступно: подключаем безопасную идентификацию читателя.