Ámbito de Microsoft Office 365

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

Descripción

Utiliza la plataforma de identidad de Microsoft para establecer una conexión autenticada entre UiPath y tu aplicación Microsoft 365. Esta conexión autenticada permite a un Robot llamar a la API de Microsoft Graph para leer y escribir recursos en tu nombre.

Importante: a partir de la versión 2.5.5, puedes utilizar las actividades de Microsoft 365 más recientes dentro de la actividad Ámbito. Para aprender a utilizar las actividades de Integration Service con Ámbito de Microsoft 365, consulta Cómo utilizar las actividades de Microsoft 365 sin las conexiones de Integration Service.

Compatibilidad de proyectos

Windows: heredado | Windows

Configuración

Consejo: esta página explica los parámetros de autenticación disponibles en la actividad Ámbito de Microsoft 365. Para obtener más información sobre cada opción de autenticación, consulta la guía Cómo conectarse a las actividades de Microsoft 365.

Para empezar a configurar esta actividad, debes seleccionar primero un método de conexión. Dependiendo del método seleccionado, se muestran diferentes campos en el panel Propiedades.

• Método de conexión : selecciona el método de conexión que deseas utilizar. Las opciones disponibles en el menú desplegable son:
  • Panel de propiedades : configura los detalles de la conexión en el panel de propiedades.
  • Activo : utiliza activos de credenciales de Orchestrator. Te recomendamos que utilices esta opción.

Método de conexión de activos

Nota: al seleccionar esta opción, la mayoría de los campos de autenticación generalmente se muestran en el panel Propiedades se ocultan, porque la información de autenticación se almacena dentro del activo.

• Activos de conexión : explora las carpetas de Orchestrator para seleccionar un activo. Este campo admite variables IResource . Selecciona el botón Administrar activos para abrir Orchestrator. La lista de activos disponibles depende del Orchestrator al que estén conectados Studio y UiPath Robot.
  • Utiliza el menú del botón Más para seleccionar Volver a cargar activos si has actualizado tus activos en Orchestrator. Ten en cuenta que si añades un nuevo activo en Orchestrator mientras utilizas Studio Desktop, no estará disponible de inmediato en la actividad Ámbito.

• Consulta el formato de activo en Cómo utilizar las actividades de Microsoft 365 sin conexiones de Integration Service.

Dependiendo del tipo de autenticación configurado en el activo, también debes configurar los siguientes campos disponibles en el panel Propiedades:

Autenticación

• Dirección de correo electrónico del usuario suplantado: la dirección de correo electrónico del usuario suplantado. Se utiliza para los métodos de autenticación ID de aplicación y ID de aplicación secreto y certificado.

Nombre de usuario y contraseña (desatendido)

• Nombre de usuario: el nombre de usuario de tu cuenta de Microsoft 365. Se utiliza para el método de autenticación de Nombre de usuario y Contraseña.
• Contraseña: la contraseña de tu cuenta de Microsoft 365.

Común

• TiempoDeEspera : especifica la cantidad de tiempo de espera (en milisegundos) para que se complete la autenticación interactiva (cuadro de diálogo de consentimiento) antes de que se produzca un error. Este campo solo admite variables enteras y Int32 . El valor predeterminado es 30 000 ms (30 segundos).

Tiempo de ejecución

• Activos de conexión de Runtime : navega para seleccionar un activo. Este campo te permite seleccionar un activo diferente para el tiempo de ejecución. Utiliza el menú del botón Más para seleccionar Ruta relativa e introduce la ruta completa del activo de Orchestrator que contiene los detalles de la conexión.

Método de conexión del panel de propiedades

Nota: al seleccionar esta opción, debes configurar los campos de autenticación disponibles en el panel Propiedades.

En primer lugar, configura los siguientes campos:

• Conexiones : selecciona una cuenta de la lista. Puedes añadir, eliminar y elegir qué conexiones usar.
• Ámbitos de autenticación : consulta la sección Uso del asistente de Ámbitos de autenticación a continuación.

Uso del asistente de Ámbitos de autenticación

Nota: este asistente reemplaza el parámetro Servicios disponible en versiones anteriores de este paquete. El asistente Alcances de autenticación está disponible al utilizar la autenticación de token interactivo.

La actividad Ámbito incorpora un selector de permisos universal, que ofrece una imagen clara de todos los ámbitos de autenticación utilizados, que las actividades necesitan para funcionar correctamente.

Todas las actividades secundarias incluidas en la actividad Ámbito de Microsoft 365 se detectan automáticamente como ámbitos necesarios.

Si no se seleccionan ámbitos manualmente desde el asistente de Ámbitos, la función Detección automática se aplica de forma predeterminada en el tiempo de ejecución, y se elimina la necesidad de configurar el asistente. Todos los ámbitos mínimos necesarios se seleccionan en tiempo de ejecución.

También puedes añadir un ámbito manualmente después de añadir una actividad secundaria al Ámbito de Microsoft 365.

A continuación, debes seleccionar el Tipo de autenticación en el panel Propiedades y configurar los campos necesarios para tu método de autenticación preferido. Las siguientes secciones enumeran los campos disponibles en cada menú.

Autenticación

• Tipo de autenticación: el tipo de autenticación necesaria para tu aplicación registrada. Selecciona una de las cinco opciones: token interactivo, Autenticación integrada de Windows (IWA), Nombre de usuario y contraseña, ID y secreto de la aplicación o ID de la aplicación y certificado. El valor predeterminado es Token interactivo.
• Entorno: el entorno. Azure Global o nubes nacionales que son entornos únicos y separados de Azure Global. Selecciona una de las cinco opciones: Predeterminado, Global, China, Alemania o USGovernment. El valor predeterminado es Global.
• ID de aplicación: el ID único de la aplicación (cliente) asignado por Azure Active Directory al registrar tu aplicación durante la configuración.El ID de la aplicación (cliente) representa una instancia de una aplicación de Microsoft 365.
• Tenant: el ID único del directorio (tenant) asignado por Azure Active Directory al registrar tu aplicación durante la configuración.Necesario para las aplicaciones de tenant múltiple y Autenticación integrada de Windows. El ID del directorio (tenant) se puede encontrar en la página de descripción general de tu aplicación registrada (debajo del ID de la aplicación (cliente)).
• Dirección de correo electrónico del usuario suplantado: la dirección de correo electrónico del usuario suplantado. Se utiliza en escenarios unattended (para métodos de autenticación de ID de aplicación y secreto e ID de aplicación y certificado).

Token interactivo

Nota: Este es el mismo método de autenticación admitido en Integration Service, ya sea a través de la aplicación pública de UiPath o de una aplicación privada personalizada (método Trae tu propia aplicación).

Para obtener más información, consulta Token interactivo.

• Aplicación OAuth: indica la aplicación (cliente) que se utilizará. Este campo solo admite variables OAuthApplication. Selecciona una de las dos opciones:
  • UiPath: predeterminado. Cuando deseas utilizar la aplicación creada por UiPath (registro público de la aplicación de UiPath).Si se selecciona, se ignoran los campos IDDeLaAplicación y Tenant proporcionados en la sección Autenticación.
  • Personalizado: cuando deseas crear tu propia aplicación con permisos específicos. En este caso, debes establecer un valor para el campo ID de aplicación. Consulta Cómo crear una aplicación para conexiones de Microsoft 365 Scope.

ID de aplicación y Certificado (desatendido)

Para obtener más información, consulta ID de aplicación y Certificado.

• Certificado como Base64: la representación Base64 del certificado.

• Contraseña del certificado : una contraseña opcional que puede ser necesaria para utilizar el certificado, como Secure String.

Application ID and Secret (Unattended)

Para obtener más información, consulta ID de aplicación y Secreto.

• Secreto de la aplicación : la cadena secreta que la aplicación utiliza para proporcionar su identidad.
• Secreto deaplicación segura: el secreto de la aplicación (cliente), como SecureString.

Nombre de usuario y contraseña (desatendido)

Para obtener más información, consulta Nombre de usuario y Contraseña.

Importante: Microsoft ha dejado obsoleta la autenticación básica para Exchange en línea. Esto afecta a algunas de nuestras actividades, como el ámbito de Microsoft Office365. Recomendamos utilizar el protocolo OAuth en las actividades que lo admiten.

• Contraseña: la contraseña de tu cuenta de Microsoft 365.
• Contraseña segura : la contraseña de tu cuenta de Microsoft 365, como SecureString.
• Nombre de usuario: el nombre de usuario de tu cuenta de Microsoft 365.

Común

• LímiteDeTiempoEnMilisegundos: especifica la cantidad de tiempo que se debe esperar (en milisegundos) para que la autenticación interactiva (cuadro de diálogo de consentimiento) se complete antes de que se lance un error. Este campo solo admite números enteros y variables Int32. El valor predeterminado es 30 000 ms (30 segundos) (no se muestra).
• ContinuarEnCasoDeError: si se configura, sigue ejecutando las actividades restantes, incluso si la actividad actual falla.

Solución de problemas

Si tienes algún problema con la autenticación, consulta Resolución de problemas - Autenticación.