Escopo do rastreamento do processo

UiPath.Core.Activities.ProcessTracking.ProcessTrackingScope

Description

Process Tracking Scope é uma atividade do Sistema no UiPath que permite o rastreamento detalhado de tarefas dentro de um fluxo de trabalho.

A atividade Process Tracking Scope pode ser usada para rastrear sequências de negócios específicas no UiPath Process Mining. Como RPA developer, você pode marcar essas sequências como tarefas ao envolvê-las em uma atividade Process Tracking Scope.

Trace versus Tarefa

Uma tarefa representa uma unidade de trabalho ou atividade específica em um processo. Ela é criada por uma atividade Process Tracking Scope no fluxo de trabalho. As tarefas têm um carimbo de data/hora de início (quando o escopo começa) e um carimbo de data/hora de término (quando o escopo termina). As tarefas podem ser aninhadas, criando relacionamentos pai-filho.

Um trace é um conceito de nível superior que representa a execução completa de um processo ou de uma série de tarefas relacionadas. Os traces agrupam e organizam várias tarefas que fazem parte da mesma execução de processos. Um trace tem seu próprio identificador exclusivo (a ID do trace), que fornece contexto sobre como diferentes tarefas estão relacionadas em um processo maior.

Na interface do UiPath Studio, você pode controlar a forma como as tarefas se relacionam com os traces usando a propriedade Como rastrear da atividade Process Tracking Scope:

Opção de como rastrear	Gerenciamento de trace	Gerenciamento de tarefas	Observações	Exemplo
No rastreamento atual	O trace existente continua sem criar um novo. O trace permanece aberto mesmo após a conclusão do Process Tracking Scope. Útil para processos de execução longa com várias etapas.	Uma nova tarefa é criada quando o escopo for iniciado. A tarefa é fechada automaticamente quando o escopo for concluído. As horas de início e término das tarefas são gravadas no trace existente.	Essa opção é útil quando você deseja acompanhar operações sequenciais que fazem parte de um processo único em andamento no mesmo contexto do processo. Algumas atividades podem alterar o contexto do trace: Get Transaction Item / Add Transaction Item, seguido por Set Transaction Status Get Transaction Item / Add Transaction Itemfollowed by Postpone Transaction Item Aguarde o item da fila e retome Start Job ou Start Job and Get Reference Wait for Job and Resume	Uma empresa de e-commerce tem um fluxo de trabalho que processa os pedidos dos clientes. O trace principal é iniciado quando um pedido é recebido. Múltiplos Process Tracking Scopes são usados para diferentes estágios: validação de pedidos, processamento de pagamentos e organização de envios. Todos esses escopos usam a opção No trace atual para manter todas as tarefas dentro do mesmo trace de processamento. Isso permite uma visualização completa de todo o processo de atendimento de pedidos.
Em um novo rastreamento	Quando o escopo começar, um novo ID de trace é criado quando o escopo começa. O contexto do trace é revertido para o anterior, caso haja um antes desse escopo. É necessário especificar um nome de processo para o novo trace. Esse nome é usado para agrupar o novo trace, ajudando a organizar e categorizar diferentes processos no Process Mining.	Uma nova tarefa é criada quando o escopo for iniciado. A tarefa é fechada automaticamente quando o escopo for concluído. As horas de início e término das tarefas são gravadas no trace existente.	Essa opção é útil quando você deseja iniciar o rastreamento de um processo ou subprocesso novo e distinto dentro da sua automação, mantendo a capacidade de retornar a um contexto de rastreamento anterior, se necessário.	Uma equipe de suporte usa uma automação para lidar com os tíquetes de clientes. O fluxo de trabalho principal recebe e e categoriza os tíquetes. Para cada tíquete, um novo Process Tracking Scope é criado com a opção Em um novo trace. Isso cria um trace separado para cada problema do cliente, permitindo o rastreamento individual e a análise de como cada ticket é tratado. Ele é útil para medir os tempos de resposta, as taxas de resolução e identificar gargalos no tratamento de tipos específicos de problemas.
Em um rastreamento existente	Não cria um novo trace. Em vez disso, ele se conecta a um que foi criado anteriormente. O contexto do trace pode ser alterado, dependendo da estrutura do fluxo de trabalho. Requer a identificação do trace existente, geralmente por propriedades do objeto (ID do objeto, tipo de objeto e interação do objeto) e nome do processo.	A tarefa recém-criada é adicionada ao trace existente, mantendo a continuidade do processo em diferentes automações. Quando o escopo terminar, a tarefa será encerrada dentro do trace existente.	Essa opção é útil quando várias automações processam o mesmo item de negócios ou objeto. No entanto, essas automações, não são diretamente conectadas por meio de um componente da UiPath, como filas ou trabalhos. Isso permite que você mantenha um trace contínuo da jornada de um item de negócios por meio de automações diferentes, executadas separadamente.	Uma grande empresa tem um sistema de processamento de faturas complexo que envolve vários departamentos. O trace inicial é criado quando uma fatura é recebida no departamento de finanças. À medida que a fatura se move por diferentes departamentos (por exemplo, verificação, aprovação e pagamento), automações separadas tratam cada etapa. A automação de cada departamento usa um Process Tracking Scope com a opção Em um trace existente. Eles identificam o trace existente usando o número da fatura como ID do objeto. Isso permite um trace completo da jornada de faturas em diferentes sistemas e departamentos, mesmo que seja feito por automações separadas.

Observação:

• A criação de tarefas sempre ocorre quando o Process Tracking Scope é iniciado.

• O fechamento da tarefa sempre ocorre quando o escopo é concluído, independentemente da opção de trace.

• O status padrão da tarefa é Bem-sucedido, a menos que seja explicitamente alterado ou ocorra uma exceção.

• Os rastreamentos podem precisar ser explicitamente fechados usando a atividade Set Trace Status se você quiser marcar o processo inteiro como concluído.

Object

No contexto do Process Tracking Service, um objeto se refere a um item de negócios processado por sistemas externos — uma maneira de marcar e seguir itens importantes em diferentes partes do seu processo automatizado. Os objetos ajudam a conectar diferentes automações que operam no mesmo item de negócios.

Por exemplo, um ticket do Jira pode ser considerado um objeto como este:

Se você tiver uma automação (A1) que cria um ticket do Jira, você usaria a atividade Track Object para definir os detalhes do ticket, como:

• ID do objeto – o identificador do Jira, por exemplo, "DOC-1234".

• Tipo de objeto – "ticket do Jira".

• Interação de objetos – como a automação interage com o ticket do Jira; neste caso, a interação é Criada, pois a automação criou o ticket.

• Propriedades do objeto – propriedades do ticket do Jira, no seguinte formato:

  {
    "XUiPathConnectorKey": "<XUiPathConnectorKey>",  // for example, "uipath-jira"
    "XUiPathConnectorName": "<XUiPathConnectorName>",  // for example, "JIRA"
    "XUiPathObjectDisplayName": "<XUiPathObjectDisplayName>",  // for example, "Issue"
    "XUiPathObjectName": "<XUiPathObjectName>"  // for example, "curated_issue"
  }

Importante:

Quando uma automação diferente (A2) precisar funcionar com o mesmo objeto criado pela automação A1, habilite o Rastreamento de processos para a automação A2 com a opção Em um trace existente. Forneça os mesmos detalhes de objeto para manter a conexão entre as automações, para que a automação A2 possa localizar e trabalhar nos tickets criados pela automação A1.

Ao rastrear objetos, você pode seguir a jornada de itens específicos de negócios por meio de seus processos automatizados, fornecendo insights valiosos para a otimização e análise do processo.

Capabilities

Como adicionar um Process Tracking Scope em seu fluxo de trabalho:

• Inicia uma tarefa quando o escopo começa (data e hora de inicio).

• Termina o trace quando o escopo termina (data e hora do fim).

• É compatível com Process Tracking Scopes. aninhados.

• Escopos internos no Process Tracking Service geram tarefas fileiras, mantendo um relacionamento pai/filho que fica visível no Process Mining dentro do gráfico de processos.

• Lida com o status de tarefa implícito e explícito:

  • Status de tarefa implícito:

    • O status padrão é Sucesso.

    • Definido automaticamente como Falhado se ocorrer uma exceção não capturada.

    • Os detalhes das exceções são disponibilizados no aplicativo de otimização de processos.

  • Status explícito da tarefa:

    • Use a atividade Set Task Status para especificar como a tarefa termina.

    • Valores: bem-sucedido, falhado, cancelado.

• Lida com o status de trace explícito:

  • Use a atividade Set Trace Status para especificar como o processo termina

    Valores possíveis: bem-sucedido, com falha.

• Oferece três comportamentos para rastreamento de tarefas por meio da propriedade Como rastrear:

  • No trace atual (comportamento padrão):

    • Rastreia a nova tarefa no trace atual.

    • Usa o ID do trace gerado pelo escopo atual.

  • Em um novo trace:

    • Gera um novo ID para o trace.

    • Rastreia a tarefa em um novo trace.

    • É necessário especificar um nome de processo para o agrupamento.

    • Reverte para o contexto de trace anterior após o término do escopo.

  • Em um trace existente:

    • Adiciona a tarefa a um trace pré-existente.

    • Isso é útil para vincular processos de automação separados.

    • Requer a identificação do rastreamento por detalhes do objeto e nome do processo.

Habilitando o Rastreamento de processos para automações existentes

Para habilitar o Rastreamento de processos para uma sequência:

1. Selecione a Sequência no fluxo de trabalho.

2. No painel Propriedades, marque a caixa de seleção Rastreamento de processos.

Quando o Rastreamento de processos estiver ativado, a Sequência é automaticamente envolvida pela atividade Process Tracking Scope.

Compatibilidade do projeto

Windows | Multiplataforma

Windows, configuração multiplataforma

Rastreamento de processo

Opcional. Se selecionado, habilita o rastreamento do processo para a sequência dentro do escopo.

Nome da tarefa

Opcional. Permite que você especifique um nome para a tarefa criada por esse escopo. Por padrão, ele usa o nome da sequência contida.

Como rastrear

Obrigatório.Determina como a tarefa está associada aos traces. As seguintes opções estão disponíveis:

No rastreamento atual

Opção padrão. Adiciona a tarefa criada pela atividade Process Tracking Scope ao trace existente. Essa opção é útil quando você deseja continuar o rastreamento no mesmo contexto do processo. A tarefa criada por esse escopo é fechada quando o escopo for concluído., enquanto o trace existente permanece aberto e continua. Esta opção é recomendada para operações sequenciais que fazem parte de um processo único em andamento.

Em um novo rastreamento

Cria um novo trace especificamente para essa tarefa e para quaisquer subtarefas dentro do escopo. Essa opção é útil quando você deseja iniciar um processo ou subprocesso novo. O novo trace tem seu próprio ID exclusivo. Após a conclusão do escopo, o novo contexto de trace é revertido para o anterior, e a tarefa associada é fechada, marcando o fim da atividade rastreada. Após a seleção, o campo Nome do processo é exibido:

• Nome do processo — Especifique o processo que você deseja iniciar no novo trace.

Em um rastreamento existente

Adiciona a tarefa a um trace pré-existente. Essa opção é útil para conectar diferentes partes de uma automação que podem não ser sequenciais por meio da atividade Track object. Requer a identificação do trace por detalhes do objeto e nome do processo.A tarefa criada no escopo existente é fechada quando o escopo for concluído, enquanto o trace existente permanece aberto e prospera. Após a seleção, os seguintes campos para a identificação do trace são exibidos:

• Nome do processo — Especifique o processo que você deseja iniciar no trace existente.

• ID do objeto — Especifique o ID do objeto associado à tarefa atual. Use isso para rastrear um objeto como parte da tarefa. Essas informações também podem ajudar você a continuar o trace em uma automação diferente.

• Tipo de objeto — Especifique o tipo de objeto para identificar o ID do trace para o qual você deseja alterar.

• Interação de objetos — Selecione como a tarefa interage com o objeto.

Importante: enquanto as tarefas são fechadas automaticamente quando o escopo for concluído, os rastreamentos podem precisar ser explicitamente fechados usando a atividade Set Trace Status se você quiser marcar o processo inteiro como concluído.