.. _sap_rest_manual_settings:

Настройки для заказчиков
========================

Для работы с сервисами REST (архив и ИМ) создана настроечная таблица ``/TRL/XDE_REST_SV``. Для ведения
настроек в данной таблице создан ракурс ведения ``/TRL/XDE_VRESTSV``, который можно открыть через тр.
SM30, либо можно запустить транзакцию ``/TRL/XDE_REST_SV``. Данный ракурс ведения не позволяет добавить
или удалить записи, возможно только изменение уже существующих записей.

Таблица ``/TRL/XDE_REST_SV`` содержит следующие поля.

.. list-table:: Список полей таблицы /TRL/XDE_REST_SV
   :widths: auto
   :header-rows: 1

   * - Имя поля
     - Ключ
     - Элемент данных
     - Описание
   * - 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 выполнить задачу и вернуть результат без выполнения
сотни попыток.