- Información general
- Excel
- Notas relacionadas
- Acerca del paquete de actividades de Excel
- Compatibilidad de Proyectos
- Codificación de caracteres compatible
- Configuración del proyecto
- Añadir o actualizar la etiqueta de confidencialidad de Excel
- Anexar rango
- Relleno automático
- Rango de ajuste automático
- Cambiar origen de datos dinámicos
- Borrar hoja/rango/tabla
- Copiar/Pegar rango
- Crear tabla dinámica
- Eliminar columna
- Eliminar filas
- Eliminar hoja
- Duplicar hoja
- Exportar a CSV
- Rellenar rango
- Filtro
- Filtrar tabla dinámica
- Buscar la primera/última fila de datos
- Buscar/Reemplazar valor
- Para cada fila de Excel
- Para cada hoja de Excel
- Formatear como tabla.
- Aplicar formato a celdas
- Obtener color de celda
- Obtener gráfico de Excel
- Obtener etiqueta de confidencialidad de Excel
- Obtener rango seleccionado
- Insertar columna
- Insertar gráfico
- Insertar filas
- Insertar hoja
- Invocar VBA
- Buscar
- Función de coincidencia
- Proteger hoja
- Leer fórmula de celda
- Leer el valor de la celda
- Leer rango
- Actualizar las conexiones de datos de Excel
- Actualizar tabla dinámica
- Quitar duplicados
- Cambiar el nombre de hoja
- Ejecutar la macro de la hoja de cálculo
- Guardar archivo de Excel
- Guardar archivo de Excel como
- Guardar archivo de Excel como PDF
- Seleccionar rango
- Ordenar rango
- Convertir texto en columnas
- Desproteger hoja
- Actualizar gráfico de Excel
- Utilice el archivo de Excel
- VLookup
- Escribir celda
- Escribir CSV
- Escribir TablaDeDatos a Excel
- Ámbito de aplicación de Excel
- Anexar a CSV
- Leer CSV
- Escribir CSV
- Eliminar columna
- Filtrar tabla
- Obtener rango de tabla
- Insertar columna
- Ordenar tabla
- Anexar rango
- Cerrar libro
- Obtener color de celda
- Leer celda
- Leer fórmula de celda
- Leer columna
- Leer rango
- Leer fila
- Seleccionar rango
- Establecer color del intervalo
- Escribir celda
- Escribir rango
- Guardar libro
- Crear tabla
- Obtener hoja del libro
- Obtener hojas del libro
- Actualizar tabla dinámica
- Crear tabla dinámica
- Obtener rango seleccionado
- Copiar hoja
- Eliminar rango
- Rango de relleno automático
- Copiar/Pegar rango
- Ejecutar macro
- Insertar/Eliminar columnas
- Insertar/Eliminar filas
- Invocar VBA
- Buscar rango
- Quitar rango de duplicados
- Alcance del proceso de Excel
- Gestionar archivos CSV
- Filtrar archivos CSV
- Verificar archivos CSV
- Funciones de tabla
- Gestionar varios archivos de Excel
- Interpretar resultados de Excel
- Gestionar tablas dinámicas
- Gestionar selección de intervalo
- Leer desde archivos de Excel
- Gestionar bases de datos en Excel
- Comparar archivos CSV
- Comparar valores numéricos
- Ordenar datos en archivos de Excel
- Filtrar y borrar filas en archivos de Excel
- Manipular selecciones de intervalo
- Verificar datos de libro de trabajo de Excel
- Leer, escribir y anexa datos en Excel
- Google Workspace
- Notas relacionadas
- Acerca del paquete de actividades Google Workspace
- Compatibilidad de proyectos
- Solicitud HTTP
- Copiar archivo
- Obtener lista de archivos
- Crear carpeta
- Eliminar archivo/carpeta
- Descargar archivo
- Para cada archivo/carpeta
- Obtener archivo/carpeta
- Mover archivo
- Compartir archivo/carpeta
- Cargar archivos
- Aplicar etiquetas de archivo
- Quitar etiquetas de archivos
- Obtener etiquetas de archivo
- Borrar campos de etiqueta de archivo
- Obtener etiquetas de Drive
- Archivar correo electrónico
- Eliminar correo electrónico
- Descargar correo electrónico
- Descargar los archivos adjuntos de correo electrónico
- Obtener lista de correo electrónico
- Para cada correo electrónico
- Reenviar correo electrónico
- Obtener correo electrónico por ID
- Obtener el correo electrónico más nuevo
- Marcar correo electrónico como leído/no leído
- Mover correo electrónico
- Responder al correo electrónico
- Enviar correo electrónico
- Aplicar etiquetas de archivo
- Eliminar etiquetas de Gmail
- Activar respuestas automáticas
- Desactivar respuestas automáticas
- Evento de calendario creado
- Evento de calendario recibido
- Evento de calendario actualizado
- Evento de calendario respondido
- Archivo creado
- Carpeta creada
- El archivo se ha actualizado
- Correo electrónico recibido
- Correo electrónico enviado
- Hoja creada
- Celda en hoja actualizada
- Fila agregada a la parte inferior de una hoja
- Tarea creada
- Tarea completada
- Conexiones
- Aplicar etiquetas de archivo
- Borrar campos de etiqueta de archivo
- Copiar archivo
- Crear carpeta
- Eliminar elemento
- Descargar archivo
- Obtener etiquetas de Drive
- Obtener archivo
- Obtener etiquetas de archivo
- Obtener archivos
- Obtener archivos y carpetas
- Obtener carpeta
- Obtener carpetas
- Obtener elemento
- Mover archivo
- Mover carpeta
- Actualizar archivo
- ActualizarCarpeta
- Actualizarelemento
- Quitar etiquetas de archivos
- Compartir archivo
- Compartir carpeta
- Cargar archivo
- Cargar archivos
- Opciones
- Aplicar etiquetas
- Archivar correo electrónico
- Eliminar correo electrónico
- Descargar correo electrónico
- Descargar archivo adjunto de correo electrónico
- Descargar los archivos adjuntos de correo electrónico
- Reenviar correo electrónico
- Obtener correo electrónico
- Obtener información de archivos adjuntos de correo electrónico
- Obtener correos electrónicos
- ObtenerEtiquetasDeCorreo
- Obtener el correo electrónico más nuevo
- Marcar el correo como leído
- Marcar correo electrónico como no leído
- Mover correo electrónico
- Eliminar etiquetas
- Responder al correo electrónico
- Enviar correo electrónico
- Desactivar respuestas automáticas
- Activar respuestas automáticas
- Opciones
- Añadir asistente
- Crear Evento
- Eliminar Evento
- Modificar Evento
- Buscar Eventos
- Utilizar Google Drive
- Compartir archivo
- Eliminar permiso de archivo
- Obtener permisos de archivo
- Actualizar el permiso de archivo
- Copiar archivo
- Crear carpeta
- Eliminar archivo
- Descargar archivo
- Buscar archivos y carpetas
- Obtener información del archivo
- Mover archivo
- Cargar archivo
- Crear documento
- Crear nueva Hoja de cálculo
- Obtener mensajes de correo
- Enviar mensajes de correo electrónico
- Cambiar etiquetas
- Usar una hoja de cálculo de Google
- Agregar/Eliminar Columnas
- Agregar Eliminar filas
- Rango de relleno automático
- Agregar nueva hoja
- Anexar fila
- Actualizaciones de hojas de cálculo por lotes
- Copiar hoja
- Copiar/Pegar rango
- Eliminar rango
- Eliminar hoja
- Obtener color de celda
- Obtener hojas
- Leer celda
- Leer columna
- Leer rango
- Leer fila
- Cambiar el nombre de hoja
- Escribir celda
- Escribir rango
- Borrar rango
- Descargar hoja de cálculo
- Utilizar documento de Google
- Actualizaciones de documentos por lotes
- Obtener documento
- Obtener índice de texto
- Insertar texto
- Reemplazar texto
- Leer todo el texto
- Crear proyecto de script
- Obtener contenido de proyecto
- Cargar archivo de script
- Crear implementación
- Ejecutar script
- Correo
- Notas relacionadas
- Compatibilidad de Proyectos
- Utilizar la aplicación Outlook de escritorio
- Utilizar Gmail
- Utilizar Outlook 365
- Archivar correo electrónico
- Eliminar correo electrónico
- Para cada correo electrónico
- Reenviar correo electrónico
- Obtener correo electrónico por ID
- Marcar correo electrónico como leído/no leído
- Mover correo electrónico
- Responder al correo electrónico
- Guardar correo electrónico
- Guardar archivos adjuntos de correo electrónico
- Enviar invitación de calendario
- Enviar correo electrónico
- Obtener mensajes de correo de Outlook
- Mover mensaje de correo de Outlook
- Enviar mensaje de correo de Outlook
- Guardar mensaje de correo de Outlook
- Borrar mensaje de Outlook Mail
- Contestar a mensaje de correo de Outlook
- Establecer categorías de correo de Outlook
- Marcar mensaje de Outlook Mail como leído/no leído
- Desencadenador de mensajes de correo de Outlook
- Microsoft 365
- Notas relacionadas
- About the Microsoft 365 activity package
- How to connect to Microsoft 365 activities
- Compatibilidad de proyectos
- Solicitud HTTP
- Eliminar correo electrónico
- Archivar correo electrónico
- Obtener lista de correo electrónico
- Descargar correo electrónico
- Descargar los archivos adjuntos de correo electrónico
- Para cada correo electrónico
- Reenviar correo electrónico
- Get Email By ID
- Obtener el correo electrónico más nuevo
- Marcar correo electrónico como leído/no leído
- Mover correo electrónico
- Responder al correo electrónico
- Enviar correo electrónico
- Establecer categorías de correo electrónico
- Activar respuestas automáticas
- Desactivar respuestas automáticas
- Archivo creado
- El archivo se ha actualizado
- Correo electrónico recibido
- Correo electrónico enviado
- Evento de calendario creado
- Evento de calendario recibido
- Evento de calendario respondido
- Evento de calendario actualizado
- Elemento de la lista añadido
- Elemento de la lista actualizado
- Se ha actualizado la celda en la hoja de trabajo
- Hoja de trabajo creada
- Fila agregada a la parte inferior de una tabla
- Conexiones
- AddEmailCategories
- Archivar correo electrónico
- Eliminar correo electrónico
- Descargar correo electrónico
- Descargar archivo adjunto de correo electrónico
- Descargar los archivos adjuntos de correo electrónico
- Reenviar correo electrónico
- Obtener correo electrónico
- Obtener información de archivos adjuntos de correo electrónico
- Obtener correos electrónicos
- GetMailFolders
- Obtener el correo electrónico más nuevo
- Marcar el correo como leído
- Marcar correo electrónico como no leído
- Mover correo electrónico
- RemoveEmailCategories
- Responder al correo electrónico
- Enviar correo electrónico
- Desactivar respuestas automáticas
- Activar respuestas automáticas
- Copiar archivo
- Copiar carpeta
- Crear carpeta
- Eliminar elemento
- Descargar archivo
- Obtener archivo
- Obtener archivos
- GetFilesAndFolders
- Obtener carpeta
- Obtener carpetas
- Obtener elemento
- Mover archivo
- Mover carpeta
- Actualizar archivo
- ActualizarCarpeta
- Actualizarelemento
- Compartir archivo
- Compartir carpeta
- Cargar archivo
- Cargar archivos
- Fusionar varias hojas en una nueva hoja de Excel de resumen
- Aceptar automáticamente invitaciones de calendario de tu gestor
- Mover archivos a carpetas dedicadas por tipo
- Verificar si los nuevos documentos de empleo (I9 e ID) coinciden
- Añadir nuevos clientes a una lista de SharePoint
- Eliminar elementos de lista de SharePoint más recientes que ayer
- Notificarme en Slack cuando se reciba un correo electrónico de Outlook importante
- Incluir la fecha de creación en los nuevos nombres de archivo de OneDrive
- Notificarme por correo electrónico cuando se cree un nuevo archivo
- Ámbito de Microsoft Office 365
- Añadir hoja
- Anexar rango
- Borrar rango
- Copiar rango
- Copiar hoja
- Crear libro
- Eliminar rango
- Eliminar hoja
- Obtener color de celda
- Obtener hojas
- Leer celda
- Leer columna
- Leer rango
- Leer fila
- Cambiar el nombre de hoja
- Escribir celda
- Escribir rango
- Establecer color del intervalo
- Crear tabla
- Obtener rango de tabla
- Insertar columna
- Eliminar columna
- Insertar filas
- Eliminar filas
- Intervalo de BuscarV
- Utilizar OneDrive y SharePoint
- Copiar archivo/carpeta
- Crear carpeta
- Eliminar archivo/carpeta
- Descargar archivo
- Exportar archivo como PDF
- Buscar archivos y carpetas
- Obtener archivo/carpeta
- Mover archivo/carpeta
- Cargar archivo
- Compartir archivo/carpeta
- Para cada archivo/carpeta
- Reenviar correo
- Obtener correo
- Mover correo
- Enviar correo
- Responder al correo
- Eliminar correo
- Establecer categorías de correo
- Añadir archivo adjunto
- Añadir asistente
- Añadir ubicación
- Crear Evento
- Eliminar Evento
- Encontrar horas de reunión
- Obtener calendarios
- Modificar Evento
- RSVP
- Buscar Eventos
- Crear grupo
- Eliminar grupo
- Obtener grupo
- Lista de grupos
- Crear depósito
- Eliminar depósito
- Mostrar depósitos
- Mostrar tareas del depósito
- Crear plan
- Obtener plan
- Mostrar planes
- Crear tarea
- Eliminar tarea
- Obtener tarea
- Mostrar tareas
- Actualizar tarea
- Para cada lista
- Obtener información de la lista
- Para cada elemento de la lista
- Eliminar elemento de la lista
- Añadir elementos de la lista
- Actualizar elemento de la lista
- Obtener elementos de la lista
- Presentaciones
- Notas relacionadas
- Acerca del paquete de actividades de Presentaciones
- Compatibilidad de Proyectos
- Añadir o actualizar la etiqueta de confidencialidad de Powerpoint
- Añadir Tabla de datos a la diapositiva
- Agregar archivo a la diapositiva
- Añadir imagen o vídeo a la diapositiva
- Agregar nueva diapositiva
- Agregar texto a diapositiva
- Copiar Pegar Diapositiva
- Eliminar diapositiva
- Formato del contenido de las diapositivas
- Obtener etiqueta de confidencialidad de PowerPoint
- Reemplazar el texto de la presentación
- Pegar elemento en diapositiva
- Ejecutar macro de presentación
- Guardar el archivo de PowerPoint como
- Guardar presentación como PDF
- Usar presentación de PowerPoint
- Word
- Notas relacionadas
- Acerca del paquete de actividades Word
- Compatibilidad de Proyectos
- Ámbito de aplicación Word / usar archivo de Word
- Añadir o actualizar la etiqueta de confidencialidad de Word
- Añadir hipervínculo al documento
- Añadir imagen
- Anexar texto
- Obtener etiqueta de confidencialidad de Word
- Insertar tabla de datos en el documento
- Pegar gráfico/imagen en el documento
- Leer texto
- Reemplazar fotografía
- Reemplazar el texto del documento
- Guardar documento como
- Guardar documento como PDF
- Establecer contenido de marcador
Ámbito de Microsoft Office 365
UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope
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.
Para establecer tu conexión autenticada, primero tienes que registrar tu aplicación Microsoft Office 365 en tu Active Active Directory de Azure (utilizando tu cuenta de Microsoft 365 personal, de trabajo y/o escolar). Al registrar tu aplicación, tienes que asignar los permisos de la API de Microsoft Graph que especifiquen los recursos a los que el robot puede acceder en tu nombre.
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 . El ID de la aplicación se utiliza para recopilar la información necesaria sobre tu aplicación registrada para iniciar la autenticación.
Para obtener más información sobre el registro de tu aplicación y la asignación de permisos, consulta la guía de configuración . Esta guía proporciona instrucciones paso a paso para configurar tu aplicación Microsoft 365 para la automatización.
Tipos de autenticación |
Como usuario |
Como aplicación (ejecutar como servicio en segundo plano) |
Atendido |
Desatendido |
Desatendido (MFA habilitado) |
Detalles |
---|---|---|---|---|---|---|
Token interactivo |
Tiene la opción de registrarse y usar su propia aplicación de Azure AD (es decir,
OAuthApplication = Custom ) o la proporcionada por UiPath (OAuthApplication = UiPath ).
| |||||
Autenticación de Windows integrada (IWA) |
Solo funciona para usuarios federados y si su aplicación de Azure registrada está configurada para admitir IWA. No funciona para la autenticación multifactor (MFA). Ver los detalles aquí: IWA en GitHub | |||||
Nombre de usuario y contraseña |
No recomendado, se proporciona solo por razones de legado (va en contra de los principios de la autenticación moderna). No funciona para la autenticación de múltiples factores (MFA). Consulta los detalles aquí: Usuario y contraseña en GitHub | |||||
Secreto e ID de aplicación |
Recomendado para ejecuciones desatendidas o cuando desee acceder a la API de Microsoft Graph como una aplicación (un servicio / daemon en segundo plano) sin un usuario que haya iniciado sesión. | |||||
IDDeAplicación y certificado |
Disponible a partir de la versión v1.9.0. Muy similar con el ID de aplicación y el secreto. La única diferencia es el uso de un certificado como secreto en lugar de una cadena de secreto de cliente. Consulta la documentación oficial. |
- 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.
Al seleccionar esta opción, los campos de autenticación que se muestran en la opción Panel de propiedades se ocultan, porque toda 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.
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 permisos de la aplicación.
Nombre de usuario y contraseña (desatendido)
- Nombre de usuario: el nombre de usuario de tu cuenta de Microsoft 365.
- 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.
- 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
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.
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 aplicación de Microsoft 365.
- Tipo de autenticación : el tipo de autenticación requerido para tu aplicación registrada. Selecciona una de las cinco opciones: TokenInteractivo, AutenticaciónDeWindows integrada, NombreDeUsuarioYContraseña, IDYSecretoDeAplicación o IDYAplicaciónDeAplicación. El valor predeterminado es InteractiveToken. Para obtener más información sobre estas opciones y cuál seleccionar, consulta la sección Automatización desatendida frente a atendida a continuación.
- Entorno : el entorno, ya sea global de Azure o nubes nacionales, que son entornos únicos e independientes de Azure global. Selecciona una de las cinco opciones: Predeterminado, Global, China, Alemania o Gobierno de EE. UU. El valor predeterminado es Global.
- ID de la aplicación: el ID de aplicación único (cliente) asignado por el Active Directory de Azure al registrar tu aplicación durante la configuración. El ID de la aplicación (cliente) representa una instancia de una aplicación Microsoft 365. Una sola organización puede tener varios ID de aplicación (cliente) para su cuenta de Microsoft 365. Cada ID de aplicación (cliente) contiene sus propios permisos y requisitos de autenticación. Por ejemplo, tú y tu colega podéis registrar una aplicación de Microsoft 365 en el Active Directory de Azure de tu empresa con diferentes permisos. Tu aplicación podría configurarse para autorizar permisos para interactuar solo con archivos, mientras que la aplicación de tu colega está configurada para autorizar permisos para interactuar con archivos, correo y calendario. Si introduces tu ID de aplicación (cliente) en esta propiedad y ejecutas la automatización Attended, el cuadro de diálogo de consentimiento se limitaría a los permisos de los archivos (y, posteriormente, solo se pueden utilizar las actividades Archivos).
- Tenant : el ID de directorio único (tenant) asignado por Azure Active Directory cuando registraste tu aplicación durante la configuración. Requerido para aplicaciones multitenant y IntegratedWindowsAuthentication. El ID del directorio (tenant) se puede encontrar en la página de información general de tu aplicación registrada (bajo el 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.
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) (no se muestra). - ContinuarEnCasoDeError: si se configura, sigue ejecutando las actividades restantes, incluso si la actividad actual falla.
-
Aplicación OAuth : indica la aplicación (cliente) que se utilizará. Si se selecciona
UiPath
, se ignoran ApplicationID y Tenant . Este campo solo admite variablesOAuthApplication
. Selecciona una de las dos opciones:- UiPath : predeterminado. Cuando quiera utilizar la aplicación creada por UiPath. En este caso, se omiten los valores de ID de aplicación y de parámetro Tenant .
- Personalizado : cuando quieres crear tu propia aplicación con los permisos correctos. En este caso, se debe establecer un valor para el parámetro de ID de aplicación .
-
Certificado como Base64 : la representación Base64 del certificado. Obligatorio si el Tipo de autenticación está establecido en ID de aplicación y Certificado.
- Contraseña del certificado : una contraseña opcional que puede ser necesaria para utilizar el certificado, como
Secure String
.
- Secreto de la aplicación : la cadena secreta que la aplicación utiliza para proporcionar su identidad. Obligatorio si el Tipo de autenticación está establecido en ID de aplicación y Secreto.
- Secreto deaplicación segura: el secreto de la aplicación (cliente), como
SecureString
.
Estas propiedades se aplican cuando ejecutas solo automatización desatendida. Al especificar valores para estas propiedades, asegúrate de que el Tipo de autenticación esté establecido en Nombre de usuario y Contraseña. Para obtener más información, consulta la sección Nombre de usuario y contraseña a continuación.
- 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.
Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.
- Completa los pasos de configuración .
- Agrega la actividad de Ámbito de Microsoft Office 365 a tu proyecto.
-
Introduce valores para las propiedades Autenticación, Entraday Desatendido (si procede).
La actividad Ámbito de Microsoft 365 tiene cuatro flujos de autenticación diferentes (Tipos de autenticación) entre los que puedes elegir al añadir la actividad a tu proyecto. Su selección depende del tipo de modo de automatización que planea ejecutar (desatendido o atendido) y los requisitos de autenticación de su aplicación (consulte con su administrador si no está seguro de qué requisitos de autenticación se aplican a su aplicación).
TipoDeAutenticación |
Atendido |
Desatendido |
Tipo de permiso de API |
---|---|---|---|
Token interactivo | X |
Permisos delegados | |
Autenticación de Windows integrada | X |
Permisos delegados | |
Nombre de usuario y contraseña | X |
Permisos delegados | |
Secreto e ID de aplicación | X |
Permisos de la aplicación | |
IDDeAplicación y certificado | X |
Permisos de la aplicación |
Los tipos de autenticación integrada de Windows o nombre de usuario y contraseña no funcionan cuando la autenticación multifactor (MFA) está habilitada. Si tu aplicación requiere MFA, puedes ejecutar la automatización atendida utilizando el tipo de autenticación de token interactivo o la automatización desatendida utilizando el ID y el secreto de la aplicación y el ID y el certificado de la aplicación. Los tipos de autenticación ID y secreto de la aplicación e ID de la aplicación y certificado son adecuados para la automatización desatendida y funcionan independientemente de si la MFA está habilitada o deshabilitada.
Al registrar tu aplicación, debes seleccionar un tipo de aplicación. Ten en cuenta los siguientes requisitos:
-
Para los escenarios atendidos (tipo de autenticación de token interactivo) y desatendido con autenticación de Windows integrada, utiliza una aplicación móvil/de escritorio (que utiliza el flujo de código de autorización OAuth 2.0).
-
Para escenarios desatendidos (nombre de usuario y contraseña, ID y secreto de la aplicación, ID de la aplicación y certificado), utiliza una aplicación web/confidencial (que utiliza el flujo de credenciales de cliente OAuth 2.0).
Token interactivo
El tipo de autenticación de token interactivo se puede utilizar para la automatización atendida y cuando se requiere la autenticación multifactor (MFA). Esta es la opción predeterminada y la que usamos en nuestros ejemplos. Si estás interesado en probar el paquete de actividades, esta opción es fácil de configurar y funciona bien para las cuentas personales (utilizando el URI de redirección predeterminado indicado en el paso 7 de la sección Registrar tu aplicación de la guía de configuración ).
Cuando la actividad de Microsoft 365 se ejecuta por primera vez con este tipo de autenticación, se te pedirá que autorices el acceso a los recursos (a los que concediste permisos al registrar tu aplicación) a través de un cuadro de diálogo de consentimiento .
Si selecciona esta opción, las propiedades Nombre de usuario, Contraseñay Tenant deben dejarse vacías.
Autenticación de Windows integrada
El tipo de autenticación Autenticación de Windows integrada puede utilizarse para la automatización desatendida. Esta opción puede aplicarse a las aplicaciones alojadas de Windows que se ejecutan en equipos unidos a un dominio de Windows o Azure Active Directory.
Solo debes seleccionar esta opción si tu aplicación registrada está configurada para admitir la autenticación integrada de Windows (se puede encontrar información adicional en GitHub).
Si seleccionas esta opción, las propiedades Nombre de usuario y Contraseña deben dejarse vacías. La propiedad Tenant es opcional.
Nombre de usuario y contraseña
El tipo de autenticación Nombre de usuario y Contraseña se puede utilizar para la automatización desatendida.
Aunque Microsoft no lo recomienda, puedes utilizar este tipo de autenticación en aplicaciones cliente públicas. El uso de este tipo de autenticación impone restricciones en su aplicación. Por ejemplo, las aplicaciones que usen este flujo no podrán iniciar la sesión de un usuario que necesite realizar una autenticación multifactor (acceso condicional). Tampoco permitirá que tu aplicación se beneficie del inicio de sesión único.
Si selecciona esta opción, se requieren las propiedades Nombre de usuario y Contraseña , y la propiedad Tenant es opcional para las aplicaciones de un solo tenant (necesaria para las aplicaciones de múltiples tenant).
Secreto e ID de aplicación
En cuanto a la autenticación con ID de aplicación (cliente) y Secreto de aplicación (cliente), tenga en cuenta lo siguiente:
- Los permisos de la API adecuados deben configurarse para la aplicación de Azure para que las actividades de Microsoft 365 funcionen correctamente (por ejemplo, los permisos de la aplicación
Group.Create
,Group.Read.All
yGroup.ReadWrite.All
deben configurarse para Microsoft Graph cuando se utilizan actividades de Grupos). - Algunas actividades no se pueden usar con este tipo de autenticación porque la API de Microsoft Graph correspondiente no admite permisos de aplicación. Consulta la documentación oficial de Microsoft.
- Para las actividades de correo electrónico ( Obtener correo, Reenviar, Enviar correoy Mover correo electrónico ) es obligatorio especificar un valor para el parámetro Cuenta .
IDDeAplicación y certificado
Para autenticarse utilizando un certificado como secreto, siga estos pasos:
-
En Azure Portal:
- Localiza tu aplicación de Microsoft 365 registrada.
-
Selecciona Certificados y secretos y carga tu archivo de certificado (clave pública). Puede tener uno de los siguientes tipos de archivo:
.cer
,.pem
,.crt
.
- Convierte el contenido sin procesar de tu archivo
.pfx
que representa el certificado en unbase64 string
. Para hacer esto, usa una herramienta basada en web como Base64.Guru o asignaConvert.ToBase64String(System.IO.File.ReadAllBytes(pfxFilePath))
a una variableString
. - En la actividad Ámbito de Microsoft 365:
- Establece Tipo de autenticación en ID de aplicación y Certificado.
- Configura CertificadoComoBase64 a la representación base64 del certificado.
-
Si se requiere una contraseña para utilizar el certificado, establece también el valor de la propiedad Contraseña del certificado .
Nota: La misma descripción que para la sección ID de aplicación y secreto también se aplica a ID de aplicación y certificado.
Si tienes algún problema con la autenticación, consulta Resolución de problemas - Autenticación.
- Descripción
- Compatibilidad de proyectos
- Información general
- Tipos de autenticación
- Configuración
- Método de conexión de activos
- Método de conexión del panel de propiedades
- Autenticación
- Token interactivo
- ID de aplicación y Certificado (desatendido)
- Application ID and Secret (Unattended)
- Nombre de usuario y contraseña (desatendido)
- Cómo funciona
- Automatización atendida frente a desatendida
- Solución de problemas