Ansicht
Dokumentation

IPC_CT_CNF_DETERMINE - Durchführung Konditionsfindung (ABAP-und JAVA-Findung)

rdisp/max_wprun_time - Maximum work process run time   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Einführung

Die ABAP-Konditionsfindung stellt neben den Generierungswerkzeugen, der Konditionspflege einen weiteren Teilbereich der Konditionstechnik dar.

Die Konditionsfindung dient der performanten Suche nach Konditionssätzen, wenn neben Applikation und Verwendung, das Schema (Konditionsartenliste), Ausprägungen der Attribute des variablen Schlüssels und ein Gültigkeitszeitpunkt bzw. Gültigkeitsbereich bekannt sind. Die Konditionsfindung spielt damit beispielsweise für das Lesen von Konditionssätzen bei der Bearbeitung von Geschäftsvorgängen eine Rolle, nicht aber für die Selektion von Sätzen innerhalb der Konditionspflege.

Der Ablauf einer Konditionsfindung ist im Normalfall nur indirekt über die ermittelten Konditionssätze nachvollziehbar. Informationen über fehlerhaftes Customizing, nicht vorhandene Konditionssätze, Gültigkeiten oder Ausnahmen werden dem Aufrufer im allgemeinen nicht zur Verfügung gestellt, um die Performance nicht negativ zu beeinflussen. Sollten zusätzliche Auskünfte nötig sein, weil die Konditionsfindung nicht das gewünschte Ergebnis liefert, so kann mittels Analyse der Ablauf protokolliert werden. Die Meldungen werden in einem speziellen Tool übersichtlich aufbereitet.

API der ABAP- und JAVA-Konditionsfindung

Die API umfasst die folgende Funktionsbausteine:

• IPC_CT_GET_RELEVANT_ATTRIBUTES : ,,Liefert die für eine Konditionsfindung relevante Felder zurück

• IPC_CT_CNF_DETERMINE: ,,,,,,Ausführung der Konditionsfindung für einen Findungsaufruf

• IPC_CT_CNF_DETERMINE_MULTI:,,,,Ausführung der Konditionsfindung für mehrere Findungsaufrufe

Der Eingine-Typ wird in der Tabelle /SAPCND/T681Z registriert:

Engine-Typ,,,,Beschreibung

'A',,,,,,ABAP-Findung

'B',,,,,,JAVA-Findung

' ',,,,,,TASK wird nicht von API unterstützt

Zur Zeit werden die Verwendungen Preisfindung (PR), Naturalrabatt (FG) und Listung (LI) nicht von der obigen API unterstützt. Es ist auch nicht geplant, diese Verwendungen in Zukunft zu unterstützen.

Beschreibung des BausteinsIPC_CT_GET_RELEVANT_ATTRIBUTES

Mit den Importparametern Applikation IV_APPLICATION, Verwendung IV_USAGE und dem Name des Schemas (Konditionsartenliste) IV_CTLIST werden die relevanten Attribute ermittelt. Die Ermittlung der relevanten Attribute ist geradeaus. Die Konditionsarten des Schema werden der Reihe nach abgearbeitet und die Felder der referenzierten Zugriffsfolgen werden gesammelt. Gemäß der Registierung im Feldkatalog wird zwischen Kopf- und Positionsattributen unterschieden. Attribute vom Typ 'M' (Mixed: Position und Kopf) werden immer den Positionsattributen zugeordnet. Positionsattribute werden mit Exportparamter ET_ITEM_ATTR_NAMES und Kopfattribute werden mit dem Exportparameter ET_HEAD_ATTR_NAMES zurückgeben. Die Attribute für die Zeitstempel liefert das Customizing für die Konditionsarten, sie werden mit dem Exportparameter ET_TIMESTAMP_ATTR_NAMES zurückgegeben.

Beschreibung der Bausteine IPC_CT_CNF_DETERMINE und IPC_CT_CNF_DETERMINE_MULTI

Wesentlicher Input ist die Applikation IV_APPLICATION, die Verwendung IV_USAGE und der Name des Schemas (Konditionsartenlisten) IV_CTLIST, zu denen Konditionssätze gesucht werden sollen . Die Tabellen IT_HEADER_ATTRIBUTES, IT_ITEM_ATTRIBUTES und IT_TIMESTAMP_ATTRIBUTES für die Attributname-/Wertpaare müssen die Werte enthalten, für die die Findung durchgeführt werden soll.

Die Reihenfolge der Konditionsarten innerhalb eines Schema ist für die Bearbeitung und Auswertung der Abbruchbedingungen essentiell. Diese Reihenfolge legt die Suchreihenfolge der auszuführenden Findung fest.

Die zu berücksichtigenden Bedingungen pro Konditionsart müssen dem Schema mit dem Pflegeview /SAPCND/VC_CTLST zugewiesen werden. Die Bedingungen werden während der Abarbeitung der einzelnen Konditionsarten geprüft. Bedingungen sind im Sinne der ABAP-Konditionsfindung Implementierungen des BAdI's /SAPCND/REQUIREMENT.

Bedingungen für die JAVA-Findung müssen mit JAVA-Userexits realisiert werden. Dokumentationen dazu sind der IPC-Dokumentation (IPC-Installationverzeichnis/DOC/SPE/USEREXITS) zu entnehmen.

Da die Konditionssätze zeitabhängig sind, müssen Datums-/Zeitinformationen an die Findung übermittelt werden. Im Normalfall ist in der Konditionsart ein Zugriffsdatum (z. B. PRICE_DATE oder ORDER_DATE) definiert, mit dem der Zugriffszeitpunkt ermittelt werden soll. Der Baustein IPC_CT_GET_RELEVANT_ATTRIBUTES gibt die Zugriffsdaten mit dem Exportparameter ET_TIMESTAMP_ATTR_NAMES zurück. Die zugehörigen Attributname/-Wertpaare für die Zugriffsdaten müssen dem Baustein IPC_CT_CNF_DETERMINE (IPC_CT_CNF_DETERMINE_MULTI) mit dem Parameter IT_TIMESTAMP_ATTRIBUTES übergeben werden.

Sind im Customizing keine Zugriffsdaten registriert, kann jedoch auch der optionale Importparameter IV_DEFAULT_ACCESS_TIMESTAMP mit einem Wert versorgt werden. Die daraus resultierende Gültigkeit wird dann für alle Konditionen verwendet.

Das Ergebnis ist eine Tabelle von Konditionssätzen. Pro Konditionssatz gibt es die Tabelle FV_VAKEY für die Schlüsselfelder, FV_VADAT für die Datenfelder und die Tabelle USAGE_FIELDS für die Verwendungsfelder; zusätzlich gibt es Felder für die technischen Findungsinformationen. Das Findungsergebnis wird mit dem Exportparameter ET_DET_RECORDS zurückgegeben.

Staffeln sind zur Zeit nicht Bestandteil des Findungsergebnisses. Der Aufrufer muss daher das Lesen und Bewerten von Staffeln unabhängig von der generischen API für die Konditionsfindung implemetieren.

Beispiel

Ein Beispielimplementierung wird mit dem Report /SAPCND/TEST_DETERMINE ausgeliefert.

Hinweise

Weitere Beschreibungen sind in der technische Dokumentation für die Konditionsfindung enthalten. Dazu siehe Hinweis 690338.

Weiterführende Informationen

Parameter

CR_ANALYSIS
ES_PROFILE
ET_RESULT
ET_TRACE
ET_XML
EV_XML
IS_ACCESS_CONTROL
IS_RESULT_CONTROL
IT_HEADER_ATTRIBUTES
IT_ITEM_ATTRIBUTES
IT_TIMESTAMP_ATTRIBUTES
IV_APPLICATION
IV_BYPASSING_BUFFER
IV_CTLIST
IV_DEFAULT_ACCESS_TIMESTAMP
IV_ENGINE_TYPE
IV_PERFORM_ANALYSIS
IV_SIMULATION
IV_USAGE

Ausnahmen

ENGINE_ERROR
ENGINE_INITIALIZATION
INVALID_CALL
INVALID_ENGINE_TYPE

Funktionsgruppe

IPC_CT_DETERMINATION_OW

ABAP Short Reference   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 8447 Date: 20240523 Time: 105332     sap01-206 ( 145 ms )