Benutzer-Exits in
Validierungen/Substitutionen/Regeln
Benutzer-Exits sind vom Anwender definierte Formroutinen, mit deren Hilfe in Validierungen, Substitutionen und Regeln Werte errechnet und/oder ersetzt werden können.
Benutzer-Exits haben folgendes Format:
· U (für Benutzer-Exit) oder S (für einen Standard-Benutzer-Exit)
· die Nummer des Benutzer-Exits (dreistellig)
U123 ist z. B. ein Benutzer-Exit.
Sie können den Formpool-Namen des Benutzer-Exits konfigurieren und müssen ihn in der Tabelle für mandantenabhängige Benutzer-Exits (T80D) im Customizing speichern. Tabelle T80D enthält die Formpool-Namen für die in Validierungen, Substitutionen und Regeln verwendeten Benutzer-Exits. Validierungs-/Substitutions-Formpools sind mandantenabhängig. (Weitere Informationen zu diesem Thema finden Sie im Arbeitsschritt Mandantenabhängige Benutzer-Exits pflegen im Einführungsleitfaden der Speziellen Ledger.
Mit dem SAP-System werden die Beispiel-Formpools RGGBS000 und RGGBR000 für Mandant 000 ausgeliefert. Diese Formpools müssen Sie kopieren und anschließend in Tabelle T80D konfigurieren. Der neue Formpool sollte mit den Namenskonventionen des Kunden übereinstimmen (und mit ‘Z’ beginnen), damit er nicht beim nächsten SAP-Upgrade überschrieben wird (z. B. ZGGBR000).
Beispiel-Formroutine für den Substitutions-Exit 001 (U001)
TABLES: COBL.
FORM U001.
COBL-KOSTL = COBL-BUKRS.
ENDFORM.
Tabellen und Strukturen sollten in der Formroutine nicht verwendet werden, damit der Inhalt der Routine zusammen mit der aufrufenden Transaktion verwendet werden kann.
SAP-Exits sind von SAP entwickelte Formroutinen. Der Name des Formpools für SAP-Exits ist SAPFGBEB.
Wenn Sie Ihre Regeln noch in Tabelle T890 (“Interpretierte Regeln”) speichern, können Sie in Ihrer Regeldefinition keine Benutzer-Exits verwenden. Wir empfehlen Ihnen, zur Umwandlung der interpretierten in generierte Regeln in Tabelle T890 das Programm RGUGBR10 zu verwenden, damit Sie bei der Pflege von Regeln die Funktionen des Customizings verwenden können. Weitere Informationen zu diesem Thema finden Sie unter Verwendung der Regel-Manager-Programme.
In der folgenden Tabelle sehen Sie, welche Typen von Benutzer-Exits in Validierungen, Substitutionen und Regeln verwendet werden können:
Benutzer- |
Beschreibung |
Anwendung |
Beispiel |
1 |
Für den Benutzer-Exit sind keine Parameter definiert. |
Regeln, Validierungen und Substitutionen (Voraussetzung) |
Siehe Formpool RGGBR000, Parametertyp C_EXIT_PARAM_NONE |
2 |
Wie Benutzer-Exit-Typ 1, lediglich ein Parameter (das zu ersetzende Feld) wird im Benutzer-Exit definiert. Sie können z. B. eine Substitutions-Routine anlegen, durch die die Kostenstelle unabhängig vom verwendeten Feld analysiert wird. |
Substitution |
Siehe Formpool RGGBS000, Parametertyp C_EXIT_PARAM_FIELD |
3 |
Alle Daten werden als ein Parameter behandelt; dieser Exit-Typ kann nur in Matrix-Validierungen bzw. -Substitutionen verwendet werden. |
Regeln, Validierungen und Substitutionen (Voraussetzung) |
Siehe Formpool RGGBR000, Parametertyp C_EXIT_PARAM_CLASS |
In Validierungen und Regeln werden die Exit-Nummern 1 und 3 aus der obigen Tabelle verwendet.
In Substitutionen werden alle Exit-Nummern aus der obigen Tabelle verwendet.
Für Substitutionen können Sie außerdem Benutzer-Exits anlegen, die ein Feld als Parameter akzeptieren und den geänderten Wert wieder diesem Parameter übergeben. Sie können also Benutzer-Exits anlegen, die unabhängig vom Feld- und Tabellennamen verwendet werden können. Dieser Benutzer-Exit-Typ kann nicht als Eintrag im Feld Nur Exit der Liste der zu substituierenden Werte verwendet werden; Sie können diesen Exit-Typ nur in Verbindung mit einem Feldnamen verwenden. Ein Beispiel dieses Exit-Typs finden Sie im Formpool RGGBS000.
Wenn Sie für Ihren Benutzer-Exit einen anderen Parameter als das Ergebnis (B_RESULT) definieren wollen, müssen Sie für Ihren Benutzer-Exit in der Formroutine GET_EXIT_TITLES innerhalb des von Ihnen definierten Formpools einen Eintrag vornehmen. Hierzu empfiehlt es sich, den von SAP ausgelieferten Beispiel-Formpool RGGBR000 für Validierungs-Exits bzw. RGGBS000 für Substitutions-Exits zu kopieren. In diesen Beispiel-Formpools sind in der Formroutine GET_EXIT_TITLES bereits Einträge für die von SAP ausgelieferten Beispiele vorhanden.