Riferimento per il server MCP (deprecato) degli strumenti per le liste di SharePoint

Panoramica

Strumenti disponibili

sharepoint_createList

Crea un nuovo elenco di SharePoint in un sito.

Parametri obbligatori

• Siteid: ID univoco del sito.
• Displayname: Nome visualizzato dell'elenco.
• Elenco: Elencare le informazioni, ad esempio il modello, genericList, documentLibrary. issueTracking

sharepoint_createListColumn

Creare una nuova colonna (columnDefinition) in un elenco di SharePoint specifico. È necessario specificare la destinazione siteId e listId, oltre a una definizione di colonna valida che specifichi il nome della colonna, il nome visualizzato e uno solo del tipo di colonna (ad esempio testo, numero, scelta, dateTime, personOrGroup, collegamento, booleano o hyperlinkOrPicture). Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.
• Nome: API o nome statico della colonna (senza spazi, 1-64 caratteri)

Parametri facoltativi:

• displayName: nome visualizzato rivolto all'utente
• description: descrizione della colonna
• enforceUniqueValues: se true, i valori devono essere univoci
• hidden: se true, la colonna è nascosta
• indexed: se true, i valori vengono indicizzati
• required: se true, è necessario un valore
• readOnly: se true, i valori non possono essere modificati
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: impostazioni del tipo di colonna (una richiesta)

sharepoint_createListItem

Creare un nuovo elemento in un elenco di SharePoint. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.
• fields: valori di campo per l'elemento di elenco (mappa chiave/mappa valori)

sharepoint_deleteListColumn

Eliminare un columnDefinition esistente da un elenco di SharePoint specifico. Fornire siteId, listId, e columnId. Questa azione rimuove definitivamente la colonna dallo schema dell'elenco. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.
• columnId: ID univoco della colonna da eliminare.

sharepoint_deleteListItem

Eliminare una voce di elenco. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.
• Itemid: ID univoco dell'elemento di elenco.

Parametri facoltativi:

• ifMatch: Facoltativo ETag per il controllo della concorrenza (ad esempio, "*").

sharepoint_editListColumn

Aggiornare un columnDefinition esistente in un elenco di SharePoint specifico. Fornire siteId, listId, e columnId. Il corpo è parziale: includere solo le proprietà che si desidera modificare, ad esempio displayName, descriptionhidden, required, o le impostazioni del facet. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.
• columnId: ID univoco della colonna da aggiornare

Parametri facoltativi:

• displayName: nome visualizzato rivolto all'utente
• description: descrizione della colonna
• hidden: se true, la colonna è nascosta
• required: se true, è necessario un valore
• enforceUniqueValues: se true, i valori devono essere univoci
• indexed: se true, i valori vengono indicizzati
• readOnly: se true, i valori non possono essere modificati
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Aggiorna le impostazioni del tipo di colonna

sharepoint_getSiteByPath

Risolvere un sito SharePoint usando il nome host e il percorso relativo al server. Parametri obbligatori:

• hostname: Nome host del tenant SharePoint, ad esempio contoso.sharepoint. com)
• serverRelativePath: percorso relativo al server del sito (ad esempio, sites/Marketing)

sharepoint_listListColumns

Elencare le definizioni di colonna (columnDefinition resources) per un elenco di SharePoint specifico. Richiede siteId e listId. Supporta parametri OData come $select, $tope $skiptoken. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.

Parametri facoltativi:

• Selezionare: Elenco delimitato da virgole di proprietà da restituire.
• Filtro: Espressione di filtro OData per limitare i risultati.
• Orderby: Elenco delimitato da virgole di proprietà in base a cui ordinare.
• Principale: Dimensione della pagina (1-999).
• skiptoken: Token opaco per il paging al set successivo.

sharepoint_listListItems

Elencare gli elementi da un elenco di SharePoint. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.

Parametri facoltativi:

• Espansione: Espansione facoltativa di OData (ad esempio, campi).
• Superiore: Dimensioni pagina facoltative.
• Filtro: Espressione di filtro OData facoltativa.
• Selezionare: Clausola OData di selezione facoltativa.

sharepoint_listLists

Elencare tutti gli elenchi SharePoint in un sito. Parametri obbligatori:

• Siteid: ID univoco del sito.

sharepoint_listSubsites

Elenca i siti figlio (siti secondari) per un determinato sito. Parametri obbligatori:

• Siteid: ID univoco del sito.

ricerca_di_sharepoint

Eseguire ricerche in SharePoint usando l'API Microsoft Graph Search con entityTypes=["site"]. Parametri obbligatori:

• requests: matrice di oggetti searchRequest

Parametri facoltativi:

• entityTypes: Deve essere [site] per le ricerche di siti SharePoint
• Query: Oggetto query con stringa di ricerca in stile keyword query language (KQL)
• from: offset a base zero del primo risultato
• size: Numero di risultati da restituire (1-50)
• fields: elenco facoltativo di campi da selezionare nella risposta

sharepoint_cercaSitiPerNome

Cercare SharePoint siti in base al nome visualizzato o all'URL parziale (linguaggio naturale).

Parametri obbligatori:

• Ricerca: Nome visualizzato, nome parziale o URL del sito di SharePoint da cercare.

Parametri facoltativi:

• consistencyLevel: Richiesto da Microsoft Graph (impostazione predefinita: eventual)

14. sharepoint_updateListItem

Aggiorna i campi di una voce di elenco esistente. Parametri obbligatori:

• Siteid: ID univoco del sito.
• listId: ID univoco dell'elenco.
• Itemid: ID univoco dell'elemento di elenco.
• fields: valori dei campi da aggiornare (parziale)

Parametri facoltativi:

• ifMatch: Opzionale ETag per il controllo della concorrenza (ad esempio, "*" per forzare)

Funzionalità principali

Gestione delle liste

• Creare nuovi elenchi di SharePoint con modelli
• Elenca tutti gli elenchi in un sito
• Supporto per vari template di elenco (genericList, documentLibrary, issueTracking)

Operazioni di colonna

• Creare colonne con più tipi di dati (testo, numero, scelta, dateTime, , personOrGroupricerca, booleano e hyperlinkOrPicture).
• Modificare le colonne esistenti.
• Eliminare le colonne.
• Elencare tutte le colonne di un elenco.
• Applicare vincoli di convalida della colonna e di univocità.

Operazioni sugli elementi

• Creare voci di elenco con valori di campo.
• Aggiorna le voci di elenco esistenti (aggiornamenti parziali)
• Elimina elementi della lista.
• Elementi di elenco con filtro e paginazione.
• Usare ETag per il controllo della concorrenza.

Scoperta del sito

• Cercare i siti in base al nome o all'URL.
• Risolvere i siti in base al nome host e al percorso.
• Elencare i siti secondari.
• Usare la ricerca in stile KQL con l'API Microsoft Graph Search.

Supporto di query OData

• Usare $select per scegliere le proprietà.
• Usare $filter per filtrare i risultati.
• Utilizzare $expand per includere tabelle correlate.
• Usare $orderby per ordinare i risultati.
• Usare $top per l'impaginazione.
• Usare $skiptoken per scorrere set di risultati di grandi dimensioni.

Supporto per tipi di colonna

• Colonne di testo (riga singola o multilinea, testo normale o rtf).
• Colonne numeri (con cifre decimali, valori minimi e massimi).
• Colonne di scelta (elenco a discesa, caselle di controllo o pulsanti di opzione).
• Colonne booleane.
• DateTime colonne (solo data o data e ora).
• Colonne di persone o gruppi (selezioni singole o multiple).
• Colonne di ricerca (fanno riferimento ad altri elenchi).
• Colonne di collegamenti ipertestuali o immagini.

Note

• Tutte le operazioni usano l'API Microsoft Graph v1.0.
• I nomi delle colonne devono essere da 1 a 64 caratteri senza spazi.
• Ogni colonna deve specificare esattamente un tipo di colonna.
• Usare l'intestazione If-Match per il controllo della concorrenza.
• Impostare consistencyLevel su eventual per le ricerche nei siti.
• I risultati della ricerca sono limitati a 50 elementi per pagina.
• Le colonne e gli elementi di elenco supportano aggiornamenti parziali.