Κοινοποίηση μέσω


Αναφορά διακομιστή MCP εργαλείων με λίστες του SharePoint

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Επισκόπηση

Αναγνωριστικό διακομιστή Εμφανιζόμενο όνομα Περιγραφή
mcp_SharePointListsTools Microsoft SharePoint Lists MCP Server Διακομιστής MCP που παρέχει εργαλεία Microsoft Graph SharePoint για λίστες. Διακομιστής MCP που παρέχει εργαλεία Microsoft Graph SharePoint για λίστες.

Διαθέσιμα εργαλεία

sharepoint_createList

Δημιουργήστε μια νέα λίστα του SharePoint σε μια τοποθεσία.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • displayName: Εμφανιζόμενο όνομα της λίστας
  • list: Πληροφορίες λίστας όπως το πρότυπο (για παράδειγμα, genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Δημιουργήστε μια νέα στήλη (στήλη Ορισμός) σε μια συγκεκριμένη λίστα του SharePoint. Πρέπει να καταχωρήσετε το siteId και το listId προορισμού, καθώς και έναν έγκυρο ορισμό στήλης που καθορίζει το όνομα, το εμφανιζόμενο όνομα της στήλης και ακριβώς έναν τύπο στήλης (όπως κείμενο, αριθμός, επιλογή, ημερομηνία/ώρα, personOrGroup, αναζήτηση, δυαδική τιμή ή υπερ-σύνδεσηOrPicture).

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Το μοναδικό αναγνωριστικό της λίστας
  • name: API/στατικό όνομα της στήλης (χωρίς κενά διαστήματα, 1-64 χαρακτήρες)

Προαιρετικές παράμετροι

  • displayName: Εμφανιζόμενο όνομα που απευθύνεται στον χρήστη
  • description: Περιγραφή στήλης
  • enforceUniqueValues: Εάν είναι true, οι τιμές πρέπει να είναι μοναδικές
  • hidden: Εάν είναι true, η στήλη είναι κρυφή
  • indexed: Εάν είναι true, οι τιμές ευρετηρίασαν
  • required: Εάν είναι true, απαιτείται μια τιμή
  • readOnly: Εάν είναι true, δεν είναι δυνατή η αλλαγή των τιμών
  • text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Ρυθμίσεις τύπου στήλης (απαιτείται μία)

sharepoint_createListItem

Δημιουργήστε ένα νέο στοιχείο σε μια λίστα του SharePoint.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Το μοναδικό αναγνωριστικό της λίστας
  • fields: Τιμές πεδίων για το στοιχείο λίστας (χάρτης κλειδιού/τιμής)

sharepoint_deleteListColumn

Διαγράψτε μια υπάρχουσα στήληΔιεύθυνση από μια συγκεκριμένη λίστα του SharePoint. Καταχωρήστε siteId, listId και columnId. Αυτή η ενέργεια καταργεί οριστικά τη στήλη από το σχήμα λίστας.

Απαιτούμενες παράμετροι

  • siteId: Μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Μοναδικό αναγνωριστικό της λίστας
  • columnId: Μοναδικό αναγνωριστικό της στήλης προς διαγραφή

sharepoint_deleteListItem

Διαγράψτε ένα στοιχείο λίστας.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Το μοναδικό αναγνωριστικό της λίστας
  • itemId: Το μοναδικό αναγνωριστικό του στοιχείου λίστας

Προαιρετικές παράμετροι

  • ifMatch: Προαιρετικό ETag για έλεγχο ταυτόχρονης εκτέλεσης (π.χ., "*")

sharepoint_editListColumn

Ενημέρωση μιας υπάρχουσας στήληςΔιεύθυνση σε μια συγκεκριμένη λίστα του SharePoint. Καταχωρήστε siteId, listId και columnId. Το σώμα είναι μερικό - συμπεριλάβετε μόνο τις ιδιότητες που θέλετε να αλλάξετε (όπως displayName, περιγραφή, κρυφό, υποχρεωτικό ή ρυθμίσεις περιορισμού).

Απαιτούμενες παράμετροι

  • siteId: Μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Μοναδικό αναγνωριστικό της λίστας
  • columnId: Μοναδικό αναγνωριστικό της στήλης για ενημέρωση

Προαιρετικές παράμετροι

  • displayName: Εμφανιζόμενο όνομα που απευθύνεται στον χρήστη
  • description: Περιγραφή στήλης
  • hidden: Εάν είναι true, η στήλη είναι κρυφή
  • required: Εάν είναι true, απαιτείται μια τιμή
  • enforceUniqueValues: Εάν είναι true, οι τιμές πρέπει να είναι μοναδικές
  • indexed: Εάν είναι true, οι τιμές ευρετηρίασαν
  • readOnly: Εάν είναι true, δεν είναι δυνατή η αλλαγή των τιμών
  • text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Ενημέρωση ρυθμίσεων τύπου στήλης

sharepoint_getSiteByPath

Επιλύστε μια τοποθεσία SharePoint χρησιμοποιώντας το όνομα κεντρικού υπολογιστή και τη διαδρομή που σχετίζονται με τον διακομιστή.

Απαιτούμενες παράμετροι

  • όνομα κεντρικού υπολογιστή: Όνομα κεντρικού υπολογιστή του μισθωτή SharePoint (για παράδειγμα, contoso.sharepoint.com)
  • serverRelativePath: Διαδρομή σχετική με διακομιστή προς την τοποθεσία (για παράδειγμα, τοποθεσίες/μάρκετινγκ)

sharepoint_listListColumns

Παραθέστε ορισμούς στηλών (στήληΠροσδιορισμός πόρων) για μια συγκεκριμένη λίστα του SharePoint. Απαιτεί siteId και listId. Υποστηρίζει παραμέτρους OData όπως $select, $top και $skiptoken.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Το μοναδικό αναγνωριστικό της λίστας

Προαιρετικές παράμετροι

  • select: Λίστα ιδιοτήτων διαχωρισμένων με κόμματα για επιστροφή
  • filter: Παράσταση φίλτρου OData για τον περιορισμό των αποτελεσμάτων
  • orderBy: Λίστα ιδιοτήτων διαχωρισμένων με κόμματα για ταξινόμηση κατά
  • top: Μέγεθος σελίδας (1-999)
  • skiptoken: Αδιαφανές διακριτικό για σελιδοποίησης στο επόμενο σύνολο

sharepoint_listListItems

Εμφάνιση στοιχείων από μια λίστα του SharePoint.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Το μοναδικό αναγνωριστικό της λίστας

Προαιρετικές παράμετροι

  • expand: Προαιρετική ανάπτυξη OData (για παράδειγμα, πεδία)
  • top: Προαιρετικό μέγεθος σελίδας
  • filter: Προαιρετική παράσταση φίλτρου OData
  • select: Προαιρετικός όρος επιλογής OData

sharepoint_listLists

Εμφάνιση όλων των λιστών του SharePoint σε μια τοποθεσία.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας

sharepoint_listSubsites

Λίστα θυγατρικών τοποθεσιών (δευτερεύουσες τοποθεσίες) για μια συγκεκριμένη τοποθεσία.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας

Κάντε αναζήτηση στο SharePoint χρησιμοποιώντας το Microsoft Graph Search API με entityTypes=["τοποθεσία"].

Απαιτούμενες παράμετροι

  • requests: Πίνακας αντικειμένων searchRequest

Προαιρετικές παράμετροι

  • entityTypes: Πρέπει να είναι ["τοποθεσία"] για αναζητήσεις τοποθεσίας SharePoint
  • query: Αντικείμενο ερωτήματος με συμβολοσειρά αναζήτησης στυλ KQL
  • from: Μετατόπιση με βάση το μηδέν του πρώτου αποτελέσματος
  • size: Αριθμός αποτελεσμάτων προς επιστροφή (1-50)
  • fields: Προαιρετική λίστα πεδίων προς επιλογή στην απόκριση

13. sharepoint_searchSitesByName

Κάντε αναζήτηση σε τοποθεσίες του SharePoint με το εμφανιζόμενο όνομα ή τη μερική διεύθυνση URL (φυσική γλώσσα).

Απαιτούμενες παράμετροι

  • search: Εμφανιζόμενο όνομα ή μερικό όνομα/διεύθυνση URL της τοποθεσίας του SharePoint για αναζήτηση

Προαιρετικές παράμετροι

  • consistencyLevel: Απαιτείται από το Microsoft Graph (προεπιλογή: τελικό)

14. sharepoint_updateListItem

Ενημερώστε τα πεδία ενός υπάρχοντος στοιχείου λίστας.

Απαιτούμενες παράμετροι

  • siteId: Το μοναδικό αναγνωριστικό της τοποθεσίας
  • listId: Το μοναδικό αναγνωριστικό της λίστας
  • itemId: Το μοναδικό αναγνωριστικό του στοιχείου λίστας
  • fields: Τιμές πεδίων για ενημέρωση (μερική)

Προαιρετικές παράμετροι

  • ifMatch: Προαιρετικό ETag για έλεγχο ταυτόχρονης εκτέλεσης (για παράδειγμα, "*" για επιβολή)

Δυνατότητες κλειδιά

Διαχείριση λίστας

  • Δημιουργία νέων λιστών του SharePoint με πρότυπα
  • Λίστα όλων των λιστών σε μια τοποθεσία
  • Υποστήριξη για διάφορα πρότυπα λίστας (genericList, documentLibrary, issueTracking)

Λειτουργίες στήλης

  • Δημιουργήστε στήλες με πολλούς τύπους δεδομένων (κείμενο, αριθμός, επιλογή, ημερομηνία/ώρα, personOrGroup, αναζήτηση, δυαδική τιμή, υπερ-σύνδεσηOrPicture)
  • Επεξεργασία υπαρχουσών στηλών
  • Διαγραφή στηλών
  • Παράθεση όλων των στηλών σε μια λίστα
  • Περιορισμοί επικύρωσης στήλης και μοναδικότητας

Λειτουργίες στοιχείου

  • Δημιουργία στοιχείων λίστας με τιμές πεδίων
  • Ενημέρωση υπαρχόντων στοιχείων λίστας (μερικές ενημερώσεις)
  • Διαγράψτε ένα στοιχείο λίστας.
  • Εμφάνιση στοιχείων με φιλτράρισμα και σελιδοποίηση
  • Έλεγχος ταυτόχρονης εκτέλεσης μέσω ETag

Εντοπισμός τοποθεσίας

  • Αναζήτηση τοποθεσιών κατά όνομα ή διεύθυνση URL
  • Επίλυση τοποθεσιών κατά όνομα κεντρικού υπολογιστή και διαδρομή
  • Δευτερεύουσες τοποθεσίες λίστας
  • Αναζήτηση στυλ KQL με το Microsoft Graph Search API

Υποστήριξη ερωτημάτων OData

  • Χρησιμοποιήστε $select για να επιλέξετε ιδιότητες.
  • Χρησιμοποιήστε $filter για να φιλτράρετε τα αποτελέσματα.
  • Χρησιμοποιήστε $expand για να συμπεριλάβετε σχετικές οντότητες.
  • Χρησιμοποιήστε $orderby για να ταξινομήσετε τα αποτελέσματα.
  • Χρησιμοποιήστε $top για σελιδοποίηση.
  • Χρησιμοποιήστε $skiptoken για να περιηγηθείτε σε μεγάλα σύνολα αποτελεσμάτων.

Υποστήριξη τύπου στήλης

  • Στήλες κειμένου (κείμενο μονής γραμμής ή πολλών γραμμών, απλό ή εμπλουτισμένο).
  • Αριθμητικές στήλες (με δεκαδικά ψηφία, ελάχιστες και μέγιστες τιμές).
  • Στήλες επιλογής (πλαίσια ελέγχου, αναπτυσσόμενο μενού ή κουμπιά επιλογής).
  • Δυαδικές στήλες.
  • Ημερομηνία Ώρα, Ημερομηνία και Ώρα, Ημερομηνία μόνο
  • Στήλες ατόμου ή ομάδας (μεμονωμένη ή πολλαπλή επιλογή).
  • Στήλες αναζήτησης (αναφορά σε άλλες λίστες).
  • Υπερ-σύνδεση ή Στήλες εικόνας.

Σημειώσεις

  1. Όλες οι λειτουργίες χρησιμοποιούν το Microsoft Graph API v1.0.
  2. Τα ονόματα στηλών πρέπει να είναι 1-64 χαρακτήρες χωρίς κενά διαστήματα.
  3. Κάθε στήλη πρέπει να καθορίζει ακριβώς έναν τύπο στήλης.
  4. Ο έλεγχος ταυτόχρονης εκτέλεσης είναι διαθέσιμος μέσω της κεφαλίδας If-Match .
  5. Οι αναζητήσεις τοποθεσίας απαιτούν consistencyLevel ορισμό σε eventual.
  6. Τα αποτελέσματα αναζήτησης περιορίζονται σε 50 στοιχεία ανά σελίδα.
  7. Υποστηρίζονται μερικές ενημερώσεις για στήλες και στοιχεία λίστας.