Ansicht
Dokumentation
/SAPCND/MNT_SELECT_OW - Selektion von Konditionssätzen in den Puffer der Konditionspflege
CPI1466 during Backup 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
E_NUM_DELETED_RECORDSE_NUM_REMAINING_RECORDS
E_NUM_SELECTED_RECORDS
E_RESULT
E_RESULT_IS_BUFFERED
IT_ATTRIB_SELECTION_EXT
IT_ATTRIB_VALUE_INT
I_ADD_ATTRIBUTE_INT_TO_EXT
I_ARC_FIELDCATALOGUE
I_HLOG
I_HSESSION
I_MAINTENANCE_MODE
I_MAX_NUMBER_FOR_DISPLAY
I_MAX_NUM_FOR_SEL_CANC
I_NON_DELETED_MARKED_ONLY
I_READ_MODE
I_SELECTION_MODE
I_USE_BUFFER
Ausnahmen
EXC_ADDING_DEBUG_TRACE_MSGEXC_CONVERT_RANGES
EXC_CREATING_OBJECT_NAMES
EXC_DUPLICATE_RECORDS
EXC_EXTERNAL_ONLY
EXC_GETTING_VALIDITY_WINDOW
EXC_GET_NUM_OF_DISPLAYED_ITEMS
EXC_INNER_REL_LOCKS
EXC_LOCKING_ATTRIBUTE
EXC_OPERATOR_NOT_SUPPORTED
EXC_READING_ARCHIVED_RECORDS
EXC_RFC
EXC_SELECTING_RECORDS
EXC_SEL_BY_TABLE_SEL
EXC_SETTING_ABAP_LOCKS
EXC_STOP_WORK
EXC_UNKNOWN_SELECTION_MODE
FIELDCATALOGUE_ONLY
Funktionsgruppe
CND/SAPLMAINTENANCE_OWABAP Short Reference BAL Application Log Documentation
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 7798 Date: 20240426 Time: 124027 sap01-206 ( 140 ms )
