Set up your Microsoft 365 Azure application

Pour activer les activités classique (classic) Microsoft 365, votre application doit être intégrée à la Plateforme d’identités 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 365, Azure Active Directory lui attribue un ID d'application (client) unique que vous saisissez dans l'activité Étendue Microsoft 365 ( Microsoft 365 Scope ), ainsi que les services auxquels vous avez attribué des autorisations (fichiers, messagerie, agenda, par exemple).

Enregistrez votre application

Tip: This process is described in detail in the Microsoft documentation in Quickstart: Register an application with the Microsoft identity platform. Please note that the Microsoft UI may have changed since these steps were first documented.

1. Connectez-vous au portail Azure à l'aide de votre compte Microsoft 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. Under Supported account types, select the option that applies to you. For more information about which option to select, refer to Who can sign in to you app?:

   • Accounts in this organizational directory only - Use this option if your target audience is internal to your organization. This represents a single tenant application.
   • Accounts in any organizational directory (Any Azure AD directory - Multitenant) - Use this option if your target audience is business or educational customers. This represents a multitenant application.
   • Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox) - Use this option to target the widest set of Microsoft identities. This represents a multitenant application.
7. Under Redirect URI (optional), enter a URI address (if applicable). The Microsoft Authentication Library (MSAL.NET) uses a default redirect URI: https://login.microsoftonline.com/common/oauth2/nativeclient. This value will likely work for you when using the Interactive Token authentication type.
   • Your selection is dependent on your authentication type. For more information on this topic, see How to connect to Microsoft 365 activities).
   • In our example, the organization supports multi-tenant authentication and can only use the Interactive Token authentication type which requires a redirect URI.
     • If you use Interactive Token and the default Microsoft Redirect URI, you must add a platform of type Mobile and desktop applications. For more information, see Configure platform settings in the Microsoft documentation.
     • If your authentication type is Integrated Windows Authentication or Username and Password, you don't need to register a redirect URI for your application. These flows do a round trip to the Microsoft identity platform v2.0 endpoint, and your application won't be called back on any specific URI.
   • When working with Microsoft 365 in a UiPath Studio project targeting .NET 5.0, add http://localhost to the Redirect URI of your custom applications.

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

8. Select Register. An example configuration is available in the image below.

   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.
   
   

   

   
   

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

Ajouter des autorisations d'API

1. Sur votre page d'application enregistrée (Portail Azure > Azure Active Directory > Inscriptions d'application > Office365App), sélectionnez Autorisations d'API ( API permissions ) 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. Under What type of permissions does your application require?, click Delegated permissions or Application permissions to show the list of permissions. Select Application permissions if you are using ApplicationIdAndSecret or ApplicationIdAndCertificate authentication type. The other authentication types available in Microsoft 365 Scope activity require Delegated permissions.

   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.

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

   Note: These permissions are not all mandatory. The provided list represents the complete set of permissions required to run all Microsoft 365 activities. You can restrict permissions depending on your particular use case. Check out the activities documentation pages to learn what permissions they need.

   • 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
   • Utilisateurs
     • User.Read

   • Shared (scopes needed to access resources that are shared with, but not owned by, the user.)

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

   • Select Add permissions to return to your list of API permissions.

     
     

     

     
     

7. Make sure your API permissions include your added Calendars, Files, User, and Mail permissions.

   
   

   

   
   

Construire votre projet dans Studio Desktop

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

   1. Ouvrez UiPath Studio.

   2. Under New Project, click Process. This opens a New Blank Process window.

   3. Saisissez un nomde projet , un emplacementet une description.

   4. Choisissez la compatibilité. Windows est sélectionné par défaut.

   5. Cliquez sur Créer (Create).

2. Installez le package UiPath.MicrosoftOffice365.Activities .

   1. From the Design ribbon, select Manage Packages.
   2. Sous Tous les packages, dans la barre de recherche , saisissez Office 365 ou Microsoft.
   3. Select the package version you want, then select Install.
   4. Cliquez sur le bouton Enregistrer (Save).
   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 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.

To learn more about the Microsoft 365 activities (including example property inputs/outputs), see the Classic activities for a complete list and links to the activity detailed pages.