Uso de variáveis em um fluxo de trabalho

No fluxo de trabalho, há vários tipos diferentes de variáveis disponíveis.

Algumas variáveis definem, descrevem ou compõem as partes do fluxo de trabalho (como atividades de fluxo de trabalho). Algumas variáveis estão disponíveis especificamente para facilitar a execução de um fluxo de trabalho (como variáveis do bloco de anotações). Algumas variáveis definem, descrevem ou compõem os registros de dados que estão sendo manipulados pelo processo de fluxo de trabalho (por exemplo, os elementos de um Registro Glide definidos em um arquivo dictionary.xml que descreve um registro, como um incidente).

Variáveis de atividade

As variáveis de atividade são propriedades associadas especificamente a uma atividade de fluxo de trabalho.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Elas são as entradas que aparecem na definição da atividade quando uma atividade específica é arrastada para a tela do fluxo de trabalho. Essas variáveis são propriedades que definem, compõem ou descrevem a atividade de fluxo de trabalho ou o trabalho que ela foi projetada para executar.

As variáveis de atividade são declaradas em uma lista relacionada na definição de atividade de fluxo de trabalho.

Para adicionar, exibir ou modificar uma variável:

Procedimento

1. Navegar até Tudo > Fluxo de trabalho > Definições de Atividades.
2. Selecione uma atividade de fluxo de trabalho, como Aprovação - Usuário.
3. Na seção ou guia Variáveis de atividade, adicione, exiba ou modifique as variáveis. As variáveis de atividade são definidas usando-se os mesmos campos do Dicionário do sistema.
   Nota:

   Se você estiver definindo uma nova variável de atividade que seja dependente de outra variável de atividade, coloque o prefixo "vars." antes do nome da variável de atividade primária. Por exemplo, se o campo secundário depender de um campo chamado parent, coloque o valor vars.parent no campo Dependente.

   Para controlar a visibilidade de uma variável de atividade na tela de fluxo de trabalho depois que a atividade foi arrastada para lá, use uma política de IU na tabela wf_activity.

   Para acessar as variáveis ou atribuir valores a essas variáveis na atividade de fluxo de trabalho, use a variável vars da atividade.

    activity.vars.variable_name = new_variable_value 

Variáveis de entrada do fluxo de trabalho

As variáveis de fluxo de trabalho são valores externos passados e referenciados por um fluxo de trabalho durante sua execução.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

As variáveis de fluxo de trabalho podem ser declaradas externamente em um script e passadas para um fluxo de trabalho principal ou podem ser declaradas em um fluxo de trabalho principal e passadas como entradas para um subfluxo.

Nota:

Há um tipo específico de variável de entrada para qualquer fluxo de trabalho declarado em relação à tabela Item solicitado [sc_request_item]. Para entender o uso dessas variáveis, consulte Variáveis do catálogo de fluxo de trabalho.

As variáveis de fluxo de trabalho são declaradas em um formulário disponível no menu da engrenagem do Editor de fluxo de trabalho.

Procedimento

1. Navegar até Tudo > Fluxo de trabalho > Editor de fluxo de trabalho.
2. Edite e submeta um fluxo de trabalho a check-out.
3. Selecione o menu "Atividades do fluxo de trabalho" e selecione Editar entradas.
4. Selecione uma variável existente ou selecione Nova.

   Observe o campo Nome da coluna. Use esse valor ao acessar a variável de um script.

   As variáveis de fluxo de trabalho não aparecem na tela do fluxo de trabalho; elas só estão disponíveis para exibição no menu "Atividade de fluxo de trabalho".

   As variáveis de entrada estão disponíveis para uso em scripts. Para acessar uma variável de entrada em um script:

   var input  = workflow. variables. variableName //get the workflow variable identified by column name.

Atribuição de valores a variáveis de fora do fluxo de trabalho

Depois de serem declarados em um fluxo de trabalho, os valores podem ser atribuídos às variáveis de onde o fluxo de trabalho é iniciado.

O exemplo a seguir demonstra como o valor de uma variável de fluxo de trabalho pode ser definido em uma inclusão de script, regra de negócios ou ação de IU:

 
//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 } ) ;

Outro exemplo que demonstra uma maneira mais legível de passar várias variáveis envolve declarar um objeto, adicionar nomes/valores a ele e passá-lo:

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

Atribuição de valores para entradas de subfluxo dentro de um fluxo de trabalho principal

Se um fluxo de trabalho que aceita entradas for chamado em outro fluxo de trabalho, esses valores de entrada poderão ser definidos na tela do fluxo de trabalho, na IU da atividade de fluxo de trabalho. Cada variável de entrada declarada para um subfluxo terá uma área de entrada de caixa de texto exibida na atividade. Nessas caixas de texto, as variáveis podem ser definidas com qualquer valor do bloco de anotações ou do registro atual.

Para obter mais informações, consulte Fluxos de trabalho usados como subfluxos.

Leitura do valor de uma variável de entrada de fluxo de trabalho

O valor de uma variável de entrada de fluxo de trabalho pode ser acessado em qualquer lugar do fluxo de trabalho que aceite javascript por referência com pontos ao objeto de fluxo de trabalho atual:

var readValue = workflow.inputs.variable_name;

Variáveis de bloco de anotações de fluxo de trabalho

Armazene e compartilhe variáveis baseadas em cadeia de caracteres como pares nome-valor entre atividades de fluxo de trabalho.

O bloco de anotações é global para a instância do fluxo de trabalho em execução e, como tal, está disponível igualmente para todas as atividades.

Declaração

O bloco de anotações em si está disponível automaticamente para um fluxo de trabalho em execução e não requer declaração específica. As variáveis são declaradas e armazenadas no bloco de anotações simultaneamente, fazendo referência a ele. Por exemplo:

workflow.scratchpad.variableName = variableValue;

Exibição

Exiba valores de bloco de anotações de atividade na tabela Bloco de anotações do histórico de Atividades do Fluxo de trabalho [wf_history_scratchpad]. O bloco de anotações do histórico de atividades de fluxo de trabalho também é uma lista incorporada aos registros do Histórico de atividades do Worfklow.

Figura 1. Amostra de registros do bloco de anotações sobre o histórico de atividade de fluxo de trabalho

Acesso e atribuição

Use a notação de objeto JavaScript padrão para acessar ou atribuir valores de bloco de anotações. Por exemplo, use esse formato para atribuir um valor específico de variável de bloco de anotações.

workflow.scratchpad.variableName = variableValue;

Use esse formato para atribuir uma variável JavaScript a uma variável de bloco de anotações.

var myValue = workflow.scratchpad.variableName;

Variáveis atuais

Atual é o banco de dados GlideRecord que iniciou o fluxo de trabalho, ou por associação à tabela na tabela de propriedades do fluxo de trabalho, ou por ser associado a um item do catálogo.

Declaração

As variáveis em atual são as colunas definidas no arquivo dictionary.xml que aceitam o registro do banco de dados. Não há nenhuma maneira em tempo de execução de adicionar variáveis ao registro atual.

Exibição

As variáveis de um registro atual são exibidas nos formulários e listas do Glide em todos as aplicações que os usam.

Acesso e atribuição

Para acessar as variáveis ou atribuir valores às variáveis na atividade de fluxo de trabalho, obtenha o valor do registro atual fazendo referência ao elemento do Glide.

var myVarValue = current.getElement(nameOfTheField);

ou

var myVarValue = current.fieldName;

ou

current.variableName.setValue( "A Variable Value");