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

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

Настройка мэппинга данных входящих отправок позволяет определить правила сохранения данных входящих документов в таблицы системы 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

  • Тип данных - Простое значение

  • Местонахождение данных - Данные заголовка