Ansicht
Dokumentation
CULR_GET_VALLIST - Aktuelle Werte eines mehrwertigen Merkmals lesen
TXBHW - Original Tax Base Amount in Local Currency SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3upDiese Dokumentation steht unter dem Copyright der SAP AG.
Funktionalität
Diese Funktion liest für eine Instanz der Konfiguration den aktuell
gültigen Wert des angegebenen Merkmals.
Die Instanz wird dabei durch eine interne Nummer und das Merkmal durch
seinen sprachneutralen Namen identifiziert. Der Wert des Merkmals wird,
sofern vorhanden, in dem entsprechenden internen Format zurückgegeben.
Die Rückgabestruktur für den Wert enthält in dem Teilfeld ATFOR eine
Information über den internen Datentyp des Merkmals: 'NUM' für numeri-
sche Merkmale, 'SYM' für symbolische (Character) Merkmale.
Beachten Sie, daß auch Merkmale mit Datums-, Zeit- oder Währungsformat
in der Konfiguration intern wie numerische Merkmale verarbeitet werden.
Für numerische Merkmale steht der Rückgabewert in dem Teilfeld ATFLV,
für symbolische in dem Teilfeld ATWRT der Wertstruktur VAL.
Falls das angegebene Merkmal als mehrwertig definiert ist, so liefert
diese Funktion die Ausnahme MULTIVALUED_CHARACTERISTIC.
Für den Zugriff auf die Werte eines mehrwertigen Merkmals ist die
Funktion CUPR_GET_VALLIST vorgesehen.
Die Ausnahme NOT_FOUND wird signalisiert, falls das angegebene
Merkmal unbewertet ist. Beachten Sie, daß ein einschränkbares Merkmal
als unbewertet gilt, solange der gültige Wertebereich noch nicht auf
einen einzelnen Wert eingeschränkt ist.
Beispiel
***********************************************************************
* Lese Wert des Merkmals MY_COLOR am Wurzelobjekt der Konfiguration *
***********************************************************************
TYPE-POOLS: CUDBT.
DATA: VAL TYPE CUDBT_VAL,
MY_COLOR(30) TYPE C.
...
CALL FUNCTION 'CUPR_GET_VAL'
EXPORTING
INSTANCE = GLOBALS-ROOT
CHARACTERISTIC = 'MY_COLOR'
IMPORTING
VAL = VAL
EXCEPTIONS
NOT_FOUND = 01
OTHERS = 02.
IF SY-SUBRC = 0.
MY_COLOR = VAL-ATWRT.
...
Hinweise
Das Beziehungswissen des Konfigurators gestattet den Aufruf von
benutzerdefinierten ABAP-Funktionen (User-Exits), um komplexe Teil-
aufgaben oder -auswertungen in der Konfiguration zu erledigen.
Im Rahmen dieser Funktionen kann es erforderlich sein, über die in
der Funktionsschnittstelle mitgegebenen Merkmalswerte hinaus Daten aus
der aktuellen Konfiguration zu lesen oder zu ändern.
Für diese Zugriffe bietet die Funktionsgruppe CUPR eine Reihe von
Funktionsbausteinen an. Diese Zugriffsbausteine benötigen zur Identifi-
kation der betrachteten Objekte in der Konfiguration eine interne
Instanznummer (INSTANCE).
Beachten Sie, daß die Instanznummer nicht fest in einem externen
Programm vorgegeben werden sollte: die Nummer wird nämlich zur Laufzeit
dynamisch für die in die Konfiguration aufgenommenen Objekte vergeben.
Beim Aufruf einer benutzerdefinierten Funktion mit dem Schlüsselwort
PFUNCTION übergibt das System die internen Instanznummern für
folgende Objekte der Konfiguration an die gerufene Funktion:
1. SELF : aktuell konfigurierte Instanz
2. PARENT: Zerlegungsvater von SELF
3. ROOT : Einstiegsobjekt (Wurzel der Zerlegung)
Diese drei Felder sind Bestandteil der Struktur GLOBALS in der
generischen Funktionsschnittstelle für benutzerdefinierte Funktionen.
Sie entsprechen den bekannten Schlüsselwörtern $SELF, $PARENT und $ROOT
im Beziehungswissen.
Durch das Nachlesen oder Verändern von Konfigurationsdaten über
Funktionsbausteine dieser Gruppe entstehen 'Seiteneffekte' in der
Beziehungsauswertung, die in allen deklarativen Beziehungsarten (z.B.
Constraints) unbedingt zu vermeiden sind.
Weiterführende Informationen
Parameter
CHARACTERISTICINSTANCE
VALUES
Ausnahmen
INTERNAL_ERRORNOT_FOUND
NOT_MULTIVALUED
UNKNOWN_CHARACTERISTIC
UNKNOWN_INSTANCE
Funktionsgruppe
CULRROGBILLS - Synchronize billing plans Vendor Master (General Section)
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 4585 Date: 20240605 Time: 200939 sap01-206 ( 31 ms )
