Skip to main content

microsoft-onedrive-icon.png Microsoft OneDrive

Mit dem OneDrive-Konnektor können Sie eine Verbindung zum Microsoft OneDrive-Cloud-Speicher in Designer herstellen. OneDrive ist als Datenquelle im Eingabedaten-Tool und im Datenausgabe-Tool verfügbar.

Upgrade auf den neuen OneDrive-Konnektor

Falls Ihr Workflow das eigenständige OneDrive-Eingabe- oder OneDrive-Ausgabe-Tool verwendet, beachten Sie bitte, dass diese mittlerweile veraltet sind. Verwenden Sie stattdessen Konnektor-Version 2.2.0 oder höher mit dem Eingabedaten- und dem Datenausgabe-Tool. Verwenden Sie das Hilfsprogramm für Workflow-Migration, um bestehende Workflows zu aktualisieren.Output Data Tool Icon Datenausgabe-Tool

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben, bevor Sie fortfahren:

Anforderung

Details

Designer

Designer 2026.1 oder höher.

Designer 2025.2 Patch 3 oder höher.

Designer 2025.1 Patch 5 oder höher.

Konnektor-Version

Microsoft OneDrive Version 2.2.0 oder höher. Verfügbar über Add-ons in Designer.

Azure-Berechtigungen

Siehe Microsoft Azure API-Anwendung einrichten.

DCM

Sie müssen den DCM in Designer aktivieren. Gehen Sie zu Optionen > Erweiterte Einstellungen > DCM, um ihn zu aktivieren.

Netzwerkzugriff

Ausgehender Zugriff auf OneDrive Online- und Microsoft OAuth-Endpunkte.

Konnektor installieren

Installieren Sie die neueste Version des OneDrive-Konnektors mit Add-ons direkt über Designer. Dies ist die empfohlene Installationsmethode, mit der Sie Konnektoren durchsuchen, installieren und aktualisieren können, ohne Designer zu verlassen oder den Alteryx Marketplace zu besuchen.

So installieren Sie den Konnektor:

  1. Gehen Sie in Designer zu Add-ons > Marketplace-Add-ons verwalten. Es wird eine Liste der verfügbaren Konnektoren angezeigt.

  2. Wählen Sie den Microsoft OneDrive-Konnektor aus und wählen Sie dann Installieren aus. Designer lädt das Paket herunter und installiert es. Designer erfordert möglicherweise einen Neustart, um die Installation abzuschließen.

  3. Nach Abschluss der Installation und der Einrichtung ist der OneDrive-Konnektor über das Eingabedaten-Tool und das Datenausgabe-Tool verfügbar.

Eine Verbindung einrichten

So stellen Sie eine Verbindung zu Microsoft OneDrive her:

  1. Ziehen Sie das Dateneingabe-Tool oder das Datenausgabe-Tool auf den Canvas und wählen Sie Mit Daten verbinden aus.

  2. Wählen Sie in der Konnektoreinrichtung die Option Datenverbindung erstellen oder durchsuchen aus.

    Wenn Sie zuvor eine Microsoft OneDrive-Verbindung erstellt haben, können Sie die Verbindung auf der Registerkarte Zuletzt verwendete auswählen.

  3. Wählen Sie + Neu aus. Wählen Sie in der Liste der Technologien Microsoft OneDrive aus.

  4. Geben Sie den Verbindungsnamen und den Datenquellennamen ein.

  5. Wählen Sie im Abschnitt Anmeldedaten Ihre Authentifizierungsmethode aus und geben Sie die Anmeldedaten ein. Weitere Informationen finden Sie unter Authentifizierungsmethoden.

  6. Wählen Sie Speichern aus. Sie können die Verbindung auch vor dem Speichern testen.

  7. Wählen Sie Verbinden aus. Microsoft OneDrive kann eine Authentifizierung anfordern.

  8. Wählen Sie im Fenster Optionen die Lese- oder Schreibkonfiguration aus. Weitere Informationen zu den Optionen finden Sie unter Daten aus OneDrive lesen oder Daten in OneDrive schreiben.Daten aus OneDrive lesenDaten in OneDrive schreiben

  9. Wählen Sie Bestätigen, um eine Verbindung zur Datei herzustellen. Anschließend können Sie mit der Erstellung Ihres Workflows fortfahren.

Workflow-Migration

Wenn Ihre vorhandenen Workflows die veralteten OneDrive-Eingabe- oder OneDrive-Ausgabe-Tools verwenden, müssen sie zunächst migriert werden, damit Sie den neuen Konnektor verwenden können. Verwenden Sie das Hilfsprogramm für Workflow-Migration, um bestehende Workflows zu aktualisieren.

Das Hilfsprogramm zeigt eine Vorschau aller Änderungen an und ersetzt veraltete Tool-Instanzen durch die neuen Konnektor-Versionen. Workflows funktionieren auch weiterhin.

Authentifizierungsmethoden

Microsoft OneDrive unterstützt drei Authentifizierungsmethoden. Verwenden Sie die nachstehende Tabelle, um die richtige für Ihren Anwendungsfall auszuwählen.

Methode

Details

Azure AD – privat (integrierte App)

  • Verwenden Sie diese Option, um eine persönliche Ad-hoc-Verbindung mit Ihren eigenen Microsoft-Anmeldedaten einzurichten.

  • E-Mail und Kennwort sind mit Ihren persönlichen Microsoft-Anmeldedaten verknüpft.

  • Dies kann für SDK verwendet werden.

  • Nicht empfohlen für die Planung von Workflows.

  • DCM ist optional.

Azure AD – privat (benutzerdefinierte App)

  • Verwenden Sie diese Option, wenn Ihr Team eine benutzerdefinierte registrierte Azure-App freigibt.

  • Dies kann für SDK verwendet werden.

  • Anweisungen zur Einrichtung finden Sie unter Einrichtung der Microsoft Azure API-App.

  • DCM ist optional.

Dienstprinzipal (Anwendung)

  • Verwenden Sie diese Option, um Workflows zu planen oder zu automatisieren, ohne die Authentifizierung an eine:n bestimmte:n Benutzer:in zu binden.

  • Nutzt die Funktionen benutzerdefinierter API-Anwendungen mit einem Dienstprinzipal.

  • Anweisungen zur Einrichtung finden Sie unter Einrichtung der Microsoft Azure API-App.

  • DCM ist erforderlich.

Beschränkungen

Der Microsoft OneDrive-Konnektor weist derzeit die folgenden Einschränkungen auf:

  • Die zugrunde liegenden Graph-APIs Zuletzt verwendet und Für mich freigegeben von Microsoft sind veraltet und geben keine Daten mehr zurück. Dies ist eine von diesem Konnektor unabhängige Einschränkung auf Plattformebene.

    Daher können die Bereiche Zuletzt verwendet und Für mich freigegeben weder durchsucht noch aufgerufen werden, und der OneDrive-Pfad ist auf Meine Dateien beschränkt.

  • Partitionierung wird nicht unterstützt.

  • Das Lesen von Daten mit Platzhaltern oder aus mehreren Dateien oder Ordnern wird nicht unterstützt, lässt sich aber mit Makros erreichen.

  • Die Ausgabeaktion Anhängen wird nicht unterstützt. Verwenden Sie Lesen > Zusammenführen > Überschreiben, um das Verhalten von Anhängen zu replizieren.

  • Wenn Sie eine neue Datei erstellen und bereits eine Datei mit demselben Namen am Zielort vorhanden ist, wird sie durch die Aktion nicht überschrieben. Stattdessen wird dem Namen der neuen Datei ein Zeitstempel-Suffix angehängt; beide Dateien bleiben erhalten.

  • Das Lesen von XLSX-Dateien mit mehreren Blättern oder das Auswählen eines Blattes nach Namen oder Index wird nicht unterstützt.

Versionshinweise

Version

Beschreibung

v3.1.1

  • Das Feld Autoritäts-URL wurde mit einem bereits ausgefüllten Standardwert und einem Inline-Hilfetext verbessert, sodass keine externe Dokumentation mehr benötigt wird.

  • Es wurde ein Problem behoben, bei dem die Auswahl eines nicht unterstützten Dateiformats im OneDrive-Eingabekonnektor irrelevante Konfigurationsoptionen anzeigen würde.

  • Es wurde ein Problem behoben, bei dem Verbindung testen in DCM bei Verwendung des integrierten App-Authentifizierungstyps fehlschlug.

  • Verbesserte Fehlerbehandlung für Eingehende und Ausgehende Vorgänge in OneDrive.

v3.1.0

  • Kompatibel mit Designer 2021.4.2 Patch 4, 2022.1 Patch 2 und höher.

  • Sie haben nun die Möglichkeit, sich mit dem sicheren OAuth-2.0-Anmeldeverfahren von Microsoft mit OneDrive zu verbinden.

  • Authentifizieren Sie sich mit einem Dienstprinzipal für automatisierte, nicht verwaltete Workflows.

  • Speichern Sie Ihre Anmeldedaten einmal über DCM und verwenden Sie sie für verschiedene Workflows auf Designer und Server.

  • Führen Sie nicht verwaltete Aufträge auf dem Server mit automatischer Tokenaktualisierung aus, ohne dass eine manuelle erneute Authentifizierung erforderlich ist.

  • Schnelles Filtern nach Persönliche Dateien, Für mich freigegeben oder Zuletzt verwendete Dateien.

  • Wählen Sie Dateien aus, indem Sie die Dateiauswahl nutzen, einen Pfad manuell eingeben oder einfach einen freigegebenen OneDrive-Link einfügen.

  • Fügen Sie eine URL ein und der Konnektor identifiziert und lädt automatisch die Details der zugehörigen Datei.

  • Wählen Sie ein bestimmtes Blatt anhand seines Namens oder seiner Nummer aus, legen Sie einen benutzerdefinierten Zellbereich fest oder rufen Sie lediglich die Liste der Blattnamen ab.

  • Geben Sie Details wie Dateiname, Pfad, Größe, Datum der letzten Änderung und Dateityp neben Ihren Daten ein.

  • Rufen Sie nur die Datei-/Ordnerstruktur ab, ohne den vollständigen Dateiinhalt herunterzuladen.

  • Lesen Sie Dateien der Formate CSV, XLSX und YXDB direkt aus OneDrive.

v2.3.0

  • Kompatibel mit Designer 2021.4.2 Patch 4, 2022.1 Patch 2 und höher.

  • Nur mit AMP Engine kompatibel.

  • Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich.

  • Das Fenster mit den Authentifizierungsoptionen wurde verbessert.

  • Die Ausgabe des OneDrive-Eingabe-Tools enthält jetzt die Blattnamen, wenn Sie XLSX-Dateien lokal herunterladen. Sie können die Blattnamen in anderen Tools Ihres Workflows verwenden.

  • Problem behoben, bei dem auch andere Blätter geändert wurden, wenn das OneDrive-Ausgabe-Tool ein bestimmtes Blatt in der XLSX-Datei überschreiben sollte.

  • Problem behoben, bei dem die Authentifizierung der OneDrive-Tools nicht richtig funktionierte. (TPM-3833)

  • Problem behoben, bei dem das OneDrive-Eingabe-Tool bestimmte Datentypen nicht korrekt las. (TPM-3751, TPM-3722, TPM-3721)

  • Problem behoben, bei dem das OneDrive-Ausgabe-Tool falsche Dateien schrieb, wenn die Daten Festkomma- oder Nullwerte enthalten. (TPM-3720)

  • Problem behoben, bei dem das OneDrive-Ausgabe-Tool Nullwerte in CSV-Dateien falsch konvertierte. (TPM-3719)

  • Problem behoben, bei dem die Dienstprinzipal-Authentifizierung im OneDrive-Ausgabe-Tool nicht funktionierte. (TPM-3580)

  • Problem behoben, bei dem das OneDrive-Ausgabe-Tool das Feld der Optionen für die Blattauswahl in die Ausgabe einschloss, obwohl der Benutzer in den Einstellungen festgelegt hatte, dass das Feld ausgeschlossen werden soll. (TPM-3393)

  • Problem behoben, bei dem das OneDrive-Ausgabe-Tool Daten nicht korrekt anhängte. (TPM-2564)

  • Problem behoben, bei dem die Option „Abbrechen“ im OneDrive-Ausgabe-Tool nicht für alle Datentypen korrekt funktionierte. (TPM-2563)

  • Die Codierungsprobleme der OneDrive-Tools wurden behoben. (TPM-1984)

  • Problem behoben, bei dem das OneDrive-Ausgabe-Tool das Kopfzeilenformat änderte. (TPM-1375)

  • Problem behoben, bei dem die Option „Anhängen“ des OneDrive-Ausgabe-Tools die Formatierung und die Formeln des Dokuments überschrieb. (TPM-1179)

  • Problem behoben, bei dem das OneDrive-Eingabe-Tool YXDB-Dateien mit Datum/Uhrzeit-Daten nicht lesen konnte. (TPM-1100)

  • Problem behoben, bei dem das OneDrive-Ausgabe-Tool fehlschlug, wenn der Workflow Daten der Datentypen Byte und Int16 enthält. (TPM-209)

V2.2.0

  • Kompatibel mit Designer 2021.4.2 Patch 4, 2022.1 Patch 2 und höher.

  • Nur mit AMP Engine kompatibel.

  • Unterstützung für DCM hinzugefügt.

    • Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich.

  • FIPS-fähig.

  • Option hinzugefügt, um nur ein Blatt zu überschreiben.

  • Das Verhalten von Blattnamenfeldern wurde geändert, sie werden nun von den geschriebenen Daten ausgeschlossen. Option hinzugefügt, um das Feld für den Blattnamen beizubehalten.

  • Die SSL-/TLS-Validierung wird jetzt mit dem Windows Certification Store abgeglichen.

v2.1.0

  • Die Authentifizierung erfolgt über den Browser des/der Benutzer:in, nicht mit der eingebetteten CEF in Designer. So werden moderne Sicherheitsrichtlinien eingehalten.

v2.0.2

  • Problem behoben, bei dem die Tool-Konfiguration verloren ging, wenn „Geben Sie Ihre Authentifizierungsinformationen an“ aktiviert war.

v2.0.1

  • Problem mit leerem Bildschirm bei der Authentifizierung in Designer 2021.3.2.54175 behoben. Bitte beachten Sie, dass Sie ebenfalls auf Designer 21.3.3.63061 oder höher aktualisieren müssen.

v2.0.0

  • Integrierte Multi-Tenant-fähige Azure App mit optionaler Verwendung einer benutzerdefinierten Azure App (einschließlich Single-Tenant-App oder Dienstprinzipal).

  • Unterstützt das Lesen und Schreiben der Dateiformate XLSX, CSV und YXDB.

  • Proxy-Unterstützung.

  • Kompatibel mit Designer Version 2021.2.2 und höher.

  • OneDrive 365 erforderlich.

v1.0.2

  • Codepage-Optionen aktualisieren.

  • Es ist möglich, zwischen Codierungen mit derselben Sprache (z. B. „Sprache“ -> „Sprache (spezifischer Code)“) und sortierten Codierungen alphabetisch zu unterscheiden.

  • Dem Benutzer erlauben, die Codierung für CSV-Dateien im Ausgabe-Tool anzugeben.

  • Verbesserte Verarbeitung der Datenkonvertierung, sodass statt einer Warnung ein Fehler ausgegeben wird, wenn ein Feld keinen Wert hat.

  • Problem behoben, bei dem die Standardwert-Einstellungen gelegentlich nicht beachtet wurden.

  • Produktionsprotokollierung deaktiviert, um Berechtigungsprobleme für verschiedene Installationen/Konfigurationen von Designer zu verhindern und die Funktion für geplante Workflows zu unterstützen.

v1.0.1

  • Problem behoben, bei dem Pakete nicht erfolgreich installiert werden konnten.

v1.0.0

  • Erste Version von OneDrive-Eingabe und OneDrive-Ausgabe.

Benutzerdefinierte Microsoft Azure API-Anwendung

Informationen zum Einrichten einer benutzerdefinierten API-Anwendung für dieses Tool finden Sie in unserem Handbuch.

Anmerkung

Die AMP Engine muss für Workflows aktiviert sein, die OneDrive-Tools ab Version 2.2.0 enthalten. Weitere Informationen finden Sie unter AMP Engine.

Alteryx-Tools für die Verbindung

OneDrive Input Tool Icon OneDrive-Eingabe-Tool

OneDrive Output Tool Icon OneDrive-Ausgabe-Tool

In diesem Abschnitt: