Компоненты функционала обмена приглашениями и их назначение

Объекты словаря

Таблицы БД

Таблица отношений партнерства между контрагентами

Таблица /TRL/XDE_DEB_REL содержит все параметры отношений партнерства между контрагентами. В качестве первичного ключа используется адрес ЭДО организации в целевой SAP системе и ИНН/КПП контрагента.

Таблица 294 /TRL/XDE_DEB_REL

Поле

Ключ

Элемент данных

Описание

BOX_ID

X

/TRL/XDE_ED_ID_BOX

Адрес ящика контрагента в системе ОЭД

INN

X

/TRL/XDE_ED_INNUL

Индивидуальный номер налогоплательщика

KPP

X

/TRL/XDE_ED_KPP

КПП

KAGENT_BOX_ID

/TRL/XDE_ED_ID_BOX

Адрес ящика контрагента в системе ОЭД

KAGENT_FNS_ID

/TRL/XDE_ED_ID_KAG

Налоговый идентификатор контрагента ЭДО

BUKRS

BUKRS

Балансовая единица

ID_OED

/TRL/XDE_ED_ID_OED

Код оператора ЭД

STATUS

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

LAST_INDEX

/TRL/XDE_ED_INDEX

Индекс таблицы статусов контрагента

DATUM

/TRL/XDE_ED_CHANDA

Дата регистрации

UZEIT

/TRL/XDE_ED_CHANTI

Время регистрации

MESSAGE

/TRL/XDE_ED_MESSAGE

Сообщение об ошибке

ROAMING_ID_OED

/TRL/XDE_ED_ID_OED

Код роумингового оператора ЭД

Таблица условий для обмена приглашениями

Таблица /TRL/XDE_INV_CON содержит условия для обмена приглашениями. Определяет связь между действием над приглашением, правами, необходимыми для операции, и статусами, соответствующими действию.

Таблица 295 /TRL/XDE_INV_CON

Поле

Ключ

Элемент данных

Описание

SETTING_SET

X

/TRL/XDE_ED_SETTING_SET

Набор настроек

COND_NUM

X

/TRL/XDE_ED_COND_NUM

Номер условия

ACTVT

X

/TRL/XDE_ED_ACTVT

Доступные функции

PERM_TYPE

/TRL/XDE_ED_PERMISSION_TYPE

Тип доступа на операцию

DIRECTION

/TRL/XDE_ED_DIRECTION_T

Входящий/Исходящий

ID_OED

/TRL/XDE_ED_ID_OED

Код оператора ЭД

STATE

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

EX_STATE

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

Таблица статусов для обмена приглашениями

Таблица /TRL/XDE_INV_STS содержит статусную схему для обмена приглашениями. В дополнение к описанию статуса, в этой таблице определяются действия над приглашениями, после которых соответствующий статус должен быть установлен. Например, операция SEND – соответствует статусу «CSO» – приглашение отправлено контрагенту.

Таблица 296 /TRL/XDE_INV_STS

Поле

Ключ

Элемент данных

Описание

STATUS

X

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

ACTION

X

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

TEXT

/TRL/XDE_ED_INVITE_STATUS_TEXT

Описание кода статуса отношений партнерства между контрагентами

Типы таблиц

Табличный тип набора данных для контрагентов

Табличный тип /TRL/XDE_T_CONTRACTOR для структуры /TRL/XDE_S_CONTRACTOR

Табличный тип набора фильтров по контрагентам

Табличный тип /TRL/XDE_T_CONTRACTORFILTER для структуры /TRL/XDE_S_CONTRACTORFILTER.

Табличный тип с отношениями партнерства между контрагентами

Табличный тип /TRL/XDE_T_DEB_REL для структуры /TRL/XDE_DEB_REL. Строка одноименной таблицы.

Табличный тип с набором данных по обмену приглашениями

Табличный тип /TRL/XDE_T_INVITE_MAIN_ALV для структуры главного экрана отчёта /TRL/XDE_INVITE. Тип строки /TRL/XDE_S_INVITE_MAIN_ALV.

Табличный тип с набором данных для отправки новых приглашений

Табличный тип /TRL/XDE_T_INVITE_NEW_INV_ALV для структуры главного экрана ФМ /TRL/XDE_SEND_NEW_INVITATIONS для отправки новых приглашений. Тип строки /TRL/XDE_S_INVITE_NEW_INV_ALV.

Структуры

Фильтр по контрагентам

Структура /TRL/XDE_S_CONTRACTORFILTER для фильтрации по контрагентам.

Содержит ИНН и КПП.

Основные данные для обмена приглашениями

Структура /TRL/XDE_S_INVITE_MAIN_ALV главного экрана отчёта /TRL/XDE_INVITE.

Таблица 297 /TRL/XDE_S_INVITE_MAIN_ALV

Компонент

Тип

Описание

ID_OED

/TRL/XDE_ED_ID_OED

Код оператора ЭД

BUKRS

BUKRS

Балансовая единица

NAME1

NAME1_GP

Имя дебитора

KUNNR

KUNNR

Номер дебитора

LIFNR

LIFNR

Номер счета поставщика или кредитора

STCD1

STCD1

ИНН

STCD3

STCD3

КПП

FNS_ID

/TRL/XDE_ED_ID_KAG

Налоговый идентификатор контрагента ЭДО

DATUM

/TRL/XDE_ED_CHANDA

Дата регистрации

UZEIT

/TRL/XDE_ED_CHANTI

Время регистрации

STATUS

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

TEXT

/TRL/XDE_ED_INVITE_STATUS_TEXT

Описание кода статуса отношений партнерства между контрагентами

ROAMING_ID_OED

/TRL/XDE_ED_ID_OED

Код роумингового оператора ЭД

Основные данные для отправки новых приглашений

Структура /TRL/XDE_S_INVITE_NEW_INV_ALV главного экрана ФМ /TRL/XDE_SEND_NEW_INVITATIONS.

Таблица 298 /TRL/XDE_S_INVITE_NEW_INV_ALV

Компонент

Тип

Описание

BUKRS

BUKRS

Балансовая единица

NAME1

NAME1_GP

Имя дебитора

KUNNR

KUNNR

Номер дебитора

LIFNR

LIFNR

Номер счета поставщика или кредитора

STCD1

STCD1

ИНН

STCD3

STCD3

КПП

ID_OED

/TRL/XDE_ED_ID_OED

Код оператора ЭД

OED_PO_NAME

/TRL/XDE_ED_PO_NAME

Наименование ПО ОЭД

FNS_ID

/TRL/XDE_ED_ID_KAG

Код роумингового оператора ЭД

EMAIL

AD_SMTPADR

Адрес электронной почты

Элементы данных

Индекс таблицы статусов контрагента

/TRL/XDE_ED_INDEX – INT4.

Действие для смены статуса приглашения

/TRL/XDE_ED_INVITE_ACTION

Код действия для смены статуса приглашения – домен /TRL/XDE_DM_INVITE_ACTION.

Статус отношений партнерства между контрагентами

/TRL/XDE_ED_INVITE_STATUS – CHAR3.

Описание кода статуса отношений партнерства между контрагентами

/TRL/XDE_ED_INVITE_STATUS_TEXT – TEXT60.

Сообщение об ошибке

/TRL/XDE_ED_MESSAGE – CHAR255.

Домены

Код действия для смены статуса приглашения

/TRL/XDE_DM_INVITE_ACTION

Тип данных CHAR, длина 6.

Диапазон значений:

  • SEND - Отправка приглашения

  • ACCEPT - Принятие приглашения

  • REVOKE - Отзыв приглашения

  • REJECT - Отклонение приглашения

  • BREAK - Разрыв связи с контрагентом

  • FRIEND - Отношения партнерства подтверждены

  • Пусто – Для статусов, не нуждающихся в обработке

Объекты блокировок

Объект блокировки таблицы отношений партнерства между контрагентами

Объект блокировки таблицы /TRL/XDE_DEB_REL.

Параметры блокировки по первичному ключу.

Библиотека классов

Классы исключений

Основной абстрактный класс исключений

Абстрактный класс исключений для обмена приглашениями /TRL/CX_XDE_INVITATIONS.

Обработка ошибок во время обработки приглашений

Класс исключений для обработки ошибок во время действий над приглашениями /TRL/CX_XDE_INVITATIONS_CHECK, преимущественно во время проверок.

Обработка ошибок при работе с базой данных

Класс исключений для обработки ошибок при работе с БД во время обмена приглашениями /TRL/CX_XDE_INVITATIONS_DB.

Обработка ошибок при работе с REST

Класс исключений для обработки ошибок при работе с REST - /TRL/CX_XDE_INVITATIONS_REST.

Класс по работе с таблицей отношений партнерства между контрагентами

Основной класс для операций с таблицей отношений партнерства между контрагентами

/TRL/XDE_CL_DEB_REL_PROCESSING – класс по работе с таблицей /TRL/XDE_DEB_REL.

Таблица 299 Методы /TRL/XDE_CL_DEB_REL_PROCESSING

Имя метода

Вид

Видимость

Описание

ENQUEUE_RECORD

Static Method

Public

Заблокировать запись в таблице /TRL/XDE_DEB_REL

DEQUEUE_RECORD

Static Method

Public

Разблокировать запись в таблице /TRL/XDE_DEB_REL

INSERT_RECORD

Static Method

Public

Создать запись в таблице /TRL/XDE_DEB_REL

UPDATE_RECORD

Static Method

Public

Обновить запись в таблице /TRL/XDE_DEB_REL

READ_DEB_REL

Static Method

Public

Считать данные из таблицы /TRL/XDE_DEB_REL

Примечание

Все методы, кроме READ_DEB_REL, в качестве входного параметра принимают структуру типа /TRL/XDE_DEB_REL.

Метод READ_DEB_REL позволяет получить нужные записи из таблицы /TRL/XDE_DEB_REL с ограничениями с помощью входных параметров.

Входные параметры:

  • IT_BOX_ID – тип /TRL/XDE_T_RANGE

  • IT_INN - тип /TRL/XDE_T_RANGE

  • IT_KPP - тип /TRL/XDE_T_RANGE

  • IT_BUKRS - тип /TRL/XDE_T_RANGE

  • IT_ID_OED - тип /TRL/XDE_T_RANGE

  • IT_STATUS - тип /TRL/XDE_T_RANGE

Выходные параметры:

  • ET_DEB_REL – тип /TRL/XDE_T_DEB_REL

Класс по работе с приглашениями

Абстрактный класс обработчик приглашений /TRL/XDE_CL_INVITATIONS.

Имеет базовую реализацию работы с приглашениями для всех операторов.

Таблица 300 Методы /TRL/XDE_CL_INVITATIONS

Имя метода

Вид

Видимость

Описание

GET_CONTRACTOR

Instance Method

Protected

Получить данные по контрагентам

GET_CONTRACTOR_FORMLIST

Instance Method

Protected

Получить данные по контрагентам для новых приглашений

CONSTRUCTOR

Instance Method

Public

CONSTRUCTOR

SEND_INVITE

Instance Method

Protected

Отправить приглашение контрагенту

ACCEPT_INVITE

Instance Method

Protected

Принять приглашение от контрагента

REJECT_INVITE

Instance Method

Protected

Отклонить приглашение от контрагента

REVOKE_INVITE

Instance Method

Protected

Отозвать приглашение контрагенту

BREAK_RELATION

Instance Method

Protected

Прекратить отношения партнерства с контрагентом

GET_INSTANCE

Static Method

Public

Получить объект нужного класса-наследника

По умолчанию конкретный обработчик при действиях ACCEPT, SEND, REJECT, REVOKE, BREAK вызывает реализацию класса родителя.

Конкретная реализация работы с приглашениями, отличная от стандартной, внедренной в классе /TRL/XDE_CL_INVITATIONS, может быть внедрена в наследниках:

  • /TRL/XDE_CL_INVITATION_2AL

  • /TRL/XDE_CL_INVITATION_2BE

  • /TRL/XDE_CL_INVITATION_2BK

  • /TRL/XDE_CL_INVITATION_2BM

  • /TRL/XDE_CL_INVITATION_2IG

  • /TRL/XDE_CL_INVITATION_2IJ

  • /TRL/XDE_CL_INVITATION_2LD

API

/TRL/XDE_CL_INVITATION_API - API класс для работы с приглашениями. Предоставляет основной функционал для обработки операций над приглашениями вне стандартного отчёта /TRL/XDE_INVITE.

Таблица 301 Константы

Имя атрибута

Видимость

Вид

Описание

Нач. знач.

GC_ACCEPT_ACTION

Public

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

ACCEPT

GC_BREAK_ACTION

Public

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

BREAK

GC_FRIEND_ACTION

Public

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

FRIEND

GC_REJECT_ACTION

Public

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

REJECT

GC_REVOKE_ATION

Public

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

REVOKE

GC_SEND_ACTION

Public

/TRL/XDE_ED_INVITE_ACTION

Действие для смены статуса приглашения

SEND

GC_STS_CD

Public

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

CD

GC_STS_CDI

Public

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

CDI

GC_STS_CDO

Public

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

CDO

GC_STS_CX

Public

/TRL/XDE_ED_INVITE_STATUS

Статус отношений партнерства между контрагентами

CX

GC_LIMIT_LIFNR

Public

CHAR1

Ограничение выборки по кредитору

L

GC_LIMIT_KUNNR

Public

CHAR1

Ограничение выборки по дебитору

K

GC_LIMIT_ALL

Public

CHAR1

Отсутствие огр. выборки

A

MC_ACCEPT_ACTVT

Private

/TRL/XDE_ED_ACTVT

Код функции

32

MC_BREAK_ACTVT

Private

/TRL/XDE_ED_ACTVT

Код функции

35

MC_REJECT_ACTVT

Private

/TRL/XDE_ED_ACTVT

Код функции

33

MC_REVOKE_ACTVT

Private

/TRL/XDE_ED_ACTVT

Код функции

34

MC_SEND_ACTVT

Private

/TRL/XDE_ED_ACTVT

Код функции

31
Таблица 302 Типы

Имя типа

Тип

Описание

MTY_S_OED_INV

S

  • id_oed TYPE /trl/xde_box_id-id_oed

  • obj_ref TYPE REF TO /trl/xde_cl_invitations

MTY_T_OED_INV

T

HASHED TABLE OF mty_s_oed_inv, ключ – ID_OED

MTY_T_OED_TAB

T

SORTED TABLE OF /trl/xde_box_id-id_oed, ключ – TABLE_LINE

MTY_S_SELF_BOX

S

  • id_box TYPE /trl/xde_box_id-id_box

  • id_oed TYPE /trl/xde_box_id-id_oed

MTY_T_SELF_BOX

T

SORTED TABLE OF mty_s_self_box, ключ – ID_BOX

MTY_S_INVITATION

S

  • bukrs TYPE bukrs

  • id_oed TYPE /trl/xde_box_id-id_oed

  • inn TYPE /trl/xde_ed_innul

  • kpp TYPE /trl/xde_ed_kpp

MTY_T_INVITATION

T

TABLE OF mty_s_invitation

MTY_T_INV_CON

T

TABLE OF /trl/xde_inv_con, ключ - DEFAULT

MTY_T_RETURN

T

TABLE OF /trl/xde_return

MTY_T_INV_STS

T

SORTED TABLE OF /trl/xde_inv_sts WITH NON-UNIQUE KEY action

MTY_S_SAP_CONTRACTOR

S

  • bukrs TYPE bukrs

  • lifnr TYPE lfa1-lifnr

  • kunnr TYPE kna1-kunnr

  • name1 TYPE kna1-name1

  • stcd1 TYPE kna1-stcd1

  • stcd3 TYPE kna1-stcd3

MTY_T_SAP_CONTRACTOR

T

TABLE OF mty_s_sap_contractor

MTY_T_DEB_REL

T

TABLE OF /trl/xde_deb_rel, ключ – BOX_ID, INN, KPP

MTY_T_OED_BX

T

TABLE OF /trl/xde_oed_bx WITH DEFAULT KEY

MTY_T_OED_BXT

T

TABLE OF /trl/xde_oed_bxt WITH DEFAULT KEY

MTY_T_BOX_ID

T

TABLE OF /trl/xde_box_id WITH DEFAULT KEY
Таблица 303 Атрибуты

Имя атрибута

Вид

Видимость

Тип

MT_BOX_ID_SYNC

Instance Attribute

Private

MTY_T_BOX_ID

MT_BOX_ID_SYNC_MOD

Instance Attribute

Private

MTY_T_BOX_ID

MT_INV_CON

Instance Attribute

Private

MTY_T_INV_CON

MT_INV_STS

Instance Attribute

Private

MTY_T_INV_STS

MT_OED_BXT_SYNC_MOD

Instance Attribute

Private

MTY_T_OED_BXT

MT_OED_BX_SYNC

Instance Attribute

Private

MTY_T_OED_BX

MT_OED_BX_SYNC_MOD

Instance Attribute

Private

MTY_T_OED_BX
Таблица 304 Методы

Имя метода

Вид

Видимость

Описание

COMMIT_DB_CHANGES

Instance Method

Public

COMMIT

COMMON_REFRESH

Instance Method

Public

Обновление отношений партнерства по всем операторам

CONSTRUCTOR

Instance Method

Public

CONSTRUCTOR

FORM_LIST

Instance Method

Public

Сформировать список контрагентов для обмена

GET_DEB_REL_LINES

Instance Method

Public

Обёртка для CL_DEB_REL_PROCESSING -> READ_DEB_REL

GET_HISTORY

Instance Method

Public

Получить историю статусов с контрагентом

GET_STATUS_TEXT

Instance Method

Public

Получить наименование статуса

PROCESS_INVITATIONS

Instance Method

Public

Обработка таблицы с приглашениями

REFRESH_STATUS

Instance Method

Private

Обновление отношений партнерства

BOXES_SYNC

Instance Method

Private

Синхронизация ящиков контрагентов

BOXES_SYNC_INSERT

Instance Method

Private

Обновление BOX_ID и OED_BX+OED_BXT

BOXES_SYNC_PREPARE

Instance Method

Private

Подготовка данных для синхронизации ящиков

CHECK_STATUS

Instance Method

Private

Проверка возможности смены статуса

FILL_PARAMETER_REFERENCES

Instance Method

Private

Заполнение атрибутов для вызова метода REST

GET_ACTVT

Instance Method

Private

Получить ACTVT для обработки приглашения по действию

GET_ALL_OED

Instance Method

Private

Получить всех операторов

GET_INSTANCES

Instance Method

Private

Получение объектов для работы с REST (по операторам)

GET_KEY_RANGES

Instance Method

Private

Сбор RANGE для получения строк DEB_REL

GET_PROCESS_METHOD

Instance Method

Private

Получение метода для работы с приглашением

GET_SELF_BOXES

Instance Method

Private

Получить собственные ящики

GET_STATUS_BY_ACTION

Instance Method

Private

Получить статус из INV_STS по действию INVITE_ACTION

PREPARE_INVITATION_DATA

Instance Method

Private

Подготовка данных для обработки приглашения

PROCESS_INVITATION

Instance Method

Private

Обработка приглашения

Примечание

Подробное описание по работе с API - см. Фунциональное описание API для обмена приглашениями

Программы

Отчёт, предоставляющий основной функционал по обмену приглашениями - /TRL/XDE_INVITE.

Привязан к транзакции /TRL/XDE_INVITE.

Группы функций

Ведение ракурсов

/TRL/FG_XDE_IN30 - группа функций с автоматически сгенерированными функциональными модулями для ведения ракурсов таблиц /TRL/XDE_INV_STS, /TRL/XDE_IN_CON.

Работа с таблицей отношений партнерства между контрагентами и новыми приглашениями

/TRL/FG_XDE_INVITE - группа функций, содержащая в себе функциональные модули для обновления таблицы /TRL/XDE_DEB_REL.

Дополнительно содержится функциональный модуль для отправки новых приглашений.

Вставка данных в таблицу отношений партнерства между контрагентами

/TRL/XDE_DEB_REL_INSERT - выполняет вставку строки типа /TRL/XDE_DEB_REL в таблицу.

Таблица 305 Параметры IMPORTING

Имя параметра

Тип

Описание

IS_DEB_REL

/TRL/XDE_DEB_REL

Структура вида строки таблицы /TRL/XDE_DEB_REL

Обновление данных в таблице отношений партнерства между контрагентами

/TRL/XDE_DEB_REL_UPDATE - выполняет обновление строки типа /TRL/XDE_DEB_REL в таблице.

Таблица 306 Параметры IMPORTING

Имя параметра

Тип

Описание

IS_DEB_REL

/TRL/XDE_DEB_REL

Структура вида строки таблицы /TRL/XDE_DEB_REL

Формирование списка новых приглашений для отправки

/TRL/XDE_SEND_NEW_INVITATIONS - функциональный модуль для отображения таблицы приглашений, которые могут быть отправлены на текущий момент, также возвращает таблицу с данными дебиторов и кредиторов для отправки.

На селекционном экране имеется возможность ограничить выборку.

Таблица 307 Параметры EXPORTING

Имя параметра

Тип

Описание

ET_INVITES

/TRL/XDE_T_INVITE_NEW_INV_ALV

Набор новых приглашений

Транзакции

/TRL/XDE_INVITE - транзакция связана с отчетом /TRL/XDE_INVITE и предоставляет функционал для обмена приглашениями.