Поиск отправки и получение информации о ней
===========================================
.. code:: abap
*"--------------------------------------------------------------------
*"*"Локальный интерфейс:
*" IMPORTING
*" REFERENCE(IV_RECORD_ID) TYPE /TRL/XDE_HEADER-RECORD_ID
*" OPTIONAL
*" REFERENCE(IV_SHIPMENT_ID) TYPE /TRL/XDE_HEADER-SHIPMENT_ID
*" OPTIONAL
*" REFERENCE(IV_DOCUMENT_ID) TYPE /TRL/XDE_HEADER-DOCUMENT_ID
*" OPTIONAL
*" REFERENCE(IV_DIRECTION) TYPE /TRL/XDE_HEADER-DIRECTION
*" OPTIONAL
*" REFERENCE(IV_DOC_TYPE) TYPE /TRL/XDE_HEADER-OED_DOC_TYP
*" OPTIONAL
*" EXPORTING
*" REFERENCE(ES_HEADER) TYPE /TRL/XDE_HEADER
*" REFERENCE(ET_STATUS) TYPE /TRL/XDE_T_STATUS
*" REFERENCE(ES_HDR_ATTR) TYPE /TRL/XDE_HDR_ATR
*" REFERENCE(ET_BO_LINK) TYPE /TRL/XDE_T_BO_LINK
*" REFERENCE(ET_DOCUMENTS) TYPE /TRL/XDE_T_DOCUMENTS
*" REFERENCE(ET_METADATA) TYPE /TRL/XDE_T_MTD
*" EXCEPTIONS
*" NOT_FOUND
*"--------------------------------------------------------------------
Функциональный модуль ``/TRL/XDE_API_SHIPM_GET_DATA`` предназначен для поиска отправки и получения информации по ней.
.. table:: Описание интерфейса функционального модуля ``/TRL/XDE_API_SHIPM_GET_DATA``
:align: center
:widths: 2 8
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| Параметр | Описание |
+====================================+=======================================================================================================+
| ``IMPORTING`` |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``IV_RECORD_ID`` | Уникальный идентификатор отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``IV_SHIPMENT_ID`` | Уникальный идентификатор пакета отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``IV_DOCUMENT_ID`` | Уникальный идентификатор документа отправки (устаревший параметр, используется для совместимости со |
| | старыми версиями Продукта). |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``IV_DIRECTION`` | Направление отправки («I» - входящая отправка, «O» - исходящая отправка). |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``IV_DOC_TYPE`` | Вид документа ОЭД. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``EXPORTING`` |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``ES_HEADER`` | Данные заголовка отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``ET_STATUS`` | История статусов отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``ES_HDR_ATTR`` | Дополнительные атрибуты отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``ET_BO_LINK`` | Данные связей отправки с бизнес-объектами SAP. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``ET_DOCUMENTS`` | Список документов отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``ET_METADATA`` | Метаданные отправки. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``EXCEPTIONS`` |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
| ``NOT_FOUND`` | Отправка не существует. |
+------------------------------------+-------------------------------------------------------------------------------------------------------+
Внутри ФМ вызывается ФМ ``/TRL/XDE_GET_SHIPMENTS``. Внутри этого ФМ выполняются выборки данных по идентификатору отправки.
Данные берутся из таблиц ``/TRL/XDE_HEADER``, ``/TRL/XDE_STATUS``, ``/TRL/XDE_HDR_ATR``, ``/TRL/XDE_BO_LINK``, ``/TRL/XDE_DOCUM``, ``/TRL/XDE_METDAT``, ``/TRL/XDE_SIGN``.
Данная API-функция подразумевает возможность расширения для заказчика.
.. important::
При использовании явных или неявных операторов ``COMMIT WORK`` и ``ROLLBACK WORK`` в расширениях корректная работа API-функций не гарантируется!
Функциональный модуль сортировки статусов
-----------------------------------------
Имя функционального модуля сортировки статусов находится в таблице ``/TRL/XDE_CUST`` по имени настройки "FM_SORT_STATUS_NEW".
.. image:: ris8.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`` |
+----------------------------+-------+------------------------------------+