Box

Verbindungstyp	Alteryx-Tool. Die aktuellste Version ist im Alteryx Marketplace verfügbar.
Typ der Unterstützung	Lesen und Schreiben

Versionshinweise

Versionshinweise zu Konnektor 1.0.0 (Python)

Kompatibilität mit Designer (noch klären)

Neuigkeiten

Brandneue Funktionen
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.

Verhaltensänderungen

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

Behobene Probleme

Behoben Konnektor-Version xxxx.x.x.xxxxx
ID	Beschreibung
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.

Bekannte Probleme

Bekannt Konnektor-Version xxxx.x.x.xxxxx
JIRA-ID	Problembeschreibung

Bekannt

Konnektor-Version xxxx.x.x.xxxxx

Beschreibung

JIRA-ID

Problembeschreibung

Zurückgezogene Probleme

Abgebrochen Konnektor-Version xxxx.x.x.xxxxx
ID	Beschreibung
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	Beschreibung
v2.5.6	Kompatibel mit Alteryx Designer und Server 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Erfordert AMP Engine. Problem behoben, bei dem das Box-Eingabe-Tool Daten nicht lesen konnte, wenn in einer Excel-Spalte zwei verschiedene Datentypen vorkamen. (TPM-4135) Problem behoben, bei dem JSON Web Token in den Box-Tools nicht funktionierten. (TPM-4115, TDCE-520) Problem behoben, bei dem das Python-SDK keine DCM-Fehler meldete. (TPM-3929) Problem behoben, bei dem das Box-Eingabe-Tool die Art der Datumstypdaten nicht beibehielt. (TDCE-537) Problem behoben, bei dem das Box-Ausgabe-Tool Zahlen in Text konvertierte. (TDCE-453)
v2.5.5	Kompatibel mit Alteryx Designer und Server 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Erfordert AMP Engine. Verwendung des .shiv-Ordners wurde entfernt. Unterstützung für Alteryx Designer und Server 2024.1 hinzugefügt. Problem behoben, bei dem das Box-Eingabe-Tool unbegrenzt ausgeführt wurde, wenn es zum Lesen eines leeren Datasets konfiguriert wurde. (TPM-2453) Problem behoben, bei dem die Box-Tools keine Verbindung mit einem neu generierten JWT-Token herstellen konnten. (TFLN-1855)
v2.5.4	Kompatibel mit Alteryx Designer und Server 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Erfordert AMP Engine. Problem behoben, bei dem die Box-Ausgabe den Datentyp fixedDecimal nicht in YXDB-Dateien schreiben konnte. (TPM-2111) Problem behoben, bei dem die Box-Ausgabe bestimmte große Excel-Dateien nicht überschreiben konnte. (TPM-2169)
v2.5.2	Kompatibel mit Alteryx Designer und Server 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Erfordert AMP Engine. Für Box-Eingaben wurde die Option „Unterordner einschließen“ hinzugefügt, wenn die Platzhaltersuche verwendet wird, Dateien lokal heruntergeladen werden oder wenn der Benutzer Datei verarbeiten als auswählt. Leistungsproblem bei Verwendung der Platzhaltersuche in Box-Eingaben behoben. (TPM-2027) Problem behoben, bei dem die Platzhaltersuche bei der ersten Ausführung des Workflows einen Fehler zurückgab. (TPM-1847) Problem behoben, bei dem die Box-Ausgabe verschiedene Zahlen- und Datums-/Uhrzeitdatentypen nicht in YXDB-Dateien schreiben konnte. (TDCE-96, TPM-1958) Problem behoben, bei dem der Workflow fehlschlug, wenn bei der Box-Ausgabe ein eingehendes Feld zum dynamischen Benennen einer oder mehrerer Ausgabedateien verwendet wird. (TPM-1980) Zeitweiliger Fehler behoben, wenn das Konfigurationsfenster der Box über einen längeren Zeitraum geöffnet bleibt. (TFLN-1210) Bekanntes Problem Box-Ausgabe kann den Datentyp fixedDecimal nicht in YXDB-Dateien schreiben. (TPM-2111) Alteryx Server erfordert den Wert AllowAll aus den SDK-Zugriffsmodus-Einstellungen.
v2.5.1	Kompatibel mit Alteryx Designer und Server 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Erfordert AMP Engine. Problem behoben, bei dem die Registerkarte Datei konfigurieren erneut gesendet wurde, wenn Benutzer die Eingabetaste im Feld Dateipfad drücken. (TFLN-1209) Problem behoben, bei dem das Lesen einer XLSX-Datei mit Nullwerten zu einem Fehler führte. (TDCE-92) Problem behoben, bei dem ein mit Box-Konnektoren und JWT-Authentifizierung ausgeführter Workflow nach einem Tag nicht mehr ausgeführt werden konnte. Dabei wurde der Fehler Kryptographie oder Ungültiger Zugriff angezeigt. (TPM-1802) Problem behoben, bei dem die Box-Ausgabe keine Daten anhängen konnte, wenn Trennzeichen in Anführungszeichen enthalten waren. (TDCE-28) Problem behoben, bei dem die Box-Ausgabe entweder die Datentypen „Datum“ und „Datum/Uhrzeit“ nicht schreiben konnte, oder das Datum 70 Jahre in die Zukunft gelegt wurde. (TPM-1902) Bekanntes Problem Die Box-Ausgabe kann verschiedene Zahlen- und Datums-/Uhrzeitdatentypen nicht in YXDB-Dateien schreiben (TDCE-96). Als Umgehungslösung können Sie Daten in CSV oder XLSX ausgeben.
v2.5.0	Kompatibel mit Designer 2021.4.2 Patch 4, 2022.1 Patch 2 und höher. Erfordert AMP Engine. Unterstützung für DCM hinzugefügt. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. Option hinzugefügt, um nur ein hinzugefügtes Blatt zu überschreiben. Das Verhalten von Blatt- und Dateinamenfeldern wurde geändert, sie werden nun von den geschriebenen Daten ausgeschlossen. Option hinzugefügt, um das Feld für den Blatt- und Dateinamen beizubehalten. Die SSL-/TLS-Validierung wird jetzt mit dem Windows Certification Store abgeglichen. FIPS-fähig. Problem mit der dynamischen Benennung von Dateien wurde behoben. (TPM-1688) Bekanntes Problem Alteryx Server erfordert den Wert AllowAll aus den SDK-Zugriffsmodus-Einstellungen.
v2.4.0	Kompatibel mit Alteryx Designer 2021.4.2 und höher. Mit den Optionen „Anhängen“ und „Überschreiben“ wird jetzt eine neue Version der Datei erstellt, anstatt die alte Datei zu löschen und eine neue zu erstellen. Dadurch werden Versionsverlauf und die freigegebene Links der Datei beibehalten. Die Begrenzung, dass nur 100 Dateien aus einem einzelnen Ordner heruntergeladen werden können, wurde entfernt.
v2.3.0	Die Authentifizierung erfolgt über den Browser des Benutzers, nicht mit der eingebetteten CEF in Designer. So werden moderne Sicherheitsrichtlinien eingehalten. Kleinere Fehlerbehebungen.
V2.2.0	Es wurde eine Option hinzugefügt, mit der Spalteninformationen (Spaltennamen und Datentypen) an das verbundene Tool übergeben werden können, ohne dass der Workflow ausgeführt werden muss. Dynamische Ausgabe hinzugefügt Es wurde eine Option zum Hochladen lokaler Dateien mit der Box-Ausgabe hinzugefügt. Das Kontrollkästchen „Kopfzeilen schreiben“ ist jetzt standardmäßig aktiviert. Kleinere Fehlerbehebungen.
v2.1.1	Problem behoben, dass leerer Bildschirm bei der Authentifizierung in Designer 2021.3.2.54175 angezeigt wird. Beachten Sie, dass Sie ebenfalls auf Designer 21.3.3.63061 oder höher aktualisieren müssen. Nach der Aktualisierung muss eine Whitelisting-Kopfzeile in Ihrer Box-App hinzugefügt werden.
v1.0.0	Unterstützt OAuth (einschließlich SSO) und Zugriffstoken-Authentifizierungsmethoden Ermöglicht Benutzern, die Ordner und Dateien lokal herunterzuladen. Erfordert Alteryx Designer 2021.3 und höher

Alteryx-Tools für die Verbindung


Box-Eingabe-Tool	Box-Ausgabe-Tool

Verwenden Sie den Box-Konnektor zum Ausführen, Planen und Veröffentlichen von Workflows aus Designer unter Verwendung von Dateien, die in Ihrem Box-Arbeitsbereich gespeichert sind. Unterstützte Dateitypen sind XLSX, CSV und YXDB.

Achtung

Desktop Automation (Planer) wird von diesem Konnektor nicht unterstützt.

Data Connection Manager

Die Box-Tools ab Version 2.5.0 unterstützen Data Connection Manager für eine einfachere und sicherere Speicherung Ihrer Anmeldedaten. Stellen Sie eine Verbindung zu Box her, um die gespeicherten Anmeldedaten einfach in Workflows wiederverwenden zu können, die Box-Tools enthalten. Alteryx Server benötigt gespeicherte Anmeldedaten, um die veröffentlichten Workflows erfolgreich ausführen zu können.

AMP Engine aktivieren

Stellen Sie sicher, dass die AMP Engine für Workflows aktiviert ist, die Box-Tools ab Version 2.5.0 enthalten, um das volle Potenzial von Designer auszuschöpfen.

Registrierung der Box-App

Melden Sie sich mit Ihren Box-Anmeldedaten unter https://alteryx.app.box.com/developers/console an.
Wählen Sie Neue App erstellen aus.
Wählen Sie Benutzerdefinierte App aus.
Wählen Sie unter Authentifizierungsmethode die Option Benutzerauthentifizierung (OAuth 2.0) aus. Geben Sie den App-Namen ein, und wählen Sie App erstellen aus.
Wählen Sie auf der Registerkarte Konfiguration unter App-Geltungsbereiche die Option Alle in Box gespeicherten Dateien und Ordner schreiben aus, um der App Berechtigungen zu erteilen.
Wählen Sie Änderungen speichern aus.
Um ein neues Entwicklertoken zu generieren, wählen Sie Widerrufen und dann Entwicklertoken generieren aus.
Zur Authentifizierung können Sie die Client-ID und das Client-Geheimnis aus den OAuth 2.0-Anmeldedaten verwenden.

Benutzerdefinierte Anwendungseinrichtung

Um ein Box CORS-Problem bei der Verwendung der App mit OAuth-Authentifizierung oder Access Token und JWT zu vermeiden, empfiehlt es sich, eine benutzerdefinierte Konfiguration zu verwenden:

Box-App mit OAuth-Authentifizierung:
1. Fügen Sie URI umleiten https://cef.alteryx.com/designer/oauthcallback hinzu, um das CORS-Problem im CEF-Fenster zu beheben.
2. Geben Sie file://* für zulässige Ursprünge ein.
Box-App mit Access Token und JWT-Authentifizierung:
1. Geben Sie file://* für zulässige Ursprünge ein.

In diesem Abschnitt:

Box