.. _incomingmap:

Настройка мэппинга данных входящих отправок
===========================================

Описание настройки
------------------

Настройка мэппинга данных входящих отправок позволяет определить правила
сохранения данных входящих документов в таблицы системы SAP (таблицы
Продукта и Z-таблицы клиента).

При настройке мэппинга данных указываются:

-  источник данных – наименование поля структуры SAP, в которую после
   парсинга входящего документа записываются данные;

-  наименование поля таблицы SAP, куда данные будут записаны.

Настройка мэппинга данных выполняется в таблице ``/TRL/XDE_IN_MAPP`` при
помощи транзакции ``SM30``.

Описание настроек представлено ниже.

* **SETNG** - Набор настроек

        Набор настроек, в рамках которого выполнена данная настройка.
        
* **ODTYP** - Вид документа ОЭД

        Идентификатор вида документа ОЭД (например, NONF, NT12 т.д.).
        
* **STXML** - Структура для XML

        Название структуры SAP, в которую записываются данные входящей отправки. 
        Поле настройки предназначено для определения разных правил мэппинга 
        для разных форматов документа в рамках одного и того же вида документа ОЭД. 
        Например, можно настроить разный мэппинг для старого (5.01) и нового (5.02) 
        формата ФНС счета-фактуры. Если поле не заполнено, 
        то предполагается использование единого типа структуры для вида документа ОЭД.
        
* **TABNM** - Таблица БД

        Название таблицы SAP, в которую будут записаны данные.
        Таблица должна содержать ключевое поле «RECORD_ID».
        Если ``DATTP = «Метаданные»``, 
        то таблица должна содержать обязательные поля ``FIELD_NAME``, ``VALUE``,
        а также дополнительное поле ``TEXT``.
        Если ``DATPL = «Данные позиций»``,
        то таблица должна содержать обязательное поле 
        идентификатора позиции (указывается в ``TABID``).
        
* **TABIX** - Сортировка

        Число, определяющее последовательность заполнения данных.
        
* **TABFL** - Поле БД

        Название поля в таблице ``TABNM``, 
        в которое будут записаны данные. 
        Если ``DATTP = «Метаданные»``, то не заполняется.
        
* **TABID** - Поле ID позиции

        Название поля в таблице ``TABNM``,
        содержащее идентификатор позиции.
        Заполняется только в случае, если ``DATPL = «Данные позиций»``.
        
* **MAPTB** - Исходная таблица

        Название таблицы с данными позиций в структуре SAP.
        Заполняется только в случае, если ``DATPL = «Данные позиций»``.
        
* **MAPFL** - Поле документа

        Наименование поля структуры SAP, 
        в которую после парсинга входящего документа записываются данные 
        (например, для cчета-фактуры возможно указать любое поле структуры ``/TRL/XDE_S_INVO``).
        
* **DATTP** - Тип данных

        Принимает одно из следующих значений: *"Простое значение"*, *"Метаданные"*.
        Если указано *«Простое значение»*, то ``MAPFL`` должна содержать значение простого типа.
        Если указано *«Метаданные»*, то ``MAPFL`` должна содержать одно из следующих значений:
        
        - Таблицу с обязательными полями ``FIELD_NAME``, ``VALUE``.
        - XML-файл в формате ``<[Имя параметра] text=»[Описание параметра]»>[Значение ]</[Имя параметра]>``.
        - Текстовые данные в формате ``[Имя параметра1]=[Значение ];[Имя параметра2]=[Значение 2]``.
        
        Данные ``[Имя параметра]`` попадают в поле ``FIELD_NAME`` таблицы ``TABNM``.
        Данные ``[Значение]`` попадают в поле ``VALUE`` таблицы ``TABNM``.
        Данные ``[Описание параметра]`` попадают в поле ``TEXT`` таблицы ``TABNM``.
        
* **DATPL** - Местонахождение данных

        Принимает одно из следующих значений: *"Данные заголовка"*, *"Данные позиций"*.
        *"Данные заголовка"* указываются в случае, если необходимо сохранить данные из 
        заголовочной части документа. *"Данные позиций"* указываются в случае, если необходимо 
        сохранить данные из позиций документа. Если указаны данные позиций, то должны быть заполнены 
        следующие поля:
        
        - ``TABID``– название поля в таблице ``TABNM``, в которое сохраняется идентификатор позиции.
        - ``MAPTB``– полное название таблицы с данными позиций в структуре SAP. Таблица должна содержать поле ``ID`` – идентификатор позиции.
        - ``MAPFL``– название поля в таблице ``MAPTB`` с данными для сохранения в поле ``TABFL``.
        
* **DATFHZ** - Вид ФХЖ

        Принимает значение, означающее местонахождение данных в разделах ФНС:

        - ``01``	Инф. поле ФХЖ (заголовок)
        - ``02``	Инф. поле ФХЖ 2 (позиции)
        - ``03``	Инф. ФХЖ 3 (доп.)
        - ``04``	Инф. отдельный файл
        
* **CNVFM** - ФМ конвертации данных

        ФМ расширения для преобразования данных перед сохранением в таблицу SAP 
        (см. пример и описание в ФМ ``/TRL/XDE_IN_MAPPING_C NV_DATE``).


Пример настройки мэппинга данных
--------------------------------

Пример настроек для сохранения заголовочных метаданных счета-фактуры и
дополнительных метаданных (``xde_meta.xml``) в таблицу Продукта
``/TRL/XDE_METDAT`` (не заполняемые столбцы пропущены):

* Вид документа ОЭД - ``INVO``
* Таблица БД - ``/TRL/XDE_METDAT``
* Сортировка - ``1``
* Поле документа - ``HEADER-M_DATA``
* Тип данных - ``Метаданные``
* Местонахождение данных - ``Данные заголовка``

Пример настроек для сохранения метаданных позиций счета-фактуры в
таблицу клиента ``ZMETADATA`` (не заполняемые столбцы пропущены):

* Вид документа ОЭД - ``INVO``
* Таблица БД - ``ZMETADATA``
* Сортировка - ``1``
* Поле ID позиции - ``POS_ID``
* Исходная таблица - ``ITEMS``
* Поле документа - ``M_DATA``
* Тип данных - ``Метаданные``
* Местонахождение данных - ``Данные позиций``

Таблица ``ZMETADATA`` содержит следующие ключевые поля:

-  ``RECORD_ID`` – идентификатор отправки;
-  ``POS_ID`` – идентификатор позиции документа;
-  ``FIELD_NAME`` – идентификатор поля метаданных.

Пример настройки, сохраняющей значения суммы, налога и валюты для
входящего счета-фактуры в таблице Продукта ``/TRL/XDE_HDR_ATR``:

- Вид документа ОЭД - ``INVO``
- Таблица БД - ``/TRL/XDE_HDR_ATR``
- Сортировка - ``1``
- Поле БД - ``TOTAX`` (``TAXWR`` или ``WAERS``)
- Поле документа - ``HEADER-TOTAX``
- Тип данных - ``Простое значение``
- Местонахождение данных - ``Данные заголовка``