Adicionar dados personalizados ao Insights

Importante:

• Para implantações que excedam 75 processos e/ou filas com dados personalizados adicionados por tenant, você deve adicionar as tabelas de processos e filas desejadas a uma lista de permissões ou Ativar agrupamento de tabelas.
• Um alerta configurável é exibido avisando você quando você está se aproximando desse limite.
• O agrupamento de tabelas também pode precisar ser ativado com base no número total dessas tabelas em todos os tenants. Revise os Requisitos de hardware e software para obter detalhes adicionais.
• O número de colunas em processamento e tabelas de fila é limitado a 40.

Design de fluxo de trabalho para o Insights

Importante: Nomes exclusivos que não diferenciam maiúsculas de minúsculas devem ser usados para todas as variáveis personalizadas (ou seja não use successfulTransaction e SuccessfulTransaction). Se suas variáveis não são exclusivas, você deve definir o Insights para não diferenciar maiúsculas de minúsculas.

Ao projetar seus fluxos de trabalho de automação destinados ao consumo e análise no Insights, há alterações a serem consideradas na abordagem de melhores práticas usada até hoje.

Não é necessário "etiquetar" itens individuais e/ou pontos de dados para garantir sua disponibilidade para análise no Insights. Para todos os processos e/ou filas com campos personalizados, uma tabela personalizada é gerada automaticamente com esses campos disponíveis.

As seguintes atividades podem ser usadas no design de seus fluxos de trabalho de automação para capturar os dados desejados:

• Adicionar Campos de Log - todos os campos de log adicionados são ingeridos como uma tabela personalizada no Insights. Consulte [aqui] (doc:adding-custom-data-to-insights#logs) para obter mais detalhes.
• Adicionar item de fila — todos os dados adicionados por meio da propriedade ItemInformation são ingeridos como uma tabela personalizada no Insights. Veja aqui para obter mais detalhes.
• Definir status de transação — todos os dados adicionados por meio das propriedades Analytics e Output são ingeridos como uma tabela personalizada no Insights. Veja aqui para obter mais detalhes.

Para obter detalhes completos sobre todos os dados ingeridos pelo Insights, consulte a página Modelo de dados do Insights.

Observação:

Para aqueles fluxos de trabalho que você deseja analisar no Insights, é recomendável registrar todos os dados desejados no final de cada fluxo de trabalho.

Onde anteriormente você usaria a atividade do RemoveLogFields no final de qualquer sequência individual para remover logs não necessários no restante do fluxo de trabalho, a remoção de todos os logs personalizados como tal faz com que o processo e os dados não sejam ingeridos no banco de dados do Insights.

Logs

Existem 2 métodos para utilizar os logs para enviar dados ao Insights:

• Mensagem de log - permite adicionar uma mensagem de string personalizada que é enviada ao Insights, na forma de um evento de log, em caso de erro no fluxo de trabalho.
• Adicionar campos de log - permite adicionar variáveis personalizadas aos painéis do Insights padrão.

Quando o Insights detecta que uma mensagem de log possui campos de log personalizados adicionados por meio da atividade Adicionar Campos de Log, uma nova tabela é criada no Insights contendo esses campos personalizados com o título "Process-<your process name>”. Esses campos personalizados são extraídos da mensagem bruta por meio de um analisador JSON personalizado e adicionados à tabela no formato RawMessage_CustomFieldName.

Os seguintes tipos de dados para campos personalizados são compatíveis: Integer, String, Boolean, Double e Float.

Observação: As tabelas personalizadas de fila não são associadas ao esquema de dados do OOTB, portanto, widgets de tabela cruzada não serão possíveis, a menos que o relacionamento seja criado. Para essa personalização, entre em contato com o representante da UiPath.

O Insights recebe o último evento de log apenas para processos bem-sucedidos. Se você usar a atividade Remover Campos de Log, o Insights não poderá capturar os campos personalizados, pois eles serão removidos pelo fluxo de trabalho antes da conclusão do processo.

Isso também significa que os processos transacionais que usam logs para capturar dados por transação não enviam os dados para cada log de transação ao Insights. Se você estiver usando um processo que itera por meio de transações e deseja armazenar dados personalizados para cada uma, você deve seguir as melhores práticas da UiPath e usar filas. As Filas suportam o envio de variáveis personalizadas para cada item de fila ao Insights.

Filas

Cada item de fila possui três seções nas quais você pode armazenar variáveis personalizadas. Ao criar um item de fila por meio da atividade Adicionar Item de Fila, um campo chamado ItemInformation fica disponível. Lá, você pode armazenar quaisquer variáveis personalizadas desejadas. Os tipos de dados compatíveis para todos os dados de fila são os mesmos que para logs personalizados: Integer, String, Boolean, Double e Float.

Para adicionar variáveis personalizadas a um item de fila depois de terminar o processamento, utilize a atividade Definir Status de Transação. Ela contém duas entradas nas quais você pode armazenar variáveis: Analytics e Output.

Se campos personalizados forem detectados pelo Insights na fila, uma tabela personalizada é criada no modelo de dados chamado Queue-"your queue name”. Os campos serão identificados por meio da entrada em que foram armazenados em:

• As variáveis armazenadas em Analytics serão nomeadas “AnalyticsData_<yourfieldname>”.
• As variáveis armazenadas em Output serão nomeadas “Output_<yourfieldname>”
• As variáveis armazenadas em ItemInformation serão nomeadas “SpecificData_<yourfieldname>”.

As tabelas personalizadas de fila não são associadas ao esquema de dados do OOTB, portanto, widgets de tabela cruzada não serão possíveis, a menos que o relacionamento seja criado. Para essas personalizações, entre em contato com o representante da UiPath.