Variáveis personalizadas

O Insights sempre consome dados por meio dos campos predefinidos disponíveis no modelo de dados do Insights, mas os administradores também podem configurar variáveis personalizadas extraídas de logs e filas de robôs para usar para calcular KPIs específicos ou criar painéis mais especializados.

Dica:

• Para incluir variáveis personalizadas para processos, você deve primeiro certificar-se de que elas são adicionadas aos logs em sua automação por meio da atividade UiPath.System.Activities.AddLogFields no Studio e, em seguida, deve selecioná-las para ingestão.
• Para incluir variáveis personalizadas para filas você deve primeiro certificar-se de que elas são adicionadas em fluxos de trabalho por meio de uma atividade no Studio e depois selecioná-las para a ingestão.
  • Use a atividade UiPath.System.Activities.AddQueueItem para dados específicos;
  • Use a atividade UiPath.System.Activities.SetTransactionStatus para Dados de saída e Dados de análise.

Configuração de variáveis personalizadas

Para configurar variáveis personalizadas, um administrador deve adotar as seguintes medidas:

1. Abra o menu de 3 pontos no canto superior direito de qualquer página do Insights e selecione Configurar variáveis personalizadas. A página de configuração abre, listando todos os campos personalizados que estão disponíveis para extração.

2. Decide whether you want to configure custom variables for processes or queues by selecting the corresponding tab at the top of the configuration page.

   
   

   

   
   
3. Na coluna Extrair, escolha as variáveis personalizadas que você deseja usar ao criar painéis.

4. Na coluna Tipo, selecione o tipo da variável personalizada. Você pode escolher String, Número ou DataHora.

   Importante:

   • Os campos são limitados a 40 caracteres, e quaisquer caracteres após esse número serão cortados. Para adicionar mais de 40 caracteres, altere o sinalizador Insights.Etl.Json.MaxStringLen. Você pode adicionar esse sinalizador na configuração da web do Orchestrator e definir o valor de acordo com as necessidades de seu projeto. Por exemplo:

   <add key="Insights.Etl.Json.MaxStringLen" value="60" />

   • A porcentagem de preenchimento mostra o progresso da extração de uma variável personalizada de todos os processos ou filas. Você precisará atualizar a página para ver a porcentagem mais recente de preenchimento. Isso pode levar algum tempo dependendo do tamanho dos dados. Os valores de variáveis personalizadas serão preenchidos começando dos dados mais novos até os mais antigos. O campo estará disponível para uso logo após a configuração ser salva — você não precisará esperar até ele ser 100% preenchido.
   • Você pode extrair variáveis de no máximo 500 processos ou filas por tenant, e no máximo 200 variáveis por processo ou fila.
   • Se você definir o Tipo de uma variável personalizada como Número, certifique-se de que ela não contém um , ou outros caracteres não numéricos, como $, pois esses caracteres não são compatíveis. Para números com caracteres especiais, selecione o tipo String.
   • Toda mudança na configuração de variáveis personalizadas causará um novo preenchimento completo para esse processo específico. O tempo do preenchimento depende do número de registros armazenados no banco de dados do Insights para esse processo específico.

5. Salve a configuração. Todas as variáveis extraídas para um processo específico devem aparecer em um Explorar com o nome *Processo — NomedoProcesso, e todas as variáveis extraídas para uma fila específica devem aparecer em um Explorar com o nome *Fila — NomedaFila.

   Importante: Você pode extrair variáveis de no máximo 500 processos ou filas por tenant, e no máximo 200 variáveis por processo ou fila.

   Número de variáveis personalizadas configuradas	Escala de hardware	Número de processos	Número de logs de robô por processo	Tempo aproximado para extração
   30	Grande escala	1	1.000.000	5 minutos
   30	Grande escala	1	40.000.000	120 minutos

Editar uma configuração existente

Para editar uma configuração existente, um administrador deve adotar as seguintes medidas:

1. Abra o menu de 3 pontos no canto superior direito de qualquer página do Insights e selecione Configurar variáveis personalizadas. A página de configuração abre, listando todos os campos personalizados que estão disponíveis para extração.
2. Decide whether you want to configure custom variables for processes or queues by selecting the corresponding tab at the top of the configuration page.
3. Para remover variáveis que foram selecionadas anteriormente, desmarque a caixa de seleção Extrair.
4. Para alterar o tipo de variável, selecione o novo tipo desejado no menu suspenso.
5. Certifique-se de salvar a configuração.
6. Executar as seguintes verificações nos painéis existentes que usaram uma variável modificada ou removida:
   1. Se você excluiu a variável, certifique-se de remover quaisquer referências a essa variável de fórmulas que foram criadas ou modificadas, de filtros ou de visualizações internas;
   2. Se você alterou o tipo de variável, certifique-se de que o novo tipo ainda se aplica corretamente;

Exemplo de configuração

Esta seção fornece um exemplo de uso de uma variável personalizada em um painel.

Adote as seguintes medidas para configurar variáveis personalizadas:

1. Selecione a variável ProcessCount para extração e escolha o tipo String.

2. Enable the Argument1_Email variable, and select the String type and then select Save.

   
   

   

   
   
3. Navegue de volta para Painéis, crie um novo painel e adicione um novo bloco.

4. Escolha o Explorar *Processo — CustomLogs2 e escolha a exibição CustomLogs2 para usar as variáveis personalizadas configuradas desse processo em seu bloco.

   
   

   

   
   

Casos nulos de variáveis personalizadas

As variáveis personalizadas podem ter um valor nulo em alguns casos específicos, conforme descrito nas seções a seguir.

Cenário 1

Se você usar um campo do modelo de dados padrão em uma visualização combinada com um campo de variável personalizada específico do processo e um processo não contiver a variável personalizada nos logs de robô, o valor de todos os campos associados ao processo que não contiverem a variável personalizada em seus logs de robôs é nulo.

Há duas maneiras de eliminar os valores nulos para esse cenário:

• Opção 1: adicione a variável personalizada como filtro e defina a condição como não é nula
  
  

  

  
  
• Option 2: Set a filter for the process name that does include the custom variable. Note, however, that if you adopt this approach, you may run into the second scenario.
  
  

  

  
  

Cenário 2

If a custom variable is not present in all logs generated by a process, the logs that do not contain a value for that custom variable will show the variable's value as null as captured in the following image .

O exemplo a seguir ilustra esse caso específico.

1. Acesse Configurar variáveis personalizadas. Você pode ver que o campo da variável personalizada Birthday2 ocorre no processo CustomLogs2.

   
   

   

   
   
2. Abra um painel novo ou existente e adicione um bloco.
3. Navegue até o Explorar CustomLogs2. Selecione o campo Nome do processo na exibição Trabalhos e o campo da variável personalizada. Nesse caso, o campo da variável personalizada é CustomLogs2.Birthday2.

4. Select Run. The results you see should be similar to the ones shown in the following screenshot.

   
   

   

   
   

Para eliminar os valores nulos, adicione o campo de variável personalizada como um filtro. Por fim, defina a condição como não é nula, de modo que você possa remover os valores nulos da visualização.

Nota: Esses dois casos ocorrem ao visualizar os dados brutos do campo personalizado. Ao aplicar uma função (Soma, Média, etc.) às variáveis personalizadas, você exclui valores nulos.

Solução de problemas e limitações

Consulte a seção de Solução de problemas para obter informações sobre solução de problemas e limitações.