Vérificateur de flux (version préliminaire)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

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. Il 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

Les règles sont définies et gérées via le vérificateur de solution dans le centre d’administration Power Platform. Les administrateurs peuvent :

• Activer ou désactiver les règles.
• Configurez les niveaux de gravité (erreur, avertissement, informations).
• Appliquer des règles à des environnements ou groupes d’environnements spécifiques (Environnements gérés uniquement).

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é.

Exécuter une analyse statique dans le portail

Pour déclencher manuellement une analyse statique :

1. Accédez à la page Solutions du Portail Power Automate.

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

3. Pointez sur Vérificateur de solution.

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 le côté droit du concepteur, vous voyez un bouton Vérificateur de flux dédié. 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 violations d’erreur du vérificateur de flux affichent un indicateur en ligne et une fenêtre contextuelle avec 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 états 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.
• Correction 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ées des informations d’identification, comme l’action « Obtenir les informations d’identification », qui s’intègre aux informations d’identification CyberArk.

Récursivité 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.

If non terminée

• Gravité : avertissement
• Type : conception
• Détails de l’erreur : action If non terminée détectée, manque de contenu ou contient uniquement 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 examinez 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 : examinez 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 : performances
• 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 : examinez 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 temps le plus court nécessaire au bon fonctionnement du flux. 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. Les actions inaccessibles peuvent résulter d’un branchement incorrect, de conditions mal placées ou de segments déconnectés, et peuvent indiquer des failles dans la logique ou la structure du flux.
• Correctif suggéré : examinez 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 pour garder le flux propre et efficace.

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é