A parte central de qualquer automação de processo no Process Composer é como os dados se movem (fluem) entre cada tarefa. Para serem executadas corretamente, as tarefas exigem variáveis.

Tipos de variáveis

Esses tipos de variáveis são compatíveis em uma automação de processo no Process Composer:

Entrada
Use esse tipo de variável para retornar valores que “entraram” em uma tarefa.
Saída
Use esse tipo de variável para retornar valores que “saíram” de uma tarefa.
Meta
Use esse tipo de variável para retornar detalhes de alto nível sobre a solicitação de uma tarefa.
Nota: Você pode usar variáveis ocultas para esconder dados. Para ver mais detalhes sobre como configurar variáveis ocultas, consulte Criar variáveis ocultas em um formulário.

Entidades variáveis

As seguintes entidades podem conter variáveis:

Valor global
Os valores globais abrangem todo o locatário e todos os tipos de variáveis e usam esse formato: $@variableName$.
ProcessRequest
As solicitações contêm apenas variáveis meta-tipo e usam esse formato:

Formato da variável

Este valor variável meta-tipo é da solicitação.
Elemento
As tarefas podem conter três tipos de variáveis (entrada, saída, meta) e usam esses formatos:
Formato da variável Esse valor variável de entrada ou saída é lido na tarefa.
Formato da variável Este valor variável meta-tipo é lido a partir da tarefa.

Com base no tipo de tarefa, os seguintes valores de metadados de Status são suportados:

Tipo de tarefa Valores suportados para metadados de Status
API Task
  • FALHOU
  • SYSTEM_EXPIRED
  • ÊXITO
  • IN_PROGRESS
  • INITIATED
  • QUEUED
  • DEPLOY_FAILED
  • NOT_KNOWN
  • UNRECOGNIZED
Tarefa Bot
  • FALHOU
  • SYSTEM_EXPIRED
  • ÊXITO
  • IN_PROGRESS
  • INITIATED
  • QUEUED
  • DEPLOY_FAILED
  • NOT_KNOWN
  • UNRECOGNIZED
Processar tarefa
  • ÊXITO
  • OPENED
  • ERROR
  • CANCELLED
Tarefa de formulário
  • SYSTEM_EXPIRED
  • Rótulo do botão Formulário
Para obter mais detalhes, consulte Adicionar tarefa de formulário a uma automação de processo.
Tarefa de aprovação Uma "string" localizada com uma opção para selecionar as opções Aprovado ou Recusado em qualquer condição no processo, seja qual for o rótulo do botão (comportamento diferente da tarefa de formulário).
Tarefa de filtro
  • FALHOU
  • IN_PROGRESS
  • COMPLETE
Tarefa de validação do documento
  • SYSTEM_EXPIRED
  • VALIDATION_SUCCESS
  • VALIDATION_INVALID
  • VALIDATION_REPROCESS

Variáveis de data e hora

Nome Entidade Descrição
criadoEm Solicitação, tarefa Mostra a data em que a solicitação ou tarefa foi criada.

Exemplo: $createdOn$ ou $Approval_Task.createdOn$

atualizadoEm Solicitação, tarefa Mostra a data da última atualização da solicitação ou da tarefa.

Exemplo: $updatedOn$ ou $Approval_Task.updatedOn$

submittedOn Solicitação, tarefa Mostra a data em que a solicitação ou tarefa foi enviada.

Exemplo: $submittedOn$ ou $Approval_Task.submittedOn$

openedOn Solicitação, tarefa Mostra a data em que a solicitação ou tarefa foi aberta.

Exemplo: $openedOn$ ou $Approval_Task.openedOn$

Variável de dicionário

Nome Entidade Descrição
atribuídoA Tarefa Mostra informações sobre o usuário designado para a tarefa.

Chave do dicionário: {id}, {username}, {email}

Exemplo: $Approval_Task.assignedTo$

createdBy Solicitação Mostra informações sobre o usuário que criou a solicitação.

Chave do dicionário: {id}, {username}, {email}

Exemplo: $createdBy$

Variáveis numéricas

Nome Entidade Descrição
Contagemexecução Tarefa Mostra o número de vezes que a tarefa foi executada.

Exemplo: $Name_Bot.executionCount$

id Solicitação, tarefa Mostra a identificação numérica de uma solicitação ou tarefa.

Exemplo: $id$ ou $Approval_Task.id$

atribuídoA{id} Tarefa Mostra a identificação numérica do usuário designado para a tarefa.

Exemplo: $Approval_Task.assignedTo{id}$

criadoPor{id} Solicitação Mostra a identificação numérica do usuário que criou a solicitação.

Exemplo: %createdBy{id}$

Variáveis de string

Nome Entidade Descrição
status Tarefa Mostra o rótulo do botão clicado (ação) para uma tarefa de formulário ou o código de retorno do bot para uma tarefa de bot (falha quando o bot falha).

Exemplo: %Approval_Task.status$ ou $Name_Bot.status$

título Solicitação, tarefa Mostra o título da solicitação ou tarefa.

Exemplo: %title$ ou %Approval_Task.title$

tipo Solicitação Mostra o tipo de tarefa (BOT para tarefas de bot e FORMULÁRIO para tarefas de formulário).

Exemplo: %Task.type$

atribuídoA{username} Tarefa Mostra o nome de usuário do usuário designado para a tarefa.

Exemplo: $Approval_Task.assignedTo{username}$

criadoPor{username} Solicitação Mostra o nome de usuário do usuário que criou a solicitação.

Exemplo: $createdBy{username}$

assignedTo{email} Tarefa Mostra o e-mail do usuário designado para a tarefa.

Exemplo: $Approval_Task.assignedTo{email}$

criadoPor{email} Solicitação Mostra o e-mail do usuário que criou a solicitação.

Exemplo: $createdBy{email}$

Variável definida pelo usuário

Nota: Ao criar variáveis definidas pelo usuário com o tipo de variável definido como saída, as variáveis de saída com expressões são exibidas no painel de propriedades do nó Início.
Nome Descrição
Qualquer Armazena os tipos de dados booliano, tabela de dados, data e hora, arquivo, número, registro, string ou janela.

Use esse tipo de variável quando não tiver certeza do tipo de dados da ação.
Booliano

Bool

Armazena um valor True ou False
Credencial

Cred

Armazena valores de string com segurança, impedindo que valores sejam exibidos em uma caixa de mensagem ou gravados em um arquivo. O valor é selecionado do Credential Vault ou é fornecido pelo usuário.
Data/hora

Data

Armazena um valor contendo um único valor de data e hora. Você pode formatar os valores selecionando um formato predefinido ou especificando um formato personalizado.
Dicionário

Dict

Armazena dados na forma de pares de valor-chave. O valor pode ser booleano, número ou string.
Arquivo

Arquivo

Armazena um caminho de arquivo.
Lista

Lista

Armazena uma sequência de valores booleanos, numéricos ou string.
Número

Num

Armazena valores numéricos.
Gravar

Gravar

Armazena uma única linha de valores extraídos de uma tabela. O valor pode ser booleano, data/hora, número ou string.
String

Str

Armazena caracteres alfanuméricos e especiais,e valores vazios.
Tabela

Tabela

Armazena vários valores em uma tabela de linhas e colunas. O valor pode ser booleano, data/hora, número ou string.
Janela

Win

Armazena um título de janela e URL.