Verificador de fluxo

Melhore seu fluxo de trabalho de desenvolvimento com o recurso de análise estática em verificador de solução. Essa ferramenta oferece suporte às práticas recomendadas em automação robótica de processos (RPA) e atende aos requisitos críticos de fluxo avaliando automaticamente seus fluxos para garantir o desempenho ideal. A análise estática está disponível na seção Verificador de fluxo do designer. Ela aplica as principais diretrizes e fornece comentários em tempo real e inspeção antecipada de código. Ele se integra diretamente ao seu fluxo de trabalho, melhora a qualidade do código e estabelece a base para uma experiência de desenvolvimento mais eficiente e produtiva.

Gerenciamento de regras

Defina e gerencie regras por meio do verificador de solução no centro de administração do Power Platform e na configuração do verificador de fluxo no portal Power Automate.

Administradores e usuários com as permissões apropriadas podem:

• Habilitar ou desabilitar as regras.
• Configurar níveis de gravidade (erro, aviso, informação).
• Configurar valores personalizados para regras que dão suporte a parâmetros, como limiares e limites (somente no portal do Power Automate).
• Aplicar regras a ambientes ou grupos de ambiente específicos (ambientes gerenciados, somente centro de administração do Power Platform).

A configuração do verificador de fluxo aplica-se no nível do ambiente e afeta todos os fluxos da área de trabalho dentro do ambiente selecionado.

As configurações de imposição do verificador de solução que você configura no centro de administração do Power Platform têm precedência sobre as configurações do verificador de fluxo no portal do Power Automate. Você não pode modificar regras que estão restritas pela aplicação do Solution checker no portal do Power Automate.

Configuração no centro de administração

Para configurar regras de análise estática:

1. Acesse o centro de administração do Power Platform.
2. Selecione Gerenciar>Ambientes para continuar.
3. Selecione Editar ambientes gerenciados.
4. Na seção Imposição do verificador de solução, configure quais regras devem ser excluídas para o ambiente selecionado.

Configuração no portal Power Automate

Para configurar regras de verificador de fluxo para um ambiente:

1. Acesse a página Fluxos da área de trabalho no portal do Power Automate.

2. Selecione o Verificador de fluxo.

3. No painel de configuração do verificador de fluxo , configure as regras desejadas. Para cada regra, você pode:

   • Habilite ou desabilite a regra.
   • Selecione um nível de severidade.
   • Especifique um valor personalizado para regras que dão suporte a parâmetros.

4. Selecione Salvar.

As alterações de configuração são aplicadas no nível do ambiente e afetam todos os fluxos da área de trabalho no ambiente selecionado. Para fluxos de área de trabalho que já estão abertos no designer, reabra o fluxo para que as alterações de configuração entrem em vigor.

Executar análise estática no portal

Para disparar manualmente a análise estática:

1. Acesse a página Soluções no Portal do Power Automate.

2. Abra o menu de contexto (⋯) ao lado de uma solução.

3. Passe o mouse sobre o Verificador de solução.

4. Escolha uma das seguintes opções:

   • Executar: inicia a análise estática.
   • Exibir resultados: abre o relatório de análise mais recente.
   • Download de resultados: exporta o relatório para revisão offline.

Análise estática no designer

A análise estática é executada automaticamente, inspecionando continuamente seu código sem a necessidade de intervenção manual. Quando você adiciona, remove ou modifica ações em seu fluxo, esse recurso é ativado para avaliar as alterações e atualizar a análise. Esse processo torna o desenvolvimento contínuo e eficiente. No lado direito do designer, você vê um botão dedicado do Verificador de Fluxo. O número no botão mostra o total de violações no fluxo da área de trabalho. Selecione o botão para abrir o painel Verificador de Fluxo e exibir insights detalhados sobre as regras específicas violadas.

Cada análise gera um escore percentual que mostra a proporção de regras seguidas com sucesso. Uma pontuação mais alta significa menos violações e melhor qualidade de código.

Essa pontuação é recalculada toda vez que uma alteração é feita no fluxo, fornecendo comentários imediatos e promovendo boas práticas de desenvolvimento.

Se as regras forem violadas, o relatório de análise estática mostra um resumo claro. Ele lista nomes de regras e o número de ações ou variáveis em seu fluxo que violam cada regra. A seleção de uma regra realça a ação correspondente e fornece uma explicação detalhada do erro. Para violações relacionadas a variáveis, o sistema navega até o painel de variáveis, facilitando as correções. O painel Verificador de fluxo inclui a funcionalidade de pesquisa e permite filtrar por subfluxo, para que você possa localizar rapidamente problemas específicos.

Cada violação exibe um bloco com detalhes, inclusive a natureza do erro, correções recomendadas e um link para a documentação. Use o controle deslizante no cabeçalho da regra para navegar entre ocorrências da mesma violação. Esta orientação ajuda os desenvolvedores a resolver problemas de forma rápida e eficaz. As violações de erro do verificador de fluxo mostram um indicador embutido e um pop-up com mais detalhes. Avisos também aparecem na área de trabalho do designer, assim como os erros. O editor mostra status de diagnóstico, como avisos e erros, nas abas de subfluxo e inclui um botão que permite ir até o componente que requer atenção.

Legenda

1. Ocorrências da violação de regra específica
2. Navegue até a ação que viola a regra
3. Link para a documentação

Regras de análise estática

As regras de análise estática são diretrizes predefinidas que ajudam a garantir que seus fluxos sejam seguros, sustentáveis e de alto desempenho. Cada regra visa aspectos específicos do design do fluxo, como segurança, desempenho e facilidade de manutenção, e fornece feedback acionável para melhorar a qualidade do fluxo. Abaixo está uma lista das regras, suas descrições e correções sugeridas.

Segurança de senha não segura

• Gravidade: Aviso
• Tipo: Segurança
• Detalhes do erro: As senhas estão gerenciadas de forma insegura no fluxo.
• Descrição: esta regra verifica se as senhas são gerenciadas de forma insegura em um fluxo da área de trabalho, garantindo que não sejam expostas ou incorretamente processadas durante a execução.
• Correção sugerida: verifique se todas as entradas relacionadas à senha são tratadas adequadamente usando os recursos de senha do Power Automate para desktop. Use "Entrada de texto criptografada direta" para máxima segurança por meio de criptografia baseada em máquina. Para fluxos usados em máquinas diferentes, escolha "Entrada de senha como variável" e marque a variável correspondente como sensível para aumentar a segurança. Além disso, use recursos seguros de gerenciamento de credenciais, como a ação "Obter Credencial", que se integra às credenciais do CyberArk.

Recursão entre dois subfluxos

• Gravidade: Aviso
• Tipo: Projeto
• Detalhes do erro: chamadas recursivas detectadas entre subfluxos, causando possivelmente um loop infinito.
• Descrição: esta regra verifica a existência de chamadas recursivas entre dois ou mais subfluxos, garantindo que o fluxo não entre em um loop infinito.
• Correção sugerida: remova quaisquer chamadas recursivas entre os subfluxos.

O tamanho da variável excedeu o limite

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: o nome da variável excede o limite de 40 caracteres.
• Descrição: esta regra verifica se o nome de cada variável definida no fluxo excede um número especificado de caracteres. O limite padrão é 40 caracteres.
• Correção sugerida: renomeie quaisquer variáveis que excedam o limite de caracteres especificado para garantir que os nomes tenham menos de 40 caracteres.

Valores padrão da variável de entrada

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: as variáveis de entrada/saída não estão usando valores padrão.
• Descrição: esta regra verifica se as variáveis de entrada/saída estão usando valores padrão, garantindo que estejam corretamente configuradas para o fluxo.
• Correção sugerida: atribua valores padrão a todas as variáveis de entrada e saída no fluxo.

Limite no número de variáveis de entrada e saída

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: o total de variáveis de entrada/saída excede o limite de 25 variáveis.
• Descrição: esta regra verifica se o número total de variáveis de entrada/saída no fluxo excede um limite especificado. O limite é de 25 variáveis.
• Correção sugerida: certifique-se de que o número de variáveis de entrada e saída no fluxo não exceda 25.

Ação de erro de bloco vazia

• Gravidade padrão: Aviso
• Tipo: Design
• Detalhes do erro: a ação "Erro no bloco" está vazia e não processa erros.
• Descrição: esta regra verifica se as ações "Erro no bloco" em seu fluxo estão configuradas corretamente para lidar com erros, certificando-se de que os erros sejam lançados e gerenciados conforme o esperado.
• Correção sugerida: Para gerenciar erros em potencial, configure as ações de Erro no bloco no fluxo.

Cláusulas If aninhadas

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: as cláusulas If aninhadas excedem cinco níveis.
• Descrição: Esta regra verifica se existem instruções `if` aninhadas com mais de cinco níveis, garantindo que o fluxo permaneça gerenciável e legível.
• Correção sugerida: Refatore o fluxo para reduzir o aninhamento de instruções `if` para no máximo cinco níveis.

Incompleto se

• Gravidade: Aviso
• Tipo: Projeto
• Detalhes do erro: ação if incompleta detectada, com conteúdo ausente ou que contenha somente ações na ramificação Else.
• Descrição: esta regra detecta se as ações If não têm conteúdo ou contêm apenas ações na ramificação Else, garantindo que as instruções condicionais sejam implementadas com eficiência.
• Correção sugerida: revise o fluxo e analise cada condição "If" para garantir que ela inclua ações significativas nas ramificações "If", "Else if" e "Else".

Loop infinito

• Gravidade: Aviso
• Tipo: Projeto
• Detalhes do erro: loop infinito detectado no fluxo, possivelmente fazendo com que ele seja executado indefinidamente.
• Descrição: esta regra verifica se existem loops infinitos no fluxo, ajudando a identificar e prevenir cenários em que o fluxo possa ser executado indefinidamente.
• Correção sugerida: certifique-se de que cada loop tenha uma condição de terminação claramente definida e alcançável. A condição pode ser baseada em um contador, um valor específico ou a conclusão de uma tarefa. Adicione verificações ou condições à prova de falhas para interromper o loop se ele for executado por mais tempo do que o esperado. Por exemplo, defina uma contagem máxima de iterações ou inclua um tempo limite.

Uso indevido de ações de espera

• Gravidade: Aviso
• Tipo: Desempenho
• Detalhes do erro: foi detectado o uso incorreto de ações de espera, com mais de 10 ações de espera causando possíveis gargalos.
• Descrição: esta regra verifica se o fluxo contém um número excessivo de ações de espera, mais de 10, para ajudar a identificar e minimizar possíveis gargalos causados por atrasos prolongados.
• Correção sugerida: revise o fluxo para identificar todas as ações de espera e verificar se elas são essenciais para a lógica do fluxo. Remova esperas desnecessárias ou combine-as sempre que possível.

Imenso tempo de espera

• Gravidade: Aviso
• Tipo: Desempenho
• Detalhes do erro: foi detectado um imenso tempo de espera, excedendo o limite de 600 segundos para ações de espera codificadas.
• Descrição: esta regra verifica se as ações de espera codificadas no fluxo excedem um período de tempo especificado, com o limite padrão definido como 600 segundos.
• Correção sugerida: revise o fluxo para localizar ações de espera que excedam o limite de 600 segundos. Verifique se esses longos tempos de espera são necessários e ajuste sua duração para o menor tempo necessário para que o fluxo funcione corretamente. Se uma longa espera for necessária, divida-a em intervalos mais curtos e adicione verificações ou condições entre elas. Sempre que possível, substitua longas ações de espera por gatilhos orientados a eventos.

Ações não alcançadas

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: uma ou mais ações no fluxo estão inacessíveis e não serão executadas sob circunstância alguma.
• Descrição: esta regra verifica se há ações no fluxo inacessíveis logicamente. Ações inalcançáveis podem resultar de ramificações incorretas, condições mal posicionadas ou segmentos desconectados e podem indicar problemas na lógica ou na estrutura do fluxo.
• Correção sugerida: Revise o fluxo para encontrar ações que não estão conectadas a um caminho de execução. Certifique-se de que cada ação possa ser acessada por meio de uma ramificação lógica ou loop válido. Remova ou mova ações inacessíveis para manter o fluxo claro e eficiente.

Subfluxo não necessário

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: a regra detectou um subfluxo que não contém ações, apenas ações desabilitadas ou inclui poucas ações para justificar sua separação. Esses subfluxos podem não contribuir significativamente para a execução do fluxo e podem reduzir a clareza.
• Descrição: essa regra verifica se há subfluxos vazios ou excessivamente mínimos, normalmente contendo menos de 5 ações. Embora os subfluxos sejam úteis para modularidade e reutilização, aqueles que não têm conteúdo ou abstração significativos podem indicar desenvolvimento incompleto, fragmentação desnecessária ou configuração incorreta. Esses padrões podem causar confusão e dificultar a manutenção.
• Correção sugerida: examine o subfluxo identificado para determinar se ele serve a uma finalidade clara e valiosa. Se não, considere removê-lo ou mesclá-lo a um bloco de lógica relacionado. Se o subfluxo for destinado ao uso futuro, adicione uma ação de marcador para esclarecer sua função e evitar interpretações equivocadas.

Limitações conhecidas

• Disponível somente em Ambientes Gerenciados.
• A personalização de regras é limitada a habilitar ou desabilitar regras e configurar a gravidade.

Problemas conhecidos

• A exclusão de ações copiadas após a exibição de um detalhe de violação de regra pode disparar erros não tratados.
• O uso de uma variável de senha não confidencial nas ações a seguir faz com que a análise estática falhe durante a avaliação da regra.
  • Exibir caixa de diálogo de entrada
  • Exibir caixa de diálogo de seleção de pastas
  • Exibir formulário personalizado