Ansicht
Dokumentation

CL_COND_DATACONTAINER - Konditionen: generischer Datencontainer

ROGBILLS - Synchronize billing plans   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Die Klasse CL_COND_DATACONTAINER bietet die Möglichkeit, den Datenteil einer Verwendung der Konditionstechnik in ein einheitliches Format zu bringen. Jede Tabelle des Datenteils wird dabei durch ein eigenes Datenobjekt repräsentiert. Jedes Datenobjekt besitzt Eigenschaften, z.B. ein übergeordnetes Datenobjekt und eine Kardinalität. Darüber sind auch die Beziehungen der Datenobjekte untereinander definiert, so dass diese Datenobjekte insgesamt eine Hierarchie bilden.

Zur Erzeugung einer Instanz stehen zwei statische Methoden zur Verfügung:

• CREATE_BY_USAGE

Diese Methode erzeugt für eine Verwendung die passende Instanz. Dabei ist zu beachten, dass für diese Verwendung die Methode IF_COND_USAGE_BADI_MAINTENANCE~GET_DATAPART_DESCRIPTION des BAdIs COND_USAGE_BADI implementiert ist. Ohne diese Implementierung kann keine Instanz erzeugt werden und die Ausnahme BADI_NOT_IMPLEMENTED wird ausgelöst.

• GET_INSTANCE

Diese Methode erzeugt anhand der übergebenen Meta-Daten zur Beschreibung des Datenteils eine Instanz. Diese Methode ist zur internen Verwendung gedacht, vorzugsweise sollte daher die Methode CREATE_BY_USAGE benutzt werden.

Es stehen folgende Instanzmethoden zur Verfügung:

• Methoden zur Arbeit mit einem Datenobjekt

• SET_DATA

Übergibt die Datensätze der Tabelle IT_DATA dem Datenobjekt, dessen Name mit I_NAME spezifiziert wurde. Mit dem Parameter I_OVERWRITE wird gesteuert, ob die bisherigen Datensätze des Datenobjektes dabei vollständig überschrieben werden sollen. Der Zeilentyp von IT_DATA muss zum jeweiligen Datenobjekt passen.

• SET_DATA_REF

Diese Methode funktioniert wie SET_DATA, die Tabellendaten müssen jedoch per Referenz (Parameter I_DATAREF) übergeben werden.

• GET_DATA

Holt die Datensätze aus dem Datenobjekt ab, dessen Name mit I_NAME spezifiziert wurde. Die Daten werden in die Tabelle ET_DATA gestellt, welche einen passenden Zeilentyp aufweisen muss.

• GET_DATA_REF

Diese Methode funktioniert wie GET_DATA, die Daten werden jedoch als Referenz auf eine Kopie zurückgegeben. Die Kopie wird zu diesem Zweck dynamisch erzeugt und ist eine Standard-Tabelle.

• RESET_DATAOBJECT

Entfernt alle Datensätze aus dem Datenobjekt. Das Datenobjekt ist danach "leer".

Zusätzlich steht die Methode GET_DATAOBJECT zur Verfügung, mit welcher man direkt auf das Datenobjekt zugreifen kann, um speziellere Operationen durchzuführen.

• Methoden für die Hierarchie der Datenobjekte

• GET_SUPERORDINATED_DATAOBJECT

Wie GET_DATAOBJECT, liefert jedoch das übergeordente Datenobjekt zurück.

• GET_SUBORDINATED_DATAOBJECTS

Liefert zum angegebenen Datenobjekt alle untergeordneten Datenobjekte zurück, entweder als Tabelle von Objektreferenzen oder als Tabelle von Datenobjektnamen.

• IS_DATAOBJECT_MANDATORY

Liefert einen Wahrheitswert zurück, ob das Datenobjekt obligatorisch ist, d.h. zu jedem Datensatz des vorhergehenden (übergeordneten) Datenobjektes muss wenigstens ein Datensatz existieren.

• IS_DATAOBJECT_MULTIPLE

Liefert einen Wahrheitswert zurück, ob das Datenobjekt mehrfach ist, d.h. zu jedem Datensatz des vorhergehenden (übergeordneten) Datenobjektes können mehrere Datensätze existieren.

• GET_CONTAINER_STRUCTURE

Liefert die Struktur der im Datencontainer enthaltenen Datenobjekte zurück. Zu jedem Datenobjekt werden die folgenden Informationen ermittelt:

object_level,,,,,,Stufe des Datenobjektes (ROOT = 0)

object_name,,,,,,Name des Datenobjektes

parent_object,,,,,,Name des vorhergehenden (übergeordneten) Datenobjektes

is_mandatory,,,,,,Datenobjekt ist obligatorisch

is_multiple,,,,,,Datenobjekt ist mehrfach

• GET_ALL_DATA_REF

Liefert eine Tabelle mit den Namen und Datenreferenzen aller Datenobjekte zurück. Die Datenreferenzen zeigen auf Standard-Tabellen, die die Kopien aller Datensätze eines Datenobjektes enthalten.

• Weitere Methoden

• CHANGE_RECORD_NUMBER

Verändert die Konditionssatznummer (von alt nach neu), falls diese im Schlüssel der Datensätze vorkommt.

• ENABLE_AUTOMATIC_NUMBER_CHANGE

Beziehungen

Beispiel

Hinweise

Weiterführende Informationen

BAL_S_LOG - Application Log: Log header data   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6362 Date: 20240419 Time: 210009     sap01-206 ( 81 ms )