Operacje i komendy dotyczące obiektów biznesowych interfejsu BAPI

Obiekty biznesowe interfejsu BAPI obsługują operacje i komendy. Operacja dotycząca obiektu biznesowego BAPI określa wywołanie BAPI, które należy wykonać w systemie SAP dla tego obiektu. Metoda BAPI określa operację, która jest z nią powiązana. Komenda obiektu biznesowego interfejsu BAPI określa stan obiektu.

Obsługiwane operacje

Operacje obiektu biznesowego są wywoływane przez komponent kliencki, który wykonuje wywołania do systemu SAP za pośrednictwem adaptera. Wywołania do systemu SAP są tworzone przy użyciu interfejsów API SAP JCo.

W poniższej tabeli zdefiniowano operacje obsługiwane przez adapter.
Uwaga: Definicje znajdujące się na liście w tabeli to oczekiwane sposoby użycia operacji. Akcja podejmowana przez aplikację SAP zależy od znaczenia samego interfejsu BAPI.
Tabela 1. Obsługiwane operacje: Obiekty biznesowe interfejsu BAPI
Operacja Definicja
After-Image Create Tworzy nową jednostkę w systemie SAP zgodną z danymi i strukturą wejściowego obiektu biznesowego. Obiekt biznesowy zwracany przez tę operację odzwierciedla nowo utworzoną jednostkę w systemie SAP.
After-Image Update with Delete Specjalna postać operacji UpdateWithDelete zapewniająca większą wydajność. Operacja ta zawsze wymaga struktury ChangeSummary, która powinna zawierać informacje o tworzeniu i usuwaniu na poziomie obiektu biznesowego. Umożliwia to adapterowi wykonywanie operacji bez konieczności pobierania istniejących wpisów z systemu SAP i dokonywania porównań, ponieważ struktura ChangeSummary wskazuje czynności do wykonania. Jeśli struktura ChangeSummary jest pusta, adapter nie podejmuje w przypadku żądania żadnej akcji.
Retrieve Odbudowuje kompletną hierarchię obiektu biznesowego. Adapter zapewnia, że zwrócony hierarchiczny obiekt biznesowy będzie dokładnie zgodny ze stanem bazy danych jednostki aplikacji. Jako kryteriów można użyć wartości nie będących wartościami kluczy.

Akceptuje zarówno obraz po aktualizacji, jak i obiekt biznesowy. W obu przypadkach porównanie jest wykonywane tylko za pomocą równości.

Obiekt biznesowy żądania może zawierać następujące obiekty:

  • Obiekt biznesowy najwyższego poziomu, ale nie obiekty podrzędne, mimo że definicja obiektu biznesowego zawiera elementy podrzędne.
  • Obiekt biznesowy może zawierać obiekt biznesowy najwyższego poziomu i niektóre z jego zdefiniowanych elementów podrzędnych.
  • Kompletny, hierarchiczny obiekt biznesowy zawierający wszystkie podrzędne obiekty biznesowe.

Operacja Retrieve (pobierania) powinna zwracać pojedynczy, unikalny obiekt biznesowy, który spełnia kryteria zdefiniowane przez użytkownika. Wymagania, które należy spełnić przed wykonaniem operacji pobierania, całkowicie zależą od interfejsu BAPI. Spełnienie wszystkich wymagań interfejsu BAPI umożliwia pomyślne wykonanie pobrania.

After-Image Delete Usuwa istniejącą jednostkę z systemu SAP i wszystkie zawarte w niej jednostki podrzędne. Należy zauważyć, że w systemie SAP istnieje pojęcie usuwania logicznego, podczas którego rekord jest oznaczany jako usunięty, ale jednostka nadal istnieje. Jest to stosowane w pewnych przypadkach w celu zachowania integralności bazy danych, ponieważ do jednostki "usuniętej" istnieją odwołania w innych jednostkach. Zatem zachowanie operacji After-Image Delete (usunięcia obrazu po aktualizacji) zależy od wywołania BAPI.

W przypadku operacji, która nie jest obsługiwana lub nie jest zgodna z komendą na wykresie biznesowym, adapter rejestruje odpowiedni błąd i generuje wyjątek ResourceException.

Obsługiwane komendy

Poniższa tabela zawiera listę komend obsługiwanych przez adapter dla obiektów biznesowych interfejsu BAPI.

Tabela 2. Obsługiwane komendy: Obiekty biznesowe interfejsu BAPI
Komenda Definicja
Create Obiekt biznesowy najwyższego poziomu i wszystkie zawarte w nim obiekty podrzędne zostały utworzone (jeśli jest to zdarzenie przychodzące) lub powinny zostać utworzone w systemie SAP (jeśli jest to żądanie wychodzące).
UpdateWithDelete Obiekt biznesowy najwyższego poziomu został lub zostanie zmodyfikowany. Może to oznaczać dodanie lub usunięcie również elementów podrzędnych.
Delete Obiekt biznesowy najwyższego poziomu i wszystkie zawarte w nim elementy podrzędne zostały lub zostaną usunięte.

W przypadku komend, które nie są obsługiwane, adapter generuje błąd ResourceException.


Warunki używania |


(c) Copyright IBM Corporation 2005, 2006.
To Centrum informacyjne jest oparte na technologii Eclipse (http://www.eclipse.org)