ID da instância personalizada

Visão geral

Por padrão, o Maestro identifica cada instância de processo por uma ID gerada pelo sistema. Uma ID da instância personalizada permite substituir esse rótulo por um valor dinâmico e legível por humanos (como um número de pedido ou um nome de cliente) derivado dos dados que o processo recebe no runtime.

A ID da instância personalizada é exibida diretamente na lista de instâncias, para que você possa identificar por que uma instância foi executada e por qual valor, sem abrir a instância.

Pré-requisitos

• Um processo agêntico aberto na tela do Maestro.
• O processo tem um evento inicial.

Configuração de um\ ID de instância personalizada

Para configurar uma ID de instância personalizada, defina a expressão nas propriedades do evento de início antes de publicar o processo.

1. Selecione o evento inicial na tela.

2. No painel Propriedades, acesse a seção Geral.

3. No campo ID da instância personalizada, defina o valor usando uma das opções a seguir:

   • Variável — selecione uma variável de evento inicial ou argumento de entrada.
   • Expressão — crie uma expressão que combine variáveis ou formatos de saída, como por exemplo: string.Format("Order: {0}", vars.OrderId).
   • Literal — insira um valor de texto fixo.

4. Publique o processo.

Resultado

Quando uma instância é executada, o Maestro avalia a expressão ID de instância personalizada após a conclusão do evento inicial e exibe o resultado como o nome da instância na lista de instâncias.

Se a expressão fizer referência a variáveis que ainda não foram resolvidas no momento da avaliação, a ID da instância personalizada será exibida em branco até que o valor esteja disponível.

Limitações

• Você pode configurar IDs de instâncias personalizadas apenas em eventos iniciais. As IDs de instâncias personalizadas são avaliadas uma vez, imediatamente após a execução do evento inicial. Os valores definidos em atividades ou eventos finais não são aplicados.
• A pesquisa e a filtragem de instâncias por ID de instância personalizada no gerenciamento de instâncias, Insights e Process Mining ainda não são compatíveis.