Zum Hauptinhalt springen

SharePoint-Integration - Einrichtungsanleitung

Verbinde dein SharePoint-Konto mit Goodweek, um Dokumente, Listen, Ordner, Dateien und Website-Inhalte direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein SharePoint-Konto mit Goodweek, um Dokumente, Listen, Ordner, Dateien und Website-Inhalte direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Nutzer innerhalb von SharePoint gewährten Zugriffsebenen 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 SharePoint-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek-Admin-Panel unter dem Tab Integrationen aktivieren.

Administrator-Einrichtung

Die SharePoint-Integration verwendet 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 bei den Nutzern auftreten.

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 zum Microsoft Entra Admin Center → Unternehmensanwendungen → Composio → Berechtigungen → Administratorzustimmung für [deine Organisation] erteilen.

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

⚠️ Wichtig: Sonderfall bei 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 anstatt mit dessen individuellem Nutzerkonto. Dies ist ein Microsoft-Verhalten 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 ein 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 durchführen, um dieses Problem zu vermeiden.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche SharePoint und klicke auf Verbinden.

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

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

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf Websites, Listen und Dokumente zugreifen, für die dein individuelles Konto innerhalb von SharePoint berechtigt ist.

  • 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 SharePoint Sites

Listet alle SharePoint-Websites auf, auf die der Nutzer zur Erkundung zugreifen kann.

Lesen

Get SharePoint Site by Hostname

Ruft Websitemetadaten anhand von Hostname oder URL ab, einschließlich Website-ID und Anzeigename.

Lesen

Get SharePoint Root Site

Ruft Metadaten zum Stammweb einer SharePoint-Websitesammlung ab.

Lesen

Get SharePoint Web Info

Ruft Informationen zum aktuellen SharePoint-Web ab, einschließlich Titel und URL.

Lesen

List SharePoint Lists

Listet alle Listen und Dokumentbibliotheken in der aktuellen SharePoint-Website auf.

Lesen

Get SharePoint List by GUID

Ruft eine bestimmte SharePoint-Liste anhand ihrer eindeutigen ID ab.

Lesen

Get SharePoint List by Title

Ruft eine SharePoint-Liste anhand ihres Anzeigetitels ab.

Lesen

List SharePoint List Columns

Listet alle Spaltendefinitionen einer SharePoint-Liste einschließlich Feldmetadaten auf.

Lesen

Create SharePoint List

Erstellt eine neue Liste in SharePoint über die REST-API.

Schreiben

Update SharePoint List

Aktualisiert Eigenschaften einer vorhandenen SharePoint-Liste, z. B. Titel oder Beschreibung.

Schreiben

Get SharePoint List Items

Ruft Elemente aus einer SharePoint-Liste mit optionaler OData-Filterung und Paginierung ab.

Lesen

Get List Item by ID

Ruft ein bestimmtes SharePoint-Listenelement anhand seiner numerischen ID ab.

Lesen

Create SharePoint List Item

Erstellt ein neues Element in einer SharePoint-Liste.

Schreiben

Update SharePoint List Item

Aktualisiert Felder eines vorhandenen SharePoint-Listenelements.

Schreiben

List Drive Children

Listet Dateien und Ordner in einer SharePoint-Dokumentbibliothek oder einem Ordner auf.

Lesen

List Files in Folder

Listet Dateien innerhalb eines bestimmten SharePoint-Ordners auf (nicht rekursiv).

Lesen

List Subfolders in Folder

Listet die direkten Unterordner innerhalb eines SharePoint-Ordners auf.

Lesen

Get All SharePoint Folders

Ruft alle Ordner im SharePoint-Web zur Erkundung ab.

Lesen

Create SharePoint Folder

Erstellt einen neuen Ordner in einer SharePoint-Dokumentbibliothek.

Schreiben

Rename SharePoint Folder

Benennt einen SharePoint-Ordner um, indem die Metadaten seines Listenelements aktualisiert werden.

Lesen

Upload File to Folder

Lädt eine Datei in eine SharePoint-Dokumentbibliothek oder einen Ordner hoch.

Schreiben

Upload File from URL to SharePoint

Ruft eine Datei von einer URL ab und lädt sie direkt in SharePoint hoch.

Schreiben

Download File by Server-relative URL

Lädt eine Datei aus SharePoint über ihre serverrelative URL herunter.

Lesen

Get Site Drive Item by Path

Ruft Metadaten für eine Datei oder einen Ordner anhand ihres serverrelativen Pfads ab.

Lesen

Update Drive Item

Aktualisiert Eigenschaften eines Drive-Elements (Datei oder Ordner) in SharePoint.

Schreiben

Update File Item Metadata

Aktualisiert Metadatenfelder eines SharePoint-Dateielements.

Schreiben

Search SharePoint Site

Durchsucht SharePoint-Inhalte mithilfe von Keyword Query Language nach Dokumenten, Elementen und Ordnern.

Lesen

Search Files Across All Sites

Durchsucht alle SharePoint-Websites und OneDrive mithilfe von Keyword Query Language nach Dateien.

Lesen

Check Out SharePoint File

Checkt eine Datei aus, um sie vor Änderungen zu sperren.

Lesen

Check In SharePoint File

Checkt eine Datei ein, um Änderungen abzuschließen und die neue Version verfügbar zu machen.

Lesen

Recycle SharePoint File

Verschiebt eine Datei in den SharePoint-Papierkorb (vorläufiges Löschen, wiederherstellbar).

Lesen

Restore Recycle Bin Item

Stellt ein gelöschtes SharePoint-Element anhand seiner GUID aus dem Papierkorb wieder her.

Lesen

Create Drive Item Sharing Link

Erstellt einen Freigabelink für ein SharePoint-Drive-Element mit konfigurierbarem Zugriffstyp.

Schreiben

Add Attachment to List Item

Lädt eine Binärdatei als Anhang zu einem SharePoint-Listenelement hoch.

Schreiben

List Item Attachments

Listet alle Anhänge eines SharePoint-Listenelements auf.

Lesen

Download List Item Attachment

Lädt den Binärinhalt eines Anhangs eines SharePoint-Listenelements herunter.

Lesen

Get Content Types for List

Ruft alle Inhaltstypen für eine bestimmte SharePoint-Liste ab.

Lesen

Create Content Type

Erstellt einen neuen Inhaltstyp in SharePoint mit den angegebenen Felddefinitionen.

Schreiben

List Site Groups

Listet alle SharePoint-Websitegruppen einer Websitesammlung auf.

Lesen

Get Group Users

Ruft alle Nutzer ab, die Mitglieder einer angegebenen SharePoint-Gruppe sind.

Lesen

List Site Users

Listet Nutzer in der Websitesammlung auf, einschließlich einzelner Nutzer und Gruppen.

Lesen

Find SharePoint User

Sucht einen Nutzer in der SharePoint-Website anhand der E-Mail-Adresse.

Lesen

Get Drive Item Analytics

Ruft Zugriffsanalysen (Aufrufzahl) für ein SharePoint-Drive-Element ab.

Lesen

List Recently Modified Drive Items

Listet kürzlich geänderte Elemente in einem SharePoint-Drive auf.

Lesen

Restore Drive Item Version

Stellt eine frühere Version eines SharePoint-Drive-Elements wieder her.

Lesen

Delete SharePoint File

Löscht eine Datei dauerhaft aus einer SharePoint-Dokumentbibliothek.

⚠️ Destruktiv

Delete SharePoint Folder

Löscht einen Ordner dauerhaft aus einer SharePoint-Dokumentbibliothek.

⚠️ Destruktiv

Delete SharePoint List Item

Löscht ein SharePoint-Listenelement anhand seiner ID dauerhaft.

⚠️ Destruktiv

Delete SharePoint List

Löscht eine SharePoint-Liste anhand ihrer GUID dauerhaft.

⚠️ Destruktiv

Anwendungsfälle

  • Dokumente websiteübergreifend finden und abrufen. Durchsuche SharePoint-Websites mit Schlüsselwörtern oder durchsuche Ordnerstrukturen von Goodweek aus, um bestimmte Dateien zu finden und deren Inhalt oder Download-Links abzurufen, ohne die SharePoint-Oberfläche zu öffnen.

  • Listenelemente erstellen und aktualisieren. Füge Elemente in SharePoint-Listen aus Goodweek-Unterhaltungen hinzu oder ändere sie – nützlich, um Projekt-Tracker, Fehlerprotokolle oder andere strukturierte Daten in SharePoint-Listen zu aktualisieren.

  • Dateien hochladen und organisieren. Lade Dateien in Dokumentbibliotheken hoch, erstelle Ordner und verwalte die Dateiorganisation in SharePoint direkt aus Goodweek, damit Dokumente aktuell bleiben, ohne manuell im Browser navigieren zu müssen.

  • Dokumente mit bestimmten Zugriffsebenen teilen. Erstelle Freigabelinks für Dateien oder Ordner mit der passenden Berechtigungsstufe aus Goodweek, wenn du Ressourcen mit internen oder externen Stakeholdern teilst.


Fehlerbehebung

Berechtigungsfehler bei der Verbindung

Möglicherweise muss dein Microsoft Entra-Mandantenadministrator die Zustimmung für die Anwendung erteilen. Bitte deinen Administrator, die oben genannten Schritte unter Administrator-Einrichtung zu befolgen, bevor du erneut versuchst, dich zu verbinden.

Integration verbunden, aber einige Websites oder Dateien sind nicht zugänglich

SharePoint berücksichtigt Berechtigungen auf Website- und Elementebene. Wenn du nicht auf eine bestimmte Website oder Dokumentbibliothek zugreifen kannst, muss dir dein SharePoint-Administrator direkt in SharePoint Zugriff gewähren.

Integration in Goodweek nicht sichtbar

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

Referenzen

Hat dies deine Frage beantwortet?