Cómo crear una aplicación para las conexiones de ámbito de Microsoft 365

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

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

Consejo: este proceso se describe en detalle en la documentación de Microsoft en Inicio rápido: registrar una aplicación con la plataforma de identidad de Microsoft. Ten en cuenta que la interfaz de usuario de Microsoft puede haber cambiado ya que estos pasos se documentaron por primera vez.

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. En Tipos de cuentas compatibles, selecciona la opción que se aplica a ti. Para obtener más información sobre qué opción seleccionar, consulta ¿Quién puede iniciar sesión en tu aplicación?:

   • Solo Cuentas en este directorio organizativo: utiliza esta opción si tu público objetivo es interno a tu organización. Esto representa una única aplicación de tenant.
   • Cuentas en cualquier directorio organizativo (Cualquier directorio Azure AD - Multitenant): utiliza esta opción si tu público objetivo son clientes empresariales o educativos. Esto representa una aplicación multitenant.
   • Cuentas en cualquier directorio organizativo y cuentas personales de Microsoft (por ejemplo, Skype, Xbox): utiliza esta opción para dirigirse al conjunto más amplio de identidades de Microsoft. Esto representa una aplicación multitenant.
7. En URI redireccionamiento (opcional), introduce una dirección URI (si corresponde). La biblioteca de autenticación de Microsoft (MSAL.NET) utiliza un URI de redirección predeterminado: https://login.microsoftonline.com/common/oauth2/nativeclient. Este valor probablemente funcione para ti al utilizar el tipo de autenticación de token interactivo.
   • Tu selección depende de tu tipo de autenticación. Para obtener más información sobre este tema, consulta ).
   • En nuestro ejemplo, la organización admite la autenticación multitenant y solo puede utilizar el tipo de autenticación que requiere un URI de redirección.
     • Si utilizas el token interactivo y el URI de redirección de Microsoft predeterminado, debes añadir una plataforma de tipo Aplicaciones móviles y de escritorio. Para obtener más información, consulta Configurar la configuración de la plataforma en la documentación de Microsoft.
     • Si tu tipo de autenticación es o , no es necesario registrar un URI de redirección para tu aplicación. Estos flujos hacen un viaje de ida y vuelta al punto final de la plataforma de identidad v2.0 de Microsoft y tu aplicación no se llamará en ningún URI específico.
   • Al trabajar con Microsoft 365 en un proyecto de UiPath Studio dirigido a .NET 5.0, añade http://localhost al URI redireccionamiento de tus aplicaciones personalizadas.

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

8. Selecciona Registrar. Una configuración de ejemplo está disponible en la siguiente imagen.

   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. En ¿Qué tipo de permisos requiere tu aplicación?, haz clic en Permisos delegados o Permisos de aplicación para mostrar la lista de permisos. Selecciona Permisos de aplicación si utilizas el tipo de autenticación ApplicationIdAndSecret o ApplicationIdAndCertificate. Los otros tipos de autenticación disponibles en la actividad Ámbito de Microsoft 365 requieren permisos delegados.

   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:

   Nota: estos permisos no todos son obligatorios. La lista proporcionada representa el conjunto completo de permisos necesarios para ejecutar todas las actividades de Microsoft 365. Puedes restringir los permisos dependiendo de tu caso de uso en particular. Consulta las páginas de documentación de actividades para aprender qué permisos necesitan.

   • 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

   • Compartidos (ámbitos necesarios para acceder a recursos que se comparten con, pero no son propiedad del usuario).

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

   • Selecciona Añadir permisos para volver a tu lista de permisos de API.

     
     

     

     
     

7. Asegúrate de que tus permisos de API incluyan tus permisos añadidos de Calendarios, Archivos, Usuario y Correo.

   
   

   

   
   

Cree su proyecto en Studio Desktop

1. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.

   2. En Nuevo proyecto, haz clic en Proceso. Esto abre una ventana Nuevo proceso en blanco.

   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. Desde la cinta Diseño, selecciona Gestionar paquetes.
   2. En Todos los paquetes, en la barra de búsqueda , escribe Office 365 o Microsoft.
   3. Selecciona la versión del paquete que deseas y luego selecciona Instalar.
   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.

Para obtener más información sobre las actividades de Microsoft 365 (incluidas las entradas/salidas de propiedades de ejemplo), consulta las actividades clásicas para obtener una lista completa y enlaces a las páginas detalladas de la actividad.