Typ 0: Definition von Exportparametern (SAP-Bibliothek

Typ 0: Definition von Exportparametern

Verwendung

Achtung

Beachten Sie, dass hier mit Exportparameter die Exportparameter der Herstellanweisung oder des Cockpits (PPPI_EXPORT_PARAMETER) gemeint sind, d.h. Werte aus der Herstellanweisung oder dem Cockpit werden an den Funktionsbaustein übergeben. Aus Sicht des Funktionsbausteins handelt es sich deshalb um Importparameter.

Exportparameter (Importparameter des Funktionsbausteins) definieren Sie in dynamischen Funktionsaufrufen und Eingabewertprüfungen, die mit Hilfe einer Prüffunktion durchgeführt werden.

Voraussetzungen

Wenn Sie den Wert einer Variablen an den Funktionsbaustein übergeben wollen, muss die Variable in derselben Herstellanweisung oder in demselben Cockpit definiert sein. Bei Herstellanweisungen kann die Variable ausserdem für den gesamten Prozessauftrag definiert sein.

Weitere Informationen zur Verwendung von Systemvariablen und Variablen im allgemeinen finden Sie unter

Verwendung von Variablen in browser-basierten Herstellanweisungen und Cockpits

Verwendung von Systemvariablen in browser-basierten Herstellanweisungen

Aktivitäten

Bei der Definition von Exportparametern hinterlegen Sie in der Prozessvorgabe folgende Informationen:

alle obligatorischen Importparameter des Funktionsbausteins;
Obligatorisch sind alle Importparameter, bei denen das Kennzeichen Optional nicht gesetzt ist. Sie müssen in der Prozessvorgabe angegeben werden.

optionale Importparameter des Funktionsbausteins, für die nicht der im Funktionsbaustein hinterlegte Vorschlagswert verwendet werden soll;
Optional sind alle Importparameter, bei denen das Kennzeichen Optional gesetzt ist. Sie brauchen in der Prozessvorgabe nicht angegeben werden.

ggf. das Merkmal Optionale Parameterübergabe für optionale Parameter, deren Wert bei Ausführung des Funktionsaufrufs nicht übergeben werden soll;
Siehe auch: Typ 0: Optionale Parameterübergabe

den Parameternamen für jeden zu übergebenden Parameter

die Variable, Konstante oder das Meldungsmerkmal für jeden zu übergebenden Parameterwert;
Der Wert einer Variablen oder Konstanten kann nur dann an einen Parameter übergeben werden, wenn sie denselben Datentyp hat wie der Parameter im Funktionsbaustein.

Hinweise zur Zuordnung des Parameterwerts

Wenn der Wert im Prozessauftrag bekannt ist, erfassen Sie ihn als Festwert in Form

einer Konstante
Den Datentyp einer Konstante bestimmen Sie über das Merkmal, mit dem Sie die Konstante definieren.

eines Meldungsmerkmals
Wenn Sie ein Meldungsmerkmal verwenden wollen, dann muss der Datentyp des Merkmals mit dem des Parameters im Funktionsbaustein übereinstimmen. Die Verwendung eines Meldungsmerkmals ist dann sinnvoll, wenn das Merkmal im Auftrag bewertet ist.

Wenn der Wert erst in der Herstellanweisung verfügbar ist, übernehmen Sie ihn mit einer Variablen aus einer vorausgehenden Prozessssvorgabe. Die Variable hat denselben Datentyp wie der Wert, auf den sie verweist. In der Prozessvorgabe müssen Sie die Variable abhängig vom Datentyp dem dafür vorgesehenen Merkmal zuordnen.

Hinweis

Wenn der Exportparameter auf einen Tabellentyp typisiert ist, können Sie eine gesamte Tabelle aus der Herstellanweisung an den Funktionsbaustein übergeben. In diesem Fall müssen Sie als Ausgabe eine wiederholte Datenanforderung (Tabelle) definiert haben. Wenn Sie eine einfache Datenanforderung definiert haben, gibt das System nur den Wert der ersten Tabellenzeile aus. Das System kann nur einspaltige Tabellen verarbeiten.

Bei Eingabewertprüfungen übergeben Sie den zu prüfenden Eingabewert mit der Variablen SY_VALUE oder X, die stets auf den unmittelbar zuvor eingegebenen Wert verweist.

Tabellenartige Exportparameter

Ein Funktionsbaustein kann Exportparameter besitzen, die auf einen Tabellentyp typisiert sind. Im Vergleich dazu kann ein Funktionsbaustein auch konkrete Tabellenparameter besitzen, die Sie mit dem Merkmal PPPI_TABLE_PARAMETER definieren.
Siehe auch: Typ 0: Definition von Tabellenparametern

Diese tabellenartigen Exportparameter werden wie einfache Exportparameter mit dem Merkmal PPPI_EXPORT_PARAMETER definiert. Das System erkennt automatisch, dass diese Parameter auf einen Tabellentyp typisiert sind.

Mit Hilfe von tabellenartigen Exportparametern können Sie aus der Herstellanweisung eine Tabellenvariable an einen Funktionsbaustein übergeben. D.h. die Variable, die Sie an den Funktionsbaustein übergeben wollen, muss innerhalb einer wiederholten Datenanforderung (Tabelle) definiert sein.

Merkmaldefinition

Sie erfassen diese Informationen, indem Sie der Prozessvorgabe folgende Merkmale in der angegebenen Reihenfolge zuordnen:

Merkmal	Bedeutung	Zulässige Werte
PPPI_EXPORT_PARAMETER	Exportparameter	Importparameter des Funktionsbausteins
< PPPI_STRING_CONSTANT oder < PPPI_FLOAT_CONSTANT oder < PPPI_DATE_CONSTANT oder < PPPI_TIME_CONSTANT oder < PPPI_STRING_VARIABLE oder < PPPI_FLOAT_VARIABLE oder < PPPI_DATE_VARIABLE oder < PPPI_TIME_VARIABLE oder < <Meldungsmerkmal>	Wertübergabe in Konstante: < alphanummerischer Wert < Fließkommazahl < Datum < Zeit Wertübergabe in Variable: < alphanummerischer Wert < Fließkommazahl < Datum < Zeit Bei Bewertung über Meldungsmerkmal: < Meldungsmerkmal	Beliebiger Festwert mit Datentyp: < alphanummerischer Wert < Fließkommazahl < Datum < Uhrzeit Vorhandene Variable mit Datentyp: < alphanummerischer Wert < Fließkommazahl < Datum < Zeit <beliebiges Meldungsmerkmal
PPPI_OPTIONAL_PARAMETER	Optionale Parameterübergabe	<Parameterübergabe nicht optional <Parameterübergabe optional