Введение

Разработчику на ABAP часто приходится работать со списками сообщений (message), осуществляя определённые процедуры, например:

• Проверять списки на наличие сообщений об ошибке (e.g. при вызове BAPI ФМ).

• Выводить список полученных сообщений (отформатированный) для просмотра их пользователем.

• Сохранять список сообщений в лог (как правило, стандартный лог, транзакция SLG1).

Обычно такие задачи каждый программист решает ad hoc, Z кодом. Иногда используются разные Sap - модули, довольно часто используется ГФ SAPLSMSG (ФМ MESSAGE_STORE и другие). Эта ГФ широко задействована в SD. Она позволяет накапливать сообщения и выводить их список в виде pop-up окна. Но я бы не сказал, что ее использование сильно облегчает жизнь.

Авторское Решение

Организация интерфейса

Я предлагаю для работы с сообщениями использовать интерфейс IF_RECA_MESSAGE_LIST. Этот интерфейс (и его имплементация) реализованы в рамках модуля RE-FX (модуль этот сравнительно молод, написан единообразно, по новейшим технологиям, очень удобен в разработке и полон прекрасных решений, применимых в других модулях и в собственных разработках).

Имплементация интерфейса IF_RECA_MESSAGE_LIST основана на ГФ SBAL, обслуживающей стандартный SAP лог. Это позволяет с легкостью сохранять сообщения в БД вызовом метода STORE.

Получить ссылку на объект следует методом CREATE фабрики CF_RECA_MESSAGE_LIST. Если вы не собираетесь сохранять сообщения в БД – параметры метода CREATE для вас не важны (в параметрах там объект и подобъект лога SLG1).

Методика работы

Загрузка сообщения в коллектор

Самый удобный способ положить сообщение в коллектор – метод ADD_SYMSG. Т.е. что-то такое:

Data: lo_msg type ref to IF_RECA_MESSAGE_LIST, dummy.

Lo_msg = CF_RECA_MESSAGE_LIST=>CREATE( ).

Message e123 into dummy.

Lo_msg-> ADD_SYMSG( ).

Но можно добавить сообщение вручную методом ADD.

Если вы работаете с BAPI, – есть очень удобный метод ADD_FROM_BAPI, забирающий сообщения из структуры/таблицы BAPIRET2 (N.B! Вы сразу, по выходным параметрам узнаете есть ли E и W сообщения). Вот его интерфейс (Рис.1):

Рис.1 Интерфейс метода ADD_FROM_BAPI

Если используется объект исключения (type ref to CX_ROOT), – нужен метод ADD_FROM_EXCEPTION.

И сообщения из другой инстанции коллектора можно перелить методом ADD_FROM_INSTANCE.

N.B! Если вы посмотрите интерфейс методов ADD или ADD_SYMSG, вы увидите массу необязательных параметров, помимо данных сообщения (Рис.2):

Рис.2 Интерфейс методов ADD_SYMSG

Эти параметры используются в RE-FX, но могут быть полезны и в Z разработках, e.g. ID_TABNAME и ID_FIELDNAME – для привязки к контексту, или ID_CUSTACT – для выхода в SPRO.

Получение информации из коллекторов

Имеется множество методов для получения информации о сообщениях в коллекторе и извлечения их. Один из самых удобных – метод RAISE_FIRST_MESSAGE. Т.е. вам нужно знать, есть ли сообщение об ошибке и сразу получить оное. Вы вызываете метод (Рис.3.):