--- sourceDocument: Yokohama Now Platform-Fähigkeiten sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/yokohama/servicenow-platform Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Platform-Fähigkeiten ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Verwenden von Variablen in einem Workflow # Verwenden von Variablen in einem Workflow {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Innerhalb des Workflows sind mehrere verschiedene Arten von Variablen verfügbar. Einige Variablen definieren, beschreiben oder verfassen die Teile des Workflows (z. B. [Workflow-Aktivitäten](https://www.servicenow.com/docs/wQKYvGSPeB5Tj2LwvwznqA "Referenz für Workflow-Aktivitätseigenschaften")). Einige Variablen sind speziell verfügbar, um die Ausführung eines Workflows zu erleichtern (z. B. Scratchpad-Variablen). Einige Variablen definieren, beschreiben oder verfassen die Datensätze, die vom Workflow-Prozess bearbeitet werden (z. B. die Elemente eines Glide-Datensatzes, die in einer Datei dictionary.xml definiert sind, die einen Datensatz beschreibt, z. B. einen Incident). ## Aktivitätsvariablen {#ariaid-title2} Aktivitätsvariablen sind Eigenschaften, die speziell einer Workflow-Aktivität zugeordnet sind. ### Vorbereitungen Erforderliche Rolle: Administrator ### Warum und wann dieser Vorgang ausgeführt wird Dies sind die Eingaben, die in der Aktivitätsdefinition angezeigt werden, wenn eine bestimmte Aktivität auf den Workflow-Canvas gezogen wird. Diese Variablen sind Eigenschaften, die die Workflow-Aktivität oder die Arbeit definieren, verfassen oder beschreiben, die sie ausführen soll. Aktivitätsvariablen werden in einer zugehörigen Liste innerhalb der Workflow-Aktivitätsdefinition deklariert. So fügen Sie eine Variable hinzu, zeigen sie an oder ändern sie: ### Prozedur 1. Navigieren zu AlleWorkflowAktivitätsdefinitionenan. 2. Wählen Sie eine Workflow-Aktivität aus, z. B. Genehmigung: Anwender . 3. In Aktivitätsvariablen Abschnitt oder Registerkarte, fügen Sie die Variablen hinzu, zeigen Sie sie an, oder ändern Sie sie. Aktivitätsvariablen werden mit denselben Feldern wie definiert [Systemwörterbuch](https://www.servicenow.com/docs/access?context=c_SystemDictionary&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Hinweis: Wenn Sie eine neue Aktivitätsvariable definieren, die von einer anderen Aktivitätsvariable abhängig ist, geben Sie das Präfix „vars" an. Vor dem Namen der übergeordneten Aktivitätsvariablen. Beispiel: Wenn das untergeordnete Feld von einem Feld mit dem Namen abhängig ist Übergeordnet , Geben Sie den Wert ein variablen.übergeordnetes Element In Abhängig Feld. Um die Sichtbarkeit einer Aktivitätsvariablen im Workflow-Canvas zu steuern, nachdem die Aktivität in den Canvas gezogen wurde, verwenden Sie eine UI-Richtlinie in der Tabelle wf_activity. Um auf die Variablen zuzugreifen oder diesen Variablen innerhalb der Workflow-Aktivität Werte zuzuweisen, verwenden Sie variablen Variable der Workflow-Aktivität. activity.vars.variable_name = new_variable_value ## Workflow-Eingabevariablen {#ariaid-title3} Workflow-Variablen sind externe Werte, die während der Ausführung an einen Workflow übergeben und von ihm referenziert werden. ### Vorbereitungen Erforderliche Rolle: Administrator ### Warum und wann dieser Vorgang ausgeführt wird Workflow-Variablen können extern in einem Skript deklariert und an einen Haupt-Workflow übergeben werden, oder sie können in einem Haupt-Workflow deklariert und als Eingaben an einen Subflow übergeben werden. Hinweis: Es gibt eine bestimmte Art von Eingabevariablen für jeden Workflow, der für die Tabelle „angefordertes Element" \[sc_Request_item\] deklariert ist. Informationen zur Verwendung dieser Variablen finden Sie unter [Workflow-Katalogvariablen](https://www.servicenow.com/docs/2Xzv3MnWcyGgFopSyQin~g#c_WorkflowCatalogVariables "Workflows, die der Tabelle „angefordertes Element“ [sc_req_item] zugeordnet sind, haben einen bestimmten Typ von Workflow-Eingabe."). Workflow-Variablen werden in einem Formular deklariert, das über das Zahnradmenü des Workflow-Editors verfügbar ist. ### Prozedur 1. Navigieren zu AlleWorkflowWorkflow-Editoran. 2. Bearbeiten und checken Sie einen Workflow aus. 3. Wählen Sie das Menü Workflow-Aktivitäten aus, und wählen Sie aus Eingaben Bearbeiten . 4. Wählen Sie eine vorhandene Variable aus, oder wählen Sie aus Neu . Beachten Sie Spaltenname Feld. Verwenden Sie diesen Wert, wenn Sie über ein Skript auf die Variable zugreifen. Workflow-Variablen werden nicht auf der Workflow-Canvas angezeigt. Sie können nur über das Menü „Workflow-Aktivität" angezeigt werden. Die Eingabevariablen können in Skripts verwendet werden. So greifen Sie über ein Skript auf eine Eingabevariable zu: var input = workflow. variables. variableName //get the workflow variable identified by column name. ## Zuweisen von Werten zu Variablen außerhalb des Workflows {#ariaid-title4} Nach der Deklaration in einem Workflow können den Variablen Werte zugewiesen werden, aus denen der Workflow gestartet wird. Das folgende Beispiel zeigt, wie der Wert einer Workflow-Variable in einer Skripteinbindung, Business-Regel oder UI-Aktion festgelegt werden kann: //Declare an instance of workflow.js var wf = new Workflow ( ) //Get the workflow id var wfId = wf. getWorkflowFromName ( "Workflow Name" ) ; //Start workflow, passing along name : value pair(s) for mapping to variable //where input_var_name is the name of the variable declared in gear menu //and input_var_value is whatever that value should be for this execution of //workflow wf. startFlow (wfId , null , "Workflow Name" , {input_var_name : input_var_value } ) ; Ein weiteres Beispiel, das eine besser lesbare Methode zum Übergeben mehrerer Variablen demonstriert, umfasst das Deklardieren eines Objekts, das Hinzufügen der Namen/Werte zum Objekt und das Übergeben des Objekts: //Declare an instance of workflow.js var wf = new Workflow ( ) //Get the workflow id var wfId = wf. getWorkflowFromName ( "Workflow Name" ) ; //Start workflow, passing along object containing name/value pairs mapping to inputs expected by the workflow var vars = { } ; vars. input_var_name1 = input_var_value1 ; vars. input_var_name2 = input_var_value2 ; // add as many variables as your workflow is expecting, then pass the object wf. startFlow (wfId , null , "Workflow Name" , vars ) ; ### Zuweisen von Werten für Subflow-Eingaben aus einem Haupt-Workflow Wenn ein Workflow, der Eingaben akzeptiert, aus einem anderen Workflow aufgerufen wird, können diese Eingabewerte aus dem Workflow-Canvas innerhalb der Anwenderoberfläche der Workflow-Aktivität festgelegt werden. Für jede für einen Subflow deklarierte Eingabevariable wird in der Aktivität ein Textfeld-Eingabebereich angezeigt. Innerhalb dieser Textfelder können die Variablen mit einem beliebigen Wert festgelegt werden, entweder aus dem Scratchpad oder aus dem aktuellen Datensatz. Weitere Informationen finden Sie unter [Workflows, die als Subflows verwendet werden](https://www.servicenow.com/docs/cgAf8Od3VbtR~JS53~xJRA "Ein Workflow kann einen anderen Workflow als Aktivität starten."). ### Lesen des Werts einer Workflow-Eingabevariable Der Wert einer Workflow-Eingabevariable ist an beliebiger Stelle im Workflow zugänglich, der javascript-by-Dot-Walking des aktuellen Workflow-Objekts akzeptiert: var readValue = workflow.inputs.variable_name; ## Workflow-Scratchpad-Variablen {#ariaid-title5} Speichern und teilen Sie Zeichenfolgenbasierte Variablen als Name-Wert-Paare zwischen Workflow-Aktivitäten. Das Scratchpad ist für die Instanz des laufenden Workflows global und daher für alle Aktivitäten gleichermaßen verfügbar. ### Deklaration Das Scratchpad selbst ist automatisch für einen ausführenden Workflow verfügbar und erfordert keine spezifische Deklaration. Variablen werden gleichzeitig im Scratchpad deklariert und gespeichert, indem darauf verwiesen wird. Zum Beispiel: workflow.scratchpad.variableName = variableValue; ### Bildschirm Zeigen Sie Aktivitäts-Scratchpad-Werte aus der Tabelle Workflow-Aktivitätenverlauf \[wf_history_Scratchpad\] an. Das Scratchpad für den Workflow-Aktivitätsverlauf ist auch eine eingebettete Liste in den Datensätzen des Arbeitslow-Aktivitätsverlaufs. Abbildung : 1. Beispiel für Scratchpad-Datensätze für Workflow-Aktivitätsverlauf ### Zugriff und Zuweisung Verwenden Sie die standardmäßige JavaScript-Objektnotation, um auf Scratchpad-Werte zuzugreifen oder diese zuzuweisen. Verwenden Sie beispielsweise dieses Format, um einen bestimmten Scratchpad-Variablenwert zuzuweisen. workflow.scratchpad.variableName = variableValue; Verwenden Sie dieses Format, um einer Scratchpad-Variable eine JavaScript-Variable zuzuweisen. var myValue = workflow.scratchpad.variableName; ## Aktuelle Variablen {#ariaid-title6} Aktuell ist die GlideRecord-Datenbank, die den Workflow gestartet hat, entweder durch Zuordnung zur Tabelle in der Workflow-Eigenschaftentabelle oder durch Zuordnung zu einem Katalogelement. ### Deklaration Aktuelle Variablen sind die Spalten, die in definiert sind dictionary.xml Datei, die den Datenbankdatensatz unterstützt. Zur Laufzeit gibt es keine Möglichkeit, dem aktuellen Datensatz Variablen hinzuzufügen. ### Bildschirm Variablen eines aktuellen Datensatzes werden in Glide-Formularen und -Listen in allen Anwendungen angezeigt, die sie verwenden. ### Zugriff und Zuweisung Um auf die Variablen zuzugreifen oder den Variablen innerhalb der Workflow-Aktivität Werte zuzuweisen, rufen Sie den Wert aus dem aktuellen Datensatz ab, indem Sie auf das Glide-Element verweisen. var myVarValue = current.getElement(nameOfTheField); oder var myVarValue = current.fieldName; oder current.variableName.setValue( "A Variable Value");