Créer des connexions pour les services dans les automatisations codées

Cette section vous permet de créer les connexions requises pour accéder aux API à partir de services qui utilisent des connexions tels que GSuite.Activities et Excel.Activities dans des automatisations codées.

Commencez par créer une connexion dans Integration Service. Les connexions sont accessibles au sein de la même organisation et du locataire de votre projet d’automatisation codé. Dans l’automatisation codée, utilisez l’objet connections pour accéder aux connexions créées précédemment dans Integration Service, puis accédez aux API correspondantes.

Après avoir terminé l’automatisation et l’avoir publiée dans Orchestrator, vous pouvez remplacer les configurations de connexion d’origine configurées dans le code, si nécessaire.

Prérequis

Créez une connexion dans Integration Service :

1. Accédez à Integration Service et sélectionnez le locataire auquel Studio est connecté.
2. Accédez à Connexions.
3. Sélectionnez Ajouter une connexion et créez une connexion pour l’une des applications suivantes :
   • Google Drive
   • Gmail
   • Google Sheets
   • Microsoft Office 365

Étapes

1. Ouvrez une automatisation codée existante à partir de la même organisation et du même locataire où vous avez initialement créé votre connexion.
2. Dans le corps Execute(), tapez connections, puis appuyez sur Ctrl + Space pour afficher les connexions disponibles.
   En fonction de l’application pour laquelle vous avez précédemment créé connection, vous pouvez choisir l’un des types de connexion suivants :

   • G Drive
   • Gmail
   • Google Sheets
   • Excel
   • OneDrive
   • O365Mail
3. Procédez à une configuration plus avancée de votre connexion en ajoutant le nom du dossier et du sous-dossier Orchestrator, ainsi que l’adresse de connexion spécifique que vous souhaitez. Utilisez des traits de soulignement pour séparer ces informations.
   Par exemple, une connexion Gmail pour le dossier My Workspace et le sous-dossier My Gmail Worskapce dans Orchestrator, ainsi que pour l’adresse [e-mail], serait représentée selon le code suivant : connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com.

   Recommandation

   Nous vous recommandons de créer vos connexions en une seule étape pour éviter les erreurs potentielles. Nous vous recommandons également de créer une variable pour la connexion. De cette façon, si des modifications surviennent dans Integration Service, vous éviterez de mettre à jour chaque instance de la connexion tout au long de votre automatisation. Utilisez l'approche suivante :

   var myGmailConnection = connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

   Évitez de créer vos connexions en deux étapes distinctes telles que :

   var myGmailConnection = connections.Gmail;
   myGmailConnection.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

4. Une fois que vous avez établi le connection, vous pouvez accéder aux API pertinentes spécifiques à un service via cette connection.
   Par exemple, si vous avez configuré une connexion Gmail comme suit : var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com, vous pouvez utiliser l'API du service à l'aide de myGmailConnection.

Remplacer la connexion dans Orchestrator

1. Publiez à nouveau le projet dans Orchestrator.
2. Accédez au flux Orchestrator où vous avez publié le projet.
3. Accédez au processus publié et sélectionnez Modifier(Edit).
4. Dans Configuration du processus, choisissez l’automatisation codée contenant votre connexion configurée en tant que point d’entrée.
5. Dans Exigences du package ( Package Requirements), recherchez et sélectionnez le type de connexion correspondant pour votre automatisation codée.

   Veillez à sélectionner le type de connexion de votre automatisation codée, car les connexions des fichiers XAML de votre projet apparaissent également dans la liste.

6. Identifiez et sélectionnez l'adresse du compte que vous prévoyez d'associer à la connexion lors de son exécution.

Limites connues

La connexion par défaut d’une bibliothèque exportée fonctionnera dans d’autres projets, uniquement si le projet importé se trouve dans le même locataire que le projet de bibliothèque d’origine.