TeachAsNewRecipe

function TeachAsNewRecipe(ctx: Required<TcHmi.Context>, recipeReference: string, newRecipeName: string, newRecipePath: string)

Die Funktion TeachAsNew liest die aktuellen Werte der Symbole eines definierten Rezepts vom Target und speichert diese in ein neues Rezept.

Parameter

Name

Typ

Beschreibung

ctx

Verfügbar ab Version 1.10

Required<TcHmi.Context>

Kontext Objekt

Muss bei der Verwendung in einem Trigger oder einem Funktionsausdruck nicht vom Anwender angegeben werden. Die Übergabe und die Auswertung erfolgt in diesem Fall über den entsprechenden Parser.

Wird vom Aufrufer verwendet um dem Framework bei der Ausführung Erfolg oder Fehlschlag zu signalisieren.

Bei direkter Verwendung der Funktion in JavaScript/TypeScript muss das Kontext-Objekt beim Aufruf übergeben und ggf. ausgewertet werden.

recipeReference

string

Die Referenz des Rezeptes (Pfad plus Name), dessen aktuelle Symbolwerte vom Target gelesen werden sollen.

Beispiele:

‚MyRecipe1‘

‚MyFolder::MyRecipe2‘

newRecipeName

string

Der Name des neuen Rezepts, welches erstellt und in das die Werte gespeichert werden sollen.

Dieser Name kann bei Bedarf auch schon die Ordnerstruktur enthalten, in der das Rezept gespeichert werden soll. Ansonsten kann die Ordnerstruktur unter newRecipePath angegeben werden.

newRecipePath

string

Der Pfad, in den das neue Rezept gespeichert werden soll.

Wenn dieser Parameter leer ist, dann wird das Rezept auf höchster Ordnerebene angelegt.

Beispiel:

‚MyFolder‘

‚MyFolder1::MyFolder2‘

Rückgabewert

Typ

Beschreibung

void

Kein Rückgabewert.

NuGet Paket: Beckhoff.TwinCAT.HMI.Functions

TeachAsNewRecipe 1:

NuGet-Pakete sind verfügbar ab Version 1.12.

TeachAsNewRecipe 2:

Verfügbar ab Version 1.10.1171.142