Демонстрация карточки документа
===============================

.. code:: abap

    *"--------------------------------------------------------------------
    *"*"Локальный интерфейс:
    *"  IMPORTING
    *"     VALUE(IV_RECORD_ID) TYPE  /TRL/XDE_ED_RECORD_ID_EXT
    *"  EXCEPTIONS
    *"      NO_OBJECT_FOUND
    *"      SETTINGS_ERROR
    *"      RUNTIME_ERROR
    *"--------------------------------------------------------------------

Функциональный модуль ``/TRL/XDE_API_SHIPM_DISPLAY`` показывает пользователю карточку отправки.

.. table:: Описание интерфейса функционального модуля ``/TRL/XDE_API_SHIPM_DISPLAY``
   :align: center
   :widths: 2 8
    
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | Параметр                           | Описание                                                                                              |
   +====================================+=======================================================================================================+
   | ``IMPORTING``                                                                                                                              |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IV_RECORD_ID``                   | Уникальный идентификатор отправки.                                                                    |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``EXCEPTIONS``                                                                                                                             |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``NO_OBJECT_FOUND``                | Отправка не найдена.                                                                                  |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``SETTINGS_ERROR``                 | Ошибка в настройках Продукта.                                                                         |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``RUNTIME_ERROR``                  | Неизвестная ошибка.                                                                                   |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+

Данные находятся по номеру GUID с помощью ФМ ``/TRL/XDE_GET_SHIPMENTS``.

Если работа ФМ оказалась неуспешной, вызывается особая ситуация ``NO_OBJECT_FOUND`` с сообщением «Отправка не найдена».

Находится имя настраиваемого класса по настройке ``SHIPMENT_OBJECT``.

Если имя класса не найдено, вызывается особая ситуация ``SETTINGS_ERROR`` с сообщением «Не задан класс обработки &».

Создается объект класса и далее вызывается метод ``DISPLAY_SHIPMENT``.

Данная API функция подразумевает возможность расширения для заказчика.

.. important::

    При использовании явных или неявных операторов ``COMMIT WORK`` и ``ROLLBACK WORK`` в расширениях корректная работа API-функций не гарантируется!

Имя класса для обработки карточки документа хранится в таблице ``/TRL/XDE_CUST`` по имени ``SHIPMENT_OBJECT``.
Для корректной работы класс должен содержать метод-конструктор со входным параметром ``IV_RECORD`` типа ``/TRL/XDE_ED_RECORD_ID_EXT``.

Этот метод может содержать и другие параметры, однако они должны быть необязательного типа. Метод-конструктор необходим для заполнения атрибутов класса данными.

.. image:: ris1.png
   :scale: 65
   :align: center
   :alt: Настройка ``SHIPMENT_OBJECT``
    

Класс также должен иметь метод ``DISPLAY_SHIPMENT``. Метод не имеет обязательных параметров, поэтому он может содержать любые параметры интерфейса необязательного типа. 
Данный метод нужен, чтобы выводить на экран данные по документу, а также для доступа к другим возможностям.