Verificador de fluxo

Melhore o seu fluxo de trabalho de desenvolvimento com a caraterística de análise estática no verificador de solução. Esta ferramenta suporta as melhores práticas na automatização robótica de processos (RPA) e cumpre os requisitos críticos de fluxo ao avaliar automaticamente os seus fluxos para garantir o desempenho ideal. A análise estática está disponível na secção Verificador de fluxos do estruturador. Impõe as principais diretrizes e fornece feedback em tempo real e inspeção antecipada de código. Integra-se diretamente no seu fluxo de trabalho, melhora a qualidade do código e estabelece as bases para uma experiência de desenvolvimento mais eficiente e produtiva.

Gestão de regras

Defina e gere regras através do verificador de soluções no centro de administração do Power Platform e da configuração do verificador de fluxo no portal Power Automate.

Administradores e utilizadores com as permissões apropriadas podem:

• Ative ou desative regras.
• Configure níveis de gravidade (erro, aviso, informações).
• Configure valores personalizados para regras que suportem parâmetros, como limiares e limites (apenas no portal Power Automate).
• Aplique regras a ambientes específicos ou grupos de ambientes (apenas Managed Environments, Power Platform admin center).

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

As definições de imposição do Solution checker que configura no centro de administração do Power Platform prevalecem sobre as definições de configuração do Flow checker no portal do Power Automate. Não podes modificar regras que são restringidas pela aplicação do verificador de soluções no portal do Power Automate.

Configuração no centro de administração

Para configurar regras de análise estática:

1. Aceda ao centro de administração do Power Platform.
2. Selecione Gerir>Ambientes para continuar.
3. Selecione Editar ambientes geridos.
4. Na secção Imposição do verificador de solução, configure as regras que 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. Aceda à página fluxos do ambiente de trabalho no portal do Power Automate.

2. Selecione verificador de fluxo.

3. No painel de configuração do verificador de fluxo , configure as regras desejadas. Para cada regra, é possível:

   • Ativa ou desativa a regra.
   • Selecione um nível de gravidade.
   • Especifique um valor personalizado para regras que suportem parâmetros.

4. Selecione Guardar.

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

Executar análise estática no portal

Para acionar manualmente a análise estática:

1. Aceda à página Soluções no portal do Power Automate.

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

3. Passe o cursor sobre o Verificador de Soluções.

4. Escolha uma das seguintes opções:

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

Análise estática no editor

A análise estática é executada automaticamente, inspecionando continuamente o seu código sem exigir intervenção manual. Quando adiciona, remove ou modifica ações no seu fluxo, esta caraterística é ativada para avaliar as alterações e atualizar a análise. Este processo torna o desenvolvimento eficiente e totalmente integrado. No lado direito do editor, pode ver um botão dedicado de verificação de fluxos. O número apresentado no botão mostra o total de violações no fluxo do desktop. Selecione o botão para abrir o painel do Verificador de Fluxos e ver informações detalhadas sobre as regras específicas que foram violadas.

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

Esta classificação é recalculada sempre que uma alteração é feita no fluxo, fornecendo feedback imediato e promovendo boas práticas de desenvolvimento.

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

Cada violação apresenta um painel com detalhes, incluindo a natureza do erro, as correções recomendadas e uma ligação para a documentação. Use o slider no cabeçalho da regra para navegar entre ocorrências da mesma infração. Esta orientação ajuda os programadores a abordar problemas de forma rápida e eficaz. Os erros detetados pelo verificador de fluxo apresentam um indicador em linha e uma janela pop-up com mais detalhes. Os avisos também aparecem em linha na área de trabalho do designer, tal como acontece com os erros. O designer mostra estados de diagnóstico, como avisos e erros, nos separadores dos subfluxos, e inclui um botão que lhe permite ir para o componente que requer atenção.

Legenda

1. Ocorrências da violação da regra específica
2. Ir para a ação que viola a regra
3. Link para Documentação

Regras de análise estática

As regras de análise estática são diretrizes predefinidas que ajudam a garantir que os seus fluxos são seguros, sustentáveis e eficientes. Cada regra visa aspetos específicos do design do fluxo, como a segurança, o desempenho e a capacidade de manutenção, e fornece feedback acionável para melhorar a qualidade do seu fluxo. Segue abaixo uma lista das regras, as respetivas descrições e as correções sugeridas.

Segurança de palavra-passe insegura

• Gravidade: Aviso
• Tipo: Segurança
• Detalhes do erro: as palavras-passe são geridas de forma insegura no fluxo.
• Descrição: esta regra verifica se as palavras-passe são geridas de forma insegura num fluxo de ambiente de trabalho para garantir que não são expostas ou incorretamente processadas durante a execução.
• Correção sugerida: certifique-se de que todas as entradas relacionadas com a palavra-passe são processadas adequadamente ao utilizar as caraterísticas de palavra-passe do Power Automate para computadores. Use "Entrada de texto encriptado direta" para obter o máximo de segurança através de encriptação baseada em computador. Para fluxos usados em computadores diferentes, selecione "Entrada de palavra-passe como variável" e marque a variável correspondente como confidencial para melhorar a segurança. Além disso, use caraterísticas de gestão segura de credenciais, como a ação "Obter Credencial", que se integra com credenciais da CyberArk.

Recursão entre dois subfluxos

• Gravidade: Aviso
• Tipo: Conceção
• Detalhes do erro: chamadas recursivas detetadas entre subfluxos, causando potencialmente um ciclo infinito.
• Descrição: esta regra verifica a existência de chamadas recursivas entre dois ou mais subfluxos, garantindo que o fluxo não entra num ciclo infinito.
• Correção sugerida: remova quaisquer chamadas recursivas entre os subfluxos.

O comprimento da variável excedeu o limite permitido

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

Valores predefinidos 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 a utilizar valores predefinidos.
• Descrição: esta regra verifica se as variáveis de Entrada/Saída estão a utilizar valores predefinidos, garantindo que estão corretamente configuradas para o fluxo.
• Correção sugerida: atribua valores predefinidos a todas as variáveis de entrada e de saída no fluxo.

Limiar 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 limiar 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 excede 25.

Ação de erro em bloco vazia

• Gravidade predefinida: Aviso
• Tipo: Design
• Detalhes do erro: a ação "On block error" está vazia e não processa erros.
• Descrição: esta regra verifica se as ações "On block error" no seu fluxo estão configuradas corretamente para processar erros, certificando-se de que os erros são lançados e geridos conforme esperado.
• Correção sugerida: para gerir erros potenciais, configure as ações On block error no fluxo.

Cláusulas aninhadas if

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: cláusulas If aninhadas excedem cinco níveis.
• Descrição: Esta regra verifica se há instruções «if» aninhadas com mais de cinco níveis, garantindo que o fluxo permanece gerível e legível.
• Correção sugerida: refatorize o fluxo para reduzir instruções if aninhadas para um máximo de cinco níveis.

Incompleto se

• Gravidade: Aviso
• Tipo: Conceção
• Detalhes do erro: foi detetada uma ação If incompleta, sem conteúdo ou apenas com ações no ramo Else.
• Descrição: esta regra deteta se as ações If não têm conteúdo ou contêm apenas ações no ramo Else, garantindo que as instruções condicionais são efetivamente implementadas.
• Correção sugerida: percorra o fluxo e analise cada condição "If" para garantir que inclui ações significativas nos ramos "If", "Else if" e "Else".

Ciclo infinito

• Gravidade: Aviso
• Tipo: Design
• Detalhes do erro: ciclo infinito detetado no fluxo, potencialmente fazendo com que seja executado indefinidamente.
• Descrição: esta regra verifica se existem ciclos infinitos no fluxo, ajudando a identificar e prevenir cenários em que o fluxo poderá ser executado indefinidamente.
• Correção sugerida: certifique-se de que cada ciclo tem uma condição de término claramente definida e alcançável. A condição pode ser baseada num contador, um valor específico ou a conclusão de uma tarefa. Adicionar verificações ou condições de salvaguarda para quebrar o ciclo se for executado por mais tempo do que o esperado. Por exemplo, defina uma contagem máxima de iterações ou inclua um tempo limite.

Utilização incorreta de ações de espera

• Gravidade: Aviso
• Tipo: Desempenho
• Detalhes do erro: foi detetada uma utilização incorreta de ações de espera, com mais de 10 ações de espera a causarem potenciais estrangulamentos.
• 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 a minimizar potenciais estrangulamentos causados por atrasos prolongados.
• Correção sugerida: reveja o fluxo para identificar todas as ações de espera e verificar se são essenciais para a lógica do fluxo. Remova esperas desnecessárias ou combine-as sempre que possível.

Tempo de espera enorme

• Gravidade: Aviso
• Tipo: Desempenho
• Detalhes do erro: foi detetado um enorme 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 definido como 600 segundos.
• Correção sugerida: reveja o fluxo para localizar ações de espera que excedam o limite de 600 segundos. Verifique se esses tempos de espera longos são necessários e ajuste a duração para o menor tempo necessário para que o fluxo funcione corretamente. Se for necessária uma espera longa, divida-a em intervalos mais curtos e adicione verificações ou condições entre eles. Sempre que possível, substitua ações de espera longas por acionadores condicionados por 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 em nenhuma circunstância.
• Descrição: esta regra verifica se há ações no fluxo que estejam logicamente inacessíveis. Ações inacessíveis podem resultar de ramificação incorreta, condições mal colocadas ou segmentos desconectados, e podem indicar falhas na lógica do fluxo ou na estrutura.
• Correção sugerida: reveja o fluxo para encontrar ações que não estão ligadas a um caminho de execução. Certifique-se de que cada ação está acessível através de um ciclo ou ramo de lógica válido. Remova ou mova ações inacessíveis para manter o fluxo limpo e eficiente.

Subfluxo não necessário

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: A regra detetou um subfluxo que ou não contém ações, apenas ações desativadas, ou inclui poucas ações para justificar a sua separação. Tais subfluxos podem não contribuir de forma significativa para a execução do fluxo e podem reduzir a clareza.
• Descrição: Esta regra verifica subfluxos que estejam vazios ou excessivamente mínimos – normalmente contendo menos de 5 ações. Embora os subfluxos sejam úteis para modularidade e reutilização, aqueles que carecem de conteúdo significativo ou abstração podem indicar desenvolvimento incompleto, fragmentação desnecessária ou má configuração. Estes padrões podem causar confusão e dificultar a manutenção.
• Solução sugerida: Rever o subfluxo identificado para determinar se serve um propósito claro e valioso. Se isso não acontecer, considere removê-lo ou integrá-lo num bloco lógico relacionado. Se o subfluxo for destinado a uso futuro, adicione uma ação provisória para clarificar o seu papel e evitar interpretações erradas.

Limitações conhecidas

• Disponível apenas em Ambientes Geridos.
• A personalização de regras limita-se a ativar ou a desativar regras e a configurar a gravidade.

Problemas conhecidos

• Apagar ações copiadas depois de visualizar os detalhes de uma violação de regra pode desencadear erros não tratados.
• Usar uma variável de palavra-passe não confidencial nas ações a seguir faz com que a análise estática falhe durante a avaliação de regras.
  • Apresentar diálogo de entrada
  • Apresentar diálogo de seleção de pasta
  • Apresentar formulário personalizado