À propos de l'analyseur de workflow

L'Analyseur de flux de travail (Workflow Analyzer) est un analyseur de code statique qui garantit que votre projet répond à des normes de qualité et de fiabilité élevées. Un analyseur de code statique vérifie les incohérences sans exécuter réellement le projet, par opposition aux analyseurs dynamiques qui interviennent au cours de l’exécution.

L'analyseur de workflow utilise un ensemble de règles pour vérifier diverses incohérences sans rapport avec l'exécution du projet. Les règles sont basées sur les Bonnes pratiques d'automatisation et tiennent compte du nommage des variables et des arguments, des séquences ou flux de travail vides, des restrictions sur les paquets, etc. L'analyseur n'identifie pas les erreurs d'exécution ou de compilation.

Il est disponible dans l'onglet Conception (Design) du ruban, les boutons Analyser le fichier (Analyze File) et Analyser le projet (Analyze Project). Le premier effectue une analyse dans le fichier actuellement activé dans le panneau Concepteur (Designer), tandis que le second analyse tous les fichiers dans le projet d'automatisation.

Studio est livré avec un ensemble de règles intégrées, identifiables par le préfixe ST- . UIAutomation.Activities, Excel.Activities, Testing Activitieset Mail.Activities ont également leurs propres règles, identifiables par le préfixe.

Vous pouvez également créer des règles personnalisées. Pour plus d'informations, consultez la section Création de règles de l'analyseur de workflow (Build Workflow Analyzer Rules) dans le guide du développeur.

Les règles peuvent également être configurées lors de la création d'une politique Studio dans Automation Ops. Pour plus d'informations, consultez le guide Automation Ops.

Remarque : les règles intégrées de Studio ne peuvent pas être portées vers les anciennes versions de Studio. Cependant, les règles des packages d'activités compatibles peuvent être utilisées dans les anciennes versions de Studio fournies avec l'analyseur de workflow.

Conventions d'affectation de noms des règles

Chaque règle a un ID, un nom, une description et une recommandation. L'ID contient l'origine, la catégorie et le numéro. Par exemple, Variables Naming Convention a l'ID ST-NMG-001 :

• ST : révèle que la règle est intégrée à Studio.
• NMG - montre que la règle fait partie de la catégorie Naming Rules . Les règles faisant partie de la catégorie Project Anatomy Rules ont l'abréviation ANA , celles faisant partie de Design Best Practices la DBP, etc.
• 001 : est le numéro de la règle.
  
  

  

  
  

Portée

Chaque règle comporte une étendue à laquelle elle s'applique :

• Activité (Activity) : les règles sont appliquées au niveau de l'activité, tout en vérifiant les variables, les arguments et les propriétés. La Conventions d'affectation de noms des variables (Variables Naming Convention) est l'une de ces règles.
• Workflow (Workflow) : les règles effectuent des vérifications dans un fichier projet unique, par exemple Variables inutilisées (Unused Variables).
• Projet (Project) : les vérifications sont effectuées au niveau du projet.

Action

Les règles comportent un certain nombre d'actions pouvant être définies :

• Erreur (Error) : génère une erreur dans le panneau Liste d'erreurs (Error List).
• Avertissement (Warning) : génère un avertissement dans le panneau Liste d'erreurs (Error List).
• Information (Info) : génère un message dans le panneau Liste d'erreurs (Error List).
• Logs détaillés (Verbose) : crée des fichiers journaux volumineux.

Consultez la page Niveaux de journalisation (Logging Levels) pour en savoir plus sur la journalisation à l'aide de Studio.

Gestion des règles

Le projet ou le fichier est analysé selon un ensemble de règles disponibles dans la fenêtre Paramètres du projet (Project Settings) :

• Dans le panneau Projet (Project), cliquez sur l'icone , puis sélectionnez Analyseur de workflow (Workflow Analyzer).
• Dans le ruban, cliquez sur le bouton Analyser le fichier (Analyze File), puis sélectionnez Paramètres d'analyseur de workflow (Workflow Analyzer Settings) depuis la liste déroulante.

Par défaut, les règles de l’analyseur de workflow sont organisées par code dans la fenêtre, et les règles activées sont affichées en premier.

Utilisez la zone de recherche en haut de la fenêtre pour rechercher des règles par nom ou par code. Pour filtrer les règles par étendue et par action par défaut, cliquez sur le bouton à droite du champ de recherche.

Configurer les règles

Vous pouvez activer/désactiver une règle en cochant/décochant la case à sa gauche, ou modifier l'action par défaut à l'aide de la liste déroulante à sa droite.

Certaines règles ne nécessitent aucune configuration supplémentaire, tandis que d'autres contiennent des paramètres que vous pouvez configurer, tels que des seuils à ne pas dépasser ou des listes d'éléments spécifiques autorisés ou interdits. Notez que lorsque vous configurez des règles qui contiennent des champs de texte (par exemple, Utilisation inappropriée de SecureString (SecureString Misusage) ou Restrictions de package (Package Restrictions), le texte ne doit pas être saisi entre guillemets.

Rétablir les paramètres par défaut

Une fois que des modifications ont été apportées aux valeurs par défaut des règles, qu'il s'agisse de Regex ou de seuils, les valeurs par défaut peuvent être rétablies . Il suffit pour cela de faire un clic droit sur la règle, puis de sélectionner Rétablir les paramètres par défaut (Reset to Default).

Validation

La validation du fichier ou du projet est effectuée à chaque déclenchement de l'Analyseur de workflow (Workflow Analyzer). Les options de validation sont disponibles dans le bouton Analyser le fichier (Analyze File) du ruban, Valider le fichier (Validate File) et Valider le projet (Validate Project).

Cette action vérifie si les variables, les arguments, les expressions et les importations sont correctement configurés. L'action Valider le fichier (Validate File) peut être déclenchée à l'aide du raccourci F8, tandis Valider le projet (Validate Project) peut l'être à l'aide de Maj + F8. Vous pouvez annuler la validation à tout moment.

Le ou les fichiers qui contiennent des erreurs sont marqués dans le panneau Projet (Project) avec un point rouge, et les erreurs sont affichées dans les panneaux Liste d'erreurs (Error List) et Sortie (Output).

Un double-clic sur un élément dans le panneau Liste d'erreurs ouvre le .xaml et met en évidence l'élément qui a provoqué l'erreur, qu'il s'agisse d'une activité, d'un argument ou d'une variable.

Sauf si tous les fichiers .xaml sont validés, vous ne pouvez pas déboguer, exécuter ou publier le projet. Les conditions de point d'arrêt ne sont pas évaluées.

Gestion des erreurs

Une fois déclenché, l'Analyseur de workflow (Workflow Analyzer) utilise l'ensemble de règles configuré pour vérifier le projet ou le fichier, puis consigne les erreurs trouvées dans la Liste d'erreurs (Error List), conformément à l'action de la règle.

Le panneau Liste d'erreurs (Error List) filtre les éléments par Erreurs (Errors), Avertissements (Warnings) et Messages (Messages). Le menu déroulant de l'étendue est utile pour le filtrage des erreurs par projet, fichier actuel ou un fichier spécifique de l'automatisation. En outre, les éléments peuvent être filtrés par ID de règle.

Cliquez sur un avertissement ou une erreur trouvé pour afficher la recommandation de la règle et un lien vers la page de documentation de chaque règle.

En plus des violations de règles, le panneau Liste d'erreurs affiche également les erreurs qui peuvent se produire lors de l'exécution de l'analyse du flux de travail. Lorsque l'analyseur de flux de travail ou l'une des règles configurées ne fonctionne pas, l'erreur, ainsi que des détails sur sa cause, est enregistrée dans la description.

Prise en charge des lignes de commande

L'interface utilisateur de ligne de commande UiPath.Studio.CommandLine.exe contient un ensemble de paramètres permettant de vérifier des fichiers ou des projets par rapport à certaines règles, même dans les configurations du pipeline CI/CD.

UiPath.Studio.CommandLine.exe est disponible dans le dossier d'installation :

• Pour les installations par machine, le chemin par défaut est %ProgramFiles%\UiPath\Studio\
• Pour les installations par utilisateur, le chemin par défaut est %LocalAppData%\Programs\UiPath\Studio

Remarque : UiPath.Studio.CommandLine.exe ne nécessite pas de licence Studio.

Configurer les règles

Par défaut, toutes les règles de l'Analyseur de workflow sont activées lors de l’installation de Studio, à l’exception des règles suivantes :

• Valeurs par défaut des arguments
• Propriétés de sortie non définies

Vous pouvez configurer des règles :

• Dans la fenêtre Paramètres d'analyseur de workflow (Workflow Analyzer Settings), activez ou désactivez les règles en cochant la case en regard de chacune d’elles,
• À partir du fichier RuleConfig.json, chemin d’accès %LocalAppData%\UiPath\Rules. Trouvez une règle spécifique, modifiez son paramètre, et modifiez le paramètre IsEnabled en le faisant basculer sur false pour désactiver la règle. Si le chemin n’est pas accessible, vous pouvez également placer le fichier RuleConfig.json dans un emplacement personnalisé et inclure le chemin vers le fichier dans la commande. Pour plus d'informations, consultez Analyser les fichiers et les projets (Analyze Files and Projects).

Les règles sont organisées en fonction de leur ID unique, visibles également dans Paramètres d'analyseur de workflow (Workflow Analyzer Settings).

Par exemple, dans l'image ci-dessous, seule la règle Variables Naming Convention a été activée et a reçu l'expression ([A-Z]) Regex. Cela signifie que les noms de variables doivent être en majuscules. Toutes les autres règles ont été désactivées dans cet exemple.

Les paramètres suivants sont disponibles pour chaque règle :

Paramètre	Description
RuleId	ID de la règle.
IsEnabled	Indique si la règle est activée ou désactivée. Si définie sur « null », la valeur du paramètre ParDéfautActivée (DefaultIsEnabled) est appliquée.
DefaultIsEnabled	Indique si la règle est activée ou désactivée par défaut.
DefaultErrorLevel	Le niveau par défaut du message de journal (Erreur (Error), Avertissement (Warning), Info, Détaillé (Verbose)).
Paramètres	Paramètres supplémentaires que la règle peut contenir (par exemple, Nom ou Valeur).
ErrorLevel	Le niveau du message de journal. Si définie sur « null », la valeur du paramètre NiveauErreurDéfaut (DefaultErrorLevel) est appliquée.

Analyser des fichiers et des projets

Après avoir configuré les règles, accédez à l'interface utilisateur de ligne de commande UiPath.Studio.CommandLine.exe.

Les commandes d'analyseur de workflow suivantes sont disponibles :

• analyze : Analyse l'ensemble du projet. Requiert le chemin d'accès au fichier project.json.
• analyze-file : Analyse un fichier unique. Requiert le chemin d'accès au fichier .xaml.

Les arguments suivants sont disponibles pour les commandes d'analyseur de workflow :

Argument	Description
-p, --project-path	Pour analyser un fichier, indiquez le chemin d'accès à .xaml. Pour analyser l'ensemble du projet, indiquez le chemin d'accès au fichier project.json.
-c, --config-path	Chemin d'accès au fichier RuleConfig.json. Spécifiez ce chemin uniquement si le fichier de configuration de règle ne se situe pas dans l'emplacement par défaut (%LocalAppData%\UiPath\Rules).
--help	Affiche les arguments disponibles pour chaque commande.
--version	Vérifiez la version de UiPath.Studio.CommandLine.exe.

Par exemple, la commande UiPath.Studio.CommandLine.exe analyze-file -p "C:\BlankProcess\Main.xaml" analyse un seul fichier dans un projet, Main.xaml. La sortie de la commande renvoie un dictionnaire codé json avec les informations suivantes pour chaque violation de règle :

• FilePath : chemin d'accès au fichier analysé.
• ErrorCode : ID de règle.
• ActivityDisplayName : le nom d'affichage de l'activité (null si non applicable).
• Item - Nom et type de l’élément (par exemple, une activité ou une variable) où le message d’erreur a été généré.
• ErrorSeverity : valeur du paramètre DefaultAction, qui est le message de journal configuré pour chaque règle, soit Avertissement (Warning), Erreur (Error), Information (Info) ou Logs détaillés (Verbose).
• Description : Description de la règle.
• Recommendation et URL : modifications recommandées pour résoudre le problème, ainsi que le lien de documentation contenant plus d'informations.
  
  

  

  
  

Pour utiliser un fichier RuleConfig.json placé dans un emplacement personnalisé, ajoutez l’emplacement à la commande. En reprenant la commande précédente à titre d’exemple, pour configurer des règles avec le fichier situé dans C:\CustomFolder\RuleConfig.json, exécutez la commande comme suit : UiPath.Studio.CommandLine.exe analyze-file -c "C:\CustomFolder\RuleConfig.json" -p "C:\BlankProcess\Main.xaml".

Pour renvoyer le code de sortie de la commande, entrez echo %errorlevel% après l’exécution. Si aucun message n'affiche l’Erreur ErrorSeverity, le code 0 est retourné. Sinon, le code 1 est retourné.

Notez que certaines entrées peuvent ne pas être associées à une règle, mais peuvent être des erreurs générées par l'analyseur de workflow. Par exemple, dans le cas d'un fichier .xaml vide, une erreur est affichée.

Les identificateurs uniques universels (GUID) utilisés comme préfixes pour une entrée sont générés à chaque exécution et s'appliquent uniquement au résultat actuel.

Exporter les résultats de l'analyseur de workflow

Pour configurer Studio afin d'exporter les résultats de chaque analyse de workflow vers le dossier du projet, accédez au mode Backstage de Studio (Studio Backstage View) > Paramètres (Settings) > Conception (Design) et activez l'option Exporter les résultats de l'analyseur (Export Analyzer results).

Lorsque cette option est activée, les résultats de chaque analyse de workflow sont enregistrés dans le sous-dossier \.local\.analysis\ du dossier du projet, dans un fichier dont le nom est constitué de l'horodatage de l'analyse suivi soit de project_analysis_results.json (lorsque l'option Analyser le projet est utilisée) ou file_analysis_results.json (lorsque l'option Analyser le fichier est utilisée).

Remarque : le dossier .local est masqué. Vous pouvez activer l'affichage des éléments masqués à partir des paramètres de l'explorateur de fichiers Windows.

Les fichiers contiennent les informations suivantes sur chaque règle activée :

• RuleId – l'identifiant de règle.
• RuleName - Le nom de la règle.
• Parameters - Les paramètres dans la règle pouvant être personnalisés, le cas échéant.
• Severity - L'action de la règle, si la règle est violée.
• ErrorsDescription - Liste des messages d’erreur générés par la règle, le cas échéant.

Application de l'analyseur de workflow avant l'exécution, la publication ou la transmission/l'enregistrement

Vous pouvez empêcher l’exécution, la publication, la transmission/l'enregistrement dans des projets de référentiels distants qui contiennent l'analyseur de workflow en activant les options suivantes depuis le mode Backstage de Studio > Paramètres (Settings) > Conception (Design) :

• Appliquer l’Analyseur avant la publication : chaque fois que l’exécution ou le débogage d’un fichier ou d’un projet est lancé, l’Analyseur de workflow vérifie toutes les règles avec l’action Error, et l’exécution n’est autorisée que si aucune erreur n’est trouvée.
• Appliquer l'Analyseur avant la publication : chaque fois que la publication est lancée, l’Analyseur de workflow vérifie toutes les règles activées indépendamment de leur action et la publication n’est autorisée que si l’action Error ne trouve aucune violation de règles.
• Appliquer l'analyseur avant la transmission/l'enregistrement (Enforce Analyzer before Push/Check-in) : chaque fois que l'envoi d'un projet vers un référentiel distant est initié (Commit et Push pour GIT, Check in pour SVN et TFS), l'analyseur de workflow vérifie toutes les règles activées quelle que soit leur action, et l'opération est autorisée uniquement s'il n'y a pas de violation de règle avec l'action Error.

Quand Appliquer l’analyseur avant la publication est activé et si la publication est réussie ( l’action Error ne constate pas de violation des règles), les résultats de l’analyse du workflow sont inclus dans le package publié .nupkg dans le fichier project_analysis_results.json situé dans \lib\net45\.analysis\. Le fichier contient les informations suivantes sur chaque règle activée :

• RuleId – l'identifiant de règle.
• RuleName - Le nom de la règle.
• Parameters - Les paramètres dans la règle pouvant être personnalisés, le cas échéant.
• Severity - L'action de la règle (si la règle est violée).
• ErrorsDescription - Liste des messages d’erreur générés par la règle, le cas échéant.