Бизнес-объекты BAPI поддерживают операции и глагольные команды. Операция бизнес-объекта BAPI задает вызов BAPI, выполняемый в системе SAP для данного объекта. Метод BAPI определяет связанную с ним операцию. Глагольная команда бизнес-объекта BAPI задает состояние этого объекта.
Операции бизнес-объекта вызываются компонентом клиента, который обращается к SAP через адаптер. Для обращения к системе SAP применяются интерфейсы API SAP JCo.
Операция | Определение |
---|---|
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.
Глагольная команда | Определение |
---|---|
Create | Если это входящее событие, то бизнес-объект верхнего уровня и все содержащиеся в нем дочерние объекты были созданы в SAP, а если это исходящий запрос, то они должны быть созданы в SAP. |
UpdateWithDelete | Бизнес-объект верхнего уровня был или должен быть изменен; допустимо также добавление или удаление дочерних объектов. |
Delete | Бизнес-объект верхнего уровня и все дочерние объекты, которые он содержит, были или должны быть удалены. |
Для неподдерживаемых глагольных команд адаптер генерирует ситуацию ResourceException.
(c) Copyright IBM Corporation 2005, 2006.
Данная справочная система Information Center создана на основе технологии Eclipse (http://www.eclipse.org)