Box

Tipo di connessione	Strumento Alteryx. La versione più recente è disponibile in Alteryx Marketplace.
Tipo di supporto	Lettura e scrittura

Note di release

Note di release del connettore 1.0.0 (Python)

Compatibilità con Designer (da discutere)

Novità

Nuove funzionalità!
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.

Modifiche di comportamento

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

Problemi risolti

Risolto Versione di release del connettore xxxx.x.x.xxxxx
ID	Descrizione
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.

Problemi noti

Conosciuto Versione di release del connettore xxxx.x.x.xxxxx
JIRA-ID	Descrizione del problema

Conosciuto

Versione di release del connettore xxxx.x.x.xxxxx

Descrizione

JIRA-ID

Descrizione del problema

Problemi annullati

Annullato Versione di release del connettore xxxx.x.x.xxxxx
ID	Descrizione
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.

Versione	Descrizione
v2.5.6	Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Richiede AMP Engine. Risolto il problema che impediva a Input di Box di leggere i dati quando una colonna di Excel aveva dati di due tipi. (TPM-4135) Risolto il problema che impediva il funzionamento dei token Web JSON negli strumenti di Box. (TPM-4115, TDCE-520) Risolto il problema che impediva all'SDK di Python di segnalare errori DCM. (TPM-3929) Risolto il problema che impediva a Input di Box di conservare i dati relativi al tipo di data. (TDCE-537) Risolto il problema a causa del quale Output di Box convertiva i numeri in testo. (TDCE-453)
v2.5.5	Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Richiede AMP Engine. Rimosso l'utilizzo della cartella .shiv. Aggiunto il supporto per Alteryx Designer e Server 2024.1. Risolto il problema che causava l’esecuzione a oltranza di Input di Box quando questo era configurato per la lettura di un set di dati vuoto. (TPM-2453) Risolto il problema che impediva agli strumenti Box di connettersi con un token JWT appena generato. (TFLN-1855)
v2.5.4	Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Richiede AMP Engine. Risolto il problema a causa del quale Output di Box non riusciva a scrivere il tipo di dati fixedDecimal nei file YXDB. (TPM-2111). Risolto il problema a causa del quale Output di Box non riusciva a sovrascrivere alcuni file Excel di grandi dimensioni. (TPM-2169)
v2.5.2	Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Richiede AMP Engine. Per Input di Box, aggiunta un'opzione Includi sottocartelle quando si utilizza la ricerca con caratteri jolly, si scaricano file localmente o l'utente sceglie Elabora file come. Risolto un problema di prestazioni quando si utilizza la ricerca con caratteri jolly in Input di Box (TPM-2027). Risolto il problema a causa del quale la ricerca con caratteri jolly restituiva un errore alla prima esecuzione del flusso di lavoro (TPM-1847). Risolto il problema a causa del quale Output di Box non riusciva a scrivere vari tipi di dati numerici e di data e ora nei file YXDB (TDCE-96, TPM-1958). Risolto il problema a causa del quale il flusso di lavoro non funzionava quando Output di Box era configurato per utilizzare il campo in entrata per denominare dinamicamente uno o più file di output (TPM-1980). Risolto un problema a causa del quale il pannello di configurazione Box mostrava un errore intermittente se lasciato aperto per un lungo periodo di tempo (TFLN-1210). Problemi noti Output di Box non riesce a scrivere il tipo di dati fixedDecimal nei file YXDB (TPM-2111). Alteryx Server richiede il valore Consenti tutti delle impostazioni Modalità di accesso SDK.
v2.5.1	Compatibile con Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versioni successive. Richiede AMP Engine. Risolto il problema a causa del quale la scheda Configura file veniva inviata nuovamente quando gli utenti premevano Invio nel campo Percorso file (TFLN-1209). Risolto il problema a causa del quale la lettura di un file XLSX con valori Null generava un errore (TDCE-92). Risolto un problema a causa del quale un flusso di lavoro con i connettori Box tramite l'autenticazione JWT non veniva eseguito dopo un giorno, con un errore di crittografia o di token di accesso non valido (TPM-1802). Risolto il problema a causa del quale Output di Box non riusciva ad aggiungere dati quando contenevano un carattere delimitatore con virgolette (TDCE-28). Risolto il problema per cui Output di Box non riusciva a scrivere i tipi di dati data e data e ora o modificava la data ai successivi 70 anni (TPM-1902). Problemi noti Output di Box non riesce a scrivere vari tipi di dati numerici e di data e ora nei file YXDB (TDCE-96). La soluzione alternativa consiste nell'output dei dati in formato CSV o XLSX.
v2.5.0	Compatibile con Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive. Richiede AMP Engine. Aggiunto il supporto per DCM. DCM necessario per l'esecuzione di questo connettore su Alteryx Server. Aggiunta l'opzione per sovrascrivere un solo foglio aggiunto. Modificato il comportamento del campo del foglio e del nome file in modo da escluderlo dai dati scritti. Aggiunta l'opzione per conservare il campo del foglio e del nome file. La convalida SSL/TLS viene ora eseguita a fronte dell'archivio certificati Windows. Capace di operare con FIPS. Risolto il problema con la denominazione dinamica dei file (TPM-1688). Problemi noti Alteryx Server richiede il valore Consenti tutti delle impostazioni Modalità di accesso SDK.
v2.4.0	Compatibile con Alteryx Designer a partire dalla versione 2021.4.2. Le opzioni Aggiungi e Sovrascrivi ora creano una nuova versione del file anziché eliminare il file precedente e crearne uno nuovo. In questo modo si conservano la cronologia delle versioni del file e i collegamenti condivisi. Rimosso il limite dei 100 file scaricati da una singola cartella.
v2.3.0	L'autenticazione avviene utilizzando il browser dell'utente anziché il CEF incorporato in Designer per garantire la conformità con i criteri di sicurezza moderni. Correzioni di bug minori.
v2.2.0	Aggiunta un'opzione per passare le informazioni sulle colonne (nomi delle colonne e tipi di dati) allo strumento connesso senza bisogno di eseguire il flusso di lavoro. Aggiunta dello strumento Output dinamico Aggiunta un'opzione per caricare i file locali in Box tramite Output di Box. La casella di spunta Scrivi intestazioni è ora abilitata per impostazione predefinita. Correzioni di bug minori.
v2.1.1	È stato risolto un problema di schermata vuota durante l'autenticazione in Designer 2021.3.2.54175. Nota che è anche necessario eseguire l'aggiornamento a Designer 21.3.3.63061 o versione successiva. Dopo l'aggiornamento, è necessario aggiungere un'intestazione di inserimento nell'elenco dei consentiti nell'app Box.
v1.0.0	Supporta i metodi di autenticazione OAuth (incluso SSO) e token di accesso Consente agli utenti di scaricare le cartelle e i file localmente. Richiede Alteryx Designer 2021.3 e versioni successive

Strumenti Alteryx utilizzati per Connect


Strumento Input di Box	Strumento Output di Box

Utilizza il connettore Box per eseguire, pianificare e pubblicare flussi di lavoro da Designer, utilizzando i file memorizzati nello spazio di lavoro Box. I tipi di file supportati sono XLSX, CSV e YXDB.

Attenzione

Desktop Automation (programmatore) non è supportato da questo connettore.

Data Connection Manager

Gli strumenti Box versione 2.5.0 e successive supportano Data Connection Manager (DCM) per una memorizzazione più semplice e sicura delle tue credenziali. Crea una connessione a Box e riutilizza con facilità le credenziali memorizzate nei flussi di lavoro che includono gli strumenti Box. Alteryx Server richiede credenziali memorizzate per eseguire correttamente i flussi di lavoro pubblicati.

Abilitazione di AMP Engine

Per sfruttare appieno il potenziale delle funzionalità di Designer, assicurati che AMP Engine sia abilitato per i flussi di lavoro che contengono gli strumenti Box versione 2.5.0 e successive.

Registrazione dell'app Box

Accedi a https://alteryx.app.box.com/developers/console utilizzando le tue credenziali Box.
Seleziona Crea nuova app.
Seleziona App personalizzata.
In Metodo di autenticazione, seleziona Autenticazione utente (Oauth 2.0). Immetti il nome dell'app e seleziona Crea app.
Nella scheda Configurazione di Ambiti di applicazione, seleziona Scrivi in tutti i file e le cartelle memorizzati su Box per fornire l'autorizzazione all'app.
Seleziona Salva modifiche.
Per generare un nuovo token sviluppatore, seleziona Revoca, quindi seleziona Genera token sviluppatore.
Per l'autenticazione, puoi utilizzare l'ID client e il segreto client dalle credenziali OAuth 2.0.

Configurazione dell'applicazione personalizzata

Per evitare un problema di CORS Box quando si utilizza l'app con autenticazione OAuth o token di accesso e JWT, utilizza una configurazione personalizzata:

App Box con autenticazione OAuth:
1. Aggiungi l'URI di reindirizzamento https://cef.alteryx.com/designer/oauthcallback per risolvere il problema di CORS della finestra CEF.
2. Immetti file://* in Origini consentite.
App Box con token di accesso e autenticazione JWT:
1. Immetti file://* in Origini consentite.

In questa sezione:

Box