Visão geral das variáveis

Última atualização : Aug 06, 2024 |

Uma variável é uma representação simbólica dos dados acessados sem digitá-los. A introdução de variáveis é útil quando você usa os mesmos valores em vários locais. Por exemplo, caso use a mesma URL em vários locais, é possível adicioná-la como uma variável global. Se a URL mudar, você só precisa alterar um valor na variável. As variáveis estão disponíveis em Orquestração e Automação. O Orquestração altera esse valor em todos os fluxos de trabalho nos quais essa variável global é usada.

No Orquestração, as variáveis são pares de chave/valor. Cada nome de variável representa sua chave. Portanto, ao fazer referência ao nome da variável, é possível acessar seu valor.

O Orquestração usa os seguintes tipos de variáveis:

  • Global

  • Local

Como um usuário Analista de negócios, você pode acessar variáveis digitando um valor estático de variável no campo correspondente. Esse valor permanece constante durante o tempo de execução.

Como um usuário Administrador, você pode digitar valores estáticos de variável no campo correspondente. Também é possível selecionar uma variável que obtenha valores em tempo real e esteja associada ao atendimento. Para adicionar uma variável, clique em o ícone Adicionar variável e selecione uma variável nas opções disponíveis.

Variáveis globais

As variáveis globais são entidades com o nome e o valor atribuídos que estão disponíveis para uso em todos os fluxos de trabalho. É possível criar, exibir, editar e excluir variáveis no Gerenciador de Orquestração. Caso edite uma variável global, a alteração é aplicada a todos os fluxos de trabalho nos quais a variável esteja em uso. Para evitar erros, não altere ou exclua a variável global durante a execução do fluxo de trabalho.

Para adicionar uma variável, clique em o ícone Adicionar variável e selecione Variáveis globais na lista de opções disponíveis. Por exemplo, é possível criar as seguintes variáveis:

Nome da variável

Valor

host

avaya.com

protocolo

https

porta

443

É possível usá-las da seguinte maneira no campo URI REST da tarefa API REST: GlobalVariables.protocol://GlobalVariables.host:GlobalVariables.port/updaterecords

Variáveis locais

As variáveis locais estão disponíveis apenas para o fluxo de trabalho específico e são representadas no Orquestração com variáveis de cache e de tarefa.

Uma interação acumula dados conforme percorre um fluxo de trabalho. Por exemplo, o Iniciar tarefa está associado ao evento ENGAGEMENT_PREROUTED. O Iniciar tarefa contém um conjunto avançado de dados relacionado à interação e aos dados coletados durante o pré-roteamento. Para disponibilizar essas informações para tarefas downstream, esses dados ficam disponíveis no cache de fluxo de trabalho.

O cache de fluxo de trabalho é o termo usado para descrever a coleta de dados disponíveis no fluxo de trabalho. O cache está disponível para o usuário Administrador a fim de facilitar a personalização e a configuração avançadas. Para acessar o cache, é possível selecionar Variáveis de cache em caixas de texto nas quais os dados são inseridos. Você pode selecionar os dados necessários na lista de itens que estão atualmente disponíveis no cache. Para adicionar ou substituir uma variável de cache, use a guia Mapeamento de resultados da tarefa API REST ou Funções do Azure. Um exemplo de uma variável de cache é uma lista de atributos que o Orquestração usa para roteamento.

Também é possível trabalhar com dados no nível da tarefa. O Orquestração cria resultados de tarefa ao receber dados e nome do resultado. Você pode usar os resultados da tarefa na tarefa na qual recebeu o resultado e em todas as tarefas subsequentes do fluxo de trabalho que estão direta ou indiretamente conectadas a essa tarefa. O Orquestração diferencia entre:

  • Variáveis de resultado: resultados das tarefas anteriores.

  • Variáveis da tarefa atual: resultados da tarefa atual.

Para configurar uma tarefa, configure as propriedades da tarefa, cujo intervalo difere dependendo da tarefa. Com as tarefas API REST e Funções do Azure, é possível adicionar todos os tipos de variáveis como valores às propriedades da tarefa. Para adicionar ou substituir um valor na propriedade da tarefa, use o campo Destino na guia Mapeamento de resultados da tarefa API REST. Você pode ver as propriedades da tarefa em instâncias de fluxo de trabalho.

Nota:

Caso remova ou edite uma variável de um fluxo de autoatendimento, também será necessário remover ou editar a variável no fluxo de trabalho em Orquestração. Modifique as tarefas downstream, como Iniciar automação, que usam a variável removida ou editada, caso contrário, o fluxo de trabalho terminará com um erro durante a chamada.



Tipos de variáveis