Definir Variáveis

A Tarefa Definir Variáveis é a ferramenta principal para modificar e atualizar dinamicamente o valor das variáveis durante a execução de um Fluxo de Trabalho (Workflow).

Enquanto a Tarefa Declarar Variáveis é responsável por criar as variáveis no início, Definir Variáveis permite sobrescrever o seu valor com base nos resultados de Tarefas anteriores, em cálculos ou em lógicas específicas. É fundamental para implementar contadores, alterar o estado de um processo ou armazenar resultados intermédios.

Relação com a Tarefa "Declarar Variáveis"

O uso desta Tarefa está intimamente ligado à Tarefa Declarar Variáveis:

• Dependência: Definir variáveis pode modificar apenas variáveis que foram previamente criadas por uma Tarefa Declarar Variáveis presente a montante no fluxo. Não pode criar novas variáveis.
• Acessibilidade: Não é necessário que a Tarefa Declarar Variáveis seja imediatamente anterior; basta que tenha sido executada em qualquer ponto antes da Tarefa Definir Variáveis atual.

Configuração (Aba "Configuration")

A configuração consiste numa tabela onde cada linha representa a atualização de uma única variável.

1. Seleção da Variável a Modificar

Na coluna Variables é possível selecionar uma variável criada pela tarefa Declarar Variáveis.

Nota

Na ausência de ligações com tarefas anteriores, nenhuma variável estará disponível nesta secção.

2. Definição do Novo Valor

Após selecionar a variável, define-se o novo valor a atribuir:

• Type: Escolha o tipo de dado para o novo valor.
• String: Para valores textuais.
• Number: Para valores numéricos.
• Expression: Para atribuir o resultado de uma expressão matemática ou lógica.
• Value: Insira o novo valor.
• Valor Estático: Pode digitar diretamente um valor fixo (ex: Concluído ou 100).
• Valor Dinâmico: Ao clicar em botão ≡, abre-se a "Parameters List" onde é possível selecionar parâmetros de outras Tarefas, funções ou a própria variável para criar expressões complexas.

Exemplo

1. Estado Inicial: Uma Tarefa Declarar Variáveis no início do Fluxo de Trabalho cria uma variável numérica chamada "count" e a inicializa em 0.
2. Ação de Atualização: Noutro ponto do fluxo (por exemplo, dentro de um loop), uma Tarefa Definir Variáveis é configurada para modificar a variável "count".
3. Configuração Detalhada:

• Variables: No menu suspenso, seleciona-se “count”.
• Type: Define-se como Expression.
• Value: Insere-se a expressão “#>Declare variables.count<# + 1”. Esta expressão lê o valor atual da variável “count” e soma-lhe 1.

4. Resultado: Após a execução desta Tarefa, o valor da variável “count” (visível na secção "Variáveis do Fluxo de Trabalho") será 1. Se a Tarefa for executada novamente, o valor passará a ser 2, e assim por diante.

Parâmetros de Saída e Impacto no Fluxo de Trabalho

A Tarefa Definir Variáveis não introduz novos Parâmetros de Saída com o seu nome. Em vez disso, o seu resultado é a modificação direta do valor da variável na secção Variáveis do Fluxo de Trabalho da Lista de Parâmetros.

Qualquer Tarefa executada subsequentemente a Definir Variáveis lerá o valor atualizado da variável.

Notas Importantes

• Não é possível definir a mesma variável mais de uma vez dentro da mesma instância da Tarefa Definir Variáveis. Para atualizar a mesma variável em pontos diferentes do fluxo, é necessário usar várias Tarefas Definir Variáveis.
• As variáveis disponíveis no menu suspenso dependem unicamente da Tarefa Declarar Variáveis presente no Fluxo de Trabalho.