Zum Hauptinhalt springen

OneDrive-Integration - Einrichtungsanleitung

Verbinde dein OneDrive-Konto mit Goodweek, um Dateien, Ordner, Freigabelinks, Arbeitsmappen und Dokumentinhalte direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein OneDrive-Konto mit Goodweek, um Dateien, Ordner, Freigabelinks, Arbeitsmappen und Dokumentinhalte direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die Zugriffsrechte, die dem Nutzer innerhalb von OneDrive gewährt wurden, und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Nutzers variieren.

📋 Voraussetzungen

Bevor ein Nutzer die OneDrive-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek Admin-Panel unter dem Tab Integrationen aktivieren.

Admin-Einrichtung

Die OneDrive-Integration nutzt Microsoft OAuth 2.0 über Microsoft Entra ID. Damit sich Nutzer verbinden können, muss ein Microsoft-Entra-Mandantenadministrator die Administratorzustimmung für die Anwendung erteilen. Ohne diesen Schritt kann während des Verbindungsvorgangs ein Berechtigungsfehler angezeigt werden.

Je nach Konfiguration deiner Entra ID gibt es drei typische Szenarien:

  1. Die Administratorzustimmung wurde bereits erteilt. Nutzer können sich ohne weitere Schritte direkt verbinden.

  2. Die Nutzerzustimmung ist in deinem Mandanten deaktiviert. Ein Entra-Administrator muss die Zustimmung im Namen der Organisation erteilen, bevor sich Nutzer verbinden können. Gehe zu Microsoft Entra Admin Center → Unternehmensanwendungen → Composio → Berechtigungen → Administratorzustimmung für [deine Organisation] erteilen.

  3. Der Zugriff auf OneDrive- oder SharePoint-Daten ist auf Ressourcenebene eingeschränkt. Je nach den Einstellungen deiner Organisation müssen möglicherweise zusätzliche Berechtigungen konfiguriert werden, bevor die Integration auf Dateiinhalte zugreifen kann.

⚠️ Wichtig: Sonderfall der Microsoft-Administratorsitzung

Wenn ein Microsoft-Entra-Mandantenadministrator den OAuth-Verbindungsvorgang selbst durchführt, wendet Microsoft die Administratorzustimmung möglicherweise automatisch an und verknüpft die Integration mit dem Konto des Administrators statt mit dessen individuellem Nutzerkonto. Dies ist ein Verhalten von Microsoft und kann auf OAuth-Ebene nicht geändert werden.

Empfohlenes Vorgehen: Der Administrator sollte die App in Entra ID vorab genehmigen (Unternehmensanwendungen → Composio → Berechtigungen → Administratorzustimmung für deine Organisation erteilen), bevor irgendein Nutzer – einschließlich des Administrators – den Goodweek-Verbindungsvorgang durchläuft. Nach der Vorabgenehmigung kann jeder Nutzer, einschließlich des Administrators, den Vorgang abschließen, und die Integration wird mit seinem individuellen Konto verknüpft.

Alternativ kann ein Nutzer ohne Administratorrechte den Verbindungsvorgang zuerst abschließen, um dieses Problem zu vermeiden.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche OneDrive und klicke auf Verbinden.

  3. Du wirst zu Microsoft weitergeleitet, wo du dich mit deinem Microsoft-Konto anmelden und den Zugriff autorisieren musst.

  4. Klicke auf Akzeptieren, um den Zugriff zu gewähren und zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto einzeln verbinden.

  • Goodweek kann nur auf Dateien und Ordner zugreifen, die zu dem von dir autorisierten Konto gehören, sowie auf alle für dich freigegebenen Dateien.

  • Du kannst den Zugriff von Goodweek jederzeit über Microsoft-Konto → Mein Konto → Datenschutz → Apps und Dienste → Composio → Zugriff entfernen widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

List OneDrive Items

Ruft Dateien und Ordner aus dem Stammverzeichnis des OneDrive des Nutzers ab.

Lesen

List Folder Children

Listet die direkten Dateien und Ordner in einem OneDrive-Ordner anhand der DriveItem-ID oder des Pfads auf.

Lesen

List All Drive Items

Listet ein vollständiges OneDrive- oder SharePoint-Laufwerk sicher mithilfe von Delta-Paginierung auf.

Lesen

Find Item

Findet eine Datei oder einen Ordner anhand des Namens innerhalb eines bestimmten OneDrive-Ordners.

Lesen

Find Folder

Findet Ordner anhand des Namens innerhalb eines zugänglichen übergeordneten Ordners in OneDrive.

Lesen

Search Drive Items

Durchsucht OneDrive und zugängliche SharePoint-Dateien per Schlagwort über Dateinamen, Metadaten und Inhalt hinweg.

Lesen

Search Items

Durchsucht OneDrive nach Dateien und Ordnern anhand eines Schlagworts, einschließlich des Dateiinhalts.

Lesen

Get Item Metadata

Ruft die Metadaten eines DriveItems anhand seiner eindeutigen ID ab, einschließlich Name, Größe und Zeitstempel.

Lesen

Get Drive Root Folder

Ruft die Metadaten des Stammordners des OneDrive des angemeldeten Nutzers ab.

Lesen

Get Drive Special Folder

Ruft einen speziellen OneDrive-Ordner anhand des Namens ab (Dokumente, Desktop, Fotos usw.).

Lesen

Get DriveItem by Sharing URL

Löst eine OneDrive- oder SharePoint-Freigabe-URL in ein DriveItem mit vollständigen Metadaten auf.

Lesen

List OneDrive Shared Items

Listet die von OneDrive-Konten anderer Personen freigegebenen Dateien auf, die für den Nutzer zugänglich sind.

Lesen

Download a File

Lädt eine Datei aus OneDrive anhand ihrer Element-ID herunter.

Lesen

Download File by Path

Lädt den Inhalt einer Datei aus OneDrive anhand ihres Pfads herunter.

Lesen

Download Item as Format

Lädt ein DriveItem herunter, das in ein angegebenes Format wie PDF oder HTML konvertiert wurde.

Lesen

Upload File

Lädt eine Datei in einen angegebenen OneDrive-Ordner hoch und erstellt bei Bedarf den Zielordner.

Schreiben

Update File Content

Aktualisiert den Inhalt einer vorhandenen Datei in OneDrive.

Schreiben

Create Folder

Erstellt einen neuen Ordner im OneDrive des Nutzers mit konfigurierbarem Konfliktverhalten.

Schreiben

Create a New Text File

Erstellt eine neue reine Textdatei mit dem angegebenen Inhalt in OneDrive.

Schreiben

Move Item

Verschiebt eine Datei oder einen Ordner zur Neuorganisation in einen neuen übergeordneten Ordner in OneDrive.

Lesen

Copy Item

Kopiert ein DriveItem (Datei oder Ordner) asynchron an einen neuen Speicherort.

Lesen

Update Drive Item Metadata

Aktualisiert die Metadaten eines OneDrive-Elements, einschließlich Name, Beschreibung und übergeordnetem Ordner.

Schreiben

Create Sharing Link

Erstellt einen Freigabelink für ein DriveItem mit konfigurierbarem Zugriffstyp und konfigurierbaren Berechtigungen.

Schreiben

Invite User to Drive Item

Lädt Nutzer ein und gewährt ihnen Berechtigungen für ein bestimmtes Element in OneDrive.

Schreiben

Get Item Permissions

Ruft die Berechtigungen eines DriveItems innerhalb eines bestimmten Laufwerks ab.

Lesen

Update Drive Item Permissions

Aktualisiert die Rollen einer vorhandenen Berechtigung für ein OneDrive-Element.

Schreiben

Get Item Versions

Ruft den Versionsverlauf eines DriveItems anhand seiner eindeutigen ID ab.

Lesen

Restore Item Version

Stellt eine frühere Version einer Datei wieder her, indem eine neue Version aus der angegebenen historischen Version erstellt wird.

Lesen

Check Out Drive Item

Checkt ein DriveItem aus, um zu verhindern, dass andere es bearbeiten, bis die Änderungen abgeschlossen sind.

Lesen

Check In Drive Item

Checkt ein zuvor ausgechecktes DriveItem wieder ein, damit die neue Version für andere sichtbar wird.

Lesen

Discard Checkout

Verwirft den Checkout eines DriveItems, gibt es frei und verwirft alle vorgenommenen Änderungen.

Lesen

List Drive Activities

Ruft die letzten Aktivitäten im OneDrive des authentifizierten Nutzers ab.

Lesen

List Root Drive Changes

Listet Änderungen im Stammverzeichnis des primären Laufwerks des Nutzers anhand eines Delta-Tokens für die inkrementelle Synchronisierung auf.

Lesen

Preview Drive Item

Generiert eine kurzlebige, einbettbare Vorschau-URL für ein bestimmtes DriveItem.

Lesen

Get Document Comments

Extrahiert Kommentare aus einer in OneDrive gespeicherten Word-.docx-Datei.

Lesen

List Drives

Listet alle für den authentifizierten Nutzer verfügbaren Drive-Ressourcen auf, einschließlich persönlicher und freigegebener Laufwerke.

Lesen

Get SharePoint List Items (via OneDrive)

Ruft Elemente aus einer SharePoint-Liste über die OneDrive-Verbindung ab.

Lesen

List Site Lists

Listet alle Listen einer bestimmten SharePoint-Site über die OneDrive-Verbindung auf.

Lesen

List Site Subsites

Listet alle Untersites einer SharePoint-Site über die OneDrive-Verbindung auf.

Lesen

Get Workbook Used Range

Ruft den aktiven Datenbereich eines Arbeitsblatts in einer in OneDrive gespeicherten Excel-Arbeitsmappe ab.

Lesen

Read Workbook Range

Liest einen bestimmten Zellbereich aus einem Arbeitsblatt einer in OneDrive gespeicherten Excel-Arbeitsmappe.

Lesen

Update Workbook Range

Aktualisiert einen Bereich in einem Arbeitsblatt einer in OneDrive gespeicherten Excel-Arbeitsmappe.

Schreiben

Write Workbook Cell

Aktualisiert den Wert, die Formel oder das Format einer bestimmten Zelle in einer in OneDrive gespeicherten Excel-Arbeitsmappe.

Schreiben

Restore Deleted Item

Stellt ein gelöschtes DriveItem (Datei oder Ordner) aus dem Papierkorb wieder her.

Lesen

Delete Item

Löscht ein DriveItem (Datei oder Ordner) anhand seiner eindeutigen ID und verschiebt es in den Papierkorb.

⚠️ Destruktiv

Permanently Delete Drive Item

Löscht ein DriveItem dauerhaft, ohne es in den Papierkorb zu verschieben. Diese Aktion ist unwiderruflich.

⚠️ Destruktiv

Delete Drive Item Permission

Widerruft eine Freigabeberechtigung für ein OneDrive-Element.

⚠️ Destruktiv

Anwendungsfälle

  • Dateien bei Bedarf finden und abrufen. Durchsuche OneDrive nach Schlagwort über Dateinamen und Inhalt hinweg von Goodweek aus, um bestimmte Dokumente zu finden, ohne die Ordnerstruktur manuell durchzugehen.

  • Dateien hochladen und organisieren. Lade neue Dateien in OneDrive-Ordner hoch, erstelle Ordnerstrukturen und verschiebe oder kopiere vorhandene Dateien aus Goodweek-Unterhaltungen, um Dokumente organisiert zu halten.

  • Dateien mit der richtigen Zugriffsebene teilen. Erstelle Freigabelinks oder lade bestimmte Nutzer zu einer Datei oder einem Ordner aus Goodweek ein, mit konfigurierbaren Ansichts- oder Bearbeitungsberechtigungen, wenn du Inhalte mit Kollegen oder externen Parteien teilst.

  • Excel-Arbeitsmappen lesen und aktualisieren. Rufe Daten aus bestimmten Zellbereichen in Excel-Arbeitsmappen ab, die in OneDrive gespeichert sind, und aktualisiere Zellwerte oder -bereiche aus Goodweek, ohne die Datei direkt zu öffnen.


Fehlerbehebung

Berechtigungsfehler bei der Verbindung

Möglicherweise muss der Administrator deines Microsoft-Entra-Mandanten die Zustimmung für die Anwendung erteilen. Bitte deinen Administrator, die obigen Schritte unter Admin-Einrichtung zu befolgen, bevor du erneut versuchst, dich zu verbinden.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass der Administrator deiner Organisation die OneDrive-Integration im Goodweek Admin-Panel unter dem Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?