Was macht SharePoint-Automation?
Automatisieren Sie SharePoint-Operationen, einschließlich der Verwaltung von Websites, Listen, Dokumenten, Ordnern und Seiten. Integriert sowohl die SharePoint REST API als auch Microsoft Graph über OneDrive.
Toolkit-Dokumentation: composio.dev/toolkits/share_point
Einrichtung
Dieser Skill erfordert den Rube MCP Server, der unter https://rube.app/mcp verbunden ist.
Stellen Sie vor der Ausführung von Tools sicher, dass aktive Verbindungen für die Toolkits share_point und one_drive bestehen. Falls keine aktive Verbindung vorhanden ist, initiieren Sie eine über RUBE_MANAGE_CONNECTIONS.
Hinweis: Viele OneDrive/SharePoint-Tools funktionieren nur mit organisatorischen Microsoft 365-Konten (Azure AD/Entra ID). Persönliche Microsoft-Konten werden NICHT unterstützt.
Kern-Workflows
1. Websites auflisten und durchsuchen
Rufen Sie Websitedetails ab und zählen Sie Unterwebsites auf, um die SharePoint-Topologie zu entdecken.
Tools:
ONE_DRIVE_GET_SITE_DETAILS– Metadaten für eine bestimmte Website anhand der ID abrufenONE_DRIVE_LIST_SITE_SUBSITES– Alle Unterwebsites einer übergeordneten Website auflisten
Wichtige Parameter:
site_id(erforderlich) – Zusammengesetztes Format:hostname,site-collection-guid,web-guid(z. B."contoso.sharepoint.com,da60e844-...,712a596e-...")
Beispiel:
Tool: ONE_DRIVE_GET_SITE_DETAILS
Argumente:
site_id: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
2. Listen verwalten
Erstellen Sie Listen, zählen Sie vorhandene Listen auf und rufen Sie Listenelemente ab.
Tools:
SHARE_POINT_LIST_ALL_LISTS– Alle Listen einer Website abrufen (unterstützt OData-Filter, Select, OrderBy, Top)SHARE_POINT_SHAREPOINT_CREATE_LIST– Eine neue Liste mit einer bestimmten Vorlage erstellenONE_DRIVE_LIST_SITE_LISTS– Alle Listen einer Website über Microsoft Graph auflistenONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS– Elemente aus einer bestimmten Liste abrufen
Wichtige Parameter für SHARE_POINT_SHAREPOINT_CREATE_LIST:
name(erforderlich) – Listennametemplate(erforderlich) – Vorlagentyp:"genericList","documentLibrary","tasks"usw.description– Optionale Beschreibung
Wichtige Parameter für SHARE_POINT_LIST_ALL_LISTS:
filter– OData-Filter, z. B."Hidden eq false"select– Zurückzugebende Eigenschaften, z. B."Title,Id"orderby– Sortierausdruck, z. B."Title desc"top– Ergebnisanzahl begrenzen
Beispiel:
Tool: SHARE_POINT_SHAREPOINT_CREATE_LIST
Argumente:
name: "Projektaufgaben"
template: "tasks"
description: "Aufgabenverfolgung für Q1-Liefergegenstände"
3. Ordner und Dateien verwalten
Erstellen Sie Ordner, listen Sie Dateien in Ordnern auf und navigieren Sie in der Dokumentbibliothek.
Tools:
SHARE_POINT_SHAREPOINT_CREATE_FOLDER– Einen neuen Ordner in einer Dokumentbibliothek erstellenSHARE_POINT_LIST_FILES_IN_FOLDER– Dateien in einem Ordner anhand der serverrelativen URL auflistenSHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL– Ordnermetadaten anhand des Pfads abrufen
Wichtige Parameter für SHARE_POINT_SHAREPOINT_CREATE_FOLDER:
folder_name(erforderlich) – Name des zu erstellenden Ordnersdocument_library– Zielbibliothek (Standard:"Shared Documents")relative_path– Zusätzlicher Pfad innerhalb der Bibliothek
Wichtige Parameter für SHARE_POINT_LIST_FILES_IN_FOLDER:
folder_name(erforderlich) – Serverrelative URL, z. B."/Shared Documents"select– Durch Komma getrennte Eigenschaften, z. B."Name,ServerRelativeUrl,Length"top– Ergebnisanzahl begrenzenorderby– Sortierausdruck, z. B."Name desc"
Beispiel:
Tool: SHARE_POINT_LIST_FILES_IN_FOLDER
Argumente:
folder_name: "/Shared Documents/Reports"
select: "Name,ServerRelativeUrl,Length"
top: 50
4. SharePoint-Inhalte durchsuchen
Verwenden Sie die Keyword Query Language (KQL), um Dokumente, Listenelemente und andere Inhalte auf der Website zu durchsuchen.
Tool: SHARE_POINT_SEARCH_QUERY
Wichtige Parameter:
querytext(erforderlich) – KQL-Abfrage, z. B."Projektbericht","FileType:docx","Author:\"Max Mustermann\""rowlimit– Maximale Ergebnisse pro Anforderung (Standard ~50, max. 500)startrow– Nullbasierter Offset für die Paginierungselectproperties– Zurückzugebende Eigenschaften, z. B."Title,Author,Path"refinementfilters– Ergebnisse eingrenzen, z. B."FileType:equals(\"docx\")"
Beispiel:
Tool: SHARE_POINT_SEARCH_QUERY
Argumente:
querytext: "IsDocument:1 FileType:pdf"
rowlimit: 25
selectproperties: "Title,Author,Path,LastModifiedTime"
5. Listenänderungen verfolgen (Delta-Abfrage)
Verwenden Sie Delta-Abfragen, um inkrementelle Änderungen (erstellte, aktualisierte, gelöschte Elemente) zu erhalten, ohne die gesamte Liste auslesen zu müssen.
Tool: ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA
Wichtige Parameter:
site_id(erforderlich) – Zusammengesetzte Website-IDlist_id(erforderlich) – Listen-GUIDtoken– Für die Erstsynchronisierung auslassen;"latest"übergeben für leere Antwort mit Token; vorherigen Token für Änderungen seit diesem Zeitpunkt übergebenexpand– z. B."fields($select=SpalteA,SpalteB)"top– Maximale Elemente pro Antwort
6. Seiteninhalt einer Website abrufen
Lesen Sie moderne Inhalte von SharePoint-Websiteseiten, einschließlich Canvas-Webparts.
Tool: SHARE_POINT_GET_SITE_PAGE_CONTENT
Wichtige Parameter:
page_file_name– Dateiname mit Erweiterung.aspx, z. B."Home.aspx"item_id– Alternativ: Listen-Element-ID der Seiterender_as–"raw"(Standard),"text"oder"html"site– Optionaler Website-Namensbereich
Bekannte Fallstricke
| Fallstrick | Detail |
|---|---|
| Site-ID-Format | Muss zusammengesetzt sein: hostname,site-collection-guid,web-guid. Falsches Format führt zu 400-Fehlern. |
| Persönliche Konten nicht unterstützt | ONE_DRIVE_LIST_SITE_LISTS und Graph-basierte Tools funktionieren nur mit organisatorischen M365-Konten, nicht mit persönlichen MSA-/Outlook.com-Konten. |
| OData-Filter-Syntax | SharePoint-OData-Filter verwenden eine spezifische Syntax. Testen Sie Filter schrittweise; nicht unterstützte Ausdrücke können stillschweigend leere Ergebnisse zurückgeben. |
| Paginierung | Verwenden Sie skiptoken für serverseitige Paginierung bei Listenoperationen. Unvollständige Paginierungseinstellungen können Ergebnisse übersehen. |
| Ordnerpfade | Es müssen serverrelative URLs (z. B. /Shared Documents) und keine absoluten URLs verwendet werden. |
Kurzreferenz
| Tool-Slug | Beschreibung |
|---|---|
ONE_DRIVE_GET_SITE_DETAILS | Metadaten einer SharePoint-Website abrufen |
ONE_DRIVE_LIST_SITE_SUBSITES | Unterwebsites einer übergeordneten Website auflisten |
ONE_DRIVE_LIST_SITE_LISTS | Alle Listen einer Website auflisten (Graph-API) |
ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA | Inkrementelle Listenänderungen verfolgen |
ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS | Elemente aus einer Liste abrufen |
ONE_DRIVE_LIST_DRIVES | Verfügbare Laufwerke für einen Benutzer/eine Website/Gruppe auflisten |
ONE_DRIVE_LIST_SITE_COLUMNS | Spaltendefinitionen für eine Website auflisten |
SHARE_POINT_LIST_ALL_LISTS | Alle Listen einer Website abrufen (REST-API) |
SHARE_POINT_SHAREPOINT_CREATE_LIST | Eine neue SharePoint-Liste erstellen |
SHARE_POINT_SHAREPOINT_CREATE_FOLDER | Einen Ordner in einer Dokumentbibliothek erstellen |
SHARE_POINT_LIST_FILES_IN_FOLDER | Dateien in einem Ordner auflisten |
SHARE_POINT_SEARCH_QUERY | Inhalte mit KQL durchsuchen |
SHARE_POINT_GET_SITE_PAGE_CONTENT | Seiteninhalt einer Website abrufen |
SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL | Ordnermetadaten anhand des Pfads abrufen |
Bereitgestellt von Composio