SharePoint-Listentools MCP-Serverreferenz (veraltet)

Übersicht

Verfügbare Tools

sharepoint_ListeErstellen

Erstellt eine neue SharePoint-Liste auf einer Website.

Erforderliche Parameter

• Siteid: Die eindeutige ID der Website.
• Displayname: Anzeigename der Liste.
• Liste: Informationen zur Liste wie z. B. Vorlagen (genericList, documentLibrary, issueTracking).

SharePoint_ErstelleListenSpalte

Erstellen Sie eine neue Spalte (columnDefinition) in einer bestimmten SharePoint Liste. Sie müssen das Ziel siteId und listId sowie eine gültige Spaltendefinition angeben, die den Namen der Spalte, den Anzeigenamen und genau einen Spaltentyp spezifiziert (z. B. Text, Zahl, Auswahl, dateTime, Nachschlagevorgang, boolescher Wert, personOrGroup oder hyperlinkOrPicture). Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.
• listId: Die eindeutige ID der Liste.
• Namen: API oder statischer Name der Spalte (keine Leerzeichen, 1-64 Zeichen)

Optionale Parameter:

• displayName: benutzerorientierter Anzeigename
• description: Spaltenbeschreibung
• enforceUniqueValues: Bei „true“ müssen Werte eindeutig sein.
• hidden: Bei „true“ wird die Spalte ausgeblendet.
• indexed: Bei „true“ werden Werte indiziert
• required: Bei „true“ ist ein Wert erforderlich
• readOnly: Bei „true“ können Werte nicht geändert werden
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Spaltentyp-Einstellungen (eine erforderlich)

sharepoint_erstellenListeneintrag

Erstellen Sie ein neues Element in einer SharePoint Liste. Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.
• listId: Die eindeutige ID der Liste.
• fields: Feldwerte für das Listenelement (Schlüssel/Wert-Zuordnung)

sharepoint_deleteListColumn

Löschen Sie eine vorhandene columnDefinition aus einer bestimmten SharePoint Liste. Geben Sie siteId, listId und columnId. Mit dieser Aktion wird die Spalte dauerhaft aus dem Listenschema entfernt. Erforderliche Parameter:

• Siteid: Eindeutige ID der Website.
• listId: Eindeutige ID der Liste.
• Columnid: Eindeutige ID der zu löschenden Spalte.

sharepoint_löscheListenelement

Ein Listenelement löschen Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.
• listId: Die eindeutige ID der Liste.
• Itemid: Die eindeutige ID des Listenelements.

Optionale Parameter:

• ifMatch: Optional für Parallelitätskontrolle (z. B. "*").

SharePoint_ListeSpalteBearbeiten

Aktualisieren Sie ein vorhandenes columnDefinition in einer bestimmten SharePoint-Liste. Geben Sie siteId, listId und columnId. Der Körper ist partiell – schließen Sie nur die Eigenschaften ein, die Sie ändern möchten, wie displayName, description, hidden, required oder Facett-Einstellungen. Erforderliche Parameter:

• Siteid: Eindeutige ID der Website.
• listId: Eindeutige ID der Liste.
• columnId: eindeutige ID der zu aktualisierenden Spalte

Optionale Parameter:

• displayName: benutzerorientierter Anzeigename
• description: Spaltenbeschreibung
• hidden: Bei „true“ wird die Spalte ausgeblendet.
• required: Bei „true“ ist ein Wert erforderlich
• enforceUniqueValues: Bei „true“ müssen Werte eindeutig sein.
• indexed: Bei „true“ werden Werte indiziert
• readOnly: Bei „true“ können Werte nicht geändert werden
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Aktualisieren der Einstellungen für Spaltentypen

sharepoint_getSiteByPath

Auflösen einer SharePoint-Website mithilfe des Hostnamens und des serverrelativen Pfads. Erforderliche Parameter:

• hostname: Hostname des SharePoint Mandanten (z. B. "contoso.sharepoint". com)
• serverRelativePath: serverrelativer Pfad zur Website (z. B. Websites/Marketing)

sharepoint_ListeSpaltenVerzeichnis

Listenspaltendefinitionen (columnDefinition-Ressourcen) für eine bestimmte SharePoint Liste. Erfordert siteId und listId. Unterstützt OData-Parameter wie $select, $topund $skiptoken. Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.
• listId: Die eindeutige ID der Liste.

Optionale Parameter:

• Auswählen: Durch Trennzeichen getrennte Liste der zurückzugebenden Eigenschaften.
• Filter: OData-Filterausdruck, um Ergebnisse einzuschränken.
• Orderby: Durch Trennzeichen getrennte Liste der Eigenschaften, nach der sortiert werden soll.
• Oben: Seitengröße (1-999).
• skiptoken: Undurchsichtiges Token für den Seitenwechsel zum nächsten Datensatz.

sharepoint_ListeListenelemente

Listenelemente aus einer SharePoint-Liste. Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.
• listId: Die eindeutige ID der Liste.

Optionale Parameter:

• Erweitern: Optionaler OData-Erweiterungsbereich (z. B. Felder).
• Nach oben: Optionale Seitengröße.
• Filter: Optionaler OData-Filterausdruck.
• Auswählen: Optionale OData-Auswahlklausel.

sharepoint_listLists

Alle SharePoint Listen auf einer Website auflisten. Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.

sharepoint_listSubsites

Listet untergeordnete Websites (Unterwebsites) für eine bestimmte Website auf. Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.

sharepoint_search

Suchen Sie SharePoint mithilfe der Microsoft Graph Search-API mit entityTypes=["site"]. Erforderliche Parameter:

• requests: Array von searchRequest-Objekten

Optionale Parameter:

• entityTypes: Muss [site] bei SharePoint-Websitesuchen sein
• Anfrage: Abfrageobjekt mit einer Suchzeichenfolge im Stil der Schlüsselwort-Abfragesprache (KQL)
• from: nullbasierter Offset des ersten Ergebnisses
• size: Anzahl der zurückzugebenden Ergebnisse (1–50)
• fields: optionale Liste der Felder, die in der Antwort ausgewählt werden können

sharepoint_searchSitesByName

Suchen Sie in SharePoint-Sites nach Anzeigename oder teilweiser URL (in natürlicher Sprache).

Erforderliche Parameter:

• Suche: Anzeigename, Teilname oder URL der SharePoint-Website, nach der gesucht werden soll.

Optionale Parameter:

• consistencyLevel: Erforderlich für Microsoft Graph (Standard: eventual)

14. SharePoint_updateListItem

Aktualisieren von Feldern eines vorhandenen Listenelements. Erforderliche Parameter:

• Siteid: Die eindeutige ID der Website.
• listId: Die eindeutige ID der Liste.
• Itemid: Die eindeutige ID des Listenelements.
• fields: zu aktualisierende Feldwerte (teilweise)

Optionale Parameter:

• ifMatch: Optional ETag für die Nebenläufigkeitskontrolle (zum Beispiel "*" um zu erzwingen)

Wichtigste Funktionen

Listenverwaltung

• Erstellen neuer SharePoint Listen mit Vorlagen
• Auflisten aller Listen auf einer Website
• Unterstützung für verschiedene Listenvorlagen (genericList, documentLibrary, issueTracking)

Spaltenvorgänge (Column operations)

• Erstellen Sie Spalten mit mehreren Datentypen (Text, Zahl, Auswahl, dateTime, personOrGroup, Nachschlagen, boolescher Wert und hyperlinkOrPicture).
• Bearbeiten sie vorhandene Spalten.
• Spalten löschen.
• Listet alle Spalten in einer Liste auf.
• Wenden Sie Spaltenvalidierung und Eindeutigkeitsbeschränkungen an.

Elementvorgänge

• Listenelemente mit Feldwerten erstellen.
• Aktualisieren vorhandener Listenelemente (teilweise Aktualisierungen)
• Listenelemente löschen.
• Listenelemente mit Filterung und Paginierung.
• Verwenden Sie ETag zur Nebenläufigkeitskontrolle.

Fundortsfindung

• Durchsuchen sie Websites anhand des Namens oder der URL.
• Auflösung von Seiten nach Hostname und Pfad.
• Unterwebsites auflisten.
• Verwenden Sie die KQL-Suchfunktion mit der Microsoft Graph Search-API.

OData-Abfrageunterstützung

• Verwenden Sie $select, um Eigenschaften auszuwählen.
• Verwenden Sie $filter, um Ergebnisse zu filtern.
• Verwenden Sie $expand, um verwandte Tabellen einzuschließen.
• Verwenden Sie $orderby, um Ergebnisse zu sortieren.
• Verwenden Sie $top für die Paginierung.
• Verwenden Sie $skiptoken, um durch große Ergebnismengen zu blättern.

Säulentyp-Unterstützung

• Textspalten (einzeilig oder mehrzeilig, Nur-Text oder Rich-Text).
• Zahlenspalten (mit Dezimalstellen, Minimal- und Höchstwerten).
• Auswahlspalten (Kontrollkästchen, Dropdown-Menüs oder Optionsfelder).
• Boolesche Spalten.
• DateTime Spalten (nur Datum oder Datum und Uhrzeit).
• Personen- oder Gruppenspalten (einzelne oder mehrfache Auswahl).
• Suchspalten (Verweis auf andere Listen).
• Hyperlink- oder Bildspalten.

Anmerkungen

• Alle Vorgänge verwenden Microsoft Graph API v1.0.
• Spaltennamen müssen 1 bis 64 Zeichen ohne Leerzeichen sein.
• Jede Spalte muss genau einen Spaltentyp angeben.
• Verwenden Sie den If-Match Header für die Nebenläufigkeitskontrolle.
• Legen Sie consistencyLevel für Websitesuchen auf eventual fest.
• Suchergebnisse sind auf 50 Elemente pro Seite beschränkt.
• Spalten und Listenelemente unterstützen partielle Aktualisierungen.