Ansicht
Dokumentation
/SAPCND/ARC_SELECT_OW - Selektion von Konditionssätzen in den Puffer der Konditionspflege
ABAP Short Reference TXBHW - Original Tax Base Amount in Local CurrencyDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Selektiert Konditionssätze von der DB in den Puffer der Konditionspflege zur Konditionspflege-Sitzungs-ID. Bereits im Puffer der Konditionspflege-Sitzung befindliche Sätze werden durch den FB überschrieben.
Ein Aufruf des FB '/SAPCND/MNT_INIT_OW' vorher ist zwingend. Die Konditionssätze können dann danach mit FB '/SAPCND/GET_WORKING_SET_OW' aus dem Puffer der Konditionspflege abgeholt werden.
Eingabe-Parameter:
I_HSESSION
Session handle der Konditionspflege: wird beim Initialisieren mit /SAPCND/MNT_INIT_OW geholt.
I_HLOG
Anwendungs-Log, in welches Meldungen geschrieben werden. Es wird bereits beim Initialisieren mit /SAPCND/MNT_INIT_OW verwendet; muss aber nicht notwendigerweise dasselbe sein.
Für gelöscht markierte Konditionssätze werden i.d.R. keine Meldungen geschrieben, ausser die Methode PREVENT_PROCESSING_DELETED_WSI ergibt ' ' bei eingestellter R/3-Kompatibilität.
I_MAINTENANCE_MODE
Anfordern der Sätze für die Anzeige (A) oder Pflege (B). Für spezielle Fälle kann auch ein Anfordern der Sätze als nur-Anzeige sinnvoll sein. Derart selektierte Sätze können durch einen späteren Aufruf von /SAPCND/MNT_ADAPT_LOCKS_OW nicht in den Änderungsmodus wechseln.
I_SELECTION_MODE
Gibt an, ob die selektierten Sätze dem session working set (Puffer) hinzugefügt (= 'A') oder entfernt (= 'B') werden sollen.
I_GROUPNAME
Der Parameter ist optional. Er gibt die Konditonspflege-Gruppe an. Mittels einer solchen Gruppe können die Tabellen und Konditionsarten, von denen selektiert wird, zusätzlich eingeschränkt werden.
IT_ATTRIB_VALUE_INT
Interne Tabelle mit Attribut/Wert/Operator-Tripeln in interne Darstellung. Es werden nur die Operatoren >, <, = , >=, <=, <> bzw. GT, LT, EQ, GE, LE, NE unterstützt.
Desweiteren werden nur variable Schlüsselfelder, d.h. Felder des Feldkataloges der Applikation mit Ausnahme des Feldes RELEASE_STAT berücksichtigt, sowie die Konditionstechnik-Felder Applikation (KAPPL), Verwendung (KVEWE), Konditionstabellennummer (KOTABNR), Konditionsart (KSCHL) und Objekt-ID (OBJECT_ID).
Beim Holen der selektierten Sätze mit FB '/SAPCND/GET_WORKING_SET_OW' gelten die eben genannten Einschränkungen bzgl. IT_ATRIB_VALUE_INT nicht.
IT_ATTRIB_SELECTION_EXT
Auflistung von Feldnamen in Form einer freien Selektion. Falls dieser Parameter nicht initial ist, wird IT_ATTRIB_VALUE_INT als gegenstandslos betrachtet. Es werden nur diejenigen Attribute unterstüzt, welche vom FB '/SAPCND/MNT_GET_SEL_FIELDS_SRV' bei Übergabe der Applikation und IS_EXTERNAL = 'X' zurückgegeben werden (Details siehe Dokumentation des FB '/SAPCND/MNT_GET_SEL_FIELDS_SRV').
Ausgabe-Parameter:
E_RESULT = 0: es sind keine Fehler bei der Selektion aufgetreten.
E_RESULT > 0: das Log ist auszuwerten.
E_RESULT = 4: bei der Selektion ist der semantische Schlüssel oder ein Attribut eines Konditionssatzes gesperrt. Gesperrte Sätze, welche zur Pflege angefordert werden, werden mit dem Lese-Flag in den Puffer der Konditionspflegesitzung übernommen. In diesem Fall wird eine Warnung ins Log gestellt.
Nur im Falle des Imports von IT_ATTRIB_SELECTION_EXT:
E_RESULT = 8: bei der stattgefundenen Konvertierung der freien Selektion in interne Einzelwerte konnte mindestens ein Attribut nicht in Einzelwerte konvertiert werden.
E_RESULT = 12: es konnte kein Konditionssatz selektiert werden, weil die freie Selektion in Einzelwerte für alle Attribute nicht erfolgreich war oder keine einzige Konditionstabelle für die gewählte freie Selektion gefunden werden konnte.
Nur im Falle I_SELECTION_MODE = 'A':
E_NUM_SELECTED_RECORDS: Anzahl der selektierten Sätze, die durch den Aufruf dieses Bausteins von der DB selektiert wurden (auch wenn sie evtl. bereits im Puffer vorhanden sind)
E_NUM_OF_DELETED_RECORDS: Anzahl der durch den Aufruf dieses Bausteins von der DB selektierten Sätze, welche das Löschkennzeichen tragen.
Hinweise
Falls IT_ATTRIB_SELECTION_EXT mitgegeben wird (heller Aufruf aus der Benutzer-Oberfläche), wird der Inhalt in IT_ATTRIB_VALUE_INT nicht ausgewertet.
Für einen dunklen Aufruf soll auschliesslich IT_ATTRIB_VALUE_INT mitgegeben wird. Die logische Verknüpfung der Attribute-Wert-Paare in IT_ATTRIB_VALUE_INT ist so, dass Attribut-Werte zu einem Attributnamen mit ODER verknüpft sind und Attribut-Werte zu verschiedenen Attributnamen mit UND. Die einzige Ausnahme davon bilden die Attribute TIMESTAMP_FROM und TIMESTAMP_TO, deren Werte immer mit UND verknüpft werden.
Das Feld 'Operator' im Zeilentyps von IT_ATTRIB_VALUE_INT darf im Moment nur bei i TIMESTAMP_FROM und TIMESTAMP_TO einen Wert ungleich ' ' annehmen. Für alle anderen Feldnamen wird nur ' ', also ein Einzelwert, unterstützt.
Hinweis zur Performance:
Aus der Tabelle IT_ATTRIB_VALUE_INT werden die für eine DB-Selektion in Frage kommenden Konditionstabellen bestimmt. Wenn IT_ATTRIB_VALUE_INT für alle Konditionstabellen ein Feld enthält, welches variables Schlüsselfeld für diese Kondtitionstabelle ist, dann kann ein einziger DB-Select pro Konditionstabelle abgesetzt und weiter prozessiert werden. Für jede Konditionstabelle, für die IT_ATTRIB_VALUE_INT kein variables Schlüssefeld enthält, muss evtl. mehrmals von der DB selektiert werden. Dies ist notwendig, um alle Konditionssätze zum gleichen Zeitraum-unabhängigen semantischen Schlüssel in den Puffer der Konditionspflege zu holen.
Beispiele
Sollen z.B. alle Kondiitionssätze selektiert werden, welche zum Datum MY_TIMESTAMP gültig sind oder welche zu wenigstens einem Zeitpunkt eines Zeitraums MY_TIMESTAMP_FROM bis MY_TIMESTAMP_TO gültig sind, müssen die Sätze im FB '/SAPCND/GET_WORKING_SET_OW' abgeholt werden.
Weiterführende Informationen
Parameter
ET_WORKING_SET_INTE_NUM_SELECTED_RECORDS
E_SELECTION_RESULT
IT_ATTRIB_INCL_EXCL_INT
IT_ATTRIB_VALUE_INT
IT_GROUP_I
I_ARC_FIELDCATALOGUE
I_GROUPNAME
I_USE_GROUP_WS
Ausnahmen
EXC_CONVERSION_FIXEDEXC_CONVERSION_INT
EXC_EXTRACTION
Funktionsgruppe
CND/SAPLARCHIVE_OWBAL_S_LOG - Application Log: Log header data CPI1466 during Backup
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 7097 Date: 20240419 Time: 084659 sap01-206 ( 105 ms )
