Verificador de fluxo (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

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.

Importante

• Este é um recurso em versão preliminar.
• Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos estão sujeitos a termos de uso suplementares e são disponibilizados antes de um lançamento oficial, de maneira que os clientes possam ter acesso antecipado e fazer comentários.

Gerenciamento de regras

As regras são definidas e gerenciadas por meio do verificador de solução no centro de administração do Power Platform. Os administradores podem:

• Habilitar ou desabilitar as regras.
• Configurar níveis de gravidade (erro, aviso, informação).
• Aplicar regras a ambientes ou grupos de ambientes específicos (Ambientes Gerenciados ).

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.

Observação

• Se o ambiente fizer parte de um grupo de ambientes com uma configuração definida, as configurações de regra serão herdadas e não poderão ser editadas individualmente. Saiba mais sobre o verificador de solução em Verificador de Solução e Imposição do verificador de solução em Ambientes Gerenciados.
• Os administradores do Power Platform devem atribuir o seguinte privilégio a todas as funções que exijam acesso ao recurso: prvReadmsdyn_analysisoverride (nome amigável é 'Substituição de Análise (Leitura)').

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.

Observação

A análise estática é executada para todos os fluxos da área de trabalho incluídos em uma solução. Identifique qual fluxo da área de trabalho dispara uma violação de regra específica verificando a coluna Nome do objeto nos resultados. Esta coluna mostra o nome do fluxo da área de trabalho correspondente.

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.

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.

Cada violação exibe um bloco com detalhes, incluindo 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.

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: Design
• 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.

Tamanho da variável excedido

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: o nome da variável excede o limite de 25 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 é 25 caracteres.
• Correção sugerida: renomeie quaisquer variáveis que excedam o limite de caracteres especificado para garantir que os nomes tenham menos de 25 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 Erro no 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 prováveis erros, configure as ações 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: fatore novamente o fluxo para reduzir o aninhamento de instruções if para um máximo de cinco níveis.

If Incompleto

• Gravidade: Aviso
• Tipo: Design
• 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: percorra o fluxo e analise cada condição "If" para garantir que ele inclua ações significativas nas ramificações "If", "Else if" e "Else".

Loop infinito

• Gravidade: Aviso
• Tipo: Design
• 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.

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