SAPPER SETTINGS - Настройки выгрузки — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
(FILE)
(Параметры заголовка документа (/SBIS/S_XML))
Строка 61: Строка 61:
 
</div>
 
</div>
  
===Параметры заголовка документа (/SBIS/S_XML)===
+
===Заголовк документа (/SBIS/S_XML)===
  
 
Параметры заголовка документа условно можно разделить на две группы:
 
Параметры заголовка документа условно можно разделить на две группы:
Строка 88: Строка 88:
  
 
Значение параметра для заголовка может иметь тип: Field – поле ABAP объекта, String – строка. Для типов возможно применение внутренних преобразований с помощью добавления постфиксов, к примеру, Field_Date преобразует дату из формата ABAP в формат 00.00.0000, Field_WaersToCode преобразует валюту в кодовое значение валюты. Список доступных преобразований можно посмотреть в методе классе /SBIS/CL_MAPPING->CONVERT_FIELD_TYPE.
 
Значение параметра для заголовка может иметь тип: Field – поле ABAP объекта, String – строка. Для типов возможно применение внутренних преобразований с помощью добавления постфиксов, к примеру, Field_Date преобразует дату из формата ABAP в формат 00.00.0000, Field_WaersToCode преобразует валюту в кодовое значение валюты. Список доступных преобразований можно посмотреть в методе классе /SBIS/CL_MAPPING->CONVERT_FIELD_TYPE.
Маппинг данных отправителя и получателя находятся в массиве FACE.
+
 
 +
===PARAM (ИнфПолФХЖ1)===
 +
 
 
Для заголовка, также можно добавить параметры, в следующем виде:
 
Для заголовка, также можно добавить параметры, в следующем виде:
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
Строка 151: Строка 153:
 
</div>
 
</div>
 
</div>
 
</div>
 +
 +
===LINKS===
  
 
В массиве LINKS можно указать ссылки на связанные документы, номер заказа, транспортную накладную и так далее:
 
В массиве LINKS можно указать ссылки на связанные документы, номер заказа, транспортную накладную и так далее:
Строка 211: Строка 215:
 
</div>
 
</div>
  
Отправитель, получатель, грузоотправитель, грузополучатель и прочие сущности сторон обмена содержатся в массиве FACE.   
+
===FACE===
 +
 
 +
Маппинг данных роли участника документооборота находится в массиве FACE.
 +
   
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
 
'''массив FACE сторон обмена'''
 
'''массив FACE сторон обмена'''
Строка 1002: Строка 1009:
 
</div>
 
</div>
 
</div>
 
</div>
 +
 +
====ITEMS (S_XML_DOC)====
  
 
Позиции документа отражаются в массиве ITEMS. В качестве значения передается ссылка на массив из программы печати ITEMS и маппинг его полей, к примеру:
 
Позиции документа отражаются в массиве ITEMS. В качестве значения передается ссылка на массив из программы печати ITEMS и маппинг его полей, к примеру:
 +
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
 
'''массив позиций ITEMS'''
 
'''массив позиций ITEMS'''

Версия 16:45, 15 марта 2018

Настройки выгрузки

После того как пользователь выбрал в списке пакет документов для отправки / просмотра, для каждой записи таблицы делается вызов программы формирования XML в соответствии с группой настроек указанной в поле INI_NAME. Настройки выгрузки сгруппированы в файлы DO_*, которые содержат указание программы печати, класс получения данных, XSLT преобразование, данные отправителя и получателя, маппинг данных SAP во внутреннюю структуру SAPPER, на основании которой формируются XML документы.

Структура настроек выгрузки:

  • ПолучениеДанных_Класс – класс получения данных документа (/SBIS/CL_SAP_DATA)
  • ПолучениеДанных_Метод – метод класса получения данных. Доступные варианты:
    • PRINT_NAST - через программу печати основанную на структуре NAST
    • EFG_PRINT - через программу печати выводимые с помощью FM EFG_PRINT
    • PRINT_PROG - через любые ABAP программы
  • ПолучениеДанных_XSLT – XSLT преобразование для получения XML документа во внутреннем формате (/SBIS/DOC301)
  • assign_program – программа печати, J_3RV_DELIV_PDF
  • ОтправительПакета_Роль, ПолучательПакета_Роль – роли отправителя и получателя пакета
  • PRINT_SEND - параметры программы печати в режиме формирования XML
  • PRINT_PRINT - параметры программы печати в режиме печати
  • FILE - настройки формирования XML файлов. Список файлов, которые необходимо создать по данным программы печати. Каждый файл раздела содержит список данных, которые необходимы для формирования файла и их источников (имена глобальных объектов программы печати их содержащие). Настройка модуля в основном сводится к заполнению данного раздела.
    • [параметры заголовка документа]
    • PARAM - дополнительные параметры на уровне заголовка документа, соответствуют ИнфПолФХЖ1 из формата ФНС.
    • FACE - массив ролей участников документооборота
    • LINKS - массив ссылок на связанные документы
    • ITEMS - массив позиций документа
      • PARAM - дополнительные параметры на уровне позиций документа, соответствуют ИнфПолФХЖ2 из формата ФНС

FILE

Описание маппинга документов содержатся в массиве FILE. Массив может содержать несколько документов, которые будут формироваться на основании одной программы печати, это может быть использовано для формирования накладной и вместе с ней сопроводительного документа. Значения структур программы печати кладутся в структуры /SBIS/S_XML (для заголовка), /SBIS/S_XML_DOC (для позиций).

пример структуры файла DO_*

развернуть

Заголовк документа (/SBIS/S_XML)

Параметры заголовка документа условно можно разделить на две группы:

  • Параметры файла электронного документа (тег Файл формата ФНС)
    • DOC_NAME – наименование документа “Накладная”
    • FILE_FORMAT_TYPE – тип документа “ЭДОНакл”
    • FILE_FORMAT_SUBTYPE – подтип докумета, КНД, "1175010"
    • FILE_FORMAT_VERSION – версия документа, по умолчанию из SAP “3.01”
    • FILE_PROG_VERSION – версия программы, по умолчанию "SAP NetConnector"
    • FILE_ID_FORM – номер визуализации формы, по умолчанию, "1С"
    • FILE_NAME – префикс имени создаваемого файла, "DP_TOVTORGPR_"
  • Параметры самого электронного документа (тег Документ формата ФНС). Этот набор параметров ставит в соответствие выходную структуру заголовка программы печати H_DOC (для J_3RV_DELIV_PDF) и структуру /SBIS/S_XML.
    • NAME – отображаемое имя документа, “Накладная”
    • DATE – дата документа
    • TIME – время документа, по умолчанию 00.00.00
    • ID - уникальный идентификатор, обычно номер документа
    • NUMBER - номер документа
    • WAERS - код валюты
    • SUM_TAX_FREE - сумма без налога
    • SUM - сумма
    • TAX_SUM - сумма налога
    • AMOUNT - количество
    • WEIGHT_GROSS - вес брутто
    • WEIGHT_NET - вес нетто
    • WEIGHT_UNIT_NAME - единица измерения веса

Значение параметра для заголовка может иметь тип: Field – поле ABAP объекта, String – строка. Для типов возможно применение внутренних преобразований с помощью добавления постфиксов, к примеру, Field_Date преобразует дату из формата ABAP в формат 00.00.0000, Field_WaersToCode преобразует валюту в кодовое значение валюты. Список доступных преобразований можно посмотреть в методе классе /SBIS/CL_MAPPING->CONVERT_FIELD_TYPE.

PARAM (ИнфПолФХЖ1)

Для заголовка, также можно добавить параметры, в следующем виде:

параметры

развернуть

LINKS

В массиве LINKS можно указать ссылки на связанные документы, номер заказа, транспортную накладную и так далее:

массив LINKS

развернуть

FACE

Маппинг данных роли участника документооборота находится в массиве FACE.

массив FACE сторон обмена

развернуть

ITEMS (S_XML_DOC)

Позиции документа отражаются в массиве ITEMS. В качестве значения передается ссылка на массив из программы печати ITEMS и маппинг его полей, к примеру:

массив позиций ITEMS

развернуть

PRINT_SEND, PRINT_PRINT

Массивы PRINT_PRINT и PRINT_SEND содержат параметры программы печати в режиме печати и в режиме формирования XML, соответственно. По сути это маппинг части ключевых полей таблицы NAST.

пример PRINT_SEND, аналогично для PRINT_PRINT

развернуть