**Обмен метаданными**
=====================

Для интеграции с ИМ на основе REST возможна передача метаданных в новом формате данных "Ключ - Значение". 
    
Включение нового формата обмена метаданными
-------------------------------------------

Для передачи метаданных в новом формате выполните следующие действия в таблице ``/TRL/XDE_CUST``.

#. Убедитесь, что включена и настроена интеграция с ИМ посредством REST:

   * настройка ``IM.INTEGRATION_TYPE`` должна иметь значение "WS";
   * настройка ``IM.WS_INTEGRATION`` должна иметь значение "REST".

#. Установите для настройки ``XMETA.NEW_FORM`` значение "X".

Работа с метаданными
--------------------
Метаданные хранятся в таблице ``/TRL/XDE_METDAT``, откуда они попадают в исходящие документы и куда они попадают при обработке
входящих документов.
В случае старой реализации (настройка ``XMETA.NEW_FORM`` имеет значение не "X") создается отдельный файл с расширением .xml. Для исходящих отправлений
необходимо заполнить поле отправки ``XDE_META`` (изменяемый параметр ``CR_DATA``) в XML-формате, сделать это можно внутри переопределенных 
ФМ сбора и/или изменения данных. Кроме того, в этих функциональных модулях нужно заполнить изменяемый параметр ``CT_METADATA``, который 
участвует в обновлении данных в таблице ``/TRL/XDE_METDAT``.

.. note:: Функциональные модули получения и изменения данных перед постановкой в очередь отправки настраиваются в ракурсе ``/TRL/XDE_SHIP_TY``
          в транзакции ``SM30``.

В рамках новой реализации обмена метаданными происходит выборка из таблицы ``/TRL/XDE_METDAT`` во время
работы программы ``/TRL/XDE_WS_OUTBOUND_PROC``. Если выбранные данные невозможно поместить в инфо-поля формализованного XML-документа, 
то они попадают в ИМ в виде набора "Ключ - Значение".
Для того чтобы данные появились в таблице ``/TRL/XDE_METDAT``, необходимо заполнить данными изменяемый параметр ``CT_METADATA`` в функциональных
модулях сбора и/или изменения данных.
Все метаданные входящих документов, полученные в виде набора "Ключ - Значение", будут записаны в таблицу ``/TRL/XDE_METDAT``.
При этом поле ``FHZ`` будет равно "04". Все длинные тексты (свыше 255) будут сохранены по ключу с помощью ФМ ``/TRL/XDE_LTXT_SAVE``.
При этом, если новая настройка ``XMETA.NEW_FORM`` в таблице ``/TRL/XDE_CUST`` не включена, то данные из таблицы ``/TRL/XDE_METDAT``
будут передаваться ранее реализованным способом (создание отдельного ``xde_meta.xml``, подробнее см. раздел :ref:`incomingmap`).