- Notas de Versão
- Introdução
- Configuração e Instalação
- Projetos de automação
- Sobre a publicação de projetos de automação
- Projetando automações
- Gerenciamento de pacotes de atividades
- Como definir as configurações do projeto de atividades
- Como assinar pacotes
- Governança
- Como importar entidades
- Experiência de Criação Moderna
- Vincular um projeto a uma ideia no Automation Hub
- Usando o Gerenciador de dados
- Dependências
- Tipos de fluxos de trabalho
- Comparação de arquivos
- Melhores Práticas de Automação
- Integração de controle de origem
- Sobre o controle de versões
- Como gerenciar projetos com o TÁS
- Como gerenciar projetos com o SN
- Dif. do fluxo de trabalho
- Depuração
- A ferramenta de diagnóstico
- Analisador de Fluxo de Trabalho
- Sobre o Analisador de Fluxo de Trabalho
- STN MG-001 - Convenção de nomenclatura de variáveis
- STN MG-002 - Convenção de nomenclatura de argumentos
- STN MG-004 - Duplicação de Nome de Exibição
- STN MG-005 - Variável substitui variável
- STN MG-006 - Variável substitui argumento
- STN MG-008 - Comprimento de variável excedido
- STN MG-009 - Variáveis Catablema de prefixo
- STN MG-011 - Argumentos Catablema de prefixo
- STN MG-012 - Valores padrão de argumentos
- STN MG-016 - Comprimento do argumento excedido
- SR-DB-002 - Contagem alta de argumentos
- SR-DB-003 - Esvaziar bloco catechu
- SR-DB-007 - Múltiplas camadas Com fluxograma
- SR-DB-020 - Propriedades de saída indefinidas
- SR-DB-021 - Tempo limite embutido em código
- SR-DB-023 - Fluxo de trabalho vazio
- SR-DB-024 - Verificação da atividade Persistente
- SR-DB-025 - Pré-requisito de serialidade de variáveis
- SR-DB-026 - Uso da atividade Dela
- SR-DB-027 - Melhores práticas de persistência
- SR-DB-028 - Pré-requisito de serialidade de argumentos
- SR-US-005 - Argumentos de atividades embutidos em código
- SR-US-009 - Variáveis não utilizadas
- SR-US-010 - Dependências não utilizadas
- SR-US-014 - Restrições de pacotes
- SR-US-020 - Mensagens de logue mínimas
- SR-US-024 - Não utilizado e postergado
- SR-US-025 - Uso incorreto do valor salvo
- SR-US-026 - Restrições da atividade
- SR-US-027 - Pacotes necessários
- ST-USG-28 — restringir modelos de invocação de arquivos
- ST-USG-032 — rótulos obrigatórios
- ST-USG-034 — URL do Automation Hub
- Variáveis
- Argumentos
- Namespaces Importados
- Automações codificadas
- Introdução
- Registro de serviços personalizados
- Contextos Antes e Depois
- Gerando código
- Geração de caso de teste codificado a partir de casos de teste manuais
- Automação assistida baseada em gatilho
- Gravação
- Elementos de Interface Gráfica
- Fluxo de controle
- Seletores
- Repo. de Objetos
- Extração de Dados
- Automação de imagem e texto
- Automação de tecnologias Citrino
- Automação RDP
- Automação da Salesforce
- Automação SAP
- Automação do Varear Horizonte
- Geração de logs
- A ferramenta ScreenScrapeJavaSupport
- O protocolo Servodrive
- Test Suite — Studio
- Extensões
- Sobre extensões
- Ferramenta SetupExtensions
- UiPathRemoteRuntime.exe não está sendo executado na sessão remota
- O UiPath Remote Runtime bloqueia a sessão do Citrix de ser fechado
- O UiPath Remote Runtime causa vazamento de memória
- Os pacotes UiPath.UIAutomation.Activities e versões do UiPath Remote Runtime são incompatíveis
- A extensão do UiPath necessária não está instalada na máquina remota
- Configurações de resolução de tela
- Políticas de grupo do Chrome
- Não é possível se comunicar com o navegador
- A extensão do Chrome é removida automaticamente
- A extensão pode ter sido corrompida
- Verifique se a extensão para o Chrome está instalada e habilitada
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Habilite o Acesso às URLs do arquivo e o Modo Anônimo
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- Lista de extensões para Chrome
- Extensão do Chrome no Mac
- Políticas de grupo Edge
- Não é possível se comunicar com o navegador
- A extensão Edge é removida automaticamente
- A extensão pode ter sido corrompida
- Check if the Extension for Microsoft Edge is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and InPrivate mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- Lista de extensões para Edge
- Extensão para Safari
- Extensão para o Varear Horizonte
- Plug-in do SAP Solution Manager
- Suplemento do Excel
- Solução de problemas
- Sobre a solução de problemas
- Suporte e limitações do Microsoft Apo-V
- Solução de problemas do Internet Explorer x64
- Problemas do Microsoft Office
- Como identificar elementos de EU em PDF com opções de acessibilidade
- Reparando o suporte da Active Accessibility
- Validation of large Windows-legacy projects takes longer than expected
Depuração remota
As automações podem se comportar de maneira diferente em máquinas diferentes. Se a máquina na qual uma automação será executada em produção tiver uma configuração diferente da máquina em que ela foi projetada (por exemplo, a máquina possui hardware ou software diferentes, permissões diferentes ou está em uma rede isolada) o processo deve ser testado e depurado com o robô nessa máquina.
A depuração remota habilita você a executar e depurar processos Attended e Unattended em Robots implantados em máquinas remotas, incluindo em Linux Robots, que podem executar projetos multiplataforma.
Você pode se conectar ao robô remoto usando um dos seguintes tipos de conexão:
- Máquina remota — estabeleça uma conexão TCP/IP ao robô na máquina remota.
- Robô não assistido — conecte-se a um robô não assistido no mesmo tenant usando o Orchestrator.
Para executar ou depurar um projeto usando uma conexão de máquina remota:
- Certifique-se de que todos os pré-requisitos sejam atendidos.
- Na máquina remota, configure o robô para aceitar solicitações de depuração remota.
-
Se a autenticação interativa for imposta no Orchestrator e você quiser executar ou depurar um processo não assistido, certifique-se de que o robô remoto atenda a uma das seguintes condições:
- Conectado ao Orchestrator usando o logon interativo.
- Conectado usando credenciais de cliente ou chave de máquina, e um usuário também entrou a partir do Assistant.
- Quando conectado usando credenciais do cliente ou chave da máquina, nenhum usuário é conectado ao Assistant, e uma sessão de solução de problemas é habilitada no Orchestrator para a máquina. Para obter mais informações, consulte Depuração de processos não assistidos.
-
No Studio:
- Configure uma conexão para o Robot remoto.
- Certifique-se de que a execução remota está habilitada.
- Execute ou depurar seu projeto.
- Existe conectividade TCP/IP entre a máquina do Studio e a máquina remota.
- O robô remoto tem a mesma versão que o Studio.
-
A estrutura do .NET compatível está instalada em sua máquina remota.
Antes que o robô remoto possa ser usado para depuração, o utilitário UiPath.RemoteDebugging.Agent nessa máquina deve ser configurado para aceitar solicitações de depuração remota do Studio:
-
Navegue até o diretório de instalação:
- Para um robô do Windows - abra um prompt de comando na pasta de instalação do UiPath® (por padrão
%PROGRAMFILES%\UiPath\Studio
para instalações por máquina e%localappdata%\Programs\UiPath\Studio
para instalações por usuário). - Para um robô do Linux — a partir de um terminal de linha de comando, navegue até
/root/application
. - Para um Robot macOS - A partir de zsh, navegue até
/Applications/UiPath Assistant.app/Contents/Robot
.
- Para um robô do Windows - abra um prompt de comando na pasta de instalação do UiPath® (por padrão
-
Execute o seguinte comando:
- Para um robô do Windows -
UiPath.RemoteDebugging.Agent.exe enable --port <port_number> --password <pasword> --verbose
- Para um robô do Linux -
~/application # dotnet ./UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose
-
Para um Robot macOS -
dotnet UiPath.RemoteDebugging.Agent.dll enable --port <port_number> --password <pasword> --verbose
Os argumentos no comando são opcionais:
-
--port <port_number>
— insira a porta a ser usada para receber comandos de depuração remota do Studio. Se nenhuma porta é fornecida, a porta 85773 é usada por padrão.A porta deve estar aberta no firewall e ainda não estar vinculada a outro aplicativo.
--password <password>
— insira uma senha que deve ser fornecida no Studio ao configurar uma conexão com o agente de depuração remota.--verbose
- Registrar informação extra no console.
- Para um robô do Windows -
-
A seguinte mensagem é exibida:
Robot on machine <hostname> is waiting for remote debugging instructions on port <port_number>
- Anote os valores do hostname e port_number; eles devem ser fornecidos ao configurar a conexão no Studio.
Nenhum trabalho assistido ou não assistido pode ser executado a partir do Orchestrator ou do Assistant local enquanto o robô está em um estado de depuração remota. Você pode enviar comandos de depuração remota até para máquinas em que a instalação do robô não está licenciada.
- No Studio, selecione a guia Depurar.
- Na faixa de opções, selecione a seta em Depuração Remota e, em seguida, selecione Configurar Depuração Remota para abrir a janela Configurações de Depuração Remota.
- No menu suspenso Tipo de Conexão, selecione Máquina Remota.
-
Forneça as seguintes informações nas caixas correspondentes:
- Host - O nome do host ou o endereço IP da máquina remota.
- Porta - A porta a ser usada. A porta padrão é 8573.
- Senha — a senha fornecida quando o agente de depuração remota foi configurado na máquina do robô, se aplicável.
- (Opcional) Para se certificar de que uma conexão pode ser estabelecida com a configuração atual, clique em Testar Conexão.
-
Clique em Salvar.
Para executar ou depurar um projeto remotamente usando um robô não assistido conectado ao Orchestrator:
- Certifique-se de que todos os pré-requisitos sejam atendidos.
- Configure uma conexão para o Robot remoto.
- Certifique-se de que a execução remota está habilitada.
- Execute ou depurar seu projeto.
- O Studio e o robô de destino estão conectados ao mesmo tenant do Orchestrator.
- O robô remoto tem a mesma versão que o Studio.
- Studio, o robô de destino e o Orchestrator estão executando a versão 2021.10 ou posterior.
- O usuário que entrou no Studio tem permissões para iniciar trabalhos e para criar e excluir buckets de armazenamento e arquivos de armazenamento no mesmo contexto de pasta que o robô de destino. Além disso, a conta do robô deve exibir permissões para buckets de armazenamento e arquivos de armazenamento.
-
O robô não assistido está configurado e a máquina tem uma das seguintes licenças de runtime disponíveis: Não Assistida, NonProduction ou Teste.
Observação: os runtimes de teste para a depuração remota são suportados no Orchestrator 2022.4 e em versões posteriores. - Para processos de depuração em primeiro plano, a opção Executar automações em primeiro plano está habilitada para o robô no Orchestrator.
- Se uma sessão de solução de problemas for usada, ela deve ser habilitada apenas após conectar o Robot ao Orchestrator.
- No Studio, selecione a guia Depurar.
- Na faixa de opções, selecione a seta em Depuração Remota e, em seguida, selecione Configurações de Depuração Remota.
- No menu suspenso Tipo de Conexão, selecione Robô não assistido.
-
Para usar qualquer máquina conectada que esteja disponível na pasta do Orchestrator selecionada na barra de status do Studio, clique em Salvar. Se você quiser selecionar a máquina à qual vai se conectar, use as seguintes opções:
- Usuário - Selecione uma conta com um robô não assistido atribuído à pasta do Orchestrator.
- Máquina - Selecione uma máquina ou modelo da pasta do Orchestrator.
-
Nome do host — selecione uma máquina da lista de máquinas conectadas.
-
Mostrar transmissão ao vivo - Selecione para ver as ações executadas pelo robô. Para obter mais informações, consulte Transmissão ao vivo e controle remoto.
Observação: se forem feitas alterações na configuração da conta no Orchestrator, atualize a conexão com o Orchestrator usando o botão na barra de status do Studio, para que elas sejam refletidas nessa janela.
Quando uma conexão de depuração remota é estabelecida, clicar no botão Depuração Remota na faixa de opções alterna entre execução remota e local. Antes de selecionar uma operação de execução ou depuração, certifique-se de que a opção desejada esteja habilitada (remota ou local).
-
Contanto que o botão esteja realçado em cinza, todas as operações de execução e depuração (Depurar Arquivo, Executar Arquivo, Depurar Projeto, Executar Projeto, Imergir/Saltar/Sair, Testar Atividade, Executar para/a partir desta atividade) são realizadas no robô remoto.
-
Contanto que o botão não esteja realçado em cinza, todas as operações de execução e depuração são realizadas no robô local.
A experiência de depuração remota é semelhante à experiência de depuração local, e todos os recursos disponíveis para a depuração local também estão disponíveis para a depuração remota. Quando a execução remota que foi disparada na guia Depurar está em progresso, a barra de status do Studio fica com cor verde.
Dependendo do tipo de conexão usada para a depuração remota, o robô remoto recebe os pacotes de atividades necessários para executar um projeto da seguinte maneira:
- Conexão de máquina remota — o Studio envia a lista de dependências de projeto e feeds de atividades (origens de pacotes) para o robô remoto, que usa os feeds fornecidos pelo Studio para baixar os pacotes necessários.
- Conexão de UiPath Robot Unattended - o Studio envia apenas a lista de dependências do projeto para o UiPath Robot remoto, que usa os feeds do Orchestrator e os feeds de atividades configurados no UiPath Robot remoto para baixar os pacotes necessários.
- Ao usar uma conexão de máquina remota, se você pausa a depuração por um período prolongado, um erro Conexão Encerrada pode ocorrer no Studio, mesmo a conexão ainda estando aparentemente ativa na máquina remota. Para evitar esse problema, você pode aumentar o tempo limite ocioso do TCP em sua nuvem ou balanceador de carga no local.
- Os fluxos de trabalho de longa duração de depuração remota são suportados apenas por conexões de Robots unattended.
- Ao usar uma conexão de robô não assistida, selecionar a opção Picture in Picture não inicia a execução em uma sessão separada.
- A opção Mostrar transmissão ao vivo funciona apenas se o Serviço de Robôs da UiPath no Unattended Robot for implantado no modo de serviço. Para obter mais informações, consulte Serviço de Robôs da UiPath.
- A opção Mostrar transmissão ao vivo é suportada apenas para o Automation Cloud Orchestrator e Automation Suite Orchestrator.