Box

Type de connexion	Outil Alteryx. La version la plus récente est disponible dans Alteryx Marketplace.
Type de prise en charge	Lecture et écriture

Notes de publication

Notes de mise à jour du Connecteur 1.0.0 (Python)

Compatibilité avec Designer (à discuter)

Nouveautés

De toutes nouvelles fonctionnalités !
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.

Changements de comportement

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

Problèmes résolus

Corrigé Version majeure xxxx.x.x.xxxxx du COnnecteur
ID	Description
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.

Problèmes connus

Connu Version majeure xxxx.x.x.xxxxx du COnnecteur
ID JIRA	Description du problème

Connu

Version majeure xxxx.x.x.xxxxx du COnnecteur

Description

ID JIRA

Description du problème

Problèmes annulés

Annulé Version majeure xxxx.x.x.xxxxx du COnnecteur
ID	Description
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.

Version	Description
v2.5.6	Compatible avec Alteryx Designer et Server 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Nécessite AMP Engine. Correction d'un problème où l'outil Entrée de Box ne pouvait pas lire les données lorsqu'une colonne Excel contenait deux types de données. (TPM-4135) Correction d'un problème où les jetons Web JSON ne fonctionnaient pas dans les outils Box. (TPM-4115, TDCE-520) Correction d'un problème où SDK de Python ne signalait pas les erreurs DCM. (TPM-3929) Correction d'un problème où l'outil Entrée de Box ne conservait pas le type de données Date. (TDCE-537) Correction d'un problème où l'outil Sortie de Box convertissait des nombres en texte. (TDCE-453)
v2.5.5	Compatible avec Alteryx Designer et Server 2021.4.2 Correctif 6, 2022.1 Correctif 4 et versions ultérieures. Nécessite AMP Engine. Suppression de l'utilisation du dossier .shiv. Ajout de la prise en charge pour Alteryx Designer et Server 2024.1. Correction d'un problème où l'outil Entrée de Box s'exécutait en continu lorsqu'il était configuré pour lire un jeu de données vide. (TPM-2453) Correction d'un problème où les outils Box ne pouvaient pas se connecter à un jeton JWT nouvellement généré. (TFLN-1855)
v2.5.4	Compatible avec Alteryx Designer et Server 2021.4.2 Correctif 6, 2022.1 Correctif 4 et versions ultérieures. Nécessite AMP Engine. Correction d'un problème où l'outil Sortie de Box ne parvient pas à écrire le type de données FixedDecimal dans les fichiers YXDB. (TPM-2111) Correction d'un problème où l'outil Sortie de Box ne parvient pas à écraser certains fichiers Excel volumineux. (TPM-2169)
v2.5.2	Compatible avec Alteryx Designer et Server 2021.4.2 Correctif 6, 2022.1 Correctif 4 et versions ultérieures. Nécessite AMP Engine. Pour Entrée de Box, ajout d'une option Inclure les sous-dossiers lors de l'utilisation de la recherche par caractères génériques, du téléchargement de fichiers localement ou lorsque l'utilisateur choisit de Traiter le fichier comme. Correction d'un problème de performance lors de l'utilisation de la recherche par caractères génériques dans Entrée de Box. (TPM-2027) Correction d'un problème où la recherche avec caractère générique renvoyait une erreur la première fois que workflow s'exécutait. (TPM-1847) Correction d'un problème où Sortie de Box ne pouvait pas écrire différents types de données de nombre et de date-time dans les fichiers YXDB. (TDCE-96, TPM-1958) Correction d'un problème où workflow échouait lorsque Sortie de Box était configurée pour utiliser le champ entrant pour nommer dynamiquement un ou plusieurs fichiers de sortie. (TPM-1980) Correction d'un problème où le panneau de configuration de Box affichait une erreur intermittente lorsqu'il était laissé ouvert pendant une longue période de temps. (TFLN-1210) Problèmes connus Sortie de Box ne parvient pas à écrire le type de données fixedDecimal dans les fichiers YXDB. (TPM-2111) Alteryx Server requiert la valeur AllowAll des paramètres du mode d'accès au SDK.
v2.5.1	Compatible avec Alteryx Designer et Server 2021.4.2 Correctif 6, 2022.1 Correctif 4 et versions ultérieures. Nécessite AMP Engine. Correction d'un problème où l'onglet Configurer le fichier était renvoyé lorsque les utilisateurs appuyaient sur Entrée dans le champ Chemin du fichier. (TFLN-1209) Correction d'un problème où la lecture d'un fichier XLSX avec des valeurs nulles entraînait une erreur. (TDCE-92) Correction d'un problème où une exécution de workflow avec les connecteurs Box utilisant l'authentification JWT ne s'exécutait pas après une journée, avec l'erreur cryptographie ou Jeton d'accès non valide. (TPM-1802) Correction d'un problème où Sortie de Box ne pouvait pas ajouter de données lorsqu'il contenait un caractère de délimiteur entre guillemets. (TDCE-28) Correction d'un problème où Sortie de Box ne parvenait pas à écrire les types de données date et date-time, ou changeait la date à 70 ans dans le futur. (TPM-1902) Problèmes connus Sortie de Box ne parvient pas à écrire différents types de données de nombre et de date-time dans des fichiers YXDB (TDCE-96). La solution consiste à sortir les données au format CSV ou XLSX.
v2.5.0	Compatible avec Designer 2021.4.2 Correctif 4, 2022.1 Correctif 2 et versions ultérieures. Nécessite AMP Engine. Ajout de la prise en charge pour DCM. DCM est nécessaire pour exécuter ce connecteur sur Alteryx Server. Ajout d'une option pour remplacer une seule feuille ajoutée. Modification du comportement du champ de nom de feuille et de fichier à exclure des données écrites. Ajout d'une option pour conserver le champ de nom de feuille et de fichier. La validation SSL/TLS est désormais effectuée par rapport au magasin de certificats Windows. Compatible FIPS. Correction d'un problème avec le nommage dynamique des fichiers. (TPM-1688) Problèmes connus Alteryx Server requiert la valeur AllowAll des paramètres du mode d'accès au SDK.
v2.4.0	Compatible avec Alteryx Designer version 2021.4.2 et ultérieure. Les options Ajouter et Remplacer créent désormais une nouvelle version du fichier plutôt que de supprimer l'ancien fichier et d'en créer une nouvelle. Cela préserve l'historique des versions du fichier et les liens partagés. Suppression de la limite de 100 fichiers téléchargés à partir d'un seul dossier.
v2.3.0	L'authentification se produit à l'aide du navigateur de l'utilisateur au lieu de CEF intégré dans Designer pour se conformer aux politiques de sécurité modernes. Corrections de bugs mineurs.
v2.2.0	Ajout d'une option pour transmettre les informations de colonne (noms de colonne et types de données) à l'outil connecté sans avoir besoin d'exécuter le workflow. Ajout de l'outil Sortie dynamique Ajout d'une option pour télécharger des fichiers locaux vers Box à l'aide de Sortie de Box. La case Écrire les en-têtes est désormais activée par défaut. Corrections de bugs mineurs.
v2.1.1	Correction du problème d'écran vide lors de l'authentification dans Designer 2021.3.2.54175. Notez que vous devez également effectuer une mise à jour vers Designer 21.3.3.63061 ou une version ultérieure. Un en-tête de liste blanche doit être ajouté dans votre application Box après la mise à jour.
v1.0.0	Prend en charge les méthodes d'authentification OAuth (y compris SSO) et jeton d'accès Permet aux utilisateurs de télécharger les dossiers et les fichiers localement. Nécessite Alteryx Designer 2021.3 et versions ultérieures

Outils Alteryx utilisés pour la connexion


Outil Entrée de Box	Outil Sortie de Box

Utilisez le connecteur Box pour exécuter, planifier et publier des workflows à partir de Designer, à l'aide de fichiers stockés dans votre espace de travail Box. Les types de fichiers pris en charge sont XLSX, CSV et YXDB.

Attention

L'automatisation de bureau (Planificateur) n'est pas prise en charge par ce connecteur.

Gestionnaire de connexions aux données

Les outils Box version 2.5.0 et ultérieure prennent en charge le Gestionnaire de connexions aux données pour un stockage plus simple et plus sûr de vos informations d'identification. Créez une connexion à Box et réutilisez facilement les informations d'identification stockées dans les workflows incluant les outils Box. Alteryx Server nécessite des informations d'identification stockées pour exécuter correctement les workflows publiés.

Activation d'AMP Engine

Assurez-vous que l'outil AMP Engine est activé pour les workflows contenant les outils Box version 2.5.0 et ultérieure afin de tirer pleinement parti des fonctionnalités de Designer.

Inscription de l'application Box

Connectez-vous à https://alteryx.app.box.com/developers/console à l'aide de vos informations d'identification Box.
Sélectionnez Créer une nouvelle application.
Sélectionnez Application personnalisée.
Dans Méthode d'authentification, sélectionnez Authentification utilisateur (OAuth 2.0). Saisissez le Nom de l'application et sélectionnez Créer une application.
Dans l'onglet Configuration de la section Étendue de l'application, sélectionnez Écrire tous les dossiers et fichiers stockés dans Box pour donner l'autorisation à l'application.
Sélectionnez Enregistrer les modifications.
Pour générer un nouveau jeton de développeur, sélectionnez Révoquer, puis Générer un jeton de développeur.
Vous pouvez utiliser l'ID client et le secret client issus des Informations d'identification OAuth 2.0 pour l'authentification.

Configuration d'application personnalisée

Pour éviter un problème CORS de Box lors de l'utilisation de l'application avec l'authentification OAuth ou le jeton d'accès et JWT, utilisez une configuration personnalisée :

Application Box avec authentification OAuth :
1. Ajoutez URL de redirection https://cef.alteryx.com/designer/oauthcallback pour résoudre le problème CORS de la fenêtre CEF.
2. Saisissez file://* pour Origines autorisées.
Application Box avec jeton d'accès et authentification JWT :
1. Saisissez file://* pour Origines autorisées.

Dans cette section:

Box