Перейти к содержанию

Postman#

Postman — это HTTP-клиент для тестирования API. В рамках этого руководства - для тестирования обмена данными с 1С.

Для того, чтобы настроить обмен по новому типу документа необходимо узнать сущность 1С, в которой хранятся его данные.

Сделать это можно по кнопке внутри документа
Рисунок 1 Получить ссылку

Ссылка будет выглядеть следующим образом:
Рисунок 2 Ссылка

Подставив вместо слова «Документ.» значение Document_, а вместо слова «Справочник.»- Catalog_ получаем название сущности.

Зная название сущности, можем посмотреть ее содержимое при помощи программы Postman.

Для выборки данных содержимого сущностей необходимо создать Get обращение к 1С как на рисунке ниже:
Рисунок 3 Главное окно

Для обращения необходимо настроить закладки – Params, Autorization, Body.

На закладке Params можно задать формат, в котором предпрочтительно вывести запрашиваемые
данные ($format), перечислить поля для выборки ($select), а также наложить фильтры ($filter).
Язык для написания параметров – Odata, подробнее можно почитать по ссылке
https://docs.microsoft.com/ru-ru/azure/search/search-query-odata-filter.

На закладке Авторизация необходимо указать данные учетной записи:
Рисунок 4 Авторизация
На закладке Body по кнопке «Send» программа выдаст содержимое сущности по указанным параметрам:
Рисунок 5 Авторизация

Полученное содержимое необходимо проанализировать на предмет наличия полей в конструкторе передаваемого заявления и отредактировав, вставить в колонку «Параметры» в документе «Настройка параметров обмена с 1С»

Здесь важно понимать, что значения, которые передавать не надо, заполняем нулевыми значениями, н-р, “Руководитель_Key” : "00000000-0000-0000-0000-000000000000".

Есть поля, которые автоматически заполняются из СЭД(полный перечень можно посмотреть в функции getEmployeeStatement):
"Организация_Key": "", - не заполняем, так как поле передается из СЭД
"ФизическоеЛицо_Key": "", - не заполняем, так как поле передается из СЭД
Сотрудник_Key, ОсновнойСотрудник_Key, ПериодРегистрации, Date, Основание, Комментарий. Если поле заполняется из конструктора заявлений, то его значение оставляем пустым: Например, для Ежегодного отпуска, ДатаНачалаОсновногоОтпуска будет выглядеть в параметре так: "ДатаНачалаОсновногоОтпуска": "", Рисунок 6 ДатаНачалаОснОтп
После настройки параметров обмена проверяем отправку документа в 1С. При отправке могут быть ошибки следующего типа: Рисунок 7 EmployeeError

Для удобства понимания ошибки можно создать POST обращение в программе Postman, указав в качестве Body текст, выданный функцией в момент ошибки: Рисунок 8 BodyConsole
Либо запустив функцию odata.getEmployeeStatement по интересуемому коду документа.

В Postman обращение оформляется следующим образом: Рисунок 9 PostBody

Ошибки как правило двух видов – не распознан ключ, не распознана дата, ошибка будет расшифрована следующим образом: -на дату Рисунок 10 PostBodyErrorData
-на ключ Рисунок 11 PostBodyErrorGuid

Далее ищем по телу обращения - какие поля остались без значения – похожими по названию на дату или _key (все должны быть заполнены или нулями или значениями из передаваемого документа).