Ansicht
Dokumentation

SWW_CONT_OBJECTS_RELATE - Obsolet: Verknüpfen von Objekten über einen Container (Retail)

PERFORM Short Reference   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der FB verknüpft das Object BASIC_OBJECT über einen Container mit den in der Tabelle OBJECTS_TO_BE_RELATED gegebenen Objekten. Das BASIC_OBJECT erhält dabei im Container den Namen BASIC_OBJECT_ELEMENT, falls ein solcher übergeben wird, ansonsten den Namen _WI_RELATION.

Dazu testet der FB zunächst, ob bereits eine Verknüpfung auf Basis von BASIC_OBJECT vorliegt. Über den Parameter WI_TYPE kann gesteuert werden, über welchen Workitem-Typ die Verknüpfung gesucht werden soll. Falls ein BASIC_OBJECT_ELEMENT angegeben ist, so gilt dieser Elementname als zusätzliches Suchkriterium.

Ist noch keine Verknüpfung vorhanden, so wird eine solche durch Aufruf des FB SWW_CI_CREATE neu eingeführt. Neue Verknüpfungen werden also grundsätzlich über den Workitem-Typ C etabliert.

Ist bereits eine Verknüpfung vorhanden, so wird der zugehörige Container um die neuen Elemente erweitert, doppelte Elemente werden eliminiert (es verbleibt nur der aktuellere Eintrag), die alten verknüpften Objekte bleiben bestehen.

Über den Parameter DO_COMMIT kann gesteuert werden, ob der FB selbst committen soll, oder ob der Aufrufer die Commitkontrolle behalten will. In diesem Fall muß er nachfolgend selbst COMMIT WORK und unmittelbar davor den FB SWW_WI_LOG_FLUSH (keine Parameter, keine Exceptions) aufrufen.

Ist mehr als eine Verknüpfung mit den gegebenen Suchkriterien vorhanden, so wird die Ausnahme MANY_WORKITEMS_FOUND ausgelöst.

Falls das Etablieren der Verknüpfung über SWW_CI_CREATE nicht gelingt, wird die Ausnahme RELATION_NOT_CREATED ausgelöst.

Über den Parameter RELATION_ID wird die ID des Workitems, über das die Verknüpfung realisiert wird, zurückgegeben.

Beispiel

Hinweise

Weiterführende Informationen

Parameter

BASIC_OBJECT
BASIC_OBJECT_ELEMENT
DO_COMMIT
OBJECTS_TO_BE_RELATED
RELATION_ID
WI_TYPE

Ausnahmen

MANY_WORKITEMS_FOUND
RELATION_NOT_CREATED

Funktionsgruppe

SWW_COMPATIBLE

CL_GUI_FRONTEND_SERVICES - Frontend Services   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 2607 Date: 20240523 Time: 101741     sap01-206 ( 52 ms )