Microsoft OneDrive

El conector de OneDrive te permite conectarte al almacenamiento en la nube de Microsoft OneDrive en Designer. OneDrive está disponible como fuente de datos en las herramientas Datos de entrada y Datos de salida.

Actualizar al conector nuevo de OneDrive

Si el flujo de trabajo utiliza las herramientas independientes Entrada de OneDrive o Salida de OneDrive, ahora están obsoletas. En cambio, utiliza la versión 2.2.0 o posterior del conector con las herramientas Datos de entrada y Datos de salida. Usa la utilidad Migración de flujos de trabajo para actualizar flujos de trabajo existentes. Output Data Tool Icon Herramienta Datos de salida

Prerrequisitos

Asegúrate de haber completado los siguientes prerrequisitos antes de continuar:

Requisito	Detalles
Designer	Designer 2026.1 o versiones posteriores. Designer 2025.2, Parche 3, o posterior. Designer 2025.1, Parche 5, o posterior.
Versión de conectores	Microsoft OneDrive versión 2.2.0 o posterior. Disponible en los complementos de Designer.
Permisos de Azure	Consulta Configurar la aplicación de API de Microsoft Azure.
DCM	Debes habilitar DCM en Designer. Ve a Opciones >Configuración avanzada > DCM para habilitarlo.
Acceso a la red	Acceso saliente a los puntos de conexión de OneDrive en línea y Microsoft OAuth.

Instalar el conector

Instala la versión más reciente del conector de OneDrive directamente desde Designer mediante complementos. Este es el método de instalación recomendado que te permite examinar, instalar y actualizar conectores sin salir de Designer ni visitar Alteryx Marketplace.

Para instalar el conector…

En Designer, ve a Complementos > Administrar complementos de Marketplace. Verás una lista de conectores disponibles.
Selecciona Conector de Microsoft OneDrive y selecciona Instalar. Designer descarga e instala el paquete. Designer puede requerir un reinicio para completar la instalación.
Una vez que se complete la instalación y la configuración, el conector de OneDrive estará disponible en las herramientas Datos de entrada y Datos de salida.

Configurar una conexión

Para conectarte a Microsoft OneDrive…

Arrastra la herramienta Datos de entrada o Datos de salida al lienzo y selecciona Conectar a datos.
En Configuración del conector, selecciona Crear o examinar una conexión de datos.
Si creaste una conexión de Microsoft OneDrive anteriormente, puedes seleccionar la conexión en la pestaña Recientes.
Selecciona + Nuevo. En la lista de tecnologías, selecciona Microsoft OneDrive.
Ingresa el Nombre de la conexión y el Nombre de la fuente de datos.
En la sección Credenciales, selecciona tu método de autenticación e ingresa las credenciales. Para obtener más información, consulta Métodos de autenticación.
Selecciona Guardar. También puedes probar la conexión antes de guardarla.
Selecciona Conectar. Microsoft OneDrive puede solicitar autenticación.
Selecciona la configuración de lectura o escritura en la ventana Opciones. Para obtener más información sobre las opciones, consulta Leer datos de OneDrive o Escribir datos en OneDrive.Leer datos desde OneDriveEscribir datos en OneDrive
Selecciona Confirmar para crear una conexión con el archivo. Puedes seguir creando tu flujo de trabajo.

Migración de flujo de trabajo

Si los flujos de trabajo existentes utilizan las herramientas Entrada de OneDrive o Salida de OneDrive obsoletas, debes migrarlos para que utilicen el conector nuevo. Usa la utilidad Migración de flujos de trabajo para actualizar flujos de trabajo existentes.

La utilidad previsualiza todos los cambios y reemplaza las instancias obsoletas de las herramientas con las nuevas versiones del conector sin interrumpir los flujos de trabajo.

Métodos de autenticación

Microsoft OneDrive admite tres métodos de autenticación. Utiliza la siguiente tabla a fin de elegir el adecuado para tu caso práctico.

Método	Detalles
Azure AD: privado (aplicación integrada)	Utiliza este método para configurar una conexión personal y acorde a tus propias credenciales de Microsoft. El correo electrónico y la contraseña están vinculados a tus credenciales personales de Microsoft. Esto se puede utilizar para SDK. No se recomienda para programar flujos de trabajo. El DCM es opcional.
Azure AD: privado (aplicación personalizada)	Utiliza este método cuando tu equipo comparta una aplicación de Azure registrada personalizada. Esto se puede utilizar para SDK. Para obtener instrucciones sobre la configuración, consulta Configuración de la aplicación de la API de Microsoft Azure. El DCM es opcional.
Entidad de servicio (aplicación)	Utiliza este método para programar o automatizar flujos de trabajo sin vincular la autenticación a un usuario específico. Aprovecha las capacidades de las aplicaciones de API personalizadas con una entidad de servicio. Para obtener instrucciones sobre la configuración, consulta Configuración de la aplicación de la API de Microsoft Azure. La DCM es obligatoria.

Limitaciones

Actualmente, el conector de Microsoft OneDrive tiene las siguientes limitaciones:

Las API de Graph Recientes y Compartidas conmigo subyacentes de Microsoft están obsoletas y no devuelven datos. Esta es una limitación a nivel de la plataforma independiente de este conector.
Como resultado, no se puede navegar por Recientes y Compartidos conmigo ni acceder a ellas, y el alcance de la ruta de OneDrive está limitado a Mis archivos.
Las particiones no son compatibles.
No se admite la lectura de datos con comodines o desde varios archivos o carpetas, pero se puede lograr mediante macros.
No se admite la acción de salida Adjuntar. Utiliza Leer > Apilar > Sobreescribir para replicar el comportamiento adjunto.
Al crear un archivo nuevo, si ya existe un archivo con el mismo nombre en el destino, la acción no lo sobrescribirá. En cambio, adjuntará un sufijo de marca de tiempo al nombre del archivo nuevo para conservar ambos archivos.
No se admite la lectura de archivos XLSX de varias hojas ni la selección de una hoja por nombre o índice.

Notas de lanzamiento

Versión	Descripción
v3.1.1	Se mejoró el campo URL de autoridad con un valor predeterminado que se completa de forma previa y texto de ayuda integrado, lo que reduce la necesidad de consultar documentación externa. Se corrigió un problema por el que la selección de un formato de archivo no compatible en el conector de Entrada de OneDrive mostraría opciones de configuración irrelevantes. Se corrigió un problema por el que la conexión de prueba fallaba en el Data Connection Manager (DCM) tras utilizar el método de autenticación de la aplicación integrada. Se mejoró el manejo de errores para las operaciones de Entrada y Salida de OneDrive.
v3.1.0	Compatible con Designer 2021.4.2 (parche 4), 2022.1 (parche 2) y versiones posteriores. Capacidad de conectarse a OneDrive mediante el inicio de sesión seguro de OAuth 2.0 de Microsoft. Realiza la autenticación con una entidad de servicio para flujos de trabajo automatizados y desatendidos. Almacena tu inicio de sesión una vez a través de DCM y reutilízalo en flujos de trabajo tanto en Designer como en Alterix Server. Ejecuta tareas desatendidas en Server con la actualización automática de tokens, no necesitas volver a autenticar de forma manual. Filtra con rapidez Archivos personales, Compartidos conmigo o Archivos recientes. Examina, escribe una ruta manualmente o copia un enlace de OneDrive que te hayan compartido para seleccionar archivos. Pega una URL y el conector identifica y carga los detalles del archivo de forma automática. Elige una hoja específica por nombre o número, define un rango de celdas personalizado o extrae solo la lista de nombres de hojas. Ingresa detalles como el nombre del archivo, la ruta, el tamaño, la fecha de la última modificación y el tipo de archivo junto con tus datos. Recupera solo la estructura de archivos o carpetas sin descargar el contenido completo del archivo. Lee archivos .csv, .xlsx y .yxdb directamente desde OneDrive.
v2.3.0	Compatible con Designer 2021.4.2 (parche 4), 2022.1 (parche 2) y versiones posteriores. Compatible solo con AMP Engine. Se requiere DCM para ejecutar este conector en Alteryx Server. Se mejoró la ventana de opciones de autenticación. La salida de la Entrada de OneDrive ahora incluye los nombres de las hojas cuando se descargan archivos XLSX localmente. Puedes usar los nombres de las hojas en otras herramientas de su flujo de trabajo. Se corrigió el problema en el que la Salida de OneDrive configurada para sobrescribir una hoja específica en el archivo XLSX modificaba también otras hojas. Se solucionó el problema en el que la autenticación de las herramientas de OneDrive no funcionaba correctamente. (TPM-3833) Se solucionó el problema por el que la Entrada de OneDrive no leía ciertos tipos de datos correctamente. (TPM-3751, TPM-3722, TPM-3721) Se solucionó el problema por el que la Salida de OneDrive escribía archivos incorrectos si los datos contenían valores decimales o nulos fijos. (TPM-3720) Se solucionó el problema en el que la Salida de OneDrive convertía incorrectamente valores nulos en archivos CSV. (TPM-3719) Se solucionó el problema en el que la autenticación principal del servicio no funcionaba en la Salida de OneDrive. (TPM-3580) Se solucionó el problema en el que, a pesar de la configuración del usuario para excluir el campo de las opciones de Hoja de selección, la Salida de OneDrive incluía el campo en la salida. (TPM-3393) Se solucionó el problema en el que la Salida de OneDrive no agregaba correctamente los datos. (TPM-2564) Se solucionó el problema en el que la opción de anulación de la Salida de OneDrive no funcionaba correctamente para todos los tipos de datos. (TPM-2563) Se solucionaron los problemas de codificación de las herramientas de OneDrive. (TPM-1984) Se solucionó el problema en el que la Salida de OneDrive cambiaba el formato de los encabezados. (TPM-1375) Se solucionó el problema en el que la opción Adición de la Salida de OneDrive sobrescribía el formato y las fórmulas del documento. (TPM-1179) Se solucionó el problema en el que la Entrada de OneDrive no podía leer archivos YXDB con datos de DateTime. (TPM-1100) Se solucionó el problema en el que la Salida de OneDrive falla cuando el flujo de trabajo incluye datos de tipos de datos Byte e Int16. (TPM-209)
v2.2.0	Compatible con Designer 2021.4.2 (parche 4), 2022.1 (parche 2) y versiones posteriores. Compatible solo con AMP Engine. Se agregó la compatibilidad con DCM. Se requiere DCM para ejecutar este conector en Alteryx Server. Se puede utilizar FIPS. Se agregó la opción de sobrescribir solo una hoja. Se cambió el comportamiento del campo Nombre de hoja para excluirlo de los datos escritos. Se agregó la opción para mantener el campo Nombre de hoja. Ahora, la validación mediante SSL/TLS se realiza en función del almacén de certificados de Windows.
v2.1.0	La autenticación se produce cuando se utiliza el navegador del usuario en lugar del CEF integrado en Designer para cumplir con las políticas de seguridad modernas.
v2.0.2	Se corrigió el problema por el cual se perdía la configuración de la herramienta cuando se habilitaba la opción “Proporcionar información de autenticación”.
v2.0.1	Se solucionó el problema que muestra la pantalla en blanco cuando se realiza la autenticación en Designer 2021.3.2.54175. Ten en cuenta que también debes actualizar Designer a la versión 21.3.3.63061 o posterior.
v2.0.0	La aplicación Azure multiinquilino integrada con la opción de utilizar una aplicación Azure personalizada (incluida la aplicación de un solo inquilino o Entidad de servicio). Admite la lectura y escritura de formatos de archivo XLSX, CSV e YXDB. Compatibilidad con proxy. Compatible con la versión 2021.2.2 de Designer y posteriores. Requiere OneDrive 365.
v1.0.2	Opciones para actualizar página de código Distingue entre codificaciones con el mismo idioma (por ejemplo, “Idioma” -> “Idioma [código específico]”) y codificaciones ordenadas alfabéticamente. Permite al usuario especificar la codificación de archivos CSV en la herramienta de salida. Se mejoró el manejo de la conversión de datos para no mostrar una advertencia en vez de un error cuando falta un valor en un campo. Se corrigió el problema en el que ocasionalmente no se respetaban los valores predeterminados. Se deshabilitó el registro de producción a fin de evitar problemas de permisos para diferentes instalaciones o configuraciones de Designer y admitir la funcionalidad de los flujos de trabajo programados.
v1.0.1	Se corrigió el problema que impedía que los paquetes se instalaran correctamente.
v1.0.0	Versión inicial de Entrada de OneDrive y Salida de OneDrive.

Aplicación de API personalizada de Microsoft Azure

Para configurar una aplicación de API personalizada para esta herramienta, ve a nuestra guía.

Nota

Asegúrate de tener habilitado AMP Engine para los flujos de trabajo que contienen las herramientas de la versión 2.2.0 de OneDrive y posteriores. Para obtener más información, consulta AMP Engine .

Herramientas de Alteryx utilizadas para establecer conexiones


Herramienta Entrada de OneDrive	Herramienta Salida de OneDrive

En esta sección: