Einlesen des führenden Objektes (SAP-Bibliothek)

Einlesen des führenden Objektes

Verwendung

Mit dieser Funktion können Sie das Objekt ermitteln, das durch das Workitem bearbeitet wird. Sie müssen das Objekt ermitteln, wenn Sie:

die Attribute dieses Objekts auf Ihrer Registerkarte anzeigen wollen
über das Objekt und seine Attribute weitere Daten aus Ihrer Anwendung ermitteln wollen
die Methoden auf diesem Objekt als Funktionen auf Ihrer Registerkarte anbieten wollen

Voraussetzungen

Sie müssen die Definition des Objekttyp mit seinen Attributen und Methoden kennen, um darauf zugreifen zu können.

Damit die Makrobefehle zur Container- und Objektbearbeitung zur Verfügung stehen, fügen Sie im TOP-Include Ihres Modulpools das Include <cntn01> ein:

include <cntn01>.

Funktionsumfang

Um das führende Objekt des Workitems zu lesen, verwenden Sie den Funktionsbaustein SAP_WAPI_GET_OBJECTS aus der SAP-WAPI-Schnittstelle. Sie finden alle freigegebenen Funktionsbausteine dieser Schnittstelle in der Funktionsgruppe SWRC .

Dieser Funktionsbaustein gibt in seinem Exportparameter LEADING_OBJECT neben anderen Informationen auch die (persistente) Objektreferenz auf das führende Objekt des Workitems zurück. Zur weiteren Auswertung müssen Sie diese Objektreferenz erst in ein Laufzeit-Handle konvertieren.

Beispiel

Wenn das führende Objekt Ihres Workitems vom Typ FORMABSENC (Abwesenheitsmitteilung) ist, verwenden Sie den Funktionsbaustein in einem PBO-Modul etwa wie folgt:

DATA: l_absenceform LIKE swr_object,
      l_runtime TYPE swc_object,
      l_object LIKE swotobjid.
[...]
*- ask frame dynpro for the ID of workitem
  CLEAR g_wi_id.
  swl_widisp_get_wi_id g_wi_id.

  CALL FUNCTION 'SAP_WAPI_GET_OBJECTS'
       EXPORTING
           workitem_id = g_wi_id
       IMPORTING
           leading_object = l_absenceform.

CLEAR l_runtime. CLEAR l_object.
MOVE l_absenceform-object_id TO l_object.
*- convert to runtime handle
swc_object_from_persistent l_object l_runtime.

*- out of the object we can get the data we want to show
swc_get_property l_runtime 'PersonnelNo' swl0attr-pernr.

In einem PAI-Modul, in dem Sie als Funktion einen Methodenaufruf implementieren wollen, verwenden Sie den Funktionsbaustein wie folgt:

DATA: l_absenceform LIKE swr_object,
      l_runtime TYPE swc_object,
      l_object LIKE swotobjid.
swc_container l_container.

CALL FUNCTION 'SAP_WAPI_GET_OBJECTS'
      EXPORTING
          workitem_id = g_wi_id
      IMPORTING
          leading_object = l_absenceform.

*- we show the absence form via it's display method...
  CLEAR l_runtime. CLEAR l_object.
  MOVE l_absenceform-object_id TO l_object.
*- convert to runtime handle
  swc_object_from_persistent l_object l_runtime.
*- call method
  swc_call_method_async l_runtime 'Display' l_container.