Tipos de variáveis com suporte no Process Composer

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:

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

Este valor variável meta-tipo é da solicitação.
Tarefa
As tarefas podem conter três tipos de variáveis (entrada, saída, meta) e usam esses formatos:
Esse valor variável de entrada ou saída é lido na tarefa.
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
Tarefa de API
  • 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$

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

Nome Entidade Descrição
Qualquer um Tarefa 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.