Создание МЧД в диалоговом режиме/по шаблону
===========================================

.. code:: abap

    *"----------------------------------------------------------------------
    *"*"Локальный интерфейс:
    *"  IMPORTING
    *"     REFERENCE(IV_ATTOREY_NUMBER) TYPE  /TRL/XDE_ED_ATTOREY_NUMBER
    *"       OPTIONAL
    *"     REFERENCE(IV_UPLOAD) TYPE  FLAG_X OPTIONAL
    *"  EXPORTING
    *"     REFERENCE(ES_MCHDHDR) TYPE  /TRL/XDE_MCHDHDR
    *"     REFERENCE(ES_RETURN) TYPE  /TRL/XDE_RETURN
    *"----------------------------------------------------------------------

Функциональный модуль ``/TRL/XDE_API_MCHD_CREATE`` предназначен для создания/регистрации МЧД в диалоговом режиме без предзаполнения или по шаблону уже существующей 
МЧД.

.. list-table:: Описание интерфейса функционального модуля /TRL/XDE_API_MCHD_CREATE
   :widths: auto
   :header-rows: 1

   * - Имя параметра
     - Тип параметра
     - Элемент данных
     - Описание
   * - IV_ATTOREY_NUMBER
     - Importing
     - /TRL/XDE_ED_ATTOREY_NUMBER
     - Номер МЧД
   * - IV_UPLOAD
     - Importing
     - FLAG_X
     - Индикатор загрузки XML
   * - ES_MCHDHDR
     - Exporting
     - /TRL/XDE_MCHDHDR
     - Заголовок МЧД
   * - ES_RETURN
     - Exporting
     - /TRL/XDE_RETURN
     - Код и текст сообщения ошибки

В первую очередь проверяются полномочия на создание МЧД. Проверяется объект полномочий ``/TRL/XDE_M`` поле ``XDE_MCHD`` код действия "01". Если полномочий нет, 
работа функционального модуля будет прервана.

Если параметр ``IV_ATTOREY_NUMBER`` заполнен, будет произведен поиск данных по существующей МЧД в продукте xDE. Если данные найдены, XML МЧД будет разобрана
для того, чтобы предзаполнить данными диалоговое окно. Иначе, если заполнен параметр ``IV_UPLOAD``, будет произведена попытка загрузить XML в качестве шаблона
создания новой МЧД. Для этого будет выведено окно для выбора XML файла и подписи к нему вручную на компьютере пользователя. Указанная XML будет
разобрана на данные для предзаполнения экрана создания МЧД. В противном случае, если параметры ``IV_ATTOREY_NUMBER`` и ``IV_UPLOAD`` не заполнены, будет создана новая 
МЧД без предзаполнения полей, самостоятельно нужно будет заполнить все необходимые данные.

После этого будет выведен экран для заполнения/изменения данных. Если на данном экране нажать "Enter" или кнопку "Сохранить" - функциональный модуль перейдет к
стадии сохранения/регистрации. Регистрация (подписание) или только сохранение МЧД зависит от того, есть ли полномочия у пользователя. Для регистрации необходимо иметь
полномочия в объекте ``/TRL/XDE_M`` поле ``XDE_MCHD`` код действия "02".

В случае сохранения будет создан файл XML, заголовок и сделаны записи в таблицу соответствия пользователей SAP и представителей. В случае регистрации будет
выведено окно для локального подписания файла XML, после чего будет выполнен запрос на регистрацию МЧД в интеграционный модуль. Статус МЧД изменится на "ARO"
(Отправлен запрос регистрации).