- 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
Sobre o Analisador de Fluxo de Trabalho
O Analisador de Fluxo de Trabalho é um analisador de código estático, que garante que seu projeto cumpra as normas de qualidade e confiabilidade. Um analisador de código estático verifica inconsistências, sem de fato executar o projeto, diferente dos analisadores dinâmicos, que verificam durante a execução.
O Analisador de Fluxo de Trabalho usa um conjunto de regras para verificar várias inconsistências não relacionadas à execução do projeto. As regras são baseadas nas Práticas recomendadas de automação e levam em consideração a nomenclatura da variável e do argumento, as sequências ou os fluxos de trabalho vazios, as restrições de pacotes, etc. O analisador não identifica erros na execução ou compilação.
Ela fica disponível na aba Design da faixa de opções, nos botões Analisar Arquivo e Analisar Projeto. O primeiro executa uma análise no arquivo que está focado atualmente no painel Designer, já o segundo analisa todos os arquivos no projeto de automação.
ST-
. UIAutomation.Activities, Excel.Activities, Atividades de teste e Mail.Activities também têm suas próprias regras identificáveis por prefixo. Veja mais na tabela abaixo:
Categoria da regra |
Description |
Origem |
---|---|---|
Nomenclatura |
Verifica o arquivo ou o projeto quanto a quaisquer inconsistências relacionadas à nomenclatura. |
Studio |
Garante que seu projeto atenda a um conjunto geral de práticas recomendadas. | Studio | |
Garante que seu projeto atenda aos requisitos gerais em termos de anatomia. | Studio | |
Confirma que os projetos são de fácil entendimento para que a capacidade de manutenção seja garantida. | Studio | |
Garante que os elementos definidos em seu projeto sejam realmente usados. | Studio | |
Verifica o arquivo ou o projeto quanto a quaisquer inconsistências relacionadas ao desempenho e à capacidade de reutilização. | Studio | |
Verifica o arquivo ou o projeto quanto a quaisquer inconsistências relacionadas à confiabilidade. | Studio | |
Verifica o arquivo ou o projeto quanto a quaisquer inconsistências relacionadas à segurança. | Studio | |
Testa os fluxos de trabalho e projetos de automação. |
Atividades | |
Validar fluxos de trabalho que consomem atividades Classic ou Modern UI Automation. |
Atividades | |
Valida fluxos de trabalho que consomem Atividades do Excel. | Atividades | |
Valida fluxos de trabalho que consomem Atividades de envio. | Atividades |
Também é possível criar regras personalizadas. Para obter mais informações, consulte Criação de regras do Analisador de Fluxo de Trabalho no Guia do desenvolvedor.
As regras também podem ser configuradas ao criar uma política do Studio no Automation Ops. Para obter mais informações, consulte o guiado Automation Ops.
ST-NMG-001
:
ST
– Revela que a regra está integrada no Studio.NMG
– Mostra que a regra faz parte da categoria Regras de Nomenclatura . As regras que fazem parte da categoria Regras de Anatomia do Projeto têm a abreviaçãoANA
, as que fazem parte da Práticas Recomendadas de Design aDBP
, e assim por diante.001
– É o número da regra.
Cada regra tem um escopo ao qual ela se aplica:
- Atividade: as regras são impostas no nível da atividade, verificando variáveis, argumentos, propriedades. A Convenção de Nomenclatura das Variáveis é uma dessas regras.
- Fluxo de trabalho: as regras realizam verificações em um único arquivo do projeto, por exemplo Variáveis Não Utilizadas.
- Projeto: as verificações são realizadas no nível do projeto.
As regras têm algumas ações que podem ser definidas:
- Error: gera um erro no painel Lista de Erros.
- Warning: gera um aviso no painel Lista de Erros.
- Info: gera uma mensagem no painel Lista de Erros.
- Verbose: cria arquivos de log grandes.
Verifique a página Níveis de registro em log para saber mais sobre o registro em log com o Studio.
O projeto ou o arquivo é analisado baseado em um conjunto de regras disponíveis na janela Configurações do Projeto:
- No painel Projeto, clique no ícone e selecione o Analisador de Fluxo de Trabalho.
- Na faixa de opções, clique no botão Analisar Arquivo, e selecione Configurações do Analisador de Fluxo de Trabalho no menu suspenso.
Por padrão, as regras são organizadas por código na janela, as regras habilitadas são exibidas primeiro.
Use a caixa de pesquisa na parte superior da janela para pesquisar regras por nome ou código. Para filtrar regras por escopo e ação padrão, clique no botão à direita da caixa de pesquisa.
Configurar Regras
Você pode habilitar/desabilitar uma regra usando a caixa de seleção à sua esquerda ou alterar a ação padrão usando o menu suspenso à sua direita.
Algumas regras não exigem nenhuma configuração adicional, enquanto outras contêm parâmetros que você pode configurar, como limiares que não devem ser excedidos ou listas de itens específicos que são permitidos ou proibidos. Observe que quando você configura regras que contêm campos de texto (por exemplo, Uso Incorreto de SecureString ou Restrições do Pacote), o texto não deve ser inserido entre aspas.
Redefinir para o padrão
Após alguma alteração ter sido feita nos valores padrão das regras, seja ela Regex ou de limite, os valores podem ser revertidos para o padrão clicando com o botão direito do mouse e selecionando Redefinir para o Padrão.
A validação do arquivo ou projeto será realizada sempre que o Analisador de Fluxo de Trabalho for disparado. As opções de validação ficam disponíveis nos botões Validar Arquivo e Validar Projeto, da faixa de opções Analisar Arquivo.
Essa ação verifica se as variáveis, os argumentos, as expressões e as importações foram configuradas corretamente. A ação Validar Arquivo pode ser disparada usando o atalho F8, e a de Validar Projeto, usando Shift + F8. A validação pode ser cancelada a qualquer momento.
Os arquivos que contêm erros são marcados no painel Projeto com um ponto vermelho, e os erros são exibidos nos painéis Lista de Erros e Saída.
.xaml
e destaca o elemento que gerou o erro, que pode ser uma atividade, um argumento ou uma variável.
.xaml
sejam validados, o projeto não pode ser depurado, executado ou publicado. As condições de ponto de interrupção não são avaliadas.
Quando disparado, o Analisador de Fluxo de Trabalho usa o conjunto de regras configurado para verificar o projeto ou arquivo, e registra em log os erros encontrados no painel Lista de Erros, de acordo com a ação da regra.
O painel Lista de Erros filtra os itens por Erros, Avisos e Mensagens. O menu suspenso de escopo é útil para filtrar os erros por projeto, arquivo atual ou um arquivo específico na automação. Além disso, os itens podem ser filtrados pelo ID da regra.
Clique em um aviso ou erro encontrado para exibir a recomendação da regra e um link para a página de documentação de cada regra.
Além das violações de regras, o painel Lista de Erros também exibe os erros que podem ocorrer na execução da análise do fluxo de trabalho. Quando o Analisador de Fluxo de Trabalho ou uma das regras configuradas falhar na execução, um erro será registrado em log com os detalhes sobre sua causa.
UiPath.Studio.CommandLine.exe
contém um conjunto de parâmetros para verificar os arquivos ou os projetos com relação a determinadas regras, mesmo nas configurações do pipeline de CI/CD.
UiPath.Studio.CommandLine.exe
está disponível na pasta de instalação:
- Para as instalações por máquina, o caminho padrão é
%ProgramFiles%\UiPath\Studio\
- Para instalações por usuário, o caminho padrão é
%LocalAppData%\Programs\UiPath\Studio
Configurar Regras
Por padrão, todas as regras do Analisador de Fluxo de Trabalho são habilitadas ao instalar o Studio, com exceção da seguinte:
Você pode configurar as regras:
- Na janela Configurações do Analisador de Fluxo de Trabalho, habilite ou desabilite as regras clicando na caixa de seleção ao lado de cada uma delas.
- Do arquivo
RuleConfig.json
, caminho%LocalAppData%\UiPath\Rules
. Encontre uma regra específica, modifique parâmetro respectivo, altere o parâmetroIsEnabled
parafalse
para desativar a regra. Opcionalmente, se o caminho não estiver acessível, coloque o arquivoRuleConfig.json
em um local personalizado e inclua o caminho para ele no comando. Para obter mais informações, consulte Analisar arquivos e projetos.
As regras são organizadas de acordo com seu ID exclusivo, visível também nas Configurações do Analisador de Fluxo de Trabalho.
([A-Z])
. Isso significa que os nomes de variáveis devem ser escritos com letras maiúsculas. Todas as outras regras foram desabilitadas neste exemplo.
Parâmetro | Description |
---|---|
RuleId | O ID da regra. |
IsEnabled | Se a regra está habilitada ou desabilitada. Se definido como nulo, o valor do parâmetro DefaultIsEnabled será aplicado. |
DefaultIsEnabled | Se a regra é habilitada ou desabilitada por padrão. |
DefaultErrorLevel | O nível padrão da mensagem de log (Error, Warning, Info, Verbose). |
Parameters | Parâmetros adicionais que a regra pode conter (por exemplo, Nome ou Valor). |
ErrorLevel | O nível da mensagem de log. Se definido como nulo, o valor do parâmetro DefaultErrorLevel será aplicado. |
Como analisar arquivos e projetos
UiPath.Studio.CommandLine.exe
.
Os seguintes comandos do Analisador de Fluxo de Trabalho estão disponíveis:
analyze
– Analisa o projeto completo. Requer o caminho para o arquivoproject.json
.analyze-file
– Analisa um único arquivo. Requer o caminho para o arquivo.xaml
.
Os seguintes argumentos estão disponíveis para os comandos do Analisador de Fluxo de Trabalho:
Argumento |
Description |
---|---|
|
Para analisar um arquivo, forneça o caminho para o
.xaml . Para analisar o projeto completo, especifique o caminho para o arquivo project.json .
|
|
O caminho para o arquivo
RuleConfig.json . Especifique o caminho apenas se o arquivo de configuração de regras não estiver no local padrão (%LocalAppData%\UiPath\Rules ).
|
|
Exibe os argumentos disponíveis para cada comando. |
|
Verifica a versão de
UiPath.Studio.CommandLine.exe .
|
UiPath.Studio.CommandLine.exe analyze-file -p "C:\BlankProcess\Main.xaml"
analisa apenas um arquivo em um projeto, Main.xaml
. A saída do comando retorna um dicionário codificado json, com as seguintes informações para cada violação da regra:
FilePath
: o caminho para o arquivo analisado.ErrorCode
: o ID da regra.ActivityDisplayName
: o nome de exibição da atividade (null
, se não for aplicável).Item
– O nome e o tipo do item (por exemplo, atividade ou variável) em que a mensagem de erro foi gerada.ErrorSeverity
: o valor do parâmetroDefaultAction
, que é a mensagem de log configurada para cada regra, seja Warning, Error, Info ou Verbose.Description
: a descrição da regra.-
Recommendation
eURL
: as alterações recomendadas para solucionar o problema, juntamente com o link da documentação com mais informações.
RuleConfig.json
num local personalizado, adicione o local ao comando. Usando o comando anterior como um exemplo, para configurar regras com o arquivo em C:\CustomFolder\RuleConfig.json
, execute o comando a seguir: UiPath.Studio.CommandLine.exe analyze-file -c "C:\CustomFolder\RuleConfig.json" -p "C:\BlankProcess\Main.xaml"
.
echo %errorlevel%
após você executá-lo. Se não houver mensagens com o erro ErrorSeverity
, o código 0
será retornado. Caso contrário, 1
será retornado.
.xaml
vazio, um erro será exibido.
Os GUID (identificadores globais exclusivos) usados como prefixos para uma entrada são gerados em cada execução e aplicados apenas no resultado atual.
Para configurar o Studio para exportar os resultados de cada análise de fluxo de trabalho para a pasta do projeto, acesse Exibição Backstage do Studio > Configurações > Design, e habilite a opção Exportar resultados do Analisador.
\.local\.analysis\
da pasta do projeto em um arquivo cujo nome é o registro de data e hora seguido por project_analysis_results.json
(quando a opção Analisar Projeto é usada), ou file_analysis_results.json
(quando a opção Analisar Arquivo é usada) .
.local
está oculta. Você pode habilitar a visualização de itens ocultos a partir das configurações do Explorador de Arquivos do Windows.
Os arquivos contém as seguintes informações sobre cada regra habilitada:
RuleId
– O ID da regra.RuleName
– O nome da regra.Parameters
– Os parâmetros personalizados na regra, se aplicável.Severity
— a ação da regra, se a regra for violada.ErrorsDescription
– Uma lista de mensagens de erro geradas pela regra, se aplicável.
Você pode impedir a execução, publicação e envio por push/verificação em projetos de repositórios remotos que contêm erros do Workflow Analyzer, habilitando as seguintes opções a partir de Studio Backstage View > Configurações > Design:
- Impor o Analisador antes de Executar – Sempre a execução/depuração de um arquivo ou projeto for iniciada, o Analisador de Fluxo de Trabalho verifica todas as regras com a ação
Error
e a execução é permitida apenas se nenhum erro for encontrado. - Impor o Analisador antes de Publicar – Sempre que a publicação for iniciada, o Analisador de Fluxo de Trabalho verifica todas as regras habilitadas, independentemente da sua ação, e a publicação é permitida apenas se não houver violações de regra com a ação
Error
. - Enforce Analyzer before Push/Check-in - Sempre que o envio de um projeto para um repositório remoto for iniciado (Commit and Push para GIT, Check in para SVN e TFS), o Workflow Analyzer verifica todas as regras habilitadas, independentemente de sua ação, e a operação é permitida apenas se não houver violações de regras com a ação
Error
.
Error
), os resultados da análise do fluxo de trabalho serão incluídos no pacote .nupkg
publicado no arquivo project_analysis_results.json
, localizado em \lib\net45\.analysis\
. O arquivo contém as seguintes informações sobre cada regra habilitada:
RuleId
– O ID da regra.RuleName
– O nome da regra.Parameters
– Os parâmetros personalizados na regra, se aplicável.Severity
— a ação da regra (se a regra for violada).ErrorsDescription
– Uma lista de mensagens de erro geradas pela regra, se aplicável.