Быстрый старт#

Разработка первого приложения с использованием программного компонента 1C:Enterprise 8 Universal Integration Plugin (OCPL)

Конфигурирование API прикладного решения 1С:Предприятие для внешних взаимодействий#

В качестве демонстрационного примера будет создан HTTP-API для доставки изменений справочника «Физические лица» прикладного решения «Зарплата и управление персоналом 3.1» на платформе 1С:Предприятие 8 (далее - Прикладное решение 1С). Пример предполагает, что Прикладное решение 1С установлено и опубликовано на веб-сервере согласно инструкции из комплекта поставки Прикладного решения 1С. Публикация должна быть выполнена с флагом «Публиковать HTTP-сервисы расширений по умолчанию» (атрибут publishExtensionsByDefault элемента httpServices в файле описания публикации default.vrd). Последовательность действий конфигурирования API:

Подключите 1C:Enterprise 8 Universal Integration Plugin (OCPL) к существующему Прикладному решению 1С согласно описанию в разделе Установка документа «Руководство по установке» компонента 1C:Enterprise 8 Universal Integration Plugin (OCPL) продукта Platform V Synapse Enterprise Integration.
Авторизуйтесь в прикладном решении 1С:Предприятие с подключенным расширением OCPL.
Вызовите меню подсистемы «Synapse App Mesh».
Выберите пункт меню «Узлы обмена» для вызова списка справочника узлов обмена.
Создайте элемент справочника, используя кнопку «Создать».
Заполните поле «Наименование», например, «API СКУД».
Установите флаг «Публиковать OData».
Сохраните элемент нажатием кнопки «Записать».
Вызовите форму настройки узла нажатием кнопки «Настройки».
В открывшейся форме в дереве объектов метаданных установите флаг на элементе Справочники → Физические лица.
Сохраните выбор нажатием кнопки «Сохранить и закрыть».
Перейдите в форму списка справочника Физические лица, выбрав его в меню подсистемы Кадры.
Откройте и сохраните любой элемент справочника.
Выполните запрос на получение изменений, подставив путь к серверу, опубликованной на нем Прикладном решении 1С, параметры авторизации и код созданного узла обмена:
```
curl --request GET --url 'http://localhost/DemoHR/hs/synapse/changes/000000001?expand=true'
```
Убедитесь, что ответ содержит описание вида:

{
  "Catalog_FizicheskieLitsa": [
    {
      "type": "Справочник.ФизическиеЛица",
      "version": 63875980439214,
      "guid": "87433449-7cc0-11e2-9368-001b11b25590",
      "path": "/odata/standard.odata/Catalog_ФизическиеЛица(guid'87433449-7cc0-11e2-9368-001b11b25590')?$format=json",
      "presentation": "<Представление данных>",
      "data": {
        "#value": {
          "Инициалы": "И. О.",
          "Отчество": "<Отчество>",
          "Имя": "<Имя>",
          "НаименованиеСлужебное": "<Представление данных>",
          "Пол": "Женский",
          "ДатаРождения": "1986-01-02T00:00:00",
          "Description": "<Представление данных>",
          "Code": "0000000033",
          "Фамилия": "<Фамилия>",
          "Parent": "00000000-0000-0000-0000-000000000000",
          "DeletionMark": false,
          "Ref": "87433449-7cc0-11e2-9368-001b11b25590",
          "ФИО": "<Представление данных>",
          "IsFolder": false
        },
        "#type": "jcfg:CatalogObject.ФизическиеЛица"
      },
      "deletion": false
    }
  ]
}