Настройки для заказчиков¶
Для работы с сервисами REST (архив и ИМ) создана настроечная таблица /TRL/XDE_REST_SV
. Для ведения
настроек в данной таблице создан ракурс ведения /TRL/XDE_VRESTSV
, который можно открыть через тр.
SM30, либо можно запустить транзакцию /TRL/XDE_REST_SV
. Данный ракурс ведения не позволяет добавить
или удалить записи, возможно только изменение уже существующих записей.
Таблица /TRL/XDE_REST_SV
содержит следующие поля.
Имя поля |
Ключ |
Элемент данных |
Описание |
---|---|---|---|
MANDT |
X |
MANDT |
Мандант |
REST_ID |
X |
/TRL/XDE_ED_REST_ID |
Тип REST сервиса |
PATH |
/TRL/XDE_ED_REST_PATH |
HTTP адрес REST сервиса |
|
USERNAME |
/TRL/XDE_ED_USERNAME |
Имя пользователя |
|
PASSWORD |
/TRL/XDE_ED_PASSWORD |
Пароль |
|
TOKEN |
/TRL/XDE_ED_TOKEN |
Значение токена |
|
ITERATOR |
/TRL/XDE_ED_ITERATOR |
Количество попыток получить данные по задаче |
|
WAIT |
/TRL/XDE_ED_WAIT |
Время ожидания между итерациями |
REST_ID
- это идентификатор REST сервиса. Значения берутся из домена /TRL/XDE_DM_REST_ID
.
Значение «REST_IM» используется для настроек REST сервиса для работы с интеграционным модулем.
Значение «REST_ARCH» используется для настроек REST сервиса для работы с архивом.
Для переключения с одного типа архива на другой используется поле ASTYPE
в таблице /TRL/XDE_CUST
.
PATH
необходим для выполнения http-запросов, где содержимое этой настройки является
неотъемлемой частью. Эта часть объединяется с другими настройками, либо константами и образует
URL.
USERNAME
и PASSWORD
работают в связке. При запросе токена через http-запрос (GET) формируется
строка. Содержимое строки (тело запроса) = «username=1&password=2&grant_type=password», где 1 =
содержимое настройки USERNAME
, 2 = содержимое настройки PASSWORD
.
TOKEN
хранит последний полученный токен. Если токен в таблице БД оказался неактуальным - токен
запрашивается через сервис заново и его значение в данном поле обновляется.
ITERATOR
хранит количество попыток получить данные из запроса. Некоторые операции разбиты на
несколько запросов. Первый запрос ставит задачу на выполнение и возвращает идентификатор задачи.
Второй запрос по данному идентификатору задачи пытается получить результат. При этом может возникнуть
ситуация, когда всё прошло корректно, но задача еще не выполнена. В таком случае - возвращается статус
результата выполнения задачи «0». Это значит, что нужно еще подождать прежде чем запросить результат
выполнения задачи.
WAIT
указывает количество секунд, которое нужно подождать прежде чем повторять очередную итерацию
из ITERATOR
. Ожидание позволяет сервису REST выполнить задачу и вернуть результат без выполнения
сотни попыток.