Операции и глагольные команды бизнес-объектов BAPI

Бизнес-объекты BAPI поддерживают операции и глагольные команды. Операция бизнес-объекта BAPI задает вызов BAPI, выполняемый в системе SAP для данного объекта. Метод BAPI определяет связанную с ним операцию. Глагольная команда бизнес-объекта BAPI задает состояние этого объекта.

Поддерживаемые операции

Операции бизнес-объекта вызываются компонентом клиента, который обращается к SAP через адаптер. Для обращения к системе SAP применяются интерфейсы API SAP JCo.

Определения операций, поддерживаемых адаптером, содержатся в следующей таблице.
Прим.: Обратите внимание, что это предположительное назначение операций. Действие, предпринимаемое в приложении SAP, зависит от значения самого интерфейса BAPI.
Табл. 1. Поддерживаемые операции - Бизнес-объекты BAPI
Операция Определение
After-Image Create Создает в SAP новый сущностный EJB, который соответствует данным и структуре входного бизнес-объекта. Бизнес-объект, возвращаемый этой операцией, отражает сущностный EJB, вновь созданный в SAP.
After-Image Update with Delete Специальная форма операции UpdateWithDelete, которая обеспечивает более высокую производительность. Для нее всегда требуется параметр ChangeSummary, который должен включать информацию уровня бизнес-объектов о создании и удалении. Это позволяет адаптеру выполнять операции, не извлекая из SAP существующие сущностные EJB для сравнения, поскольку ChangeSummary указывает, что должно быть сделано. Если ChangeSummary содержит пустое значение, адаптер не выполняет никакого действия по запросу.
Retrieve Заново создает полную иерархию бизнес-объекта. Адаптер гарантирует, что возвращаемый иерархический бизнес-объект в точности соответствует состоянию базы данных EJB приложения. В качестве критериев можно использовать значения, не являющиеся ключами.

Принимает или новую запись, или бизнес-объект. В обоих случаях при сравнении проверяется только равенство.

Бизнес-объект запроса может содержать любой из следующих бизнес-объектов:

  • Бизнес-объект верхнего уровня, но без дочерних объектов, даже если они входят в определение этого бизнес-объекта
  • Бизнес-объект, который содержит бизнес-объект верхнего уровня и часть потомков, включенных в его определение
  • Полный иерархический бизнес-объект, содержащий все дочерние бизнес-объекты

Операция Retrieve возвращает единственный уникальный объект, удовлетворяющий пользовательским критериям. Необходимое условие для выполнения операции retrieve полностью зависит от BAPI. BAPI считает “необходимым” все то, что позволяет операции retrieve быть успешно выполненной.

After-Image Delete Удаляет из SAP существующий сущностный EJB и все содержащиеся в нем дочерние сущностные EJB. Обратите внимание, что SAP включает концепцию логического удаления, в соответствии с которой запись помечается как удаленная, но сущностный EJB все еще существует. В некоторых случаях это делается для сохранения целостности базы данных, поскольку на “удаленный” объект есть ссылки в других объектах. Следовательно, поведение операции After-Image Delete зависит от вызова BAPI.

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

Поддерживаемые глагольные команды

В следующей таблице перечислены глагольные команды, поддерживаемые адаптером для бизнес-объектов интерфейса BAPI.

Табл. 2. Поддерживаемые глагольные команды - Бизнес-объекты BAPI
Глагольная команда Определение
Create Если это входящее событие, то бизнес-объект верхнего уровня и все содержащиеся в нем дочерние объекты были созданы в SAP, а если это исходящий запрос, то они должны быть созданы в SAP.
UpdateWithDelete Бизнес-объект верхнего уровня был или должен быть изменен; допустимо также добавление или удаление дочерних объектов.
Delete Бизнес-объект верхнего уровня и все дочерние объекты, которые он содержит, были или должны быть удалены.

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


Условия использования |


(c) Copyright IBM Corporation 2005, 2006.
Данная справочная система Information Center создана на основе технологии Eclipse (http://www.eclipse.org)