LeseDatensatzname (Panels, Comfort Panels, RT Advanced) - WinCC

Systemfunktionen (Basic Panels, Panels, Comfort Panels, RT Advanced)

ft:publication_title
Systemfunktionen (Basic Panels, Panels, Comfort Panels, RT Advanced)
Product
WinCC
Version
V21
Publication date
11/2025
Language
de-DE
LeseDatensatzname

Beschreibung

Schreibt die Namen der angegebenen Rezeptur und des angegebenen Rezepturdatensatzes in die angegebenen Variablen.

Hinweis

Wenn die Rezeptur oder der Rezepturdatensatz nicht existiert, werden Platzhalter ("###") in die Variablen geschrieben.

Hinweis

Als Variablen werden nur interne oder externe Variablen unterstützt.

Verwendung in der Funktionsliste

LeseDatensatzname (Rezepturnummer, Datensatznummer, Rezepturname, Datensatzname, Bearbeitungsstatus)

Verwendung in benutzerdefinierten Funktionen

GetDataRecordName Recipe_number, Data_record_number, Recipe_name, Data_record_name, Processing_status

Verwendbar, sofern das projektierte Gerät benutzerdefinierte Funktionen unterstützt. Weitere Informationen finden Sie unter "Geräteabhängigkeit".

Parameter

Rezepturnummer

Nummer der Rezeptur, deren Name in die angegebene Variable geschrieben wird.

Datensatznummer

Nummer des Rezepturdatensatzes, dessen Name in die angegebene Variable geschrieben wird.

Rezepturname

Die Variable, in die der Rezepturname geschrieben wird. Die Variable muss vom Typ STRING sein.

Datensatzname

Die Variable, in die der Name des Rezepturdatensatzes geschrieben wird. Die Variable muss vom Typ STRING sein.

Bearbeitungsstatus

Gibt den Bearbeitungsstatus der Systemfunktion zurück. Verwenden Sie den Rückgabewert, um z.B. andere Systemfunktionen erst dann auszuführen, wenn diese Systemfunktion erfolgreich beendet wurde:

2 = Systemfunktion wird gerade ausgeführt.

4 = Systemfunktion wurde erfolgreich beendet.

12 = Systemfunktion wurde nicht ausgeführt, weil ein Fehler aufgetreten ist.

Für den Parameter können Sie nur eine HMI-Variable verwenden.

Anwendungsbeispiel

Sie wollen die Namen der angezeigten Rezeptur und den Namen des angezeigten Rezepturdatensatzes am Bediengerät ausgeben.

Projektieren Sie folgende Variablen:

  • "RecNumber" vom Typ INTEGER

  • "RecDataNumber" vom Typ INTEGER

  • "RecName" vom Typ STRING

  • "RecDataName" vom Typ STRING

Projektieren Sie eine Rezepturanzeige mit den Variablen "RecNumber" für die Rezepturnummer und "RecDataNumber" für die Datensatznummer.

Projektieren Sie an das Ereignis "Drücken" einer Schaltfläche die Systemfunktion "LeseDatensatzname" und übergeben Sie folgende Parameter:

  • Rezepturnummer: RecNumber

  • Datensatznumer: RecDataNumber

  • Rezepturname: RecName

  • Datensatzname: RecDataName

Projektieren Sie zwei Ausgabefelder und verbinden Sie diese mit den Variablen "RecName" und "RecDataName".

Wählen Sie in der Rezepturanzeige eine Rezeptur- und eine Datensatznummer aus. Sobald Sie die Schaltfläche betätigen, wird die Systemfunktion ausgelöst und die Namen der Rezeptur und des Rezepturdatensatzes werden in den beiden Ausgabefeldern angezeigt.