MCP-servernaslaginformatie van Microsoft SharePoint en OneDrive

Overzicht

Beschikbare hulpmiddelen

createFolder

Hiermee maakt u een nieuwe map in een opgegeven documentbibliotheek, als onderliggend item van de opgegeven bovenliggende map. Als u geen documentbibliotheek opgeeft, gebruikt de server de OneDrive van de gebruiker. Als u geen bovenliggende map opgeeft, maakt de server de map in de hoofdmap. Als er al een map met dezelfde naam bestaat, maakt de server de nieuwe map met een numeriek achtervoegsel, zoals NewFolder (1).

Vereiste parameters:

• folderName(tekenreeks): de naam van de map die moet worden gemaakt. Als er al een map met dezelfde naam bestaat, voegt de server een numeriek achtervoegsel toe aan de naam van de nieuwe map, zoals NewFolder (1).
• documentLibraryId(tekenreeks) – id van de documentbibliotheek (ook wel een station genoemd) waar u de map wilt maken. Als u een map wilt maken op het station van de gebruiker of in OneDrive, zoals 'mijn station' of 'mijn onedrive', verzendt u "me" als de documentLibraryId.

Optionele parameters:

• parentFolderId(tekenreeks, standaardinstelling = "hoofdmap") - id van de bovenliggende map, waaronder de nieuwe map wordt gemaakt. De standaardinstelling is de hoofdmap van de documentbibliotheek als deze niet is opgegeven.

findSite

Hiermee vindt u SharePoint-sites waar de gebruiker toegang toe heeft. Met dit hulpprogramma kunt u een specifieke site vinden op basis van een zoekquery die u opgeeft, of de 20 belangrijkste relevante sites zoeken die toegankelijk zijn voor de gebruiker als u geen zoekquery opgeeft.

Vereiste parameters:

Geen

Optionele parameters:

• searchQuery(tekenreeks, standaardinstelling = null): - zoekquery die de volledige of gedeeltelijke sitenaam kan zijn. Als u een zoekquery opgeeft, kunt u efficiënt zoeken naar een site, maar alleen als de gebruiker op zoek is naar een specifieke site. Als de gebruiker bijvoorbeeld vraagt om een site met de naam xyz, geeft u xyz door als de searchQuery. Als de gebruiker alleen om 'mijn sites' vraagt, laat u deze parameter leeg.

listDocumentLibrariesInSite

Bevat documentbibliotheken (ook wel stations genoemd) op de opgegeven SharePoint-site. Als u geen site opgeeft, gebruikt de server de hoofdsite.

Vereiste parameters:

Geen

Optionele parameters:

• siteId: site-id (standaard: hoofdmap)

findFileOrFolder

Hiermee vindt u een bestand of een map (ook wel een DriveItem genoemd), waartoe de gebruiker toegang heeft door een zoekquery door te geven.

Vereiste parameters:

• searchQuery: zoekquery die de volledige of gedeeltelijke bestandsnaam kan bevatten

renameFileOrFolder

Wijzig de naam van een bestand of map (ook wel DriveItems genoemd) in de opgegeven documentbibliotheek. Opmerking: de nieuwe naam moet voldoen aan naamconventies.

Vereiste parameters:

• documentLibraryId: Documentbibliotheek-id (tekenreeks)
• fileOrFolderId: Bestands- of map-id (tekenreeks)
• newFileOrFolderName: Nieuwe naam voor het bestand of de map (tekenreeks)

deleteFileOrFolder

Verwijder een bestand of map uit de opgegeven documentbibliotheek.

Vereiste parameters:

• documentLibraryId: Documentbibliotheek-id (tekenreeks)
• fileOrFolderId: Bestands- of map-id (tekenreeks)

readSmallTextFile

Lees (download) een tekstbestand uit een specifieke documentbibliotheek. Als u geen documentbibliotheek opgeeft, wordt de OneDrive van de gebruiker gebruikt. U moet een fileId (driveItemId van een bestand) opgeven om het bestand te identificeren en te downloaden.

Vereiste parameters:

• fileId(tekenreeks)
• documentLibraryId(tekenreeks) – id van de documentbibliotheek (ook wel een station genoemd) of het bestand dat u wilt lezen. Als de gebruiker u vraagt een bestand te lezen of te downloaden op zijn station of OneDrive, bijvoorbeeld: Lees een bestand in 'mijn station', Lees een bestand in 'mijn onedrive' als documentLibraryId.

moveSmallFile

Verplaats een bestand in de opgegeven documentbibliotheek naar een andere map. Dit hulpprogramma ondersteunt alleen verplaatsingen voor bestanden van minder dan 5 MB en verplaatsingen die zich binnen dezelfde site bevinden. U kunt bestanden tussen stations niet verplaatsen met behulp van deze aanvraag.

Vereiste parameters:

• documentLibraryId(tekenreeks) – id van de documentbibliotheek (ook wel een station genoemd) of het bestand dat u wilt verplaatsen. Als de gebruiker u vraagt een bestand te verplaatsen op zijn station of OneDrive, bijvoorbeeld: Verplaats een bestand in 'mijn station', Verplaats een bestand in 'mijn onedrive' als documentLibraryId.
• fileId(tekenreeks) - Id van het bestand dat moet worden verplaatst
• newParentFolderId(tekenreeks): de id van de doelmap waarnaar het bestand moet worden verplaatst. Moet zich in dezelfde documentbibliotheek bevinden als de oorspronkelijke locatie van het bestand.

getFileOrFolderMetadata

Haal metagegevens van een bestand of map op uit de opgegeven documentbibliotheek op een Sharepoint-site.

Vereiste parameters:

• FileOrFolderId(tekenreeks) - Id van een bestand of map. Ze worden ook wel DriveItems genoemd. En hun id kan ook soms worden aangeduid als een driveItemId.
• documentLibraryId(tekenreeks) - Id van de documentbibliotheek (ook wel station genoemd) van het bestand of de map waarvan u de metagegevens nodig hebt. Als de gebruiker u vraagt een bestand of map op zijn station of OneDrive op te halen, bijvoorbeeld: 'Haal metagegevens van een bestand op mijn station op' of 'Haal metagegevens van een map op in mijn OneDrive' moet u "mij" als documentLibraryId verzenden.

createSmallTextFile

Maak of upload een tekstbestand dat kleiner is dan 5 MB naar een specifieke documentbibliotheek. Als u geen documentbibliotheek opgeeft, wordt de OneDrive van de gebruiker gebruikt. U kunt het bestand uploaden naar een specifieke map. Als u geen map opgeeft, wordt het bestand geüpload naar de hoofdmap.

Vereiste parameters:

• bestandsnaam (tekenreeks) - Naam van het bestand dat moet worden gemaakt
• contentText (tekenreeks) - Tekstinhoud van het bestand dat moet worden gemaakt
• documentLibraryId (tekenreeks) – id van de documentbibliotheek (ook wel een station genoemd) voor het bestand. Als een gebruiker u vraagt een bestand te maken op zijn station of OneDrive, zoals 'Maak een bestand op mijn station' of 'Maak een bestand op mijn OneDrive', stuurt u 'mij' als documentLibraryId.

Optionele parameters:

• parentfolderId(tekenreeks, standaardinstelling = "hoofdmap") - map-id binnen het station om het nieuwe bestand toe te voegen.

getFileOrFolderMetadataByUrl

Haal metagegevens voor een bestand of map op uit een URL voor delen. Alleen gebruikers met expliciete machtigingen voor toegang tot het bestand kunnen de metagegevens ophalen.

Vereiste parameters:

• fileOrFolderUrl:(tekenreeks) - URL van het bestand of de map (ook wel DriveItems genoemd). De URL wordt niet ingewisseld om deze te delen met de gebruiker; ze moeten al expliciete toegang tot het bestand hebben.

shareFileOrFolder

Verzend een uitnodiging voor delen, om machtigingen te verlenen voor een bestand of map in een opgegeven documentbibliotheek. Ondersteunt het toewijzen van rollen en het melden van ontvangers.

Vereiste parameters:

• documentLibraryId: Documentbibliotheek-id (tekenreeks, vereist)
• fileOrFolderId: Bestands- of map-id (tekenreeks, vereist)
• recipientEmails:(tekenreeks [], vereist) – E-mailadressen van geadresseerden die moeten worden uitgenodigd. Er is ten minste één e-mailadres van de geadresseerde vereist.

Optionele parameters:

• roles(tekenreeks []) – Rollen die moeten worden toegewezen aan ontvangers. Geaccepteerde waarden: lezen, schrijven (schrijven verleent zowel lees- als schrijftoegang). De standaardinstelling geeft de rol Lezen als deze niet is opgegeven.
• sendInvitation(bool, standaardinstelling = true) – Geeft aan of een uitnodiging voor delen moet worden verzonden. De standaardinstelling is Waar als deze niet is opgegeven.
• message(tekenreeks, standaardinstelling = "Dit is het bestand waaraan we samenwerken.") – Aangepast bericht dat moet worden opgenomen in de uitnodigingsmail. De standaardinstelling is een standaardbericht als dit niet is opgegeven.

getFolderChildren

Geeft de bovenste 20 bestanden en mappen weer in een opgegeven bovenliggende map in een documentbibliotheek. Als u geen documentbibliotheek opgeeft, wordt de OneDrive van de gebruiker gebruikt.

Vereiste parameters:

• documentLibraryId(tekenreeks) – id van de documentbibliotheek (ook wel een station genoemd) voor het bovenliggende bestand. Als een gebruiker u vraagt bestanden op te halen van een map van hun station of OneDrive, zoals 'Haal bestanden op van een map op mijn station' of 'Haal bestanden ophalen van een map op mijn OneDrive', stuurt u 'mij' als de documentLibraryId.

Optionele parameters:

• parentFolderId:(tekenreeks, standaardinstelling = "hoofdmap") - id van de bovenliggende map (DriveItem) waarvan de bestanden en mappen worden vermeld. De standaardinstelling is niet gespecificeerd voor de hoofdmap van de documentbibliotheek.

Echo

Hiermee wordt het bericht teruggestuurd naar de client.

Vereiste parameters:

• bericht: Bericht om terug te verzenden

setSensitivityLabelOnFile

Stel het vertrouwelijkheidslabel van een bestand in vanuit de opgegeven documentbibliotheek.

Vereiste parameters:

• documentLibraryId(tekenreeks): de documentbibliotheek-id, ook wel stationId genoemd, van de documentbibliotheek
• fileId(tekenreeks): de bestands-id, ook wel driveItemId genoemd, van het bestand
• sensitivityLabelId(tekenreeks) - vereist. Id van het vertrouwelijkheidslabel dat moet worden toegewezen of een lege tekenreeks om het vertrouwelijkheidslabel te verwijderen.

Optionele parameters:

• assignmentMethod(tekenreeks, standaardinstelling = "bevoegd") - de toewijzingsmethode van het label in het document. Hiermee wordt aangegeven of de toewijzing van het label automatisch, als standaardinstelling of als een bevoegde bewerking is uitgevoerd (het equivalent van een beheerdersbewerking). Mogelijke waarden zijn standaardinstelling, bevoegd, automatisch en unknownFutureValue.
• justificationText(tekenreeks, standaardinstelling = "Gewijzigd door MCPServer") – Optioneel. Tekst met uitleg over controledoeleinden, is vereist bij het downgraden of verwijderen van een label.

getDefaultDocumentLibraryInSite

Haal de standaarddocumentbibliotheek (ook wel Station genoemd) op van een SharePoint-site. Als u geen site opgeeft, wordt de hoofdmapsite gebruikt.

Vereiste parameters:

Geen

Optionele parameters:

• siteId: site-id (standaard: hoofdmap)

Belangrijke functies

Mapbeheer

• Mappen maken met automatische conflictoplossing voor naamgeving
• Map met onderliggende items weergeven (top 20)
• Bestanden verplaatsen tussen mappen (binnen dezelfde site)

Bestandsactiviteiten

• Kleine tekstbestanden maken en uploaden (< 5 MB)
• Tekstbestanden lezen en downloaden
• Bestanden en mappen een nieuwe naam geven
• Bestanden en mappen verwijderen
• Metagegevens van bestanden en mappen ophalen op basis van id of URL

Site- en bibliotheekdetectie

• SharePoint-sites zoeken met een zoekquery
• Documentbibliotheken weergeven op een site
• Standaarddocumentbibliotheek ophalen

Delen en machtigingen

• Bestanden en mappen delen met roltoewijzingen
• Uitnodigingen voor delen verzenden met aangepaste berichten
• Toegangsbeheer via expliciete machtigingen

Beveiliging en naleving

• Vertrouwelijkheidslabels instellen voor bestanden
• Ondersteuning voor bevoegde, standaard- en automatische toewijzingsmethoden
• Tekst met uitleg over nalevingscontrole

Integratie

• Ondersteuning voor OneDrive en SharePoint Online
• Tenantspecifieke serververbinding
• DriveItem-abstractie voor bestanden en mappen

Opmerkingen

1. Standaarddocumentbibliotheek is 'mij' (OneDrive van de gebruiker)
2. De standaard bovenliggende map is 'hoofdmap'
3. Mapnaamconflicten opgelost met numerieke achtervoegsels
4. Bestandswijzigingen beperkt tot minder dan 5 MB en binnen dezelfde site
5. Voor URL's voor delen zijn expliciete toegangsmachtigingen vereist
6. DriveItems vertegenwoordigen zowel bestanden als mappen
7. Top 20-limiet voor de weergave van onderliggende mappen