Gouvernance

Remarque : cette page documente le modèle de gouvernance basé sur des fichiers disponible pour Studio. Pour plus d'informations sur la façon de déployer les stratégies depuis Automation Ops, consultez le Guide Automation Ops.

Pour s’assurer que les utilisateurs de Studio respectent les normes de développement et se conforment à certaines règles, les organisations peuvent appliquer des politiques de gouvernance qui contrôlent les fonctionnalités de Studio.

Vous pouvez appliquer les politiques de gouvernance de l’une des façons suivantes :

• Créez et déployez des stratégies à partir d’Automation Ops, une application Web facile à utiliser.
• Utilisez un modèle de gouvernance basé sur les fichiers qui consiste à créer un fichier de stratégie JSON et à déployer le fichier de façon locale, externe ou via Orchestrator.

Les capacités actuelles sont les suivantes :

• appliquer différentes politiques par profil Studio.
• restreindre l’utilisation des flux de packages à partir de la fenêtre Gérer les packages et du Mode Backstage>Paramètres > Gérer les sources.
• appliquer les normes de développement organisationnel à l’aide des règles de l'analyseur de workflow.
• appliquer les paramètres de conception et d'emplacement, et configurer plusieurs paramètres qui ne sont pas disponibles dans Studio.
• activer l'envoi des données d'utilisation de Studio à votre organisation.
• imposer l'utilisation de référentiels spécifiques pour le contrôle de code source GIT.

Regardez la vidéo suivante pour avoir un aperçu des capacités de gouvernance de Studio et obtenir une démo de la manière de les utiliser dans StudioX.

Pour appliquer une stratégie de gouvernance, commencez par générer un fichier de gouvernance à partir de Studio, puis configurez le fichier en utilisant les paramètres qu’il contient, et appliquez la stratégie de l’une des façons suivantes :

• Utilisation d’un fichier local (à des fins de test) - Placez le fichier de gouvernance dans le dossier Roaming sur la machine où Studio est installé.
• Utilisation d’un fichier externe (pour les déploiements importants) - Placez le fichier de gouvernance sur un chemin d'accès (par exemple, un serveur HTTP/HTTPS) référencé soit par une clé de registre, soit par une ressource dans Orchestrator.
• Utilisation d’une ressource dans Orchestrator - Copiez le contenu du fichier de gouvernance dans une ressource d’Orchestrator.

Générer le fichier de gouvernance

La première étape dans l’application des normes de développement dans votre organisation est de générer un fichier de gouvernance à partir de Studio ou de créer manuellement un fichier similaire qui intégrerait tout ou une partie des capacités que nous avons énumérées ci-dessus.

Important : Le fichier de gouvernance doit être de type .config avec le nom suivant uipath.policies.config.

Pour générer un fichier de gouvernance avec votre configuration actuelle à partir de Studio, rendez-vous dans le mode Backstage > onglet Aide et sélectionnez Générer un fichier de gouvernance. Le fichier exporté peut être partagé au sein de votre équipe.

Remarque : si Automation Ops est activé pour votre organisation, vous êtes invité à choisir de générer une stratégie Classique ou Moderne. Sélectionnez l'option classique pour le modèle de gouvernance basé sur des fichiers. L'option moderne génère des stratégies que vous pouvez ensuite importer dans Automation Ops pour une migration facile vers ce modèle.

Utilisez le bouton ci-dessous pour télécharger l'exemple qui inclut toutes les règles de l'analyseur de workflow. Modifiez l’exemple pour l'adapter aux besoins de votre organisation.

Télécharger l’exemple

Configurer le fichier de gouvernance

Version du fichier et étiquette du fichier

Les fichiers de gouvernance peuvent avoir différentes versions et un nom personnalisé.

{
    "Metadata": {
        "Version": "1.0"
                "LastUpdatedUtc": "2021-08-25T07:49:26.3089368Z",
                "Availability": null
    },
    "Info": {
        "Name": "Sample Policy Registry Key"
    }
}

Paramètres	Values
"Metadata" > "Version"	major.minor entre guillemets «  » ("")
"Info" > "Name"	Libellé écrit entre guillemets de type "", visible dans Accueil (Home) > Aide (Help), dans la rubrique Politique de la société (Company policy).

Profils Studio

Si le fichier de gouvernance peut contenir des politiques pour les utilisateurs de Studio et de StudioX, celles-ci doivent être structurées par profil. Les politiques pour Studio doivent être séparées de celles pour StudioX comme dans l'exemple ci-dessous :

{
    "Profiles": {
        "Development": {
            "Shell": {
                "IsFeedbackEnabled": true,
                "HideGettingStartedScreen": false
            },
            "PackageManager": {},
            "Analyzer": {}
        },
        "Business": {
            "Shell": {
                "IsFeedbackEnabled": true,
                "HideGettingStartedScreen": false
            },
            "PackageManager": {},
            "Analyzer": {}
        }
    }
}

Paramètres	Values
"Profiles"	Pour Studio : Development Pour StudioX : Business N'est plus utilisé pour Studio Pro : StudioPro Vous pouvez ajouter les deux profils dans le même fichier.

Paramètres que les utilisateurs ne peuvent pas configurer à partir de Studio

Les paramètres de "Shell" vous permettent d'empêcher les exécutions de production de StudioX en définissant la limite du nombre d'exécutions qu'un utilisateur peut effectuer pour un projet qui n'a pas été modifié.

De plus, vous pouvez définir si les utilisateurs peuvent avoir accès au formulaire de commentaires et à l'écran d'accueil.

{
      "Shell": {
        "IsFeedbackEnabled": true,
        "HideGettingStartedScreen": false,
        "RequireUserPublish": {
          "PermittedConsecutiveRuns": 3,
          "DialogMessage": null,
          "LogToQueue": {
            "QueueName": "NameOfQueue",
            "QueueFolder": "NameOfQueueFolder"
          }
        }
      }
}

Paramètre de Studio	Paramètres	Values
Active ou désactive le formulaire Envoyer des commentaires (Send feedback) accessible depuis la barre de titre de Studio.	"IsFeedbackEnabled"	Que ce soit true ou false.
Active ou désactive l'écran d'accueil avec des liens vers UiPath Academy, une vidéo d'introduction et des didacticiels qui s'affichent lorsque les utilisateurs ouvrent Studio.	"Masquer l'écran de démarrage"	Que ce soit true ou false.
Les paramètres de "RequireUserPublish" vous permettent de limiter le nombre d'exécutions consécutives pouvant être déclenchées à partir de Studio pour un projet qui n'a pas été modifié et de configurer les paramètres de journalisation pour les événements dont la limite est dépassée. Cette option peut être utilisée afin d'empêcher les utilisateurs de déclencher des exécutions de production à partir de Studio. En règle générale, les projets prêts pour la production doivent être publiés dans Orchestrator et exécutés à partir de l'Assistant.	"RequireUserPublish" 1	S/O
Nombre maximal de fois consécutives qu'un projet n'ayant pas été modifié peut être exécuté.	"PermittedConsecutiveRuns" 1	Entrez le nombre d'exécutions autorisé. Si la valeur est null ou négative, aucune limite ne sera définie.
Message qui s'affichera dans une boîte de dialogue pour l'utilisateur lorsque le nombre maximal d'exécutions consécutives autorisé a été dépassé. La boîte de dialogue invite l'utilisateur à publier le projet ou à annuler l'exécution.	"DialogMessage"	Saisissez un message personnalisé à afficher entre guillemets de type "". Si la valeur est null, le message suivant sera utilisé : Il semble que vous réalisez des exécutions de production directement depuis votre projet. Votre organisation exige que vous publiiez votre projet sur Orchestrator et que vous l’exécutiez depuis votre Assistant.
Les paramètres de "LogToQueue" vous permettent de configurer une file d'attente Orchestrator où consigner les événements. Les informations suivantes sont enregistrées pour chaque événement : nom d'utilisateur, nom du projet, hachage du fichier XAML principal et horodatage par la machine locale.	"LogToQueue"	S/O
File d'attente Orchestrator dans laquelle consigner les enregistrements.	"QueueName"	Entrez le nom de la file d'attente entre guillemets de type "". Si la valeur est null, aucun enregistrement ne sera consigné.
Dossier Orchestrator contenant la file d'attente dans laquelle consigner les enregistrements.	"QueueFolder"	Entrez le nom du dossier Orchestrator entre guillemets de type "". Si la valeur est null, aucun enregistrement ne sera consigné.

1 - Les modifications ne sont prises en compte que dans le profil StudioX.

Emplacements des modèles disponibles

Vous pouvez empêcher les flux Démarrer (Getting Started), Officiel (Official) et Place de marché (Marketplace) d'apparaître dans Accueil (Home) (mode Backstage de Studio) > Modèles (Templates) dans la liste des emplacements à partir desquels des modèles peuvent être ajoutés. Les flux sont activés par défaut.

{
      "TemplatesManager": {
        "Feeds": [
          {
            "Name": "GettingStarted",
            "IsEnabled": true
          },
          {
            "Name": "Official",
            "IsEnabled": true
          },
          {
            "Name": "Marketplace",
            "IsEnabled": true
          }
        ]
      }
}

Paramètres	Values
« Gestionnaire de modèles »	"Feeds"	« Nom »	Emplacement du modèle (Démarrer (GettingStarted), Officiel (Official), Place de marché (Marketplace)) écrit entre guillemets.
		"IsEnabled"	Que ce soit true ou false.

Utilisation des sources de package

Vous pouvez restreindre l'accès, l'ajout ou la suppression des sources de package à Studio ou à StudioX via le fichier de gouvernance.

{
    "PackageManager": {
        "AllowAddRemoveFeeds": false,
        "AllowEnableDisableFeeds": false,
        "AllowOrchestratorFeeds": true,
        "Feeds": [{
                "Name": "Organization Internal Feed",
                "Source": "https://[company].pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json",
                "IsEnabled": true
            },
            {
                "Name": "Official",
                "Source": "https://www.myget.org/F/workflow",
                "IsEnabled": true
            }
        ]
    }
}

Paramètres		Values
"Package Manager"	"AllowAddRemoveFeeds"		Que ce soit true ou false.
	"AllowEnableDisableFeeds"		Que ce soit true ou false.
	"AllowOrchestratorFeeds"		Que ce soit true ou false.
	"Feeds"	« Nom »	Libellé écrit entre guillemets de type "", visible dans Gérer les packages (Manage Packages).
		"Source"	Source du flux écrite entre guillemets de type "", visible dans Gérer les packages (Manage Packages).
		"IsEnabled"	Que ce soit true ou false.

Si les paramètres « AllowAddRemoveFeeds » et « AllowEnableDisableFeeds » sont définis sur true, l'utilisateur peut modifier les flux disponibles dans le gestionnaire de paquets. Si des modifications sont apportées, elles sont conservées lorsque Studio est redémarré.

Si le paramètre "AllowOrchestratorFeeds" est défini sur true et que le Robot est connecté à Orchestrator, les utilisateurs ne peuvent pas désactiver les flux Orchestrator par défaut.

Les flux définis dans le fichier de gouvernance sont ajoutés à la section Sources de packages par défautdans la fenêtre Gérer les paquets et l’utilisateur peut ajouter les flux personnalisés (s’ils ont les droits requis dans le fichier de gouvernance) à la section Sources de packages définies par l’utilisateur.

Veuillez noter que le chemin d'accès au flux local pour les installations par utilisateur est C:\Users\CurrentUser\AppData\Local\Programs\UiPath\Studio\Packages.

Paramètres du panneau Activités (StudioX uniquement)

Les paramètres de ActivitiesManager vous permettent de masquer certaines activités et d'imposer l'utilisation du filtre Afficher le développeur dans StudioX.

"ActivitiesManager": {
        "AllowShowDeveloper": false,
        "HiddenActivities": ["UiPath.Mail.Activities.Business.GmailApplicationCard","UiPath.Mail.Activities.Business.OutlookApplicationCard"]
}

Paramètre	Paramètres	Valeur (Value)
Permet aux utilisateurs de sélectionner le filtre Afficher le développeur (Show Developer) dans le panneau Activités de StudioX. S'il est défini sur False, l'option ne sera pas disponible.	"AllowShowDeveloper"	Que ce soit true ou false.
Liste d'activités à masquer dans le panneau Activités.	"HiddenActivities"	Saisissez dans le tableau les noms des activités, séparés par des virgules. Dans l'exemple ci-dessous, les activités Utiliser Gmail (Use Gmail) et Utiliser l'application de bureau Outlook (Use Desktop Outlook App) ont été masquées. "HiddenActivities": ["UiPath.Mail.Activities.Business.GmailApplicationCard", "UiPath.Mail.Activities.Business.OutlookApplicationCard"]

Paramètres de contrôle de code source

Les paramètres de "SourceControl" vous permettent d'imposer l'utilisation des référentiels autorisés lorsque vous travaillez avec GIT et de valider les modifications avant la publication.

{
      "SourceControl": {
        "CheckInBeforePublishParam": {
          "AllowEdit": false,
          "Value": false
        },
       "RepositoriesConfigParam": {
          "AllowEdit": true,
          "Value": {
            "AllowSaveLocal": null,
            "AllowEditRepositories": null,
            "Repositories": [
              {
                "SourceControlType": 0,
                "Name": null,
                "Url": null,
                "DefaultFolder": null
              }
            ]
          }
       
}

Le paramètre "AllowEdit" indique si les utilisateurs sont autorisés ou non à modifier le paramètre par défaut configuré par le fichier de gouvernance.

Paramètre de Studio	Paramètres	Valeur (Value)
Appliquer l'archivage avant la publication Remarque : Ce paramètre est accessible dans Accueil (Home) > Paramètres (Settings) > Conception (Design).	"CheckInBeforePublishParam"	Que ce soit true ou false.
Les paramètres de RepositoriesConfigParam vous permettent de régir l'utilisation des référentiels de contrôle de code source. Cela s'applique uniquement à GIT.	"RepositoriesConfigParam"	S/O
Autoriser les utilisateurs à enregistrer des projets localement sur leur machine.	"AllowSaveLocal" 1	Soit true, soit false. Si la valeur est null, le paramètre est interprété comme true. Lorsqu'il est défini sur false, les utilisateurs ne peuvent pas sélectionner Ce PC (This PC) comme emplacement lors de la création d'un nouveau projet dans StudioX et le projet devra être enregistré dans un référentiel.
Autoriser les utilisateurs à ajouter et à modifier des référentiels.	"AllowEditRepositories"	Soit true, soit false. Si la valeur est null, le paramètre est interprété comme true. Si défini sur false : Dans le mode Backstage de StudioX, les options présentes dans Accueil (Home) > Équipe (Team) sont en lecture seule et les utilisateurs ne peuvent pas ajouter, modifier ou supprimer un référentiel. Dans Studio, les utilisateurs peuvent ajouter des URL de référentiel dans la fenêtre Clonage d'un référentiel GIT distant (Clone a remote GIT repository), mais chaque URL sera vérifiée par rapport à la liste des référentiels autorisés.
La liste des référentiels GIT autorisés. Ce paramètre accepte un tableau JSON de référentiels.	"Repositories" Remarque : un référentiel déjà extrait localement par un utilisateur est autorisé pour les deux profils quand bien même il ne figure que sur la liste d'autorisation d'un seul profil.	Ajoutez les référentiels dans le tableau en saisissant leur nom, leur URL et éventuellement leur DefaultFolder (le dossier par défaut du référentiel). Exemple de référentiel : "Name" : "%username%'s Repo", "Url" : "https://github.com/uipath/%username%", "DefaultFolder" : null Ajouter une URL de base (par exemple https://github.com/MyOrg/) permet l'utilisation de référentiels avec des URL enfants (par exemple https://github.com/MyOrg/RPA). Toutes les chaînes de caractères placées entre % dans les paramètres de nom et d'URL sont interprétées comme des variables d'environnement sur les machines utilisateur. Tous les espaces dans le paramètre d'URL sont remplacés par des traits d'union (-).

1 - Les modifications ne sont prises en compte que dans le profil StudioX.

Paramètres de Studio

Les paramètres suivants vous permettent de configurer les paramètres présents dans Accueil (mode Backstage de Studio) > Paramètres. Pour plus d’informations, consultez Configurer les paramètres StudioX.

{
      "Workflow": {
        "DefaultProjectLanguageParam": {
          "Value": VisualBasic,
          "AllowEdit": false
        },
        "DefaultProjectFrameworkParam": {
          "Value": "Classic",
          "AllowEdit": true
        },          
        "AllowedProjectFrameworks": {
          "Classic": true,
          "Modern": true,
          "CrossPlatform": true
        },
        "DockedAnnotationsParam": {
          "AllowEdit": false,
          "Value": true
        },
        "IsCollapsedViewSlimParam": {
          "AllowEdit": false,
          "Value": false
        },
        "UseSmartFilePathsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableLineNumberingParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableActivityOnlineRecommendationsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnforceReleaseNotes": null,
        "AnalyzeOnPublishParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AnalyzeOnPushParam": {
          "AllowEdit": true,
          "Value": false
        },
        "AnalyzeOnRunParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AnalyzeRpaXamlsOnlyParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AdditionalAnalyzerRulePathParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultProjectFolderParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultProcessPublishUrlParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultLibraryPublishUrlParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultTemplatePublishUrlParam": {
          "AllowEdit": false,
          "Value": "C:\\Users\\username\\Documents\\UiPath\\.templates"
        },
        "ModernBehaviorParam": {
          "AllowEdit": false,
          "Value": false
        },
        "ObjectRepositoryEnforcedParam": {
          "AllowEdit": false,
          "Value": false
        },
        "UseConnectionServiceParam": {
          "AllowEdit": true,
          "Value": false
        }
      },
}

Pour la plupart des options, deux paramètres sont disponibles :

• "AllowEdit" : Indique si les utilisateurs sont autorisés ou non à modifier le paramètre par défaut configuré par le fichier de gouvernance (true pour autoriser, false pour refuser).
• "Value" - Indiquez le paramètre par défaut tel que décrit dans les tableaux suivants.

Sous "Workflow" :

Paramètre de Studio	Paramètres	Valeur (Value)
Utiliser le langage C#	"DefaultProjectLanguageParam" 1	CSharp Si "AllowEdit" est false : autorisez uniquement C#. Si « AllowEdit » est true : définit le langage par défaut sur C# et autorise les utilisateurs à modifier le langage par défaut. VisualBasic Si "AllowEdit" est false : autorisez uniquement VB. Si « AllowEdit » est true : Définit le langage par défaut sur VB et autorise les utilisateurs à modifier le langage par défaut.
Créer des annotations ancrées	"DockedAnnotationsParam"	Que ce soit true ou false.
Infrastructure cible par défaut du projet	"DefaultProjectFrameworkParam" 1	"Classic" Si "AllowEdit" est false : autorisez uniquement Windows-Héritage (Infrastructure .NET 4.6.1). Si "AllowEdit" est true - Définissez la cible par défaut sur Windows - Legacy et autorisez les utilisateurs à modifier l'infrastructure cible. "Modern" Si « ModifierAutorisation » (AllowEdit) est false autorisez uniquement Windows. Si « ModifierAutorisation » (AllowEdit) est true : définissez la cible par défaut sur Windows et autorisez les utilisateurs à modifier l'infrastructure cible. "Cross-platform" Si « ModifierAutorisation » (AllowEdit) est false : autorisez uniquement le multiplate-forme. Si « ModifierAutorisation » (AllowEdit) est true : définissez la cible par défaut sur Multiplate-forme (Cross-platform) et permettez aux utilisateurs de modifier l'infrastructure cible.
Les paramètres de "AllowedProjectFrameworks" déterminent les infrastructures cibles autorisées lors de la création ou de l'ouverture d'un projet dans le profil Studio. Pour activer une infrastructure, définissez son paramètre sur true. Remarque : Ce paramètre ne peut pas être configuré à partir de l'interface utilisateur de Studio	"AllowedProjectFrameworks" 1	Soit true, soit false. pour chacun des éléments suivants : « Classique » (Windows - Héritage) « Moderne » (Windows) « Multiplate-forme » (Cross-platform)
Utiliser Smart File Paths	"UseSmartFilePathsParam" 2	Que ce soit true ou false.
Activer la numérotation des lignes	"EnableLineNumberingParam" 2	Que ce soit true ou false.
Activer les suggestions d’activités d’IA	"EnableActivityOnlineRecommendationsParam"	Que ce soit true ou false.
Rendre le champ « Notes de publication » obligatoire dans l'assistant de publication Remarque : Ce paramètre ne peut pas être configuré à partir de l'interface utilisateur de Studio.	"EnforceReleaseNotes"	Que ce soit true ou false.
Vue simplifiée des activités réduites	"IsCollapsedViewSlimParam"	Que ce soit true ou false.
Appliquer l'analyseur avant la publication	"AnalyzeOnPublishParam"	Que ce soit true ou false.
Appliquer l'analyseur avant le Push/Check-In	"AnalyzeOnPushParam"	Que ce soit true ou false.
Appliquer l'analyseur avant l'exécution	"AnalyzeOnRunParam"	Que ce soit true ou false.
Analyser les fichiers RPA XAML uniquement	"AnalyzeRpaXamlsOnlyParam"	Que ce soit true ou false.
Emplacement des règles de l'analyseur de workflow	"AdditionalAnalyzerRulePathParam"	null - Utilise l’emplacement par défaut. Pour modifier l’emplacement, entrez le chemin vers le dossier où les règles personnalisées sont stockées entre guillemets.
Chemin d’accès au projet	DefaultProjectFolderParam	null - Utilise l’emplacement par défaut. Pour modifier l’emplacement, entrez le chemin vers le dossier où les règles personnalisées sont stockées entre guillemets.
Publier l’URL du Processus	"DefaultProcessPublishUrlParam"	null - Utilise l’emplacement par défaut. Pour modifier l’emplacement, entrez le chemin d’accès entre guillemets.
Publier l’URL de la Bibliothèque	"DefaultLibraryPublishUrlParam"	null - Utilise l’emplacement par défaut. Pour modifier l’emplacement, entrez le chemin d’accès entre guillemets.
Publier l’URL des Modèles de projet	"DefaultTemplatePublishUrlParam"	Pour modifier l’emplacement, entrez le chemin d’accès entre guillemets.
Utiliser Modern pour de nouveaux projets	"ModernBehaviorParam"	Que ce soit true ou false.
Référentiel d’objet appliqué	"ObjectRepositoryEnforcedParam"	Que ce soit true ou false.
Par défaut, les connexions sont gérées	"UseConnectionServiceParam"	Que ce soit true ou false.

1 - Les modifications ne sont prises en compte que dans le profil Studio.

2 - Les modifications ne sont prises en compte que dans le profil StudioX.

Sous "ObjectBrowser" :

Paramètre de Studio	Paramètres	Valeur (Value)
Envoyer des descripteurs d’IU anonymes	"SendUiDescriptors"	true ou false

Envoyer les données d'utilisation de Studio à votre organisation

Les paramètres de "Telemetry" vous permettent d'activer l'envoi des données d'utilisation de Studio à une ressource Application Insights sur votre portail Azure. Ces données vous permettent de surveiller et d'analyser l'activité des utilisateurs dans Studio. Pour activer cette fonctionnalité, saisissez la clé d'instrumentation de votre instance Application Insights dans le paramètre "instrumentation-keys".

{
       "Telemetry": {
        "TelemetryOptions": {
          "TelemetryOptionsDictonary": {
            "instrumentation-keys": ""
        }
      }
   }
}

Consultez le tableau suivant pour obtenir des informations sur les données de télémétrie envoyées à Application Insights.

Action	Nom de l'événement	Données collectées
Studio est démarré	StudioStarted	ID de l'utilisateur Windows Identifiant de la session
Studio est fermé	StudioClosed	ID de l'utilisateur Windows Identifiant de la session Durée de la session
Le projet est ouvert	Ouvrir le projet	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Le projet est créé 1	Nouveau projet NouveauProjetCréé (NewProjectCreated)	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Le projet est exécuté	RunProject StartDebug 2	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Le fichier est exécuté	ExécuterDocument (RunDocument) StartDebug 2	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Le projet est débogué	DebugProject StartDebug 2	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Le fichier est débogué	DebugDocument StartDebug 2	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Accéder à cette activité est exécuté	Designer_RunTo	ID de l'utilisateur Windows Identifiant de la session Nom du projet
Le projet a été publié	Publier le projet	ID de l'utilisateur Windows Identifiant de la session Nom du projet URL d'Orchestrator Nom du dossier Emplacement de publication (flux)
Le package d'activité a été installé	PackageAdded	ID de l'utilisateur Windows Identifiant de la session Nom du paquet Version du package Nom du projet
L’activité a été ajoutée à un projet.	S.Activities.ActivityAdded	ID de l'utilisateur Windows Identifiant de la session Nom de l'activité Nom du paquet Version du package
La cible est indiquée dans l'activité UI Automation	S.Activities.PropertyChanged	ID de l'utilisateur Windows Identifiant de la session

1 : lorsqu'un projet est créé, NouveauProjet (NewProject) est généré lorsque l'utilisateur choisit de créer un nouveau projet dans le mode Backstage de Studio, et NouveauProjetCréé (NewProjectCreated) est généré lorsque l'utilisateur clique sur le bouton Créer (Create) dans la boîte de dialogue du nouveau projet.

2 - L'événement StartDebug suit le robot cible qui a exécuté l'opération : le robot local (Local) ou un robot distant (Orchestrator pour la connexion d'un robot sans surveillance, Distant (Remote) pour la connexion d'une machine distante).

Utilisation des données dans Application Insights

En plus des scénarios de cas d'utilisation décrits dans la documentation officielle de Microsoft, vous pouvez tester et créer des requêtes à l'aide de Log Analytics dans Azure Monitor de votre instance Azure Insights. Pour voir toutes les données possibles pour un événement, vous pouvez créer une requête simple qui explorera toutes ses occurrences dans la plage de temps prédéfinie. Par exemple :

customEvents
| where name == "StudioStarted"

Consultez la table suivante pour des exemples de requêtes de télémétrie et une description pour chacune. Vous pouvez également consulter la liste des problèmes connus.

Événement (Event)	Exemple de requête	Description de la requête
StudioStarted Studio est démarré	customEvents | where name == "StudioStarted" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Combien de fois par jour Studio a été ouvert au cours des 30 derniers jours, hors journée en cours.
StudioClosed Studio est fermé	customEvents | where name == "StudioClosed" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Combien de fois par jour Studio a été fermé au cours des 30 derniers jours, hors journée en cours.
StudioClosed Studio est fermé	customEvents | where name == "StudioClosed" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend TotalSessionTimeInSeconds = tostring(customDimensions.TotalSessionTimeInSeconds) | extend SessionId = tostring(parse_json(tostring(customDimensions.Context)) .SessionId) | summarize AvgSessionTime_inMinutes = round(avg(todouble(TotalSessionTimeInSeconds))/60,2) by bin(timestamp, 1d) | order by timestamp desc	Durée moyenne quotidienne des sessions des 30 derniers jours, hors journée en cours (en minutes arrondies à deux décimales).
Ouvrir le projet Le projet est ouvert	customEvents | where name == "OpenProject" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Combien de fois par jour un projet a été ouvert au cours des 30 derniers jours, hors journée en cours.
NouveauProjetCréé (NewProjectCreated) Le projet a été créé	customEvents | where name == "NewProject" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActionArgs = tostring(customDimensions .ActionArgs) | where ActionArgs != "" | summarize count(name) by ActionArgs, bin(timestamp, 1d) | order by timestamp desc	Combien de projets et de quel type ont été créés au cours des 30 derniers jours, hors journée en cours.
StartDebug Le projet est exécuté ou débogué / Le fichier est exécuté ou débogué	customEvents | where name == "StartDebug" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend RunTarget = tostring(customDimensions .RunTarget) | summarize count(name) by RunTarget, bin(timestamp, 1d) | order by timestamp desc	Combien d'exécutions ont été lancées et pour quelle cible au cours des 30 derniers jours, hors journée en cours.
Designer_RunTo Accéder à cette activité (Run to this Activity) est exécuté	customEvents | where name == "Designer_RunTo" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Combien de fois Accéder à cette activité (Run to this activity) a été exécuté au cours des 30 derniers jours, hors journée en cours.
Publier le projet Le projet a été publié	customEvents | where name == "PublishProject" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Combien de projets ont été publiés au cours des 30 derniers jours, hors journée en cours.
PackageAdded Le package d'activité a été installé	customEvents | where name == "PackageAdded" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActionArgs = tostring(customDimensions. ActionArgs) | summarize count(name) by ActionArgs, bin(timestamp, 1d) | order by timestamp desc	Combien de packages, et leurs noms, ont été installés au cours des 30 derniers jours, hors journée en cours.
S.Activities.ActivityAdded L’activité a été ajoutée à un projet.	customEvents | where name == "S.Activities.ActivityAdded" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActivityType = tostring(customDimensions. ActivityType) | extend PackageName = tostring(customDimensions.PackageName) | extend PackageVersion = tostring(customDimensions.PackageVersion) | summarize count(name) by ActivityType, PackageName, PackageVersion, bin(timestamp, 1d) | order by timestamp desc	Combien d'activités ont été ajoutées au cours des 30 derniers jours, hors journée en cours. Inclut le nom et la version du package d'où provient chaque activité. 3
S.Activities.PropertyChanged La cible est indiquée dans l'activité UI Automation	customEvents | where name == "S.Activities.PropertyChanged" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActivityType = tostring(customDimensions.ActivityType) | extend PropertyName = tostring(customDimensions.PropertyName) | summarize count(name) by ActivityType, PropertyName, bin(timestamp, 1d) | order by timestamp desc	Combien de fois les propriétés des activités utilisées ont été modifiées au cours des 30 derniers jours, hors journée en cours. Inclut les noms des activités et le nom de chaque propriété qui ont été modifiées.

La table suivante répertorie les paramètres supplémentaires qui sont inclus par défaut dans les événements.

Paramètre	Description	Représentation dans la requête (sur un événement sélectionné)
customDimensions	Une collection détaillée de données et de paramètres associés à chaque événement.	customEvents | where name == "StudioStarted" | extend customDimensions
Context	Une partie de la collection customDimensions qui gère les détails du projet, y compris le profil, l'ID utilisateur, le type de licence, le type de robot, l'ID de session.	customEvents | where name == "StudioStarted" | extend Context = parse_json(customDimensions.Context)
Environnement (Environment)	Une partie de la collection customDimensions qui comprend le nom de la machine, la version du système d'exploitation et le nom d'utilisateur.	customEvents | where name == "StudioStarted" | extend Environment = parse_json(customDimensions.Environment)

Log Analytics vous donne la possibilité d'étendre explicitement chaque type de données faisant partie des paramètres mentionnés pour servir de filtre ou pour être utilisé comme élément de synthèse supplémentaire. Pour ce faire, cliquez sur l'icône à trois points à côté d'un élément de données dans le journal, puis choisissez d'étendre les données ou de les utiliser comme filtre.

Consultez la table suivante pour des exemples d'extension ou de filtrage de données.

Exemple de données	Représentation dans la requête (sur un événement sélectionné)
ApplicationName (extension)	customEvents | where name == "StudioStarted" | extend ApplicationName = tostring(customDimensions.ApplicationName)
LicenseType (extension)	customEvents | where name == "StudioStarted" | extend LicenseType = tostring(parse_json(tostring(customDimensions.Context)).LicenseType)
OSVersion (filtre inclus)	customEvents | where name == "StudioStarted" | where parse_json(tostring(customDimensions.Environment)).OSVersion == "Microsoft Windows NT 10.0.19043.0"
CurrentLanguage (filtre inclus)	customEvents | where name == "StudioStarted" | where parse_json(tostring(customDimensions.Context)).CurrentLanguage == "en"

Problèmes connus

• L'événement Publier le projet affiche uniquement les détails des projets publiés sur Orchestrator.
• L'événement S.Activities.ActivityAdded affiche une version de package incorrecte.

Règles de l’analyseur de workflow

L' analyseur de workflow est l'outil permettant de vérifier si les projets répondent aux normes de développement. À l'aide du fichier de gouvernance, les organisations peuvent appliquer des règles personnalisées relatives à leurs besoins dans tous les projets, de manière centralisée.

Remarques

• L'ensemble de règles personnalisé peut être défini à l’avance dans un fichier distinct de type .json, et livré par un assemblage externe dll ou un module d’activités personnalisé. En savoir plus sur la création de règles personnalisées pour l’analyseur de workflow.
• Le fichier de gouvernance ne peut pas fournir d’informations d’identification, ce qui signifie que les flux sécurisés ne sont pas pris en charge.
• Si un ensemble de règles personnalisé est appliqué, les utilisateurs ne peuvent pas apporter de modifications aux règles de l'analyseur de workflow.
• Si un jeu de règles personnalisé n’a pas été référencé ou intégré dans le fichier de gouvernance, les règles par défaut de l'analyseur de workflow sont utilisées. Si la section « Analyseur » n’est pas mentionnée, la gouvernance de l'analyseur de workflow n’est pas appliquée. Si la section est mentionnée, même si elle est vide, la gestion des règles est désactivée dans Studio.
• Lors de l’application de la gouvernance, les packages d’activité Studio ou UiPath intégrés aux règles sont désactivés par défaut, sauf indication contraire dans le fichier de gouvernance ou l'ensemble de règles personnalisé.

Enforcing Rules

Il existe deux façons de gérer l'ensemble de règles personnalisé dans le fichier de gouvernance uipath.policies.config :

1. Pointer vers l'ensemble de règles situé à l’un des chemins suivants :

   • sur la machine locale;
   • partagé sur un serveur réseau ou une machine, identifiable par le chemin UNC;
   • dans le stockage blob partagé, identifiable via le chemin http(s).
2. Intégrer l'ensemble de règles personnalisé en activant ou en désactivant les règles, en mentionnant leurs ID, paramètres, niveaux d’erreur.

Toutes les règles personnalisées doivent être référencées ou ajoutées dans la section "Analyzer". Les règles et les compteurs doivent être divisés en leurs propres sections, comme illustré ci-dessous :

{
    "Analyzer": {
    "AllowEdit": false,
        "ReferencedRulesConfigFile": null,
        "EmbeddedRulesConfig": {
            "Rules": [
        {
                    "Id": "ST-NMG-001",
                    "IsEnabled": false,
                    "Parameters": [{
                        "Name": "Regex",
                        "Value": null
                    }],
                    "ErrorLevel": "Error"
                }
            ],
            "Counters": [{
                "Id": "ST-ANA-009",
                "IsEnabled": true,
                "Parameters": []
            }]
        }
    }
}

Paramètres/sections	Values
"AllowEdit"	S’ils sont configurés sur true, les paramètres de gouvernance sont adoptés par défaut, ce qui permet à l’utilisateur d’apporter des modifications aux règles. S'ils sont configurés sur false, aucune modification ne peut être apportée à des règles. Si le paramètre n’est pas ajouté, par défaut, les utilisateurs sont limités aux règles d’édition.
"ReferencedRulesConfigFile"	Chemin d'accès à l'ensemble de règles .json Utilisez null pour appliquer les règles de "EmbeddedRulesConfig"
"EmbeddedRulesConfig"	Détient "Rules" et "Counters"
"Id"	ID de règle, ex. ST-NMG-001
"IsEnabled"	true ou false
"Parameters"	Contient les paramètres de règle Name et Value Utilisez [] si la règle n'a pas de paramètres.
"Name"	Le nom du paramètre écrit entre guillemets.
"Value"	La valeur du paramètre écrite entre guillemets Peut être null
"ErrorLevel"	Soit Error, Warning, Info ou Verbose.
"Counters"	Détient des paramètres pour les compteurs : « Id », « IsEnabled », « Parameters » 1.

1 - Puisque les compteurs n’ont pas de paramètres, utilisez [].

Si le paramètre « AllowEdit » est défini sur true, l'utilisateur peut modifier les règles disponibles dans la fenêtre des paramètres de l'analyseur de workflow. Si des modifications sont apportées, elles sont conservées lorsque Studio est redémarré.

Appliquer la politique de gouvernance

Remarque : nous vous recommandons de configurer et de déployer des stratégies à l'aide d'Automation Ops. Pour plus d'informations sur la création de stratégies à partir de fichiers de gouvernance générés dans Studio, consultez la section Créer une stratégie de gouvernance (Create a Governance Policy) dans le Guide Automation Ops.

Utilisation d’un fichier local

S’il est stocké localement, le fichier de gouvernance doit être situé sur le chemin suivant : %AppData%\UiPath.

Utilisation d’un Fichier externe

S’il est stocké en externe, le chemin d'accès vers le fichier de stratégie doit être défini à l’aide du registre Windows ou d’une ressource Orchestrator :

Pour définir le chemin d'accès du fichier à l’aide du registre Windows :

1. Ouvrez l’éditeur de registre sur la machine où Studio est installé.
2. Localisez la clé de registre suivante : Computer\HKEY_CURRENT_USER\Software\UiPath et appuyez sur Entrée.
3. Dans l’éditeur du registre, faites un clic droit et sélectionnez Nouveau > Valeur de chaîne. Entrez le nom GovernanceSource de la nouvelle valeur. Ne donnez pas un autre nom à la valeur !
4. Double-cliquez sur la chaîne GovernanceSource à modifier. Dans le champ Données de la valeur , ajoutez le chemin d'accès au fichier uipath.policies.config et cliquez sur OK.
   • Si le fichier de stratégie est stocké localement, un exemple pour ce champ serait C:\policies\uipath.policies.config.
   • Si le fichier de stratégie est stocké sur un serveur, un exemple pour ce champ serait 192.168.1.1\policies\uipath.policies.config.

La clé du registre devrait ressembler à ceci :

Pour définir le chemin d'accès du fichier à l’aide d’une ressource Orchestrator :

1. Dans Orchestrator, sélectionnez Locataire > Dossiers, puis ajoutez un nouveau dossier nommé uipath.settings.config.
2. Assignez les utilisateurs auxquels appliquer la stratégie de gouvernance du dossier.

3. Dans le dossier uipath.settings.config, créez une nouvelle ressource et configurez-la comme suit :

   • Nom de la ressource - uipath.studio.governancesource.
   • Type - Texte.

   • Valeur globale - Sélectionnez cette option et entrez le chemin complet vers le fichier uipath.policies.config dans la zone de texte.

     Vous avez également la possibilité d'appliquer des stratégies distinctes pour différents utilisateurs en ajoutant des valeurs par utilisateur associées à des chemins vers différents fichiers.

     
     

     

     
     

Utilisation d’une ressource Orchestrator

1. Dans Orchestrator, sélectionnez Locataire > Dossiers, puis ajoutez un nouveau dossier nommé uipath.settings.config.
2. Assignez les utilisateurs auxquels appliquer la stratégie de gouvernance du dossier.

3. Dans le dossier uipath.settings.config, créez une nouvelle ressource et configurez-la comme suit :

   • Nom de la ressource - uipath.studio.governancepolicy.
   • Type - Texte.

   • Valeur globale - Sélectionnez cette option, puis collez l’intégralité du contenu du fichier uipath.policies.config dans la zone de texte.

     Vous avez également la possibilité d’appliquer différentes stratégies pour différents utilisateurs en ajoutant des valeurs par utilisateur et en y collant différents paramètres.

     Remarque :

     • L’application d’une stratégie de gouvernance à l’aide d’une ressource Orchestrator qui fait référence au chemin d'accès au fichier ou contient le contenu du fichier requiert Orchestrator v2020.10 ou supérieure avec les dossiers modernes.
     • Les utilisateurs doivent être connectés à leur compte dans Studio pour recevoir les politiques par utilisateur.
     
     

     

     
     

Application et Précédence

Lorsqu’une stratégie est définie, elle est appliquée après le redémarrage de Studio.

Un message apparaît dans la fenêtre de paramètres Analyseur de workflow (Workflow Analyzer), la fenêtre Envoyer des commentaires (Send Feedback), dans l'onglet Paramètres (Settings) du mode Backstage et dans la fenêtre Gérer les packages (Manage Packages).

Studio applique la stratégie de gouvernance en utilisant l’ordre de priorité suivant : Automation Ops > uipath.studio.governancepolicy > uipath.studio.governancesource > Clé de registre > Fichier local.

Si la stratégie de gouvernance est supprimée pour l’utilisateur, les paramètres qui ont été appliqués par le biais du fichier de gouvernance sont maintenus par défaut. Toutefois, l’utilisateur a maintenant la possibilité de modifier les paramètres qui ont été restreints lorsque la politique de gouvernance était en place.