Gestion des exigences de package

Vue d'ensemble (Overview)

Le parcours RPA commence dans Studio, le domaine des workflows et des activités. Lors de la conception des workflows, les développeurs peuvent utiliser divers objets, qui sont généralement gérés de manière centralisée à partir d'Orchestrator à l'aide de dossiers, ce qui vous permet de garder le contrôle précis de vos automatisations et des objets associés.

Ces objets sont essentiels à une exécution réussie du processus. L'absence de l'un des objets indiqués empêche le processus de s'exécuter correctement.

L'onglet Exigences du package (Package Requirements) vous permet d'identifier les objets manquants et de les ajouter manuellement au niveau du processus. Cela permet :

• de sensibiliser les utilisateurs aux dépendances des processus,
• de réduire le débogage manuel des workflows,

• d'identifier les objets manquants sans avoir à basculer entre l'interface utilisateur Studio et Orchestrator.

  
  

  

  
  

Remarque : cette fonctionnalité est compatible avec les processus créés à l’aide de Studio version 2021.10 et ultérieure, conjointement avec les modules d’activités version 2021.10 et ultérieure.

Fonctionnement des exigences de package

Lorsque vous créez un processus, Orchestrator inspecte le package sous-jacent avec tous ses fichiers de composants .xaml et regroupe les objets intrinsèques, par exemple :

• Compartiments de stockage
• Actifs
• Files d'attente (Queues)
• autres processus
• Catalogues d'actions
• Connexions

Selon que les objets respectifs sont détectés ou non, l'onglet Exigences du package (Package Requirements) se comportera de deux manières :

• L'onglet devient rouge : le workflow a des dépendances qui ne sont pas présentes dans Orchestrator, vous devez donc les ajouter.

• L’onglet est vide, affichant que « Cette version de package ne contient aucune exigence. » - le package téléchargé n'a aucune exigence.

  Remarque : Orchestrator ne détecte pas automatiquement les exigences des packages stockés dans des flux externes.

Statuts des exigences de package

Statuts généraux

• Disponible (Available) : l'objet est présent dans Orchestrator. Aucune autre action n'est nécessaire.

• Manquant (Missing) : l'objet n'est pas présent dans le dossier Orchestrator actuel. Vous pouvez soit l'importer, soit l'ajouter au dossier Orchestrator correspondant, à condition que vous disposiez des autorisations appropriées.

• Dossier introuvable (Folder not found) : l'objet existe supposément dans un dossier Orchestrator référencé dans le champ Chemin d'accès au dossier (Folder path) d'une activité, mais :

  • Le dossier n’existe pas dans Orchestrator. Vous devez ajouter le dossier à Orchestrator, utiliser le même nom que celui indiqué dans la colonne Chemin d'accès au dossier (Folder path) et lui affecter des utilisateurs.

  • Vous n'avez pas accès à ce dossier. Vous devez demander l'accès au dossier Orchestrator indiqué dans la colonne Chemin d'accès au dossier (Folder path).

• Inconnu (Unknown) : le nom de l'objet n'a pas pu être déterminé. Aucune action disponible à effectuer. Plusieurs scénarios peuvent entraîner un statut Inconnu (Unknown) :

  • le nom de l'objet est défini comme une expression lors du runtime ;

  • vous ne disposez pas des autorisations appropriées pour ce type d'objet ;

  • une activité de workflow fait référence à un élément de la file d'attente, par exemple, qui ne peut pas être lié à sa file d'attente.

    Remarque : l'état Inconnu (Unknown) d'un objet n'empêche pas le processus de s'exécuter correctement.

• Filtres non valides (Invalid filters) : les filtres d'une connexion ne sont pas configurés.

Remarque : l'état Inconnu (Unknown) d'un objet n'empêche pas le processus de s'exécuter correctement.

Statuts de déclencheur

En plus des statuts généraux, les déclencheurs affichent les statuts suivants :

• Création en attente - ajouter un déclencheur nécessite de l'associer à un processus existant. Pendant que le processus est créé, le déclencheur réside dans la mémoire de l'Orchestrator et il s'active après le processus de création. Vous pouvez modifier le déclencheur depuis l'onglet exigences du package tant qu'ils ont ce statut. Vous avez ensuite la possibilité de les modifier à partir de la page Déclencheurs (Triggers).

• Configuration non valide (Invalid configuration) : le runtime sélectionné n'est pas disponible.

• Nom dupliqué (Duplicate name) : le nom du déclencheur est dupliqué.

Autorisations

Pour gérer les exigences du package, vous avez besoin des autorisations suivantes :

Je veux ...	J'ai besoin ...	L'accès au dossier dont j'ai besoin...
... voir les packages disponibles	Autorisations de Consultation (View) par rapport aux packages (au niveau du locataire)	Non applicable, car les autorisations relatives aux packages sont définies au niveau du locataire.
... télécharger un package	Autorisations Création (Create) par rapport aux packages (au niveau du locataire)	Non applicable, car les autorisations relatives aux packages sont définies au niveau du locataire.
... voir les objets disponibles	Autorisations Consultation (View) par rapport à l'objet spécifié	Accès au(x) dossier(s) contenant l'objet.
... ajouter un objet	Autorisations Création (Create) par rapport au type d'objet spécifique	Accès au(x) dossier(s) auquel(s) vous souhaitez ajouter l'objet.
... importer un objet à partir d'un autre dossier	Autorisations Création (Create) et Consultation (View) par rapport au type d'objet spécifique	Accès : au(x) dossier(s) depuis lequel/lesquels vous importez, et au(x) dossier(s) dans lequel/lesquels vous importez l'objet.

Gestion des objets manquants

Pour chaque objet manquant, à l'exception des catalogues d'actions et des connexions, vous avez la possibilité de l'ajouter ou de l'importer dans le dossier actuel, à condition de disposer des autorisations nécessaires.

Remarque : Vous ne pouvez pas ajouter de catalogues d'actions et de connexions à partir de l'onglet Exigences du package (Package Requirements) dans Orchestrator, mais à partir d'Action Center et d'Integration Service, respectivement.

Ajout d'un objet manquant

Prérequis : Assurez-vous que vous disposez des autorisations de Création (Create) par rapport à l'objet spécifique et que vous avez accès au dossier auquel vous souhaitez ajouter l'objet.

1. Pour ajouter un objet manquant, cliquez sur le bouton Ajouter (Add) correspondant. La page Créer [objet] (Create [object]) s'ouvre.
2. Configurez l'objet selon vos besoins.
   Le champ de nom est pré-rempli avec le nom d'objet manquant et ne peut pas être modifié. Cette restriction s'applique afin de respecter le nom d'objet utilisé dans le workflow.

Importation d'un objet manquant

Si vous pensez que l'objet manquant existe dans le locataire actuel, mais dans un autre dossier, vous pouvez l'importer dans le dossier actuel.

Prérequis : Assurez-vous que vous disposez des autorisations Consultation (View) et Création (Create) par rapport à l'objet spécifique, et que vous avez accès à la fois au dossier à partir duquel vous importez et au dossier dans lequel vous importez l'objet.

1. Pour importer un objet à partir d'un autre dossier, cliquez sur le bouton Importer (Import) correspondant. La page Lier [objets] depuis d'autres dossiers (Link [objects] from other folders) s'ouvre et affiche deux onglets :
2. Si l'objet existe dans d'autres dossiers, il apparaît dans l'onglet Sélectionner [objet] (Select [object]). Sélectionnez-la.
3. Cliquez sur Continuer (Continue) pour accéder à l'onglet Validation du dossier (Folder validation).

   Après avoir sélectionné l'objet, l'onglet Validation du dossier (Folder validation) affiche le ou les dossiers sources à partir desquels vous pouvez importer.

4. Si l'objet existe dans plusieurs dossiers et que vous avez sélectionné toutes les copies à l'étape précédente, vous êtes à présent invité à ne conserver qu'un seul dossier source.
5. Supprimez les copies d'objets associées aux dossiers à partir desquels vous n'avez pas besoin d'importer.
6. Cliquez sur Lier (Link) pour importer l'objet dans le dossier indiqué dans la colonne Chemin d'accès au dossier (Folder Path).
7. Après avoir ajouté ou importé un objet, vous êtes redirigé vers l'onglet Exigences du package (Package Requirements) pour continuer à ajouter ou importer les objets manquants. Remarquez les statuts modifiés pour les objets qui ont été ajoutés ou importés.

Important :

Dans le cas de dépendances de processus multicouches, Orchestrator détecte et affiche uniquement la dépendance de premier niveau pour un processus donné.

Par exemple, le processus A a besoin du processus B pour démarrer, et le processus B a besoin du processus C pour démarrer. La hiérarchie des dépendances est A > B > C. Dans ce cas, lors de la vérification des exigences du package pour le processus A, Orchestrator détecte et affiche le premier niveau de dépendance, le processus B. Si le processus B est manquant, vous pouvez l'ajouter à partir de l'onglet Exigences du package (Package Requirements), mais si le processus C est manquant, vous devez l'identifier vous-même comme manquant et l'ajouter manuellement.

Ajout de catalogues d'actions

Orchestrator détecte les catalogues d'actions requis pour exécuter le processus, mais vous ne pouvez pas ajouter ceux qui manquent à partir de l'onglet Exigences du package (Package Requirements), car les catalogues d'actions sont des objets configurables via Action Center.

Prérequis : Assurez-vous que vous disposez des autorisations de Création (Create) par rapport à l'objet spécifique et que vous avez accès au dossier auquel vous souhaitez ajouter l'objet.

Suivez ces étapes :

1. Rendez-vous sur l'instance Action Center correspondante.
2. Accédez à la page Paramètres d'administration (Admin Settings).
3. Sélectionnez le dossier de processus.
4. Cliquez sur Ajouter un nouveau catalogue (Add New Catalog). Assurez-vous d'utiliser le nom détecté comme manquant dans l'onglet Exigences du package (Package Requirements).
5. Cliquez sur Créer (Create).

Ajout de déclencheurs de temps et de file d'attente

L'ajout d'un déclencheur de temps ou de file d'attente préremplit les champs de la page Créer un déclencheur (Create Trigger) avec les valeurs définies par le développeur RPA dans l'activité de déclencheur associée, au moment de la conception. Vous pouvez modifier ces valeurs tant que le déclencheur a le statut Création en attente (Pending creation), ou plus tard à partir de la page Modifier le déclencheur (Edit trigger). Le statut Création en attente (Pending creation) signifie que le déclencheur est stocké dans une mémoire temporaire jusqu'à ce que le processus dont il a besoin soit créé.

1. Accédez à Automations > Processus (Automations) > Processes) et cliquez sur Ajouter un processus (Add process).
2. Sélectionnez le package qui contient l'activité de déclencheur de temps.
3. Saisissez les arguments de runtime requis, puis cliquez sur Suivant (Next).
4. La page des exigences du package affiche le déclencheur de temps avec le statut Manquant (Missing). Cliquez sur le bouton Ajouter un déclencheur (Add trigger) pour configurer le déclencheur de temps.
5. Configurez les propriétés du déclencheur comme indiqué sur la page Création de déclencheurs de temps (Creating time triggers)/Création de déclencheurs de file d'attente (Creating queue triggers). Le statut du déclencheur de temps/file d’attente passe à Création en attente (Pending creation).
6. Cliquez sur Suivant (Next) pour poursuivre la configuration du processus, puis cliquez sur Créer (Create).
   Une fois le processus créé, le déclencheur de temps/file d'attente apparaît dans la grille Déclencheurs de temps/de file d'attente (Time/Queue Triggers) dans Orchestrator.
   Ajout de files d'attente à partir de la page de création de déclencheur de file d'attente

   Vous avez la possibilité d'ajouter une file d'attente lors de la création d'un déclencheur de file d'attente manquant. Sachez que cela vous empêche d'ajouter des SLA à la file d'attente jusqu'à ce que le déclencheur soit créé.

   
   

   

   
   

Ajout de déclencheurs d'événement

1. Accédez à Automations > Processus (Automations) > Processes) et cliquez sur Ajouter un processus (Add process).
2. Sélectionnez le package qui contient l'activité de déclencheur d'événement.
3. Saisissez les arguments de runtime requis, puis cliquez sur Suivant (Next).
4. La page des exigences du package affiche la connexion à l'événement identifiée dans le package. Sélectionnez une connexion ou ajoutez-en une nouvelle. Voir Configuration des connexions (Configuring connections) pour plus de détails.
5. Le déclencheur d'événement apparaît sous la connexion correspondante, avec le statut Création en attente (Pending creation). Cliquez sur l'icône en forme de crayon pour modifier votre déclencheur d'événement.
   La page Modifier le déclencheur d'événement (Edit Event Trigger) s'ouvre. Cette étape est facultative. Les sélections par défaut s'appliquent si elle est ignorée.
6. Configurez les propriétés du déclencheur comme indiqué sur la page Création d'un déclencheur d'événement (Creating an event trigger).
   

Une fois le processus créé, le déclencheur d'événement apparaît dans la grille Déclencheurs d'événement (Event Triggers) dans Orchestrator et dans la liste Déclencheurs (Triggers) dans Integration Service.

Configurer les connexions

Remarque : Cette fonctionnalité est disponible uniquement dans les espaces de travail personnels.

Orchestrator permet de spécifier le compte utilisé dans une connexion lors de la création d'un nouveau processus ou de la modification d'un processus existant.

En tant qu'administrateur, vous pouvez configurer la connexion de vos utilisateurs dans leur propre espace de travail personnel, à condition que vous disposiez de l'ensemble d'autorisations suivant :

• Autorisations Consultation pour les connexions

• Autorisations Consultation (View) et Modification (Edit) pour les espaces de travail personnels

• Autorisations Consultation (View) et Modification (Edit) pour l'écrasement de ressources

1. Accédez à Automatisations (Automations) > Processus (Processes) dans votre espace de travail personnel. La page Processus (Processes) s'affiche.
2. Cliquez sur Plus d'actions (More Actions) > Modifier (Edit) en regard d'un processus pour le modifier. La fenêtre Modifier un processus (Edit Process) s'affiche.
3. Dans l'onglet Configuration du processus (Process Configuration), configurez les détails généraux du processus selon vos besoins.
4. Accédez à l'onglet Exigences des packages (Packages Requirements) pour voir les objets utilisés par le projet d'automatisation sous-jacent. Vous y verrez toutes les connexions qui ont été ajoutées au projet d'automatisation au moment de la conception. Une connexion regroupe toutes les activités qui ont été configurées pour l'utiliser. L'une des options suivantes s'affiche :
   Graphique 1.

   Option de connexion	Comportement	Remarques
   Connexion existante	L'activité s'exécute pour la connexion partagée sélectionnée.	Les connexions disponibles sont organisées sous leurs dossiers conteneurs.
   Configurable par les utilisateurs	Permet aux utilisateurs de sélectionner leur propre connexion au moment du runtime dans l'Assistant UiPath.	Ne sélectionnez pas cette option pour les runtimes Unattended.
   Aucune autorisation ou connexion manquante	Vérifiez les autorisations Consultation (View) dans le dossier contenant la connexion dont vous avez besoin.	Vous pouvez ajouter les connexions manquantes dans le dossier actuel en cliquant sur l'icône en forme de roue dentée > Ajouter une connexion (Add connection). Cliquer sur l'icône en forme une roue dentée > Gérer les connexions (Manage connections) vous redirige vers l'interface Integration Service, où vous pouvez créer de nouveaux connecteurs et connexions.

5. Cliquez sur le bouton pour gérer vos connexions ou en ajouter de nouvelles via Integration Service.
   
   

   

   
   

   L'option Configurable par les utilisateurs (Configurable by users)

   L'option Configurable par les utilisateurs (Configurable by users) s'affiche par défaut dans les situations suivantes :

   • Le package est publié sur un espace de travail personnel

   • La connexion n'est pas partagée (elle réside dans un dossier auquel vous ne pouvez pas accéder)

   • La connection n’existe pas.

   • Autorisations insuffisantes

   Si vous définissez manuellement l'option Configurable par les utilisateurs (Configurable by users), vous autorisez vos utilisateurs à sélectionner leur propre connexion au moment du runtime, dans l'Assistant UiPath.

   Filtres d'activités Integration Service

   Une activité d'Integration Service peut contenir des filtres. Les valeurs de filtre dépendent de la connexion utilisée et peuvent être remplacées au moment de l'exécution dans l'Assistant UiPath. Seules les activités avec des filtres qui peuvent être écrasés sont affichées comme exigences du package. Si la connexion est définie sur Configurable par les utilisateurs (Configurable by users), aucun filtre ne s'affiche.

   Remarque :

   Le passage d'une connexion existante à Configurable par les utilisateurs (Configurable by users) réinitialise les filtres d'activité. De cette façon, les utilisateurs peuvent configurer leurs propres filtres.

   L'utilisation d'une autre connexion que celle existante réinitialise les filtres d'activité. De cette façon, vous pouvez définir de nouveaux filtres pour la nouvelle connexion.

   Pour exécuter des automatisations Unattended, une connexion pour un compte de service doit être définie. Vous ne devez pas définir l'option Configurable par les utilisateurs (Configurable by users).

Personnalisation de configurations utilisateur

Lorsqu'un déclencheur d'événement a l'option Configurable par les utilisateurs (Configurable by users) sélectionnée, vos utilisateurs peuvent définir leurs propres connexions au moment de l'exécution, dans l'Assistant UiPath.

La page Configurations utilisateur personnalisées (Custom user configurations) répertorie les configurations de déclencheur d'événement définies par vos utilisateurs.

En tant que Folder Administrator, vous pouvez remplacer les configurations existantes des utilisateurs ou en ajouter de nouvelles au niveau du processus ou du déclencheur.

Exploration de l'espace de travail personnel d'un utilisateur

• Définir une configuration pour vos utilisateurs implique d'explorer l'espace de travail personnel de l'utilisateur sélectionné.

• Pour ajouter des connexions au nom de vos utilisateurs, vous devez voir leurs connexions personnelles, qui résident dans leur dossier Espace de travail personnel (Personal Workspace).

• Les utilisateurs reçoivent une alerte chaque fois que vous commencez ou finissez d'explorer leur espace de travail personnel.

Statuts de configuration utilisateur

Ces statuts vous aident à identifier les utilisateurs dont la configuration est défectueuse :

Configuré (Configured) : l'utilisateur dispose d'une configuration qui fonctionne.

Partiellement configuré (Partially configured) : l'utilisateur dispose d'une configuration défectueuse, ce qui peut impliquer des connexions manquantes.

Accès à la page Configurations utilisateur personnalisées (Custom user configurations)

Vous pouvez accéder à la page Configurations utilisateur personnalisées (Custom user configurations) à partir des pages Processus (Processes) et Déclencheurs d'événement (Event Triggers).

1. Dans le dossier sélectionné, accédez à :

   Option	Description
   Automatisations (Automations) > Déclencheurs (Triggers)> Déclencheurs d'événement (Event triggers)	Une liste de tous les déclencheurs d'événement disponibles s'affiche.
   Automatisations (Automations) > Processus (Processes)	Une liste de tous les processus disponibles s'affiche.

2. Pour le déclencheur de processus/événement souhaité, cliquez sur le bouton Autres actions (More Actions), puis sélectionnez Configurations utilisateur personnalisées (Custom user configurations). Cela vous redirige vers la page Configurations utilisateur personnalisées (Custom user configurations).

Ajout d'une nouvelle configuration utilisateur

1. Pour le déclencheur de processus ou d'événement souhaité, accédez à la page Configurations utilisateur client (Customer user configurations).
2. Dans la section Configurations des exigences du package par compte utilisateur (Package requirements configurations per user account), cliquez sur Ajouter une configuration utilisateur (Add user configuration). L'assistant Configurer les exigences de processus du compte utilisateur (Configure process requirements for user account) s'ouvre.
   Remarque :

   • Au niveau du déclencheur d'événement, cette opération nécessite les autorisations Modifier (Edit) pour les Écrasements de ressources (Resource overwrites) et Afficher (View) pour les Déclencheurs (Triggers).

   • Au niveau du processus, cette opération nécessite des autorisations Modifier (Edit) pour les Écrasements de ressources (Resource overwrites), ainsi que les autorisations Afficher (View) et Modifier (Edit) pour les Processus (Processes).

3. Dans la liste déroulante Compte utilisateur (User account), sélectionnez l'utilisateur pour lequel vous souhaitez configurer le processus ou le déclencheur d'événement, puis cliquez sur Ajouter un utilisateur (Add user).
   Remarque :

   • L'utilisateur sélectionné doit se trouver dans le même dossier que le déclencheur de processus/événement. Sinon, vous êtes invité à affecter l'utilisateur dans le dossier.

   • Si, entre-temps, vous supprimez des utilisateurs du dossier, leur configuration utilisateur continue d'apparaître dans la liste.

   • Un message contextuel vous informe lorsque vous devez explorer l'espace de travail personnel de l'utilisateur sélectionné.

4. Fournissez les détails requis, tels que les connexions ou les filtres d'activité.
5. Enregistrez la configuration.

Écrasement d'une configuration utilisateur existante

1. Pour le déclencheur de processus ou d'événement souhaité, accédez à la page Configurations utilisateur client (Customer user configurations).
2. Pour le compte utilisateur souhaité, cliquez sur Modifier la configuration (Edit configuration).
   Remarque :

   • Au niveau du déclencheur d'événement, cette opération nécessite les autorisations Modifier (Edit) pour les Écrasements de ressources (Resource overwrites) et Afficher (View) pour les Déclencheurs (Triggers).

   • Au niveau du processus, cette opération nécessite des autorisations Modifier (Edit) pour les Écrasements de ressources (Resource overwrites), ainsi que les autorisations Afficher (View) et Modifier (Edit) pour les Processus (Processes).

3. Modifiez les détails requis, tels que les connexions ou les filtres de données.
4. Mettez à jour la configuration en cliquant sur Enregistrer (Save).

   Dans l'Assistant, les utilisateurs disposant des autorisations Écrasement des ressources (Resource Overwrites) appropriées peuvent toujours mettre à jour les paramètres que vous avez configurés.

Suppression de la configuration du déclencheur d'événement d'un utilisateur

Pour supprimer les configurations de déclencheur d'événement de vos utilisateurs :

1. Pour le déclencheur de processus ou d'événement souhaité, accédez à la page Configurations utilisateur client (Customer user configurations).
2. Pour le compte utilisateur souhaité, cliquez sur Effacr la configuration (Clear configuration).
   Remarque :

   • Au niveau du déclencheur d'événement, cette opération nécessite les autorisations Modifier (Edit) pour les Écrasements de ressources (Resource overwrites) et Afficher (View) pour les Déclencheurs (Triggers).

   • Au niveau du processus, cette opération nécessite des autorisations Modifier (Edit) pour les Écrasements de ressources (Resource overwrites), ainsi que les autorisations Afficher (View) et Modifier (Edit) pour les Processus (Processes).

   • Cette opération efface les configurations de l'utilisateur sélectionné. Si la configuration d'un utilisateur est supprimée, le processus peut ne pas s'exécuter comme prévu.