Dados de automação

Você pode conectar dados de um aplicativo do Process Mining com dados de automações executadas na UiPath Platform. Isso oferece uma visão de ponta a ponta dos processos monitorados por meio do UiPath.

Quando você conecta os dados de automação aos seus dados do processo, você obtém uma perspectiva mais detalhada do processo de ponta a ponta. Isso fornece uma maior insight sobre as operações com "Human-in-the-loop" que ocorrem dentro do processo. Além disso, permite que você entenda melhor os atrasos entre etapas automatizadas e manuais, bem como entre etapas do sistema, e também acompanhe destinos específicos.

As informações do objeto (tipos de objetos e IDs do objeto) que estão presentes no projeto do Process Mining e nos dados de automação são usadas para conectar os dados da automação aos seus dados de processo.

Por exemplo, você pode unir os dados do sistema Coupa para o processo Purchase-to-Pay com dados de automação para o processo de processamento de faturas, que é um subprocesso do processo Purchase-to-Pay, usando o tipo de objeto Sales Order ID do objeto SalesOrderID como IDs de conexão em origens de dados.

Pré-requisito

Assume-se que você tenha dados de automação que estão aproveitando o Serviço de Rastreamento de Processos e tenha um ou mais objetos de negócios associados a tarefas nas automações. Consulte Rastreamento de processo para obter mais informações.

Adição de dados da automação

Siga estas etapas para adicionar dados de automação aos Dados de entrada.

1. Selecione o ícone Adicionar dados ao lado de Dados de automação na seção Dados de entrada do editor de Transformações de dados . A janela Selecionar processo de negócios automatizado é aberta, mostrando as automações de processo disponíveis.
   Observação:

   Você também pode selecionar Adicionar dados na janela Gerenciar dados de automação para abrir a janela Selecionar processo de negócios automatizado .

2. Selecione o processo ou processos que você deseja conectar aos dados do aplicativo do Process Mining .
3. Selecione Configurar.

Os dados da automação são carregados e as tabelas a seguir são adicionadas à lista de dados de automação na seção Dados de entrada :

• Automation_events
• Queue_items
• Action_center_tasks
• Automation_due_dates

Exclusão de dados de automação

Siga estas etapas para excluir dados de automação.

1. Acesse a janela Selecionar processo de negócios automatizado .
2. Desmarque o processo ou processos para os quais você não deseja mais carregar dados de automação.
3. Selecione Configurar.

Gerenciando dados da automação

Selecione o ícone Configurações para abrir a janela Gerenciar dados de automação .

Observação:

Gerenciar dados de automação não está disponível para aplicativos de Otimização de processos criados no Maestro.

Excluindo tabelas da automação

Por padrão, as tabelas Automation_events, Queue_items, Action_center_tasks e Automation_due_dates são incluídas nos dados de entrada para automações.

Você pode selecionar as tabelas que deseja excluir da entrada.

Definir um intervalo de datas para os dados de automação

Se você deseja definir um período limitado ou específico para a automação, pode especificar as datas de início e término que definem o período. O período especificado se aplica a todas as tabelas que fazem parte dos dados de entrada.

Observação:

Isso ainda pode incluir dados de fora do período se um rastreamento continuar (ou terminar) após a data de término escolhida. Isso ocorre porque a restrição de período se aplica ao início do trace, não à sua duração ou fim. Portanto, quaisquer dados gerados pelo trace após a data de término escolhida ainda serão incluídos nos resultados.

Atualizando os dados

Os dados de automação são atualizados automaticamente quando os dados são carregados para o aplicativo de processos.

Você também pode atualizar os dados na janela Gerenciar dados de automação . Siga estas etapas.

1. Selecione Atualizar dados. uma mensagem de confirmação é exibida.
2. Selecione Recarregar para recarregar todos os dados de automação disponíveis.

Tabela Automation_events

A tabela Automation_events armazena os eventos de automação e os objetos de negócios envolvidos.

A tabela a seguir descreve os campos da tabela Automation_events .

Campo	Tipo	Description
Trace_ID	text	O identificador exclusivo do rastreamento.
Process	text	Nome do processo. Isso é selecionado pelo usuário ao conectar os dados de automação. Um ou vários traces podem ser selecionados.
Event_ID	text	O identificador exclusivo do evento.
Parent_event_ID	text	O Event_ID do evento pai.
Task	text	Nome do evento de automação.
Object_ID	text	O identificador do objeto de negócios relacionado ao evento de automação. Isso é definido explicitamente pelo usuário no fluxo de trabalho da automação.
Object_type	text	Qual o tipo de objeto de negócios. Por exemplo, ordem de venda, fatura ou cliente.
Object_interaction	text	Informações sobre o objeto relacionado ao evento. Por exemplo, uma interação de criação ou uma aprovação.
Object_properties	text	Um valor JSON armazenando todas as propriedades relacionadas ao objeto (pares de chave-valor).
Automation_name	text	Propriedade do trabalho que registra em log o evento de automação. No caso de um evento do tipo “aguardar trabalho”, é a propriedade do trabalho que está sendo aguardado.
Automation_type	text	O tipo de tarefa que o robô executará.
Job_source	text	Uma indicação de onde o trabalho foi iniciado.
Job_info	text	Uma breve descrição do trabalho.
Automation_version	text	A versão da automação.
Host_machine_name	text	O nome do computador ou servidor no qual o trabalho é executado.
Robot_name	text	O nome do Robô que executou o trabalho.
Robot_type	text	O tipo do robô que é responsável por executar o trabalho. Por exemplo, "Attended", "Unattended" ou "non-production".
Job_ID	text	O identificador do evento da automação. Um evento pode ocorrer várias vezes quando vários objetos se relacionam com o evento.
Queue_item_ID	text	O identificador do item de fila quando um item de fila está relacionado ao evento de automação.
Action_center_task_ID	text	O identificador da tarefa quando uma tarefa está relacionada ao evento de automação.
Event_start	Carimbo de data/hora	Carimbo de data/hora de quando um evento de automação foi iniciado. Ela está sempre disponível.
Event_end	Carimbo de data/hora	Carimbo de data/hora de quando um evento de automação terminou. Isso só está disponível quando o evento é concluído.

Tabela Itens_Fila

A tabela Queue_items armazena os itens da fila relacionados aos eventos de automação.

A tabela a seguir descreve os campos da tabela Queue_items .

Campo	Tipo	Description
Queue_item_ID	text	O identificador para vincular o item da fila a um evento de automação.
Queue_name	text	O nome da fila à qual o item de fila pertence.
Defer_date	Carimbo de data/hora	A data e a hora em que o item de fila se torna disponível para processamento.
Due_date	Carimbo de data/hora	A data e a hora em que o item da fila deve ser concluído.
Creation_timestamp	Carimbo de data/hora	A data e a hora em que o item de fila foi adicionado à fila.
Start_processing	Carimbo de data/hora	A data e a hora em que o item da fila começou a ser processado.
End_processing	Carimbo de data/hora	A data e a hora em que o item da fila foi concluído.
Processing_time	duração/inteiro	O número de milissegundos entre Start_processing e End_processing .
Processing_exception_reason	text	Uma indicação de por que o item de fila não pôde ser concluído ou processado com sucesso.
Progress	text	Uma indicação do progresso do item da fila.
Reference	text	Um identificador exclusivo para o item da fila.
Retry_number	Número inteiro	O número de vezes que o item da fila será tentado novamente se falhar inicialmente.
Reviewer	text	O usuário que é responsável por verificar a conclusão bem-sucedida do item da fila.
Review_status	text	O status do item de fila indicado pela revisão.
Robot_name	text	O nome do robô que processou o item de fila.
Priority	text	A prioridade do item na fila.
Processing status	text	O status do item de fila enquanto ele está em processo de manipulação.
Processing_exception_type	text	Uma indicação de se ocorreu um erro durante o processamento do item.
Robot_type	text	O tipo do robô que é responsável pelo processamento do item da fila. Por exemplo, "Attended", "Unattended" ou "non-production".
Is_open	Booleano	Uma propriedade derivada do status do processamento. O item de fila é considerado aberto quando o status de processamento for “new” ou “em andamento”.

Tabela Action_center_tasks

A tabela Action_center_tasks armazena as tarefas do Action Center que estão relacionadas aos eventos de automação.

A tabela a seguir descreve os campos da tabela Action_center_tasks .

Campo	Tipo	Description
Action_center_task_ID	text	Identificador para vincular a tarefa a um evento de automação.
Title	text	A descrição da tarefa.
Catalog	text	A lista de tarefas que precisam ser realizadas para concluir o fluxo de trabalho.
Assignee	text	O usuário ou sistema responsável por concluir a tarefa.
Action	text	A atividade ou conjunto de atividades que precisam ser realizadas para concluir tal tarefa.
Priority	text	A prioridade da tarefa no fluxo de trabalho.
Status	text	O status real da tarefa no fluxo de trabalho.
Type	text	Uma classificação da tarefa.
Creation_timestamp	Carimbo de data/hora	A data e a hora em que a tarefa foi criada.
Last_assigned_timestamp	Carimbo de data/hora	A data e a hora em que a tarefa foi atribuída pela última vez.
Completion_timestamp	Carimbo de data/hora	A data e hora em que a tarefa foi concluída.
Is_completed	Booleano	Uma indicação de que a tarefa foi concluída.
Assigning_time	Número inteiro	Um campo derivado com base na diferença entre a criação e o último carimbo de data/hora atribuído.
Completion_time	Número inteiro	Um campo derivado com base na diferença entre a criação e o carimbo de data/hora da conclusão.
Number_of_users	Número inteiro	Um campo derivado baseado no número de usuários envolvidos na observação dos eventos da tarefa.

Tabela Automation_de_datas_de_automação

A tabela Automation_due_dates armazena as datas de vencimento dos itens da fila e tarefas.

A tabela a seguir descreve os campos da tabela Automation_due_dates .

Campo	Tipo	Description
Queue_item_ID	text	Contém valores apenas quando a data de conclusão está relacionada a um item da fila.
Action_center_task_ID	text	Contém valores apenas quando a data de vencimento está relacionada a uma tarefa.
Due_date	text	O nome da Data de vencimento: <queue name>, atribuição da tarefa <task type> ou conclusão da tarefa <task type> .
Due_date_status	text	Uma indicação do status da tarefa determinada com base na data de conclusão esperada.
Action_on_overdue	text	A ação a ser realizada quando a tarefa está atrasada. Disponível apenas em datas de vencimento relacionadas à tarefa.
Actual_timestamp	Carimbo de data/hora	A data e a hora em que a tarefa ou item da fila foi concluído.
Expected_timestamp	Carimbo de data/hora	A data e a hora em que o item ou tarefa da fila deve ser concluído.
On_time	Booleano	Uma indicação se a data de conclusão foi cumprida ou não.
Time_difference	Número inteiro	A diferença entre o tempo real e esperado.

Uso de dados de automação em transformações

Para usar os dados de automação em suas transformações, primeiro adicione as tabelas ao arquivo sources.yml . Em seguida, você pode se referir a essas tabelas de origem no projeto dbt como qualquer outra tabela de entrada.

Referenciação das tabelas de origem no projeto dbt

Você pode usar o código a seguir para fazer referência às tabelas em seu projeto dbt.

with Automation_events as (
    select * from {{ source('sources', 'Automation_events') }}
),

Queue_items as (
    select * from {{ source('sources', 'Queue_items') }}
),

Action_center_tasks as (
    select * from {{ source('sources', 'Action_center_tasks') }}
),

Automation_due_dates as (
    select * from {{ source('sources', 'Automation_due_dates') }}
),

Casos de uso

Cenário 1. Adicionando eventos de automações ao log de eventos

Você pode adicionar eventos de uma automação ao log de eventos se suas transformações do Process Mining abrangerem vários objetos de negócios. Nesse cenário, você conecta dados de automação a um aplicativo de processo a ele para obter mais compreensão em partes específicas do processo.

Observação:

O exemplo mostra como conectar automações a um objeto Sales order . Você pode usar um objeto diferente ajustando as referências relevantes conforme necessário.

Siga estas etapas para adicionar automações ao log de evento.

1. Adicione um novo arquivo SQL Sales_order_automation_events.
2. Copie o seguinte exemplo de SQL no qual você:
   1. Filtre o Automation_events no tipo de objeto da ordem de venda.
   2. Renomeie Object_ID como Sales_order_ID para identificar que este é um evento de ordem de venda.
   3. Use o valor armazenado em Task como o Activity.
   4. Inclua pelo menos o campo obrigatório Event_end.

      with Automation_events as (
          select * from {{ source('sources', 'Automation_events') }}
      ),
      
      Sales_order_automation_events as (
          select
              Automation_events."Object_ID" as "Sales_order_ID",
              Automation_events."Task" as "Activity",
              Automation_events."Event_end",
              Automation_events."Event_ID",
              'null' as "Parent_event_ID"
          from Automation_events
          where Automation_events."Object_type" = 'Sales order'
      )
      
      select * from Sales_order_automation_events
      

3. Junte o Sales_order_automation_events com os outros eventos definidos no seu projeto do Process Mining.
   Observação:

   Quando você usa o modelo de aplicativo Personalizado ou de Log de evento , seu projeto do Process Mining rastreia apenas um objeto de interesse. Você pode unir os eventos de automação em seu objeto diretamente ao log de eventos.

   • Certifique-se de gerar um Event_ID exclusivo nos eventos associados para garantir identificadores de eventos exclusivos no seu log de eventos.
4. Verifique se o ID do objeto definido no projeto do Process Mining corresponde ao ID do objeto de seus eventos de automação. Atualize suas transformações adequadamente, para que os eventos de ambas as origens de dados sejam conectados aos objetos corretos.

Cenário 2: obtenção de informações adicionais do objeto das automações

Nesse cenário, você extrai as informações de propriedades do objeto dos dados de automação para usá-las para enriquecer os painéis em seu aplicativo de processos.

O campo Object_properties armazena as propriedades dos objetos de negócios que são adicionados nas automações. O valor neste campo está no formato JSON com pares de chave-valor.

Por exemplo: {"Claim_number": 216, "Client": "Alex Smith"}

Extraia as propriedades individuais usando a função json() pm-utils.

O código SQL a seguir mostra um exemplo de como usar a função json() do pm-utils para extrair as propriedades Claim_number e Client .

select
    Automation_events."Object_ID",
    {{ pm_utils.json('Automation_events."Object_properties"', 'Claim_number') }} as "Claim_number",
    {{ pm_utils.json('Automation_events."Object_properties"', 'Client') }} as "Client",
from Automation_events

Cenário 3: enriquecimento de eventos de automação com dados de itens de fila

Um evento de automação pode ser associado a um item de fila. O evento de automação representa a execução do item da fila. As informações sobre itens de fila são armazenadas na tabela separada Queue_items. Associe os eventos de automação com esta tabela no Queue_item_ID para obter informações sobre:

• A prioridade da execução.
• Exceções.
• Datas de vencimento.

O seguinte código SQL mostra um exemplo de como enriquecer os eventos de automação com as propriedades dos itens de fila Priority e Processing_exception_type.

select
    Automation_events."Event_ID",
    Automation_events."Object_ID",
    Queue_items."Priority",
    Queue_items."Processing_exception_type"
from Automation_events
left join Queue_items
    on Automation_events."Queue_item_ID" = Queue_items."Queue_item_ID"

As informações de data de vencimento são armazenadas na tabela Automation_due_dates . Um item de fila pode ter no máximo uma data de vencimento. O seguinte código SQL mostra como obter as informações da data de vencimento disponíveis.

select
    Automation_events."Event_ID",
    Automation_events."Object_ID",
    Queue_items."Due_date",
    Queue_items."Expected_timestamp",
    Queue_items."Actual_timestamp"
from Automation_events
left join Automation_due_dates
    on Automation_events."Queue_item_ID" = Automation_due_dates."Queue_item_ID"

Cenário 4: enriquecimento de eventos de automação com dados da tarefa

Um evento de automação pode ser associado a uma tarefa. O evento de automação representa a etapa no processo automatizado em que uma pessoa está envolvida. As informações sobre tarefas são armazenadas na tabela separada Tasks. Associe os eventos de automação com esta tabela no Task_ID para obter informações sobre:

• O destinatário da tarefa
• A prioridade da tarefa
• Datas de vencimento (SLAs da tarefa)

O seguinte código SQL mostra um exemplo de como enriquecer os eventos de automação com as propriedades de tarefas Assignee e Priority.

select
    Automation_events."Event_ID",
    Automation_events."Object_ID",
    Action_center_tasks."Assignee",
    Action_center_tasks."Priority"
from Automation_events
left join Action_center_tasks
    on Automation_events."Event_ID" = Action_center_tasks."Action_center_tasks_ID"

As informações de data de vencimento são armazenadas na tabela Automation_due_dates . Uma tarefa pode estar relacionada a várias datas de vencimento. Você pode aplicar datas de vencimento quando a tarefa deve ser atribuída e quando a tarefa deve ser concluída.

Observação:

Juntar o Automation_events ao Action_center_tasks no Action_center_task_ID sem qualquer filtro pode causar duplicação.

O seguinte código SQL mostra um exemplo de como enriquecer os eventos de automação com informações da data de vencimento das tarefas, considerando apenas as datas de vencimento da conclusão da tarefa.

with Task_completion_due_dates as (
    select * from Automation_due_dates
    where pm_utils.charindex('task completion', '"Due_date"') > 0
)

select
    Automation_events."Action_center_tasks_ID",
    Automation_events."Object_ID",
    Action_center_tasks."Due_date",
    Action_center_tasks."Expected_timestamp",
    Action_center_tasks."Actual_timestamp"
from Automation_events
left join Task_completion_due_dates
    on Automation_events."Task_ID" = Task_completion_due_dates."Task_ID"