Typ 0: Definition von Importparametern

Verwendung

Achtung Achtung

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

Ende der Warnung.

Importparameter (Exportparameter des Funktionsbausteins) definieren Sie in dynamischen Funktionsaufrufen. Dabei weisen Sie dem Importparameter die Variable zu, deren Wert aus dem Funktionsbaustein an die Herstellanweisung oder das Cockpit übergeben wird.

Diese Variable kann in der Herstellanweisung oder im Cockpit angezeigt werden.

Mit Hilfe der Variablen können Sie den Wert außerdem in nachfolgende Prozessvorgaben derselben Herstellanweisung oder desselben Cockpits übernehmen. Beachten Sie hierbei jedoch, dass die Funktion beim Bearbeiten der Herstellanweisung oder des Cockpits mehrfach ausgeführt werden kann.

Voraussetzungen

Wenn Sie den Wert einer Variablen aus dem Funktionsbaustein in die Herstellanweisung oder das Cockpit übernehmen wollen, muss die Variable in derselben Herstellanweisung oder in demselben Cockpit definiert sein. Bei Herstellanweisungen kann die Variable außerdem für den gesamten Prozessauftrag definiert sein.

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

Aktivitäten

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

die Exportparameter des Funktionsbausteins
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 Variablen für jeden zu übergebenden Parameterwert ;
Der Wert einer Variablen kann nur dann an einen Parameter übergeben werden, wenn sie denselben Datentyp hat wie der Parameter im Funktionsbaustein.

Hinweis Hinweis

Wenn der Importparameter 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.

Ende des Hinweises

Tabellenartige Importparameter

Ein Funktionsbaustein kann Importparameter 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 Importparameter werden wie einfache Importparameter mit dem Merkmal PPPI_IMPORT_PARAMETER definiert. Das System erkennt automatisch, dass diese Parameter auf einen Tabellentyp typisiert sind.

Mit Hilfe von tabellenartigen Importparametern können Sie aus einem Funktionsbaustein eine Variable in eine Tabellenvariable der Herstellanweisung übernehmen. D.h. die Variable, in die Sie den Wert aus dem Funktionsbaustein übernehmen 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_IMPORT_PARAMETER	Importparameter	Exportparameter des Funktionsbausteins
< PPPI_STRING_VARIABLE oder < PPPI_FLOAT_VARIABLE oder < PPPI_DATE_VARIABLE oder < PPPI_TIME_VARIABLE	Wertübernahme in Variable: < alphanummerischer Wert < Fließkommazahl < Datum < Zeit	Variable mit Datentyp: < alphanummerischer Wert < Fließkommazahl < Datum < Zeit
PPPI_OPTIONAL_PARAMETER	Optionale Parameterübergabe	< Parameterübergabe nicht optional < Parameterübergabe optional

Wenn Sie den Variablenwert in der Herstellanweisung oder im Cockpit anzeigen wollen, müssen Sie ein Ausgabefeld dafür definieren. Weitere Informationen dazu finden Sie unter Typ 0: Definition von Ausgabefeldern zu Variablenwerten .