Tutorial - Processo simples

Visão geral

Este guia demonstra como implementar um processo simples que destaca os principais recursos de orquestração por agentes: modelagem, implementação, depuração, publicação, implantação e gerenciamento.O processo não cobre a integração com outros produtos da UiPath. Para obter instruções sobre a configuração e implementação de dependências, como Data Fabric, Integration Service, Studio Web, Agents, Apps de ação do Action Center, consulte Instruções – Processo complexo.

O objetivo é criar o processo de roteamento simples semelhante ao da imagem a seguir:

Modelar um processo

Observação: a configuração do Projeto de processo por agente está atualmente vinculada ao tenant. Certifique-se de permanecer no mesmo tenant entre as sessões de edição.

Observação: a configuração do projeto de Processo com agente atualmente é compatível com apenas um arquivo de processo de negócios (.bpmn).Embora você possa adicionar vários arquivos ao projeto, isso pode ocasionar problemas inesperados tanto para depuração quanto para publicação.

Comece modelando o processo de ponta a ponta e, em seguida, configure os componentes.

Crie um processo por agente como um novo tipo de projeto do Studio.

1. Navegue até seu tenant do Automation Cloud™.
2. Na barra do lado esquerdo, na lista de produtos, selecione Maestro.
3. Na página de destino do Maestro, selecione Iniciar modelagem.Seu novo processo com agente é aberto.
   Dica: você também pode começar criando um novo Processo com agente no Studio Web.
   

   

   
   
4. Clique com o botão direito do mouse para renomear o projeto para Processo simples e o processo para Processo simples.

   Seu processo com agente é, por padrão, parte de uma solução. Leia sobre soluções no guia do usuário do Studio Web.

   
   
   
   
   
5. Selecione o elemento inicial e clique em Adicionar: anotação de texto na caixa de ferramentas e digite Caminho da variável de entrada.
   
   
   
   
6. Selecione o elemento inicial e clique em Adicionar: evento intermediário na caixa de ferramentas.
   
   
   
   
7. Selecione Alterar elemento na barra de ferramentas e selecione Evento de captura intermediário do temporizador e digite Atraso para o nome do evento intermediário.
   
   
   
   
8. Selecione o elemento temporizador e clique em Adicionar: Gateway exclusivo na caixa de ferramentas e digite Qual caminho? para o nome do gateway.
   
   
   
   
9. Selecione o gateway, clique em Adicionar: tarefa e digite Uma tarefa para o nome.
   
   
   
   
   Observação: os erros de validação são mostrados no canto inferior esquerdo da tela.
   

   

   
   
10. Selecione o gateway novamente e clique em Adicionar: Tarefa e Tarefa do tipo B para o nome.
    
    
    
    
11. Selecione o gateway e expanda a primeira condição, ele terá um nome gerado começando por edge_Gateway_{randomcharacters} e tipo A para o rótulo. Expanda a segunda condição e digite B para o rótulo.
    
    
    
    
    
    
    
    
12. É uma prática recomendada criar um fim explícito para seu processo. Para identificar rapidamente qual caminho o processo seguiu, crie um fim explícito para cada um.

    Selecione a tarefa A e clique em Adicionar: evento de fim na caixa de ferramentas e digite Fim A para o nome.

    
    
    
    
    
13. Selecione a tarefa B e clique em Adicionar: evento de fim na caixa de ferramentas e digite Fim B para o nome.
    
    
    
    

Parabéns! Você agora criou seu primeiro processo BPMN de ponta a ponta!

Agora adicione alguns recursos ao processo.

Implementar um processo

Iniciar evento

1. Selecione o elemento de início e, no painel de propriedades, digite Início manual para o Nome e, na seção Argumentos, selecione Adicionar novo para adicionar uma variável que possamos usar quando iniciarmos o processo.
   
   
   
   
2. Configure a variável com esses valores e clique em Salvar. Uma variável de saída será criada automaticamente.
   • Nome: caminho
   • Type: String
   • Valor: A
   
   
   
   
   
   
   
   
   
3. Selecione o evento Atraso e abra o painel de propriedades e, na seção Temporizador, selecione Tipo=Duração e 5 segundos na configuração do valor.
   
   
   
   
4. Selecione o gateway e expanda as Condições para inserir a condição para os caminhos Não e Sim e selecione o seletor de entrada de texto para abrir o editor de Expressão para inserir as condições.
   
   
   
   
5. Use Inserir variável para localizar e inserir a variável de saída de Início manualpath.
   
   
   
   Defina o valor igual a "A" e selecione Salvar.
   
   
   
   
6. Abra o editor de Expressão para a condição B e insira o caminho da variável de saída de Início manual, defina o valor igual a "B" e clique em Salvar.
   
   
   
   
   Ou você pode simplesmente copiar/colar as expressões abaixo no editor de expressão:

   • A

     vars.path == "A"

   • B

     vars.path == "B"

Parabéns! Você agora configurou totalmente seu primeiro processo.

Observação: você pode baixar o BPMN para uso em outros projetos clicando com o botão direito do mouse no nome do arquivo .bpmn.

Debug um processo

Observação: você pode configurar pontos de interrupção passando o mouse sobre o canto superior esquerdo de um elemento e selecionando Clicar para adicionar um ponto de interrupção. Atualmente, os pontos de interrupção só podem ser definidos quando você começa a depurar um processo. No entanto, eles são retidos entre as execuções. Leia sobre depuração e pontos de interrupção.

Debug direto

Primeiro, execute seu processo diretamente para garantir que você o configurou corretamente. Defina o valor padrão para sua variável path como A, então você deve vê-lo fluir até a tarefa A e Fim A.

1. Selecione Debug para testar seu processo.
   
   
   
   
2. Observe como cada etapa é executada. Navegue pelas seções Trilha de Execução e Variáveis Globais/Incidentes para visualizar detalhes adicionais.
3. Selecione Voltar para o modo de projeto para sair da depuração.

Depurar etapa por etapa

Execute seu processo passo a passo para que você possa manipular a variável path para testar a rota B.

1. Selecione Debug passo a passo.
   
   
   
   
2. Selecione Próxima etapa para mover a execução para o temporizador
   
   
   
   
3. Atualize a Variável global path para a origem do evento Início manual para B. Selecione Enter ou tab para confirmar a alteração.
   
   
   
   
4. Selecione Atualizar 1 variável e Atualizar variáveis na próxima caixa de diálogo para confirmar as alterações.
5. Selecione Continuar para finalizar a execução.
6. Assista como cada etapa é executada. Navegue pelas seções Trilha de execução e Variáveis/incidentes globais para visualizar detalhes adicionais. Dessa vez, o processo segue a rota B.
   
   
   
   
7. Selecione Voltar para o modo de projeto para sair da depuração.

.

Publicar e implantar um processo simples

1. Selecione Publicar.
2. Escolha o Local e selecione Publicar.
   
   
   
   
3. Leia Publicação e implantação de soluções para as etapas para publicar no Orchestrator.

Parabéns! Você agora publicou, implantou e iniciou totalmente seu primeiro processo.

Agora é hora de fazer o gerenciamento de instâncias de runtime.

Gerenciar um processo de negócios

1. Do portal do Automation Cloud, navegue até o serviço do Maestro.
2. Selecione Processo Simples na lista de processos para abrir a visualização Todas as instâncias para seu processo. Você pode usar pesquisa para filtrar a lista, se necessário.
   
   
   
   
3. Selecione a instância mais recente para abrir o visualizador de instâncias. Você verá o processo sendo executado ao vivo em cada etapa (supondo que o temporizador de atraso de 5 segundos ainda esteja em execução).
   
   
   
   

   Você pode clicar no segundo plano do modelo para ver Variáveis globais e Histórico da ação, bem como a Trilha de execução.Você pode clicar em um nó no modelo ou na Trilha de execução para inspecionar Detalhes e Variáveis para essa etapa de execução.

   Parabéns! Você agora gerenciou totalmente seu primeiro processo.

   Agora interrompa nosso processo para que você possa corrigi-lo!

Interromper e corrigir um processo

Nesse procedimento, causaremos uma falha na execução para usar o gerenciamento de instâncias com o objetivo de recuperar.

1. Acesse o Orchestrator, a guia Automações na pasta Meu espaço de trabalho e localize Simple.Process na lista Processos.
2. Selecione Iniciar um trabalho para a entrada Simple.Process, mas desta vez edite os Argumentos antes de começar a interrompê-lo.
3. Selecione a guia Argumentos e edite a variável path. Defina o valor como C e selecione Salvar.
   
   
   
   
4. Selecione Iniciar.
5. Navegue até o Maestro e selecione Processo simples na lista de Processos para abrir a visualização Todas as instâncias para seu processo.
   
   
   
   
6. Selecione a etapa gateway exclusivo Qual caminho? etapa do gateway para ver o erro Sem fluxo de saída para o gateway, que é esperado, pois não temos configuração para path==”C”.
   
   
   
   
7. Clique no contêiner da primeira etapa ou no segundo plano do modelo para visualizar as Variáveis globais.
   
   
   
   
8. Certifique-se de que o fluxo seguirá uma condição configurada atualizando a variável path da saída de Início manual (a segunda) para A.
   
   
   
   
9. Selecione Atualizar 1 variável para atualizar a variável e adicione um comentário para fins de auditoria.
   
   
   
   
10. Selecione Tentar novamente, adicione um comentário e escolha Tentar novamente a instância para tentar novamente a etapa com a nova variável e ver a instância ser concluída.
    Observação: você pode precisar atualizar a página para ver a Instância concluída.
    
    
    
    
    
11. Consulte o Histórico da Ação para ver a trilha de auditoria de nossas alterações.
    
    
    
    

    Parabéns! Você corrigiu com sucesso uma instância quebrada.

Migrar entre versões de um processo

A lógica de fluxo de processo atual não é suficientemente robusta para gerenciar todos os cenários de caminho. Você está abordando esse problema ao publicar uma nova versão do processo. Esta versão atualizada acomodará de forma eficaz não apenas novas instâncias de processos, mas também retificará instâncias problemáticas existentes. Para garantir que você lide com eficácia com todos os cenários em que path não é igual a A, modifique a rota B para uma rota Não A.

Neste procedimento, você irá provocar uma falha na execução a fim de corrigi-la com uma nova versão.

1. Navegue para o Orchestrator.
2. Acesse Meu espaço de trabalho.
3. Acesse a aba Automações e localize Simple.Process na lista Processos.
4. Selecione Iniciar um trabalho para a entrada Simple.Process e escolha Iniciar.
5. Selecione a guia Argumentos e edite a variável path.
6. Defina o valor como C e escolha Salvar.
7. Selecione Iniciar.

Agora corrija seu processo para que você possa migrar essa instância quebrada.

1. Abra seu processo simples no UiPath Studio.
2. Selecione a etapa gateway exclusivo Qual caminho? gateway e abrir o painel de propriedades.
3. Altere o rótulo B para Não A e altere a condição para vars.path != A
   
   
   
   
4. Altere o nome da tarefa B para tarefa Não A.
5. Altere o nome do evento final Fim B para Fim Não A.
6. Clique em Publicar, selecione o Feed do Espaço de Trabalho Pessoal do Orchestrator e clique em Publicar.

Agora migre sua instância quebrada para a nova versão.

1. Navegue até o Maestro, selecione Instâncias de processo e escolha Processo Simples na lista de Processos para abrir a visualização Todas as instâncias para seu processo.
2. Clique na instância mais recente para abrir o visualizador de instâncias. Você verá que o processo está em um estado de falha no gateway Qual caminho?.
   Observação: você pode precisar clicar no botão de atualização para ver a lista com a instância mais recente.
3. Selecione Migrar, escolha a versão de destino para o processo que você acabou de publicar (deve ser 1.0.1, mas pode ser diferente para você), forneça um comentário e selecione Migrar instância.
   
   
   
   
4. Selecione Tentar novamente, adicione um comentário e clique em Tentar novamente a instância para repetir a etapa com a nova variável e observar a conclusão da instância.
   Observação: você pode precisar atualizar a página para ver a Instância concluída.
   
   
   
   
   
5. Observe o Histórico de ações para ver a trilha de auditoria para suas alterações.

Parabéns! Você migrou com sucesso uma instância quebrada para uma nova versão do processo!

Processo final

É assim que o processo final se parece: