Set up your Microsoft 365 Azure application

Para habilitar las actividades clásicas de Microsoft 365, tu aplicación debe estar integrada con la plataforma de identidad de Microsoft y tener los permisos correctos de la API de Microsoft Graph asignados a ella.

Para integrar su aplicación, asignar permisos y comenzar a crear su proyecto de automatización, complete los siguientes pasos:

1. Registre su aplicación.
2. Agrega permisos de API.
3. Construya su proyecto.

Después de registrar tu aplicación Microsoft 365, Azure Active Directory asigna un ID de aplicación (cliente) único que introduces en la actividad Ámbito de Microsoft 365 junto con los servicios a los que has asignado permisos (p. ej., archivos, correo, calendario).

Registre su aplicación

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. Inicia sesión en el portal de Azure utilizando tu cuenta de Microsoft 365 personal, de trabajo o educativa.
2. En el panel de navegación de la izquierda, haz clic en Azure Active Directory.
3. Una vez que se abra la página de Azure Active Directory , haz clic en Registros de aplicaciones.

4. Haga clic en + Nuevo registro en la barra de navegación superior.

5. Introduzca un nombre para su aplicación (por ejemplo, "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.

     Para obtener más información, consulta Registro de aplicaciones de escritorio en la documentación de la plataforma de identidad de Microsoft.

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

   Nota: esta configuración es solo un ejemplo. Sigue los pasos descritos en la documentación y realiza selecciones según las políticas de tu organización.
   
   

   

   
   

¡Listo! Ahora, agreguemos permisos de API a su aplicación registrada.

Agregar permisos de API

1. Desde la página de tu aplicación registrada (Portal de Azure > Azure Active Directory > Registros de aplicaciones > Office365App), selecciona Permisos de API en el panel de navegación de la izquierda.
2. Una vez que se abra la página de permisos de API, haz clic en + Añadir un permiso (se abre la ventana Solicitar permisos de API ).
3. En Seleccionar una API, haz clic en API de Microsoft (puede estar abierto de forma predeterminada).

4. En API de Microsoft usadas habitualmente, haz clic en 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.

   Para obtener más información sobre los tipos de permisos, consulta Configurar una aplicación cliente para acceder a las API web en la documentación de Microsoft Azure.

6. Use la barra de búsqueda o desplácese hacia abajo en la lista alfabética y seleccione los siguientes permisos:

   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.

   • Calendario

     • Calendarios. Leer
     • Calendarios. LeerEscribir

   • Archivos

     • Archivos. Leer
     • Archivos.leer.todos
     • Archivos.LeerEscribir
     • Archivos.leerEscribir todo

   • Sitios

     • Sitios. Leer.todos
     • Sitios. LeerEscribir.todo

   • Correo

     • Correo. Leer
     • Mail.ReadWrite
     • Correo.Enviar
   • Usuarios
     • User.Read

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

     • Correo.Leer.Compartido
     • Correo.LeerEscribir.Compartido
     • Correo.Enviar.Compartido
     • Calendarios.Leer.Compartido
     • Calendarios.LeerEscribir.Compartir

   • 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.

   
   

   

   
   

Cree su proyecto en Studio Desktop

1. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.

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

   3. Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.

   4. Elija la compatibilidad. Windows está seleccionado de forma predeterminada.

   5. Haz clic en Crear.

2. Instale el paquete UiPath.MicrosoftOffice365.Activities .

   1. From the Design ribbon, select Manage Packages.
   2. En Todos los paquetes, en la barra de búsqueda , escribe Office 365 o Microsoft.
   3. Select the package version you want, then select Install.
   4. Haz clic en el botón " Guardar ".
   Para obtener más información sobre los paquetes de UiPath Studio, consulta Gestionar paquetes en la Guía de Studio.

¡Ya está! Ahora que has completado la configuración, puedes empezar a añadir las actividades de Microsoft 365 a tu proyecto.

Próximos pasos

Para una experiencia de aprendizaje práctica y para empezar a utilizar rápidamente las actividades, consulta las guías de inicio rápido . Estas guías proporcionan instrucciones paso a paso para ayudarte a crear ejemplos de trabajo de las diferentes actividades para que puedas verificar la conexión a tu aplicación registrada y familiarizarte con las propiedades de entrada / salida.

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.