Vérificateur de flux

Améliorez votre workflow de développement avec la fonctionnalité d’analyse statique dans Vérificateur de solution. Cet outil prend en charge les pratiques recommandées en matière d’automatisation robotisée des processus (RPA) et répond aux exigences de flux critiques en évaluant automatiquement vos flux pour garantir des performances optimales. L’analyse statique est disponible dans la section Vérificateur de flux du concepteur. Elle applique les directives clés et fournit des commentaires en temps réel et une inspection anticipée du code. Elle s’intègre directement à votre flux de travail, améliore la qualité du code et jette les bases d’une expérience de développement plus efficace et productive.

Gestion des règles

Définissez et gérez des règles via le vérificateur de solution dans le Centre d’administration Power Platform et la configuration du vérificateur de flux dans le portail Power Automate.

Les administrateurs et les utilisateurs disposant des autorisations appropriées peuvent :

• Activer ou désactiver les règles.
• Configurez les niveaux de gravité (erreur, avertissement, informations).
• Configurez des valeurs personnalisées pour les règles qui prennent en charge les paramètres, tels que les seuils et les limites (Power Automate portail uniquement).
• Appliquez des règles à des environnements ou groupes d’environnements spécifiques (environnements managés, Centre d’administration Power Platform uniquement).

La configuration du vérificateur de flux s’applique au niveau de l’environnement et affecte tous les flux de bureau dans l’environnement sélectionné.

Les paramètres d’application du vérificateur de solution que vous configurez dans le Centre d’administration Power Platform sont prioritaires sur les paramètres de configuration du vérificateur de flux dans le portail Power Automate. Vous ne pouvez pas modifier les règles soumises à des restrictions en raison de l’application du vérificateur de solution dans le portail Power Automate.

Configuration dans le centre d’administration

Pour configurer des règles d’analyse statique :

1. Accédez au Centre d’administration Power Platform.
2. Sélectionnez Gérer>Environnements pour continuer
3. Sélectionnez Modifier les environnements gérés.
4. Dans la section Vérificateur de solution, configurez les règles à exclure pour l’environnement sélectionné.

Configuration dans le portail Power Automate

Pour configurer des règles de vérificateur de flux pour un environnement :

1. Accédez à la page Flux de bureau dans le portail Power Automate.

2. Sélectionnez Vérificateur de flux.

3. Dans le volet de configuration du vérificateur de flux , configurez les règles souhaitées. Pour chaque règle, vous pouvez :

   • Activez ou désactivez la règle.
   • Sélectionnez un niveau de gravité.
   • Spécifiez une valeur personnalisée pour les règles qui prennent en charge les paramètres.

4. Cliquez sur Enregistrer.

Les modifications de configuration sont appliquées au niveau de l’environnement et affectent tous les flux de bureau dans l’environnement sélectionné. Pour les flux de bureau déjà ouverts dans le concepteur, rouvrez le flux pour que les modifications de configuration prennent effet.

Exécuter une analyse statique dans le portail

Pour déclencher manuellement une analyse statique :

1. Accédez à la page Solutions dans le portail Power Automate.

2. Ouvrez le menu contextuel (⋯) en regard d’une solution.

3. Placez le pointeur sur Solution checker.

4. Choisissez l’une des options suivantes :

   • Exécuter : lance l’analyse statique.
   • Afficher les résultats : ouvre le rapport d’analyse le plus récent.
   • Télécharger les résultats : exporte le rapport pour une révision hors ligne.

Analyse statique dans le concepteur

L’analyse statique s’exécute automatiquement, inspectant en permanence votre code sans nécessiter d’intervention manuelle. Lorsque vous ajoutez, supprimez ou modifiez des actions dans votre flux, cette fonctionnalité s’active pour évaluer les modifications et actualiser l’analyse. Ce processus rend le développement transparent et efficace. Sur la droite du concepteur, vous trouverez un bouton dédié au vérificateur de flux. Le nombre sur le bouton indique le nombre total de violations dans le flux de bureau. Sélectionnez le bouton pour ouvrir le volet Vérificateur de flux et afficher des informations détaillées sur les règles spécifiques qui ne sont pas respectées.

Chaque analyse génère un score en pourcentage qui indique la proportion de règles suivies avec succès. Un score plus élevé signifie moins de violations et une meilleure qualité de code.

Ce score est recalculé chaque fois qu’une modification est apportée au flux, ce qui permet de fournir des commentaires immédiats et de promouvoir de bonnes pratiques de développement.

Si les règles ne sont pas respectées, le rapport d’analyse statique affiche un résumé clair. Il répertorie les noms de règles et le nombre d’actions ou de variables dans votre flux qui enfreignent chaque règle. La sélection d’une règle met en surbrillance l’action correspondante et fournit une explication détaillée de l’erreur. Pour les violations liées aux variables, le système accède au volet des variables, ce qui facilite les corrections. Le volet Vérificateur de flux inclut une fonctionnalité de recherche et vous permet de filtrer par sous-flux, ce qui vous permet de trouver rapidement des problèmes spécifiques.

Chaque violation affiche une vignette avec des détails, notamment la nature de l’erreur, les correctifs recommandés et un lien vers la documentation. Utilisez le curseur dans l’en-tête de la règle pour naviguer entre les occurrences de la même violation. Ces conseils aident les développeurs à résoudre les problèmes rapidement et efficacement. Les erreurs détectées par le vérificateur de flux s’affichent avec un indicateur en ligne et une fenêtre contextuelle contenant plus de détails. Des avertissements apparaissent également en ligne dans l’espace de travail du concepteur, tels que des erreurs. Le concepteur affiche les statuts de diagnostic tels que les avertissements et les erreurs sur les onglets de sous-flux et inclut un bouton qui vous permet d’accéder au composant qui nécessite une attention particulière.

Légende

1. Occurrences de la violation de règle spécifique
2. Accédez à l’action qui enfreint la règle
3. Lien vers la documentation

Règles d’analyse statique

Les règles d’analyse statique sont des directives prédéfinies qui permettent de garantir la sécurité, la gestion et les performances de vos flux. Chaque règle cible des aspects spécifiques de la conception du flux, tels que la sécurité, les performances et la maintenabilité, et fournit des commentaires exploitables pour améliorer la qualité de votre flux. Vous trouverez ci-dessous une liste des règles, leurs descriptions et les correctifs suggérés.

Sécurité des mots de passe non sécurisés

• Gravité : Avertissement
• Type : sécurité
• Détails de l’erreur : les mots de passe ne sont pas gérés de manière sécurisée dans le flux.
• Description : cette règle vérifie si les mots de passe sont gérés de manière non sécurisée dans un flux de bureau pour garantir qu’ils ne sont pas exposés ou mal gérés pendant l’exécution.
• Solution suggérée : assurez-vous que toutes les entrées liées au mot de passe sont gérées de manière appropriée à l’aide des fonctionnalités de mot de passe de Power Automate pour le bureau. Utilisez la « saisie directe de texte chiffré » pour une sécurité maximale grâce au chiffrement basé sur la machine. Pour les flux utilisés sur différentes machines, choisissez « Saisie du mot de passe en tant que variable » et marquez la variable correspondante comme sensible pour renforcer la sécurité. Utilisez également des fonctionnalités de gestion sécurisée des informations d’identification, telles que l’action « Obtenir des informations d’identification », qui s’intègre aux informations d’identification CyberArk.

Récursion entre deux sous-flux

• Gravité : Avertissement
• Type : conception
• Détails de l’erreur : appels récursifs détectés entre les sous-flux, provoquant potentiellement une boucle infinie.
• Description : cette règle recherche des appels récursifs entre au moins deux sous-flux, en veillant à ce que le flux n’entre pas dans une boucle infinie.
• Correction suggérée : supprimez tous les appels récursifs entre les sous-flux.

Longueur de la variable dépassée

• Gravité : avertissement
• Type : maintenabilité
• Détails de l’erreur : le nom de la variable dépasse la limite de 40 caractères.
• Description : cette règle vérifie si le nom de chaque variable défini dans le flux dépasse un nombre de caractères spécifié. La limite par défaut est fixée à 40 caractères.
• Correction suggérée : renommez les variables qui dépassent la limite de caractères spécifiée pour vous assurer que leur nom est inférieur à 40 caractères.

Valeurs par défaut de la variable d’entrée

• Gravité : avertissement
• Type : maintenabilité
• Détails de l’erreur : les variables d’entrée/sortie n’utilisent pas de valeurs par défaut.
• Description : cette règle vérifie si les variables d’entrée/sortie utilisent des valeurs par défaut, en s’assurant qu’elles sont correctement configurées pour le flux.
• Correction suggérée : attribuez des valeurs par défaut à toutes les variables d’entrée et de sortie du flux.

Seuil du nombre de variables d’entrée et de sortie

• Gravité : avertissement
• Type : maintenabilité
• Détails de l’erreur : le total des variables d’entrée/sortie dépasse la limite de 25 variables.
• Description : cette règle vérifie si le nombre total de variables d’entrée/sortie dans le flux dépasse un seuil spécifié. La limite est fixée à 25 variables.
• Correction suggérée : assurez-vous que le nombre de variables d’entrée et de sortie dans le flux ne dépasse pas 25.

Action Erreur sur bloc vide

• Gravité par défaut : avertissement
• Type : conception
• Détails de l’erreur : l’action « Erreur sur bloc » est vide et ne gère pas les erreurs.
• Description : cette règle vérifie si les actions « Erreur sur bloc » de votre flux sont correctement configurées pour gérer les erreurs, en veillant à ce que les erreurs soient générées et gérées comme prévu.
• Correction suggérée : pour gérer les erreurs potentielles, configurez les actions Erreur sur bloc dans le flux.

Clauses If imbriquées

• Gravité : avertissement
• Type : maintenabilité
• Détails de l’erreur : les clauses If imbriquées dépassent cinq niveaux.
• Description : cette règle vérifie s’il existe des instructions if imbriquées avec plus de cinq niveaux, en s’assurant que le flux reste gérable et lisible.
• Correction suggérée : refactorisez le flux pour réduire les instructions if imbriquées à cinq niveaux au plus.

Incomplète si

• Gravité : avertissement
• Type : conception
• Détails de l’erreur : action If incomplète détectée, sans contenu ou ne contenant que des actions dans la branche Else.
• Description : cette règle détecte les actions If qui manquent de contenu ou contiennent uniquement des actions dans la branche Else, en s’assurant que les instructions conditionnelles sont effectivement implémentées.
• Correction suggérée : parcourez le flux et vérifiez chaque condition « If » pour vous assurer qu’elle inclut des actions significatives dans les branches « If », « Else if » et « Else ».

Boucle infinie

• Gravité : Avertissement
• Type : conception
• Détails de l’erreur : boucle infinie détectée dans le flux, ce qui risque de l’entraîner à s’exécuter indéfiniment.
• Description : cette règle vérifie s’il existe des boucles infinies dans le flux, ce qui permet d’identifier et d’empêcher les scénarios dans lesquels le flux peut s’exécuter indéfiniment.
• Correction suggérée : assurez-vous que chaque boucle a une condition de terminaison clairement définie et réalisable. La condition peut être basée sur un compteur, une valeur spécifique ou l’achèvement d’une tâche. Ajoutez des vérifications ou des conditions de sécurité intégrée pour interrompre la boucle si elle s’exécute plus longtemps que prévu. Par exemple, définissez un nombre maximal d’itérations ou incluez un délai d’expiration.

Utilisation abusive des actions d’attente

• Gravité : avertissement
• Type : performances
• Détails de l’erreur : une utilisation abusive des actions d’attente a été détectée, avec plus de 10 actions d’attente provoquant des goulots d’étranglement potentiels.
• Description : cette règle vérifie si le flux contient un nombre excessif d’actions d’attente (plus de 10) afin d’identifier et de minimiser les goulots d’étranglement potentiels causés par des retards prolongés.
• Correction suggérée : vérifiez le flux pour identifier toutes les actions d’attente et vérifier si elles sont essentielles à la logique du flux. Supprimez les attentes inutiles ou combinez-les dans la mesure du possible.

Temps d’attente immense

• Gravité : Avertissement
• Type : Performance
• Détails de l’erreur : un temps d’attente immense a été détecté, dépassant la limite de 600 secondes pour les actions d’attente codées en dur.
• Description : cette règle vérifie si les actions d’attente codées en dur dans le flux dépassent une durée spécifiée, avec la limite définie sur 600 secondes.
• Correction suggérée : vérifiez le flux pour rechercher les actions d’attente qui dépassent la limite de 600 secondes. Vérifiez si ces longs temps d’attente sont nécessaires et ajustez leur durée au minimum requis pour que le flux fonctionne correctement. Si une longue attente est nécessaire, divisez-la en intervalles plus courts et ajoutez des vérifications ou des conditions entre eux. Dans la mesure du possible, remplacez les actions d’attente longue par des déclencheurs basés sur les événements.

Actions non atteintes

• Gravité : avertissement
• Type : maintenabilité
• Détails de l’erreur : une ou plusieurs actions dans le flux sont inaccessibles et ne seront pas exécutées dans aucune circonstance.
• Description : cette règle recherche les actions du flux qui sont logiquement inaccessibles. Des actions inaccessibles peuvent résulter d’un branchement incorrect, de conditions mal placées ou de segments déconnectés, et peuvent indiquer des défauts dans la logique ou la structure du flux.
• Correctif suggéré : vérifiez le flux pour rechercher les actions qui ne sont pas connectées à un chemin d’exécution. Assurez-vous que chaque action est accessible via une branche ou une boucle logique valide. Supprimez ou déplacez les actions inaccessibles afin de maintenir un flux clair et efficace.

Flux secondaire inutile

• Gravité : Avertissement
• Type : maintenabilité
• Détails de l’erreur : la règle a détecté un sous-flux qui ne contient aucune action, uniquement les actions désactivées ou inclut trop peu d’actions pour justifier sa séparation. Ces sous-flux peuvent ne pas contribuer significativement à l’exécution du flux et peuvent réduire la clarté.
• Description : cette règle recherche les sous-flux vides ou trop minimaux, contenant généralement moins de 5 actions. Alors que les sous-flux sont utiles pour la modularité et la réutilisation, ceux qui manquent de contenu significatif ou d’abstraction peuvent indiquer un développement incomplet, une fragmentation inutile ou une mauvaise configuration. Ces modèles peuvent prêter à confusion et entraver la maintenabilité.
• Solution suggérée : vérifiez le sous-flux identifié pour déterminer s’il sert un objectif clair et utile. Si ce n’est pas le cas, envisagez de le supprimer ou de le fusionner dans un bloc logique associé. Si le sous-flux est destiné à une utilisation ultérieure, ajoutez une action fictive pour clarifier son rôle et éviter toute interprétation erronée.

Limitations connues

• Disponible uniquement dans les Environnements gérés.
• La personnalisation des règles se limite à l’activation ou à la désactivation des règles et à la configuration de la gravité.

Problèmes connus

• La suppression d’actions copiées après avoir affiché le détail d’une violation de règle peut déclencher des erreurs non gérées.
• L’utilisation d’une variable de mot de passe non sensible dans les actions suivantes entraîne l’échec de l’analyse statique lors de l’évaluation de la règle.
  • Afficher la boîte de dialogue de saisie
  • Afficher la boîte de dialogue de sélection de dossier
  • Afficher un formulaire personnalisé