Verwenden von Variablen in einem Workflow

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 ). 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

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 Alle > Workflow > Aktivitä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 .
   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

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.

Workflow-Variablen werden in einem Formular deklariert, das über das Zahnradmenü des Workflow-Editors verfügbar ist.

Prozedur

1. Navigieren zu Alle > Workflow > Workflow-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

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.

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

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

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");