Workflow - Manual do Usuário > Modelador > Automatização > Placeholders

Placeholders

Os placeholders funcionam semelhantes a ponteiros para valores que estão armazenados em outros locais, podendo ser utilizados para acessar dados do processo, tarefas, entre outros. Eles são somente leitora, não permitindo alterar os valores, apenas consultá-los.

Atualmente os placehonders podem ser utilizados nos seguintes lugares:

Sendo disponibilizados dados dos seguintes pontos do processo:

O acesso aos placeholders é realizado respeitando um dos seguintes formatos de descrição:

${<nome>}: Sendo que <nome> representa o nome da variável ou placeholder padrão que se deseja acessar.
${<nome.propriedade>}: Sendo que <nome.propriedade> representa o nome da variável e sua propriedade, para variáveis de tipo Object.

Nota

Os nomes dos placeholders são case sensitive, diferenciando letra maiúscula de minúscula.
Os placeholders são sempre acessados através da definição do seu nome e ou nome.propriedade de forma estática, não sendo possível utilizar-se de placeholders para formar o nome de outro placeholder que se deseja acessar o conteúdo.
Caso a variável ou propriedade que está sendo acessada através do placeholder seja do tipo Object, o retorno será o que for retornado pelo método toString do mesmo, sem nenhum tipo tratamento.
Não são suportados placeholders de variáveis do tipo List

Durante a execução, os valores dos placeholders são procurados respeitando as seguintes regras:

Procura-se os placeholders apenas pelo seu nome.
- Sendo encontrada uma variável com o nome correspondente, esta é utilizada.
- Caso o tipo da variável não seja válido para o campo onde está sendo utilizada, ocorre erro, sendo que a definição do erro é realizada em cada campo.
- Não sendo encontrada uma variável com o nome correspondente, é inserido vazio ("") no lugar onde o campo foi declarado.
A busca pelo nome é realizada na seguinte sequência:
- Placeholders padrão,
- Variáveis locais,
- Variáveis do processo.

Nota

A busca pelas informações nessa ordem garante que seja possível definir variáveis locais que sobrescrevam o valor de variáveis do processo, todavia, isso vale apenas para a execução daquela instância da tarefa. O valor da variável do processo quando acessado de outro ponto do processo continua o original.
Quando, em um campo que suporta placeholders, for inserido um placeholder com sua descrição errada, o restante do texto será truncado.

Placeholders padrão de funções JS

São disponibilizados placeholders padrão, que podem ser utilizados para acessar dados relativos ao processo, através das respectivas funções JavaScript. Estão disponíveis os seguintes placeholders:

Informações do processo:
- context.processId
- context.processName
Informações da instância:
- context.processInstanceId
Informações da tarefa:
- context.task.name
- context.task.description
- context.task.responsible
  Restrição:
  Válido apenas para Notificações.
- context.task.token
- context.task.expiration, data de expiração da pendência, não estando expirada, retorna vazio.
  Restrição:
  Válido apenas para Notificações.

Se for utilizado um placeholder inválido, será retornado um erro.

PORTAL DE DOCUMENTAÇÃO
Workflow - versão 6.10.1