Ferramentas de listas do SharePoint - referência do servidor MCP (obsoleto)

Visão geral

Ferramentas disponíveis

sharepoint_createList

Cria uma nova lista do SharePoint em um site.

Parâmetros necessários

• Siteid: A ID exclusiva do site.
• Displayname: Nome de exibição da lista.
• Lista: Lista informações como modelo (por exemplo, genericList, documentLibrary, issueTracking).

sharepoint_createListColumn

Crie uma nova coluna (columnDefinition) em uma lista de SharePoint específica. Você deve fornecer o destino siteId e listId, além de uma definição de coluna válida que especifica o nome da coluna, o nome de exibição e exatamente um tipo de coluna (como texto, número, opção, dateTime, personOrGroup, pesquisa, booliano ou hyperlinkOrPicture). Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.
• Listid: A ID exclusiva da lista.
• Nome: API ou nome estático da coluna (sem espaços, 1 a 64 caracteres)

Parâmetros opcionais:

• displayName: Nome de exibição voltado para o usuário
• Descrição: Descrição da coluna
• enforceUniqueValues: Se for verdadeiro, os valores devem ser únicos
• hidden: Se verdadeiro, a coluna está oculta
• indexado: Se for verdadeiro, os valores são indexados
• exigido: Se for verdadeiro, um valor é exigido
• readOnly: Se for verdadeiro, os valores não podem ser alterados
• texto, número, escolha, booleano, dataHora, pessoaOuGrupo, busca, hiperlinkOuImagem: Configurações de tipo de coluna (uma necessária)

sharepoint_createListItem

Crie um novo item em uma lista de SharePoint. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.
• Listid: A ID exclusiva da lista.
• campos: Valores de campo para o item da lista (mapa chave/valor)

sharepoint_deleteListColumn

Exclua um columnDefinition existente de uma lista de SharePoint específica. Forneçam siteId, listId, e columnId. Essa ação remove permanentemente a coluna do esquema da lista. Parâmetros obrigatórios

• Siteid: ID exclusiva do site.
• Listid: ID exclusiva da lista.
• Columnid: ID exclusiva da coluna a ser excluída.

sharepoint_deleteListItem

Excluir um item de lista. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.
• Listid: A ID exclusiva da lista.
• ItemId: O ID exclusivo do item de lista.

Parâmetros opcionais:

• ifMatch: Opcional ETag para controle de simultaneidade (por exemplo, "*").

sharepoint_editListColumn

Atualize um columnDefinition existente em uma lista de SharePoint específica. Forneçam siteId, listId, e columnId. O corpo é parcial – inclua apenas as propriedades que você deseja alterar, como displayName, , description, hidden, requiredou configurações de faceta. Parâmetros obrigatórios

• Siteid: ID exclusiva do site.
• Listid: ID exclusiva da lista.
• columnId: ID único da coluna a ser atualizada

Parâmetros opcionais:

• displayName: Nome de exibição voltado para o usuário
• Descrição: Descrição da coluna
• hidden: Se verdadeiro, a coluna está oculta
• exigido: Se for verdadeiro, um valor é exigido
• enforceUniqueValues: Se for verdadeiro, os valores devem ser únicos
• indexado: Se for verdadeiro, os valores são indexados
• readOnly: Se for verdadeiro, os valores não podem ser alterados
• texto, número, escolha, dataHora, pessoaOuGroup, busca, hiperlinkOuImagem: Atualizar configurações de tipo de coluna

sharepoint_getSiteByPath

Resolva um site SharePoint usando seu nome de host e caminho relativo ao servidor. Parâmetros obrigatórios

• hostname: Nome do host do locatário SharePoint (por exemplo, contoso.sharepoint. com)
• serverRelativePath: Caminho relativo ao servidor até o site (por exemplo, sites/Marketing)

sharepoint_listListColumns

Listar definições de coluna (columnDefinition recursos) para uma lista de SharePoint específica. Requer siteId e listId. Dá suporte a parâmetros OData, como $select, $tope $skiptoken. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.
• Listid: A ID exclusiva da lista.

Parâmetros opcionais:

• Selecione: Lista separada por vírgulas de propriedades a serem retornadas.
• Filtro: Expressão de filtro OData para restringir os resultados.
• Orderby: Lista separada por vírgulas de propriedades a serem ordenadas.
• Topo: Tamanho da página (1-999).
• skiptoken: Token opaco para avançar para o próximo conjunto de dados.

sharepoint_listListItems

Listar itens de uma lista de SharePoint. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.
• Listid: A ID exclusiva da lista.

Parâmetros opcionais:

• Expandir: Expansão opcional do OData (por exemplo, campos).
• Topo: Tamanho da página opcional.
• Filtro: Expressão de filtro OData opcional.
• Selecione: Cláusula de seleção opcional do OData.

sharepoint_listLists

Liste todas as listas de SharePoint em um site. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.

sharepoint_listSubsites

Liste os subsites de um site específico. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.

sharepoint_search

Pesquise o SharePoint usando a API de Pesquisa do Microsoft Graph com entityTypes=["site"]. Parâmetros obrigatórios

• solicitações: Vetor de objetos searchRequest

Parâmetros opcionais:

• entityTypes: deve ser [site] para pesquisas de site SharePoint
• Consulta: Objeto de consulta com uma string de busca no estilo da linguagem de consulta por palavras-chave (KQL)
• de: Deslocamento base zero do primeiro resultado
• Tamanho: Número de resultados a serem retornados (1-50)
• campos: Lista opcional de campos para selecionar na resposta

sharepoint_searchSitesByName

Pesquise SharePoint sites por nome de exibição ou URL parcial (linguagem natural).

Parâmetros obrigatórios

• Busca: Nome de exibição, nome parcial ou URL do site do SharePoint a ser pesquisado.

Parâmetros opcionais:

• consistencyLevel: Obrigatório por Microsoft Graph (padrão: eventual)

14. sharepoint_updateListItem

Atualize campos de um item da lista existente. Parâmetros obrigatórios

• Siteid: A ID exclusiva do site.
• Listid: A ID exclusiva da lista.
• Itemid: O ID exclusivo do item da lista.
• campos: Valores de campo a atualizar (parcial)

Parâmetros opcionais:

• ifMatch: Opcional ETag para controle de concorrência (por exemplo, "*" para forçar)

Características principais

Gestão da lista

• Criar novas listas de SharePoint com modelos
• Liste todas as listas em um site
• Suporte para vários modelos de lista (genericList, documentLibrary, issueTracking)

Operações de coluna

• Crie colunas com vários tipos de dados (texto, número, opção, dateTime, personOrGrouppesquisa, booliano e hyperlinkOrPicture).
• Editar colunas existentes.
• Excluir colunas.
• Liste todas as colunas em uma lista.
• Aplicar as restrições de validação de coluna e de unicidade.

Operações de item

• Crie itens de lista com valores de campo.
• Atualizar itens da lista existentes (atualizações parciais)
• Excluir itens de lista.
• Listar itens com filtragem e paginação.
• Use ETag para controle de simultaneidade.

Descoberta do sítio

• Pesquisar sites por nome ou URL.
• Resolva sites por nome de host e caminho.
• Listar subsites.
• Use a pesquisa no estilo KQL com a API de Pesquisa do Microsoft Graph.

Suporte a consultas OData

• Use $select para escolher propriedades.
• Use $filter para filtrar resultados.
• Use $expand para incluir tabelas relacionadas.
• Use $orderby para classificar os resultados.
• Use $top para paginação.
• Use $skiptoken para percorrer grandes conjuntos de resultados.

Suporte de tipos de coluna

• Colunas de texto (linha única ou multilinha, texto simples ou enriquecido).
• Colunas numéricas (com casas decimais, valores mínimos e máximos).
• Colunas de escolha (caixas de seleção, menu suspenso ou botões de opção).
• Colunas booleanas.
• DateTime colunas (somente data ou data e hora).
• Colunas de pessoa ou grupo (seleções simples ou múltiplas).
• Consulte colunas (consulte outras listas).
• Colunas de hiperlink ou imagem.

Notas

• Todas as operações utilizam a API Microsoft Graph v1.0.
• Os nomes de coluna devem ter de 1 a 64 caracteres sem espaços.
• Cada coluna deve especificar exatamente um tipo de coluna.
• Use o If-Match cabeçalho para controle de simultaneidade.
• Defina consistencyLevel para eventual pesquisas de site.
• Os resultados da busca são limitados a 50 itens por página.
• Colunas e itens de lista dão suporte a atualizações parciais.