Box

Tipo de conexión	Herramienta de Alteryx. La versión más reciente está disponible en Alteryx Marketplace.
Tipo de soporte	Lectura y escritura

Notas de lanzamiento

Notas del lanzamiento de Conector 1.0.0 (Python)

Compatibilidad con Designer (por discutir)

Novedades

¡Nuevas características!
The Box connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow.

Cambios en el comportamiento

We've disabled the right-click context menu in Designer for the Box tools to prevent unintended actions.

Problemas corregidos

Corregido Lanzamiento de Connector, versión xxxx.x.x.xxxxx
ID	Descripción
TPM-5038	Newly created files in the Box tools inherit the previously selected filename when saved with any extension.
TPM-5006	Selecting Enable Dry Run in the Box Input tool (version 2.5.6) using a DCM connection with JWT authentication causes an error.
TPM-4984	The Box connector version 2.5.7 doesn’t recognize YXDB files.
TPM-4948	An error occurs when uploading a file using the Box tools.
TPM-4853	Special characters in the proxy password cause an error when setting up a manual proxy server for the Box tools.
TPM-4782	Secret values are exposed in the returned JSON in the Designer HTML Developer Tools for the Box tools.
TPM-4754	The Box Input tool returns a "list index out of range" error.
TPM-4645	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-4396	The Box Input tool doesn’t function properly with DCM.
TPM-4239	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for YXDB files that contain only a heading row.
TPM-4192	File name breadcrumbs don’t appear correctly in the Box UI.
TPM-4191	The Box Input tool version 2.5.6 on Python 3.10 adds extra decimal values to datetime fields.
TPM-3832	The SharePoint Input tool version 2.6.2 returns a "Python int too large to convert to C long" error.
TPM-3334	After upgrading to SDK version 2.4.0, null datetime values appear as NaT in CSV files using the Box tools.
TPM-3266	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for CSV and XLSX files that contain only a heading row.

Problemas conocidos

Conocido Lanzamiento de Connector, versión xxxx.x.x.xxxxx
JIRA-ID	Descripción del problema

Conocido

Lanzamiento de Connector, versión xxxx.x.x.xxxxx

Descripción

JIRA-ID

Descripción del problema

Problemas cancelados

Cancelado Lanzamiento de Connector, versión xxxx.x.x.xxxxx
ID	Descripción
TPM-4190	The dry run feature doesn’t work in the Box Input tool version 2.5.6.
TPM-4049	The Box Output tool returns errors when writing large XLSX files.
TPM-3758	The Box Output tool doesn’t retain selected fields as expected.
TPM-3634	File paths don’t update when files are deleted from the Box server using a browser.
TPM-3479	In Box version 2.5.5 (Python 3.8), using the 'Download file locally for later processing' feature with an empty or invalid location doesn’t work as expected in either scenario.
TPM-3477	INT data types upload as FLOAT types when viewed in the Box browser.
TPM-3435	The Box Output tool maps incorrect data types for XLSX files.
TPM-2871	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-2792	The Box Input tools return a "Communication error: Failed to write Control In message" during validation.
TPM-2267	The Box Output tool writes an empty YXDB file if a field is of the DateTime data type.
TPM-2246	The Box Output tool displays an unclear error message for invalid CSV files.
TPM-2133	Field names are not automatically voiced in the Box tools.
TPM-1568	The Box tools experience a significant lag when users click away from the tool.

Versión	Descripción
v2.5.6	Compatible con Alteryx Designer y Server 2021.4.2 parche 6, 2022.1 parche 4 y versiones posteriores. Requiere el uso de AMP Engine. Se solucionó el problema en el que Entrada de Box no podía leer datos cuando una columna de Excel tenía datos de dos tipos de datos. (TPM-4135) Se solucionó el problema en el que los tokens web JSON no funcionaban en las herramientas de Box. (TPM-4115, TDCE-520) Se solucionó el problema en el que Python SDK no informaba errores de DCM. (TPM-3929) Se solucionó el problema en el que Entrada de Box no retenía el tipo de dato de tipo de fecha. (TDCE-537) Se solucionó el problema en el que la salida de Box convertía números en texto. (TDCE-453)
v2.5.5	Compatible con Alteryx Designer y Alteryx Server 2021.4.2 parche 6, 2022.1 parche 4 y versiones posteriores. Requiere el uso de AMP Engine. Se eliminó el uso de la carpeta .shiv. Se agregó compatibilidad con Alteryx Designer y Server 2024.1. Se corrigió un problema en el que Entrada de Box se ejecutaba indefinidamente cuando se configuraba para leer un conjunto de datos vacío. (TPM-2453) Se corrigió un problema en el que las herramientas de Box no podían conectarse con un token JWT recién generado. (TFLN-1855)
v2.5.4	Compatible con Alteryx Designer y Alteryx Server 2021.4.2 parche 6, 2022.1 parche 4 y versiones posteriores. Requiere el uso de AMP Engine. Se corrigió un problema en que la Salida de Box no escribía el tipo de dato fixedDecimal en los archivos YXDB. (TPM-2111) Se corrigió un problema en que la Salida de Box no sobrescribía algunos archivos Excel de mayor tamaño. (TPM-2169)
v2.5.2	Compatible con Alteryx Designer y Alteryx Server 2021.4.2 parche 6, 2022.1 parche 4 y versiones posteriores. Requiere el uso de AMP Engine. Para la Entrada de Box, se agregó una opción a fin de incluir subcarpetas cuando se utiliza la búsqueda de comodín, la descarga local de archivos o cuando el usuario selecciona Procesar archivo como. Se solucionó el problema de rendimiento cuando se utiliza la búsqueda de comodín en Entrada de Box. (TPM-2027) Se solucionó el problema por el cual la búsqueda de comodín devolvía un error la primera vez que se ejecutaba el flujo de trabajo. (TPM-1847) Se corrigió el problema por el cual Salida de Box no podía escribir distintos tipos de datos de números y fecha y hora en archivos YXDB. (TDCE-96, TPM-1958) Se corrigió el problema por el cual el flujo de trabajo fallaba cuando Salida de Box estaba configurado para usar el campo entrante a fin de nombrar de forma dinámica uno o más archivos de salida. (TPM-1980) Se corrigió el problema por el cual el panel de configuración de Box mostraba un error intermitente cuando se dejaba abierto durante un período largo. (TFLN-1210) Problema conocido La Salida de Box no puede escribir el tipo de dato fixedDecimal en los archivos YXDB. (TPM-2111) Alteryx Server requiere el valor AllowAll de la configuración del modo de acceso de SDK.
v2.5.1	Compatible con Alteryx Designer y Alteryx Server 2021.4.2 parche 6, 2022.1 parche 4 y versiones posteriores. Requiere el uso de AMP Engine. Se corrigió el problema por el cual se reenviaba la pestaña Configurar archivo cuando los usuarios presionaban Intro en el campo Ruta de archivo. (TFLN-1209) Se corrigió el problema por el cual la lectura de un archivo XLSX con valores nulos daba como resultado un error. (TDCE-92) Se corrigió el problema por el cual un flujo de trabajo ejecutado con los conectores de Box que utilizaban la autenticación de JWT no se llevaba a cabo después de un día, y arrojaba el error de criptografía o de Token de acceso no válido. (TPM-1802) Se corrigió el problema por el cual Salida de Box no podía anexar datos cuando contenía el carácter delimitador entre comillas. (TDCE-28) Se corrigió el problema por el cual Salida de Box no podía escribir los tipos de datos de fecha y de fecha y hora, o bien cambiaba la fecha a 70 años en el futuro. (TPM-1902) Problema conocido Salida de Box no puede escribir varios tipos de datos de números y fecha y hora en archivos YXDB (TDCE-96). La solución es colocar los datos de salida en archivos CSV o XLSX.
v2.5.0	Compatible con Alteryx Designer 2021.4.2 parche 4, 2022.1 parche 2 y versiones posteriores. Requiere el uso de AMP Engine. Se agregó la compatibilidad con DCM. Se requiere DCM para ejecutar este conector en Alteryx Server. Se agregó la opción para sobrescribir solo una hoja agregada. Se cambió el comportamiento del campo de nombre de hoja y archivo para excluirlo de los datos escritos. Se agregó la opción para mantener el campo de nombre de hoja y archivo. Ahora, la validación mediante SSL/TLS se realiza en función del almacén de certificados de Windows. Se puede utilizar FIPS. Se solucionó el problema con el nombramiento dinámico de archivos. (TPM-1688) Problema conocido Alteryx Server requiere el valor AllowAll de la configuración del modo de acceso de SDK.
v2.4.0	Compatible con Alteryx Designer 2021.4.2 y versiones posteriores. Ahora, las opciones Anexar y Sobrescribir crean una nueva versión del archivo, en lugar de eliminar el archivo antiguo y crear uno nuevo. Esto permite conservar el historial de versiones del archivo y los enlaces compartidos. Se eliminó el límite de descarga de 100 archivos en una sola carpeta.
v2.3.0	La autenticación se lleva a cabo utilizando el navegador del usuario, en lugar de CEF incrustado en Designer para cumplir con las políticas de seguridad modernas. Correcciones de errores menores.
v2.2.0	Se agregó una opción para pasar información de columnas (nombres de columna y tipos de dato) a la herramienta conectada sin tener que ejecutar el flujo de trabajo. Se agregó la salida dinámica. Se agregó una opción para cargar archivos locales a Box mediante Salida de Box. La casilla de verificación Escribir encabezados ahora está habilitada de forma predeterminada. Correcciones de errores menores.
v2.1.1	Se solucionó el problema que muestra la pantalla en blanco cuando se realiza la autenticación en Alteryx Designer 2021.3.2.54175. Ten en cuenta que también debes actualizar Designer a la versión 21.3.3.63061 o posterior. Es necesario agregar un encabezado de lista blanca a la aplicación Box después de actualizar.
v1.0.0	Admite los métodos de autenticación OAuth (incluido SSO) y Token de acceso Les permite a los usuarios descargar las carpetas y los archivos de forma local. Requiere Alteryx Designer 2021.3 o versiones posteriores.

Herramientas de Alteryx utilizadas para establecer conexiones


Herramienta Entrada de Box	Herramienta Salida de Box

Utiliza el conector de Box para ejecutar, programar y publicar flujos de trabajo desde Designer, con los archivos almacenados en tu espacio de trabajo de Box. Los tipos de archivo admitidos son XLSX, CSV e YXDB.

Atención

La automatización del escritorio (programador) no es compatible con este conector.

Administrador de conexiones de datos (DCM)

Las herramientas Box 2.5.0 y versiones posteriores son compatibles con el Administrador de conexiones de datos para almacenar tus credenciales con más facilidad y seguridad. Crea una conexión a Box y reutiliza con facilidad las credenciales almacenadas en los flujos de trabajo en los que se incluyen las herramientas Box. Alteryx Server requiere credenciales almacenadas para ejecutar los flujos de trabajo publicados correctamente.

Habilitar AMP Engine

Asegúrate de tener AMP Engine habilitado para los flujos de trabajo que contienen las herramientas Box 2.5.0 y versiones posteriores a fin de aprovechar todo el potencial de las capacidades de Designer.

Registro a la aplicación Box

Inicia sesión en https://alteryx.app.box.com/developers/console con tus credenciales de Box.
Selecciona Crear nueva aplicación.
Selecciona Aplicación personalizada.
En Método de autenticación, selecciona Autenticación de usuario (OAuth 2.0). Ingresa el nombre de la aplicación y selecciona Crear aplicación.
En la pestaña Configuración de Ámbitos de aplicación, selecciona Escribir todos los archivos y carpetas almacenados en Box para proporcionar permiso a la aplicación.
Selecciona Guardar cambios.
Para generar un nuevo token de desarrollador, selecciona Revocar y, a continuación, Generar token de desarrollador.
Para la autenticación, puedes utilizar Id. de cliente y Secreto de cliente de Credenciales OAuth 2.0.

Configuración de una aplicación personalizada

Para evitar un problema de CORS en Box cuando se utiliza la aplicación con autenticación OAuth o Token de acceso y JWT, utiliza una configuración personalizada:

Aplicación Box con autenticación OAuth:
1. Agrega el URI de redirección https://cef.alteryx.com/designer/oauthcallback para resolver el problema de CORS de la ventana CEF.
2. Ingresa file://* en Orígenes permitidos.
Aplicación Box con Token de acceso y autenticación JWT:
1. Ingresa file://* en Orígenes permitidos.

En esta sección:

Box