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.
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.
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: 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.
Poniższa tabela zawiera listę komend obsługiwanych przez adapter dla obiektów biznesowych 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.
(c) Copyright IBM Corporation 2005, 2006.
To Centrum informacyjne jest oparte na technologii Eclipse (http://www.eclipse.org)