Variablen in einem Workflow verwenden

Innerhalb des Workflows stehen verschiedene Arten von Variablen zur Verfügung.

Einige Variablen definieren, beschreiben oder bilden die Teile des Workflows (z. B. Workflow-Aktivitäten). Einige Variablen stehen speziell zur Verfügung, um die Ausführung eines Workflows zu erleichtern (z. B. Scratchpad-Variablen). Einige Variablen definieren, beschreiben oder bilden die Datensätze, die vom Workflow-Prozess bearbeitet werden (z. B. die Elemente eines Glide-Datensatzes, die in einer Datei dictionary.xml definiert sind und einen Datensatz beschreiben, 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 in die Workflow-Canvas gezogen wird. Bei diesen Variablen handelt es sich um Eigenschaften, die die Workflow-Aktivität oder die von ihr auszuführenden Aufgaben definieren, bilden oder beschreiben.

Aktivitätsvariablen werden in einer zugehörigen Liste innerhalb der Workflow-Aktivitätsdefinition deklariert.

Eine Variable hinzufügen, anzeigen oder ändern:

Prozedur

1. Navigieren zu Alle > Workflow > Aktivitätsdefinitionenan.
2. Wählen Sie eine Workflow-Aktivität aus, z. B. Genehmigung - Benutzer.
3. Im Abschnitt oder auf der Registerkarte Aktivitätsvariablen können Sie die Variablen hinzufügen, anzeigen oder ändern. 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ängt, geben Sie das Präfix „vars.“ vor dem Namen der übergeordneten Aktivitätsvariablen ein. Wenn das untergeordnete Feld zum Beispiel von einem Feld abhängig ist, das als übergeordnet bezeichnet wird, geben Sie den Wert vars.parent in das abhängige Feld ein.

   Um die Sichtbarkeit einer Aktivitätsvariablen auf der Workflow-Canvas zu steuern, nachdem die Aktivität auf die Canvas gezogen wurde, verwenden Sie eine UI-Richtlinie für die Tabelle „wf_activity“.

   Um auf die Variablen zuzugreifen oder diesen Variablen innerhalb der Workflow-Aktivität Werte zuzuweisen, verwenden Sie die Vars-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 diesem 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 innerhalb eines Haupt-Workflows deklariert und als Eingaben an einen Subflow übergeben werden.

Hinweis:

Es gibt eine bestimmte Art von Eingabevariable für jeden Workflow, der für die Tabelle „Anforderungselement [sc_request_item]“ deklariert ist. Informationen zur Verwendung dieser Variablen finden Sie unter Workflow-Katalogvariablen.

Workflow-Variablen werden in einer Form deklariert, die über das Betriebsmenü von Workflow-Editors verfügbar ist.

Prozedur

1. Navigieren zu Alle > Workflow > Workflow-Editoran.
2. Bearbeiten Sie einen Workflow, und checken Sie ihn aus.
3. Wählen Sie das Menü „Workflow-Aktivitäten“ und wählen Sie Eingaben bearbeiten.
4. Wählen Sie eine vorhandene Variable aus, oder wählen Sie aus Neu .

   Beachten Sie das Feld Spaltenname. 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.

Werte zu Variablen außerhalb des Workflows zuweisen

Nach der Deklaration in einem Workflow können den Variablen Werte zugewiesen werden, von denen aus der Workflow gestartet wird

Das folgende Beispiel veranschaulicht, wie der Wert einer Workflow-Variablen in einer Skripteinbindung, einer Business Rule oder einer 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 anderes Beispiel, das eine besser lesbare Methode zum Übergeben mehrerer Variablen veranschaulicht, umfasst das Deklarieren 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 in der Anwenderoberfläche der Workflow-Aktivität festgelegt werden. Für jede für einen Subflow deklarierte Eingabevariable wird in der Aktivität ein Textfeldeingabebereich angezeigt. In diesen Textfeldern können die Variablen mit einem beliebigen Wert entweder vom Scratchpad oder vom aktuellen Datensatz aus festgelegt werden.

Weitere Informationen finden Sie unter Workflows, die als Subflows verwendet werden.

Wert einer Workflow-Eingabevariablen lesen

Auf den Wert einer Workflow-Eingabevariablen kann an jeder Stelle innerhalb des Workflows zugegriffen werden, die Javascript akzeptiert, indem das aktuelle Workflow-Objekt mit Dot-Walking aufgerufen wird:

var readValue = workflow.inputs.variable_name;

Workflow-Scratchpad-Variablen

Speichern und teilen Sie Zeichenfolge-basierte Variablen als Name-Wert-Paare zwischen Workflow-Aktivitäten.

Das Scratchpad ist für die Instanz des laufenden Workflows global und steht als solches für alle Aktivitäten gleichermaßen zur Verfügung.

Deklaration

Das Scratchpad selbst steht automatisch für einen auszuführenden Workflow zur Verfügung und bedarf keiner besonderen Deklaration. Variablen werden gleichzeitig deklariert und im Scratchpad gespeichert, indem darauf verwiesen wird. Zum Beispiel:

workflow.scratchpad.variableName = variableValue;

Bildschirm

Zeigen Sie die Scratchpad-Aktivitätswerte in der Tabelle „Workflow-Aktivitätsverlauf-Scratchpad“ [wf_history_scratchpad] an. Workflow-Aktivitätsverlauf-Scratchpad ist auch eine eingebettete Liste in Worfklow-Aktivitätsverlauf-Datensätze.

Abbildung : 1. Beispiel Scratchpad-Datensätze zum Workflowaktivitätsverlauf

Zugriff und Zuweisung

Verwenden Sie die standardmäßige JavaScript-Objektnotation, um auf Scratchpad-Werte zuzugreifen oder diese zuzuweisen. Verwenden Sie dieses Format beispielsweise, um einen bestimmten Wert für die Scratchpad-Variable zuzuweisen.

workflow.scratchpad.variableName = variableValue;

Verwenden Sie dieses Format, um einer Scratchpad-Variablen eine JavaScript-Variable zuzuweisen.

var myValue = workflow.scratchpad.variableName;

Current-Variablen

„Current“ ist die Datenbank GlideRecord, die den Workflow gestartet hat, entweder durch Zuordnung zu der Tabelle in der Workflow-Eigenschaftstabelle oder durch Zuordnung zu einem Katalogelement.

Deklaration

Variablen in „Current“ sind die Spalten, die in der Datei dictionary.xml definiert sind, die den Datenbanksatz unterstützt. Zur Laufzeit gibt es keine Möglichkeit, Variablen zum Current-Datensatz hinzuzufügen.

Bildschirm

Variablen eines Current-Datensatzes werden in den Anwendungen, in denen sie verwendet werden, in den Glide-Formularen und -Listen angezeigt.

Zugriff und Zuweisung

Um auf die Variablen zuzugreifen oder den Variablen innerhalb der Workflow-Aktivität Werte zuzuweisen, rufen Sie den Wert aus dem Current-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");