Configuration

This setup is required when using the classic Microsoft 365 activities. If you are using the newer Microsoft 365 activities with Integration Service connections, see.…

Introduction

Pour activer les activités Microsoft Office 365, votre application doit être intégrée à la plate-forme d' identité Microsoft et disposer des autorisations d'API Microsoft Graph appropriées.

Pour intégrer votre application, attribuer des autorisations et commencer à créer votre projet d'automatisation, procédez comme suit :

1. Enregistrez votre application.
2. Ajouter des autorisations d'API.
3. Créez votre projet.

Après avoir enregistré votre application Microsoft Office 365, Azure Active Directory attribue un ID d'application (client) unique que vous entrez dans l'activité Étendue Microsoft Office 365 avec les services auxquels vous avez attribué des autorisations (par exemple, fichiers, courrier, calendrier).

Étapes

Enregistrez votre application

1. Connectez-vous au portail Azure à l'aide de votre compte Microsoft Office 365 personnel, professionnel ou scolaire.
2. Dans le panneau de navigation de gauche, cliquez sur Azure Active Directory.
3. Une fois la page Azure Active Directory ouverte, cliquez sur Inscriptions d'applications ( App registrations) .

4. Cliquez sur + Nouvelle inscription (New registration) dans la barre de navigation supérieure.

   
   

   

   
   
5. Saisissez un nom pour votre application (par exemple, «Office365App»).

6. Sous Types de comptes prisen charge , sélectionnez l'option qui s'applique à vous. Pour plus d'informations sur l'option à sélectionner, vous trouverez ci-dessous les recommandations de Microsoft :

   • Comptes uniquement dans cet annuaire de l'organisation (Accounts in this organization directory only) : utilisez cette option si votre public cible est interne à votre organisation.
   • Comptes dans n'importe quel annuaire de l'organisation (Tous les annuaires Azure AD - Multilocataire) : utilisez cette option si votre public cible est constitué de clients professionnels ou éducatifs et pour activer l'architecture mutualisée.
   • Les comptes dans n'importe quel annuaire de l'organisation (N'importe quel annuaire Azure AD - Multitenant) et les comptes Microsoft personnels (par exemple, Skype, Xbox) - Utilisez cette option pour cibler l'ensemble le plus large d'identités Microsoft et pour activer l'architecture multilocataire.

7. Sous URI de redirection (facultatif), saisissez une adresse URI (le cas échéant).

   • Votre sélection dépend de votre type d'authentification. Pour plus d'informations sur ce sujet, consultez la section Automatisation Unattended et Attended dans la page des détails de l'activité Étendue Microsoft 365 (Microsoft 365 Scope).
   • Dans notre exemple, l'organisation prend en charge l'authentification multi-locataires et ne peut utiliser que le type d'authentification par jeton interactif qui nécessite un URI de redirection.
   • Si votre type d'authentification est Authentification Windows intégrée ou Nom d'utilisateur et mot de passe, vous n'avez pas besoin d'enregistrer un URI de redirection pour votre application. Ces flux font un aller-retour vers le point de terminaison v2.0 de la plate-forme d'identité Microsoft, et votre application ne sera pas rappelée sur un URI spécifique.
   • Lorsqu'ils travaillent avec Office 365 dans un projet UiPath Studio ciblant .NET 5.0, les clients doivent ajouter http://localhost à l'URI de redirection de leurs applications personnalisées.

     Pour plus d'informations, voir Enregistrement de l'application de bureau dans la documentation de la plate-forme d'identité Microsoft.

8. Cliquez sur Enregistrer ( Inscrire). Un exemple de configuration est disponible dans la capture d'écran ci-dessous.

   Remarque : cette configuration n'est qu'un exemple. Suivez les étapes décrites dans la documentation et effectuez vos sélections en fonction des politiques de votre organisation.
   
   

   

   
   
   Remarque :

   Aujourd'hui, la bibliothèque d'authentification Microsoft (MSAL.NET) utilise urn:ietf:wg:oauth:2.0:oob comme URI de redirection par défaut et cette valeur fonctionnera probablement pour vous lorsque vous utiliserez le type d'authentification InteractiveToken (nous l'utilisons dans tous nos exemples et guides de démarrage rapide).

   À l'avenir, Microsoft prévoit de remplacer l'URI de redirection par défaut par https://login.microsoftonline.com/common/oauth2/nativeclient, vous pouvez donc envisager de l'utiliser à la place.

Vous avez terminé ! Maintenant, ajoutons des autorisations API à votre application enregistrée.

Ajouter des autorisations d'API

1. Sur la page de votre application enregistrée (Portail Azure > Azure Active Directory > Inscriptions d'applications > Office365App), cliquez sur Autorisations d'API dans le panneau de navigation de gauche.
2. Une fois la page d'autorisation de l'API ouverte, cliquez sur + Ajouter une autorisation (cela ouvre la fenêtre Demander les autorisations de l'API ).
3. Sous Sélectionner une API, cliquez sur API Microsoft (peut être ouvert par défaut).

4. Sous API Microsoft couramment utilisées, cliquez sur Microsoft Graph.

   
   

   

   
   

5. Sous Quel type d'autorisations votre application a-t-elle besoin ?, cliquez sur Autorisations déléguées ou Autorisations d'application pour afficher la liste des autorisations. Les autorisations d'application doivent être définies lorsque la valeur de TypeAuthentification dans l'activité Étendue Microsoft Office 365 est définie sur ApplicationIdAndSecret ou ApplicationIdAndCertificate. Les autres types d'authentification disponibles dans l'activité Étendue Microsoft Office 365 nécessitent des autorisations déléguées.

   Pour plus d'informations sur les types d'autorisation, consultez Configurer une application cliente pour accéder aux API Web dans la documentation Microsoft Azure.

   Important :

   Certaines activités ne prennent pas en charge le type d'authentification ApplicationIdAndSecret ou ApplicationIdAndCertificate (par ex. Rechercher des heures de réunion (Find Meeting Times).

   Pour les activités de messagerie, il est obligatoire de spécifier une valeur pour le paramètre Account (c'est-à-dire quelle boîte aux lettres de toutes les boîtes aux lettres du locataire souhaitez-vous utiliser).

   Lorsque vous utilisez ce type d'authentification, l'application a accès à toutes les boîtes aux lettres de votre locataire, la raison étant que l'autorisation API de l'application Mail.Read signifie Lire les e-mails dans toutes les boîtes aux lettres et Mail.ReadWrite signifie Lire et écrire les e-mails dans toutes les boîtes aux lettres.

   Une solution consiste à restreindre les autorisations de l'application à des boîtes aux lettres spécifiques, afin que l'application n'ait accès qu'aux boîtes aux lettres spécifiées.

   Pour plus d'informations, voir Étendue des autorisations d'application à des boîtes aux lettres Exchange Online spécifiques.

   Utilisez l'autorisation d'application Sites.Selected pour autoriser l'application à accéder uniquement aux collections de sites SharePoint spécifiques plutôt qu'à toutes.

6. Utilisez la barre de recherche ou faites défiler la liste alphabétique vers le bas et sélectionnez les autorisations suivantes :

   • Calendrier

     • Calendars.Read
     • Calendars.ReadWrite

   • Fichiers

     • Fichiers.Lecture
     • Fichiers.Lecture.Tout
     • Fichiers.LectureÉcriture
     • Fichiers.ReadWrite.All

   • Sites

     • Sites.Lus.Tous
     • Sites.Lecture.Écriture.Tout

   • Courrier (Mail)

     • E-mail.Read
     • E-mail.Lecture.Ecriture
     • Envoyer.Mail

   • Partagé\*

     • E-mail.lu.partagé
     • Courrier.Lecture.Écriture.Partagée
     • E-mail.Envoyé.partagé
     • Calendars.Read.Shared

     • Calendars.ReadWrite.Shared

       \* Étendues nécessaires pour accéder aux ressources partagées avec l'utilisateur, mais qui ne lui appartiennent pas.

   • Cliquez sur Ajouter des autorisations (pour revenir à votre liste d' autorisations API)

     
     

     

     
     

7. Vérifiez que vos autorisations API incluent vos autorisations Calendriers, Fichierset E- mail ajoutées.

   
   

   

   
   

Construisez votre projet

1. Créez un nouveau projet d'automatisation.

   • Ouvrez UiPath Studio.
   • Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   • Saisissez un nomde projet , un emplacementet une description.

   • Cliquez sur Créer (Create).

     
     

     

     
     

2. Installez le package UiPath.MicrosoftOffice365.Activities .

   • Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   • Sous Tous les packages, cliquez sur Go!
   • Dans la barre de recherche , entrez Office365.

   • Cliquez sur, installez et acceptez la licence pour UiPath.MicrosoftOffice365.Activities.

     Pour plus d'informations sur les packages Uipath Studio, consultez Gestion des packages dans le Guide de Studio.

     
     

     

     
     

Vous avez terminé !

Maintenant que vous avez terminé la configuration, vous pouvez commencer à ajouter les activités Microsoft Office 365 à votre projet.

Prochaines étapes

Pour une expérience d'apprentissage pratique et pour commencer rapidement à utiliser les activités, consultez les guides de démarrage rapide . Ces guides fournissent des instructions étape par étape pour vous aider à créer des échantillons pratiques des différentes activités afin que vous puissiez vérifier la connexion à votre application enregistrée et vous familiariser avec les propriétés d'entrée/de sortie.

Pour en savoir plus sur les activités Microsoft Office 365 (y compris des exemples d'entrées/sorties de propriétés), consultez la page principale des activités pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.