Отображение истории статусов
============================

.. code:: abap

    *"--------------------------------------------------------------------
    *"*"Локальный интерфейс:
    *"  IMPORTING
    *"     VALUE(IV_RECORD_ID) TYPE  /TRL/XDE_HEADER-RECORD_ID OPTIONAL
    *"  CHANGING
    *"     REFERENCE(CT_STATUS) TYPE  /TRL/XDE_T_STATUS OPTIONAL
    *"  EXCEPTIONS
    *"      NOT_FOUND
    *"--------------------------------------------------------------------


Функциональный модуль ``/TRL/XDE_API_SHIPM_DSP_STATUS`` предназначен для отображения данных (истории) статусов отправки.

.. table:: Описание интерфейса функционального модуля ``/TRL/XDE_API_SHIPM_DSP_STATUS``
   :align: center
   :widths: 2 8
    
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | Параметр                           | Описание                                                                                              |
   +====================================+=======================================================================================================+
   | ``IMPORTING``                                                                                                                              |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IV_RECORD_ID``                   | Уникальный идентификатор отправки.                                                                    |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``CHANGING``                                                                                                                               |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``CT_STATUS``                      | Данные статусов, отсортированных в порядке назначения.                                                |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``EXCEPTIONS``                                                                                                                             |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``NOT_FOUND``                      | Отправка не найдена.                                                                                  |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+

Работа ФМ заключается в вызове ФМ ``/TRL/XDE_SHIPMENT_DSP_STATUS``, который 
находит данные с помощью ФМ ``/TRL/XDE_GET_SHIPMENTS``.

Если результат ``/TRL/XDE_GET_SHIPMENTS`` окажется неудачным, будет вызвана особая ситуация ``NOT_FOUND`` с сообщением «Отправка не найдена &».

После этого данные, полученные выше, сортируются с помощью ФМ ``/TRL/XDE_SORT_STATUS``. Далее данные выводятся в отдельном окне для пользователя.

Если результат работы ФМ ``/TRL/XDE_SHIPMENT_DSP_STATUS`` окажется неудачным, будет вызвана особая ситуация ``NOT_FOUND``.

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

.. important::

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


Функциональный модуль сортировки статусов
-----------------------------------------
    
Имя функционального модуля сортировки статусов находится в таблице ``/TRL/XDE_CUST`` по имени настройки "FM_SORT_STATUS_NEW".

.. image:: ris7.png
   :scale: 87
   :align: center
   :alt: Настройка ``FM_SORT_STATUS_NEW``
    
* Если удалить настройку, ошибка не возникнет.
* Если заполнить некорректно, вызова ФМ не произойдет.

Правила для ФМ из этой настройки касаются интерфейса ФМ, см. в таблице ниже.

.. table:: Параметры модуля сортировки статусов
   :align: center
   :widths: 2 1 4
   
   +----------------------------+-------+------------------------------------+
   | Наименование параметра     | Тип   | Название словарного типа или класс |
   +============================+=======+====================================+
   | ``IMPORTING`` (попадают в ФМ)                                           |
   +----------------------------+-------+------------------------------------+
   | ``IV_RECORD_ID``           | Тип   | ``/TRL/XDE_ED_RECORD_ID_EXT``      |
   +----------------------------+-------+------------------------------------+
   | ``IT_STATUS``              | Тип   | ``/TRL/XDE_T_STATUS``              |
   +----------------------------+-------+------------------------------------+
   | ``EXPORTING`` (результаты ФМ на выходе)                                 |
   +----------------------------+-------+------------------------------------+
   | ``ET_STATUS``              | Тип   | ``/TRL/XDE_T_STATUS``              |
   +----------------------------+-------+------------------------------------+