teachAsNewRecipe

[ Funktion ]

public static teachAsNewRecipe (
    recipeName: string,
    path: string | null,
    newRecipeName: string,
    newRecipePath: string | null,
    callback: null | ((this: void, data: TcHmi.IResultObject) => void) = null
): TcHmi.IErrorDetails;

Liest die aktuell geltenden Werte aus dem Zielsystem (referenziert durch ein Rezept) und schreibt sie in ein neues Rezept.

Parameter

Name

Typ

Beschreibung

recipeName

string

Name des Rezepts. Dieser kann auch den vollen Pfad beinhalten. Als Trennzeichen für Ordner muss in diesem Fall '::' genutzt werden.

path

string, null

Pfad des Zielordners. Wird dieser nicht angegeben, so wird der Rezepttyp im Hauptordner angelegt.

newRecipeName

string

Name des neuen Rezepts. Dieser kann auch den vollen Pfad beinhalten. Als Trennzeichen für Ordner muss in diesem Fall '::' genutzt werden.

newPath

string, null

Pfad des Zielordners. Wird dieser nicht angegeben, so wird der Rezepttyp im Hauptordner angelegt.

callback [ Optional ]

(data: TcHmi.IResultObject) => void, null

Asynchrone Callback Funktion, die ausgelöst wird, wenn die Aktion abgeschlossen wurde.

Rückgabewert

Typ

Beschreibung

TcHmi.IErrorDetails

Liefert eine Rückmeldung, ob die Operation erfolgreich abgeschickt worden konnte.

teachAsNewRecipe 1:

Verfügbar ab Version 1.10.1171.142

Beispiel - JavaScript

TcHmi.Server.RecipeManagement.teachAsNewRecipe (
    'recipe10',
    'testRecipeCategory',
    'recipe11',
    'newRecipesCategory',
    function(data) {
        if (data.error === TcHmi.Errors.NONE) {
            // Success
        } else {
            // Error
        }
    }
);