Skip to main content

Box

The Box connector lets you connect to Box tools in Designer. Box is available as a data source in the Input Data and Output Data tool.

Wichtig

New Connector Version in Designer

The Box connector is now part of the Alteryx One connectors experience. Review the information on this page carefully to ensure you're using the appropriate tools correctly.

If you want to update the Box connector in your Designer workflows, you can use the workflow migration utility.

Versionshinweise

Versionshinweise zu Konnektor 1.0.0 (Python)

Konnektor-Version xxxx.x.x.xxxxx

ID

Beschreibung

v3.0.0

  • The same DCM Connection can be used in both Input and Output tool.

  • Test Connection button has been added to all DCM authentication types to validate the credentials before saving it.

  • You can edit Scope for Built-in, Custom app.

  • You can edit Redirect URI for Custom app.

  • Box tool can render all platform-supported file formats, including CSV, XLSX, Avro, and JSON.

  • File Partitioning has been added for xlsx file format in Box Output.

  • Parquet file support in Box is available from Designer 2026.2 and above.

Prerequisites

Requirement

Detail

Designer Version

  • 2025.1 Patch 5, 2025.2 Patch 3, 2026.1 or later.

  • File partitioning is available starting with 2025.2 Patch 5.

  • Workflow Migration tool is supported for 2025.2 Patch 3 or later.

Install the Connector

You can easily install the latest version of the Box connector from Designer via the Add-Ons. This is the recommended installation method that allows you to browse, install, and update connectors without leaving Designer or visiting the Alteryx Marketplace.

To install the connector…

  1. In Designer, go to Add-Ons > Manage Marketplace Add-Ons. You will see a list of available connectors.

  2. Select Box Tools Connector and select Install. Designer downloads and installs the package. Designer might require a restart to complete the installation.

  3. After installation and setup are complete, the Box connector is available from the Input Data and Output Data tools.

Set Up a Connection

To connect to Box connector using DCM...DCM – Designer

  1. Drag the Input Data or Output Data tool to the canvas, and select Connect to Data.

  2. In the Connector Setup, select Create or Browse a Data Connection.

    If you've created a Box connection before, you can select the connection from the Recents tab.

  3. Select + New. From the list of technologies, select Box.

  4. Select Quick Connect and then select Setup Connection. The Connections window opens.

  5. Select +New.

  6. Specify the connection name and the data source name.

  7. In the Credentials section, select your authentication method, enter the credential name, and specify the access token.

  8. Select Save.

  9. Select Connect. Box may request authentication.

  10. Select the file to read from or write to in the file browser window.

  11. Select the read or write configuration in the Options window.

  12. Select Confirm to create a connection to the file. You can continue building your workflow.

Registrierung der Box-App

  1. Melden Sie sich mit Ihren Box-Anmeldedaten unter https://alteryx.app.box.com/developers/console an.

  2. Wählen Sie Neue App erstellen aus.

  3. Wählen Sie Benutzerdefinierte App aus.

  4. 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.

  5. 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.

  6. Wählen Sie Änderungen speichern aus.

  7. Um ein neues Entwicklertoken zu generieren, wählen Sie Widerrufen und dann Entwicklertoken generieren aus.

  8. 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:

  1. 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.

      BoxOAuth

    2. Geben Sie file://* für zulässige Ursprünge ein.

      BoxOAuthCORS

  2. Box-App mit Access Token und JWT-Authentifizierung:

    1. Geben Sie file://* für zulässige Ursprünge ein.

      BoxTokensCORS

Box Standalone Connectors

8. Dezember 2025

ID

Beschreibung

TPM-5038

  • Fixed an issue where the Box connector version 2.5.7 failed with multiple Box Input tools on Server 25.1 when workflows run in parallel and returned the error Failed to find DCM connection values.

TPM-5006

  • Designer displays a clear warning message when users enter an invalid sheet number, sheet name, or sheet range.

  • 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.

  • Fixed an issue where newly created files in the Box tools inherit the previously selected filename when saved with any extension.

  • Fixed an issue where selecting Enable Dry Run in the Box Input tool (version 2.5.6) using a DCM connection with JWT authentication causes an error.

  • Fixed an issue the Box connector version 2.5.7 doesn’t recognize YXDB files.

  • Fixed an error that occurs when uploading a file using the Box tools.

  • Fixed an issue where special characters in the proxy password cause an error when setting up a manual proxy server for the Box tools.

  • Fixed an issue where secret values were exposed in the returned JSON in the Designer HTML Developer Tools for the Box tools.

TPM-4984

  • 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)

Alteryx-Tools für die Verbindung

box Box-Eingabe-Tool

box 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.

In diesem Abschnitt: