Postman#
Postman — это HTTP-клиент для тестирования API. В рамках этого руководства - для тестирования обмена данными с 1С.
Для того, чтобы настроить обмен по новому типу документа необходимо узнать сущность 1С, в которой хранятся его данные.
Сделать это можно по кнопке внутри документа
Ссылка будет выглядеть следующим образом:
Подставив вместо слова «Документ.» значение Document_, а вместо слова «Справочник.»- Catalog_ получаем название сущности.
Зная название сущности, можем посмотреть ее содержимое при помощи программы Postman.
Для выборки данных содержимого сущностей необходимо создать Get обращение к 1С как на рисунке ниже:
Для обращения необходимо настроить закладки – Params, Autorization, Body.
На закладке Params можно задать формат, в котором предпрочтительно вывести запрашиваемые
данные ($format), перечислить поля для выборки ($select), а также наложить фильтры ($filter).
Язык для написания параметров – Odata, подробнее можно почитать по ссылке
https://docs.microsoft.com/ru-ru/azure/search/search-query-odata-filter.
На закладке Авторизация необходимо указать данные учетной записи:
На закладке Body по кнопке «Send» программа выдаст содержимое сущности по указанным параметрам:
Полученное содержимое необходимо проанализировать на предмет наличия полей в конструкторе передаваемого заявления и отредактировав, вставить в колонку «Параметры» в документе «Настройка параметров обмена с 1С»
Здесь важно понимать, что значения, которые передавать не надо, заполняем нулевыми значениями, н-р, “Руководитель_Key” : "00000000-0000-0000-0000-000000000000".
Есть поля, которые автоматически заполняются из СЭД(полный перечень можно посмотреть в функции getEmployeeStatement):
"Организация_Key": "", - не заполняем, так как поле передается из СЭД
"ФизическоеЛицо_Key": "", - не заполняем, так как поле передается из СЭД
Сотрудник_Key, ОсновнойСотрудник_Key, ПериодРегистрации, Date, Основание, Комментарий.
Если поле заполняется из конструктора заявлений, то его значение оставляем пустым:
Например, для Ежегодного отпуска, ДатаНачалаОсновногоОтпуска будет выглядеть в параметре так:
"ДатаНачалаОсновногоОтпуска": "",
После настройки параметров обмена проверяем отправку документа в 1С. При отправке могут быть ошибки следующего типа:
Для удобства понимания ошибки можно создать POST обращение в программе Postman, указав в качестве Body текст, выданный функцией в момент ошибки:
Либо запустив функцию odata.getEmployeeStatement по интересуемому коду документа.
В Postman обращение оформляется следующим образом:
Ошибки как правило двух видов – не распознан ключ, не распознана дата, ошибка будет расшифрована следующим образом:
-на дату
-на ключ
Далее ищем по телу обращения - какие поля остались без значения – похожими по названию на дату или _key (все должны быть заполнены или нулями или значениями из передаваемого документа).