Tokens de instâncias de solicitações

Instância da solicitação

Os tokens de instância de solicitação trazem informações sobre a solicitação em execução no momento. Eles podem ser usados em:

• Configuração de eventos de e-mail / mensagem

• Configuração de caixa de entrada

• Integrações, desde que estejam rodando dentro da instância de solicitação

Os tokens de instâncias de solicitações não funcionam corretamente se forem usados como valor padrão em um campo no Evento de Início do aplicativo. Isso ocorre porque, nesse estágio, o aplicativo está apenas sendo iniciado, e a solicitação ainda não foi registrada no banco de dados. Como a solicitação ainda não existe, os tokens não conseguem exibir informações, pois esses dados ainda não foram gerados. Apenas após a criação da solicitação (quando a instância é efetivamente registrada no sistema), os tokens conseguem acessar e exibir as informações corretamente.

Para utilizar os tokens de instâncias de forma eficiente, é recomendável fazê-lo em eventos subsequentes ao início do aplicativo, onde a solicitação já estará criada e as informações estarão disponíveis para uso.

A instância de uma solicitação é uma execução única. Por exemplo, Solicitação "Pedido de compras" realizada em 31/12, por John Doe, de número 1234".

Token	Descrição	Exemplo de valor
{Instance.FlowId}	Código identificador único do aplicativo de processo	1234
{Instance.Id}	Código identificador único da solicitação	5678
{Instance.UID}	Guid único de identificação da solicitação	63f62bb6-c1dc - 48eb-b8d2 -d9315c20d80d
{Instance.StartDate}	Data da solicitação	20/05/2020
{Instance.StartDateTime}	Data e hora da solicitação	20/05/2020 20:55
{Instance.EndDate}	Data de finalização	21/05/2020
{Instance.EndDateTime}	Data e hora de finalização	21/05/2020 20:55
{Instance.Simulation}	Indicador se é uma simulação	S / N
{Instance.FlowName}	Nome do aplicativo de processo	Solicitação de compras
{Instance.FlowVersion}	Versão do aplicativo de processo	2
{Instance.ConfirmationCode}	Código de verificação para acesso ao relatório da solicitação	RF9LX8
{Instance.LinkReport}	Link para acesso ao relatório de detalhamento da solicitação	https://suaempresa....
{Instance.Team}	Nome do time do solicitante	Compras
{Instance.Position}	Nome da função do solicitante	Diretor
{Instance.Xml}	Xml do aplicativo de processo	<?xml version="1.0" encoding="ISO-8859-1" ?><workflow><execute...
{Instance.LastReason}	A última justificativa de ação preenchida por uma pessoa ao clicar em botão de tarefa humana.	A solicitação está sendo rejeitada por falta de verba.
{Instance.InstanceTaskId}	Código único de identificação da instância da tarefa atual.	14566

Para que os tokens {Instance.Team} e {Instance.Position} funcionem é necessário que a pessoa cadastrada no Zeev possua um time e função vinculado ao seu usuário e que, no controle de acesso ao aplicativo, tenha configurações definidas.

ATENÇÃO: ao copiar um token diretamente do manual, a informação é copiada exatamente com os mesmos estilos e configurações do conteúdo copiado. Como, para destacar os tokens, utilizamos o negrito, ao colar esta informação em um editor de texto HTML (como o "Corpo da mensagem" do Evento de mensagem), a informação é inserida com o mesmo conteúdo (html) copiado. Assim, utilizar CTRL + C > CTRL + V deixará o token não funcional.

Por isso temos 2 alternativas:

1. Utilizar o atalho Ctrl + Shift + V ao colar os tokens no campo "Corpo da mensagem" ou editores HTML, garantindo que apenas o texto sem formatação seja inserido.

2. Utilizar o seletor de tokens disponível no canto superior direito aos campos nos quais os tokens estão disponíveis, facilitando a inserção correta dos tokens.