Verificador de fluxos (pré-visualização)

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

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

As regras são definidas e geridas através do verificador de solução no centro de administração do Power Platform. Os admins podem:

• Ative ou desative regras.
• Configure níveis de gravidade (erro, aviso, informações).
• Apliqu regras para ambientes específicos ou grupos de ambientes (apenas em Ambientes Geridos).

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.

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. Paire o cursor sobe o Verificador de solução.

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 estruturador

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 estruturador, vê um botão Verificador de Fluxos dedicado. O número no botão mostra o total de violações no fluxo de ambiente de trabalho. 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 controlo de deslize no cabeçalho da regra para navegar entre ocorrências da mesma violação. Esta orientação ajuda os programadores a abordar problemas de forma rápida e eficaz. Violações de erro do Verificador de fluxos mostram um indicador inline e um pop-up com mais detalhes. Também aparecem avisos inline na área de trabalho do estruturador, tal como os erros. O estruturador mostra os estados de diagnóstico, como avisos e erros, em separadores de subfluxo e inclui um botão que lhe permite aceder ao componente que precisa de atenção.

Legenda

1. Ocorrências da violação da regra específica
2. Navegar 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: Design
• 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.

Comprimento da variável excedido

• 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 on block error 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 if aninhadas

• Gravidade: Aviso
• Tipo: Capacidade de Manutenção
• Detalhes do erro: 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 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.

If incompleto

• Gravidade: Aviso
• Tipo: Design
• 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 inacessíveis

• 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 da subdivisão incorreta, condições mal colocadas ou segmentos desligados, e podem indicar falhas na lógica do fluxo ou 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.

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

• Eliminar ações copiadas depois de ver um detalhe de violação de regra pode acionar erros não processados.
• 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