Gestion des actifs dans Orchestrator

Création d'actifs

1. Sur la page Ressources (Assets), sélectionnez Ajouter (Add). La fenêtre Ajouter une ressource (Add Asset) s’affiche.
2. Dans le champ Nom de l'actif (Asset name), entrez un nom pour l'actif.
3. Dans la liste Type (Type), sélectionnez le type d'actif à créer.
4. Ajoutez une Description de l'actif.
5. Select the desired access scope from the Access scope section.
   • Automations only: allows asset values to be retrieved exclusively within automation related contexts.
   • Automations and API: allows asset values to be retrieved programatically via APIs and integrations, without requiring an automation context.
6. À partir de la liste Magasins d’informations d’identification (Credential Store), sélectionnez où cette ressource est stockée dans l’un de vos magasins d’informations d’identification définis.
7. Utilisez le bouton bascule Valeur globale (Global Value ) pour indiquer si cette ressource a une valeur par défaut (utilisée lorsqu'aucune valeur spécifique par compte/par compte-machine n'existe).
   • Si cette option est activée, dans le champ Valeur (Value), saisissez le contenu de la ressource. Si le type de ressource est booléen, sélectionnez Vrai (True) ou Faux (False), et s'il s'agit d'informations d’identification, saisissez le Nom d'utilisateur (Username) et le Mot de passe (Password).
   • S'il est désactivé, vous devez fournir au moins une valeur de ressource spécifique au compte.
8. Utilisez le bouton Ajouter une valeur d'actif de robot pour créer les valeurs d'actif par compte ou par compte-machine souhaitées.
9. Sélectionnez Créer. La ressource est créée et affichée sur la page Ressources (Assets).
   Remarque :

   • Une fois qu’un actif est créé, vous ne pouvez pas en modifier le type.
   • Si vous créez des ressources d'informations d'identification ou de secret à valeur globale avec le même nom Orchestrator et le même nom externe dans plusieurs dossiers Orchestrator, ces ressources pointent vers un même objet dans le magasin d'informations d'identification. Par conséquent, toute modification que vous apportez à la ressource contenue dans l'un des dossiers Orchestrator affecte les ressources portant un nom identique dans les autres dossiers Orchestrator. Pour éviter toute modification accidentelle des ressources d'informations d'identification ou de secret portant le même nom dans les dossiers Orchestrator, nommez la ressource de chaque dossier avec un nom différent. Cela garantit que les ressources pointent vers des objets différents dans le magasin d'informations d'identification.

Champ	Description
Nom de l'actif (Asset name)	Un nom personnalisé de l'actif, pour vous aider à l'identifier facilement. Ne peut pas dépasser 256 caractères.
Saisie de texte	Le type d'actif. Les options suivantes sont disponibles : Text : ressources qui peuvent stocker des valeurs sous forme de chaînes de caractères. Il s'agit de l'option par défaut. Bool : ressources qui peuvent stocker une valeur True ou False. Si vous sélectionnez cette option, le champ Valeur affiche deux cases d'option ( Vrai , Faux , Faux ). Integer (Entier) : ressources qui peuvent stocker des nombres entiers. Informations d’identification : ressources qui peuvent stocker les informations d’identification. Si vous sélectionnez cette option, le champ Value est remplacé par deux autres champs : Username , qui ne peut pas dépasser 512 caractères, et Password , qui ne peut pas dépasser 25 000 caractères. Secret : les ressources qui peuvent stocker des secrets, tels que les clés API. Saisissez la valeur du secret dans le champ Secret . Le secret ne peut pas dépasser 25 000 caractères. Remarque : vous ne pouvez actuellement utiliser des ressources de type secret qu'en conjonction avec des agents codés, indiqués sous la forme Agent ()<programming language> . Aucun type de processus dont le package sous-jacent est créé par Studio ne prend actuellement en charge les ressources de type secret.
Access scope	Defines where the asset value can be accessed from. Use this setting to control whether the asset is available only within automation workflows or also through APIs and integrations. The following options are: Automations only: the asset value can be used only within automation workflows. Automations and API: the asset value can also be accessed programmatically through APIs and integrations.
Magasin d'identifiants	Disponible uniquement lorsque vous ajoutez des informations d'identification ou des ressources de secret. Le magasin d’informations d’identification dans lequel la ressource sera enregistrée, qu’il s’agisse de la base de données Orchestrator native ou de l’un de vos magasins externes créés. Remarque : vous ne pouvez pas récupérer les ressources de type secret à partir d'un magasin d'informations d'identification externe lorsque vous utilisez un proxy déconnecté.
Nom externe	Disponible uniquement lorsque vous ajoutez des informations d'identification ou des ressources de secret à un magasin d'informations d'identification. Le nom de la ressource à utiliser lors de la communication avec le magasin d'informations d'identification.
Valeur globale	Une ressource à valeur globale est reçue par tous les comptes, à l'exception de ceux dont les valeurs sont spécifiques (définies à l'aide du bouton Add robot asset value (Ajouter la valeur de la ressource du robot). Lorsque cette option est activée, vous devez entrer la valeur globale reçue par les comptes : Pour les ressources Booléen (Bool), deux cases d'option, Vrai (True) et Faux (False), sont affichées. Par défaut, l'option Faux (False) est sélectionnée. Pour les ressources Credential (Informations d'identification), les champs User Name (Nom d'utilisateur) et Password (Mot de passe) sont activés. Vous devez remplir les deux champs. Pour les ressources Secret, vous devez entrer une valeur dans le champ Secret. Pour les ressources de texte, ce champ autorise jusqu'à 1 000 000 caractères.
Ajouter une valeur de ressource de robot	Vous permet d'ajouter des valeurs de ressources spécifiques par compte ou par compte-machine. Lorsque vous n'utilisez pas l'option Valeur globale (Global Value), vous devez configurer au moins une valeur spécifique. Si une valeur globale est fournie, l'ajout de valeurs spécifiques est facultatif. Pour les ressources Booléen (Bool), deux cases d'option, Vrai (True) et Faux (False), sont affichées. Par défaut, l'option Faux (False) est sélectionnée. Pour les ressources Credential (Informations d'identification), les champs User Name (Nom d'utilisateur) et Password (Mot de passe) sont activés. Vous devez remplir les deux champs. Pour les ressources Secret, vous devez entrer une valeur dans le champ Secret. Pour les ressources de texte, ce champ autorise jusqu'à 1 000 000 caractères.

Gestion des liens de ressources

Le partage de ressources entre les dossiers permet de lancer des tâches dans plusieurs dossiers sans devoir concevoir une nouvelle fois vos workflows dans Studio lorsque les processus sous-jacents ont pour cible la même ressource. Lier une ressource à un dossier rend la ressource et tous les objets associés à la ressource, tels que les éléments de ressources, disponibles dans ce dossier.

Important :

Vous ne pouvez partager que des actifs avec des valeurs globales et aucune valeur spécifique par compte. Vous ne pouvez pas partager des ressources avec des valeurs par compte entre les dossiers.

Remarque :

An asset linked to multiple folders is marked using the icon. If the icon is not present, then the current folder is the only folder the asset resides in. Deleting it here completely removes the asset from Orchestrator. You need the Assets - Create permission in the folders where you want to add the asset (target folders) and Assets - View in the folder where the asset currently resides (original folder). If you have Assets - Edit in the target folder, you do not need Assets - Edit in the original folder. Once an asset is shared to a folder, users with Assets - Edit in the destination folder can edit the asset, and the changes will apply globally.

Relier plusieurs ressources au dossier actuel

1. Dans le dossier auquel vous souhaitez lier une ressource, sur la page Ressources (Assets), cliquez sur Ajouter (Add). Trois boutons s'affichent, vous permettant d'ajouter une ressource, de lier des ressources à partir d'autres dossiers ou de masquer les options.
2. Sélectionnez Lier depuis d'autres dossiers. La fenêtre Lier les ressources (Link Assets) s'affiche et affiche une liste de tous les ressources des dossiers dans lesquels vous disposez des autorisations Consultation (View) pour les ressources.

Figure 1. Lier des ressources d'autres dossiers

3. Dans la section Sélectionner des ressources (Select Assets), sélectionnez une ou plusieurs ressources dans la liste.
4. Sélectionnez continuer (continue). Vous êtes redirigé vers la section Validation du dossier (Folder Validation). Ici, vous pouvez voir les dossiers auxquels les ressources sont déjà liées. S'il y a plusieurs dossiers, leurs noms sont affichés.

Figure 2. Valider le dossier

5. Sélectionnez Supprimer pour la ressource correspondante pour annuler la modification ou cliquez sur Quitter pour annuler l'opération.
6. Sélectionnez Lier si vous souhaitez établir le lien entre les ressources que vous avez sélectionnées et le dossier actuel. Les ressources s'affichent sur la page Ressources.

Lier une ressource à plusieurs dossiers

1. Accédez à un dossier contenant la ressource à lier.

Sélectionnez Autres actions > Gérer les liens de la ressource souhaitée pour ouvrir la fenêtre Gérer les liens. La fenêtre Gérer les liens de la ressource s'affiche.

Figure 3. Gérer les liens de la ressource

1 - Le volet de gauche affichant tous les dossiers pour lesquels vous avez reçu des autorisations Consultation (View) pour les ressources.

2 - L'état actuel de la ressource affichant le nombre de dossiers dans lesquels elle se trouve ainsi que leurs noms.

3 - Les dossiers dans lesquels la ressource doit être ajoutée selon votre sélection dans le volet de gauche.

4 - Les dossiers dont la ressource sera supprimée.

1. Sélectionnez Update (Mettre à jour). Une fenêtre de confirmation s'affiche.
2. Sélectionnez Annuler si vous souhaitez annuler les modifications ou Continuer pour que les modifications prennent effet. Les opérations sont désormais appliquées à Orchestrator conformément à vos modifications.

Dissociation des ressources des dossiers

La dissociation des ressources des dossiers peut être effectuée d'une manière similaire à l'opération de liaison. Accédez aux zones de gestion des liens présentées dans les procédures ci-dessus et supprimez les connexions entre la ressource et le dossier de votre choix.

Vous pouvez également supprimer une ressource à l'aide de la fonctionnalité Supprimer (Remove). Voir Suppression d'un actif.

Important :

La suppression d'une ressource existant dans plusieurs dossiers ne la supprime que du dossier dans lequel l'opération de suppression a lieu, sans la supprimer des autres dossiers. Afin de supprimer complètement une ressource, vous devez supprimer tous ses liens existants.

Modification des actifs

Pour modifier une ressource, cliquez sur le bouton Autres actions > Modifier , effectuez les modifications nécessaires et cliquez sur Mettre à jour dans la fenêtre Mettre à jour la ressource . Vous pouvez uniquement modifier la valeur et le nom de la ressource. Toutes les modifications sont vérifiées et peuvent être consultées sur la page Audit . Si vous modifiez le nom d'utilisateur ou une ressource d'informations d’identification, vous devez également modifier le mot de passe.

Suppression des valeurs de ressource par utilisateur et par robot

Vous pouvez supprimer les valeurs de ressource définies pour des utilisateurs ou des robots spécifiques directement à partir de l’éditeur de ressources.

1. Ouvrez Ressources.
2. Créez une nouvelle ressource ou modifiez une ressource existante.
3. Dans la section Valeur de la ressource, choisissez la valeur que vous souhaitez supprimer.
4. Sélectionnez Supprimer.
5. Sélectionnez Supprimer dans la boîte de dialogue de confirmation.

Vous pouvez également sélectionner plusieurs entrées et les supprimer simultanément à l’aide de l’option Supprimer dans l’en-tête de la grille.

Ajout de balises aux ressources

Remarque :

Vous avez besoin de l'autorisation Modification (Edit) par rapport aux ressources et Consultation (View) par rapport aux balises pour ajouter des balises existantes aux ressources. Vous avez besoin de l'autorisation Modification (Edit) et Création (Create) par rapport aux balises pour ajouter de nouvelles balises aux ressources.

Remarque :

• Chaque ressource peut avoir jusqu'à un million de paires clé/valeur.
• Les étiquettes et les propriétés clé/valeur sont limitées à 256 caractères.
• Les noms de balise ne peuvent pas contenir ces caractères : <, >, %, &, , ?, /, :.

Vous pouvez appliquer des balises à une ressource lors de sa création ou de la modification d'une ressource existante. Pour ajouter des balises à une ressource lors de sa modification, suivez ces étapes :

1. Sur la page Ressources (Assets), cliquez sur Plus d'actions (More Actions) > Modifier (Edit) en regard de la ressource souhaitée. La ressource est ouverte pour modification.
2. Dans le champ Étiquettes (Labels), commencez à saisir le nom de l'étiquette. Vous pouvez choisir une étiquette existante ou en créer une.
3. Dans le champ Propriétés (paires clé-valeur) (Properties (key-value pairs)), cliquez sur Ajouter nouveau (Add new).
4. Ajoutez de nouvelles clés et valeurs. Vous pouvez choisir des clés et/ou valeurs existantes, ou vous pouvez en créer.
5. Une fois terminé, cliquez sur Mettre à jour (Update). Votre ressource est mise à jour et les balises nouvellement créées, le cas échéant, deviennent disponibles pour d'autres objets.

Suppression de balises des ressources

Pour supprimer des balises d'une ressource, suivez ces étapes :

1. Sur la page Ressources (Assets), cliquez sur Plus d'actions (More Actions) > Modifier (Edit) en regard de la ressource souhaitée. La ressource est ouverte pour modification.
2. Dans le champ Étiquettes (Labels), cliquez sur le X adjacent au nom de l'étiquette pour la supprimer. L'étiquette est supprimée.
3. Dans le champ Propriétés (paires clé-valeur) (Properties (key-value pairs)), cliquez sur le X adjacent aux clés et/ou valeurs pour les supprimer. Les clés et/ou valeurs sont supprimées.
4. Pour supprimer une paire clé/valeur, cliquez sur l'icône Supprimer (Remove) correspondant à cette entrée. La paire clé/valeur est supprimée.
5. Une fois terminé, cliquez sur Mettre à jour (Update). Votre ressource est mise à jour et les balises sont supprimées

Suppression des actifs

To remove an asset, click More Actions > Remove.

Vous pouvez également sélectionner un ou plusieurs actifs et cliquer sur Supprimer (Remove).