Общая информация

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

Автоматический REST-интерфейс может использоваться следующих задач:

• интеграция прикладного решения с интернет-сайтами и интернет-магазинами;
• реализация сторонними средствами дополнительной функциональности прикладного решения без изменения его конфигурации;
• загрузка данных в прикладное решение и выгрузка данных из него;
• интеграция прикладного решения с корпоративными системами, возможно, даже без дополнительного программирования.

Доступ к данным приложения через REST-интерфейс позволяет выполнять следующие типичные операции:

• получение списка документов, справочников, записей регистра сведений и т. п., возможно, с фильтром;
• получение данных элемента справочника, документа (по ссылке), данных записи независимого регистра сведений (по ключу), данных набора записей подчиненного регистра (по регистратору);
• редактирование данных одного элемента справочника, документа и другого ссылочного объекта;
• создание нового элемента справочника, документа, набора записей;
• проведение одного документа, старт бизнес-процесса.

В качестве протокола доступа платформа использует протокол OData версии 3.0. Это открытый веб-протокол для запроса и обновления данных. Он позволяет оперировать данными, используя в качестве запросов HTTP-команды. Получать ответы можно в формате Atom/XML или JSON.

Клиенты OData существуют практически для всех значимых платформ:

• мобильные: iOS, Windows Phone, Android;
• серверные/настольные: .NET, Java, PHP, Objective-C, Ruby, JavaScript;
• поддержка в системах управления содержимым (CMS): Drupal, Joomla.

В этой книге мы не будем рассматривать примеры работы в этих платформах и то, какими средствами в них выполняется обращение по протоколу OData. При необходимости вы можете обратиться к документации той платформы, которая вам нужна.

Поскольку эта книга – о системе «1С:Предприятие», то работу с автоматическим REST-интерфейсом мы рассмотрим для простоты на примере обращения к нему (клиентская часть) из этой же самой информационной базы. В реальной жизни такая задача вряд ли встретится, но взаимодействие одной базы «1С:Предприятия» с другой базой «1С:Предприятия» через REST-интерфейс – это довольно частая задача. И решается она точно такими же средствами.

Для обращения к REST-интерфейсу используются такие объекты встроенного языка, как HTTPСоединение, HTTPЗапрос и HTTPОтвет (дальше вы увидите это на примерах в разделе «Примеры использования»).

В REST-интерфейсе доступны практически все основные объекты конфигурации: справочники, документы, константы, перечисления, планы обмена, регистры накопления, расчета, бухгалтерии и регистры сведений, виртуальные таблицы периодического регистра сведений, регистров бухгалтерии и регистров накопления, планы счетов, видов характеристик и видов расчета, бизнес-процессы, задачи и журналы документов.

В REST-интерфейсе доступны также реквизиты объектов конфигурации, табличные части и реквизиты табличных частей, доступны операции создания, чтения, модификации и удаления данных, а также некоторые методы встроенного языка. Например:

• для документа – проведение и отмена проведения;
• для задачи – выполнение;
• для бизнес-процесса – старт;
• для регистра сведений – получение среза первых и среза последних;
• для регистра накопления и регистра бухгалтерии – получение остатков, оборотов, остатков и оборотов;
• для регистра расчета – получение данных графика, фактического периода действия, перерасчета и базы.

При чтении и записи данных с помощью REST-интерфейса платформа выполняет все обычные проверки прав и вызывает обработчики событий.

Подробнее

Более подробно про автоматический REST-интерфейс рассказано в документации «1С:Предприятия 8» в разделе «Глава 17. Механизмы интернет-сервисов – HTTP-сервисы – Стандартный интерфейс ODATA».