SharePoint-reference (forhåndsvisning)

Bemærkning

Funktionerne i denne artikel drives af standardledningsnettet, som bruger de faktureringsmuligheder beskrevet i Licensering for agenter drevet af standardledningsnettet. Lær, hvordan du får adgang til standardfunktioner i Access standardagenter og agentflows.

Vigtig

Dette er en prøveversionsfunktion.

• Microsoft udgiver prøveversionsfunktioner før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
• Prøveversionsfunktioner har begrænset funktionalitet og er ikke beregnet til produktionsbrug.
• Microsoft kan ændre navnene og parametrene for MCP-værktøjer i prøveversion. Undgå hardkodede afhængigheder. Microsoft vedligeholder scenariesupport.
• Prøveversionsfunktioner er underlagt Microsoft supplerende vilkår for anvendelse.

Oversigt

Server-ID	URL-adresse på lejerniveau	Vis navn	Beskrivelse
mcp_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_SharePointRemoteServer	SharePoint	Værktøjer til SharePoint-operationer. Brug denne server til at administrere websteder, lister, listeelementer, kolonner, dokumentbiblioteker, filer, mapper og fildeling. Filhandlinger er begrænset til filer, der er 5 MB eller mindre.

Tilgængelige værktøjer

findSide

Finder SharePoint websteder, du har adgang til. Returnerer bestemte websteder, der svarer til en søgeforespørgsel, eller de 20 mest relevante websteder, hvis du ikke angiver en forespørgsel.

Valgfrie parametre:

• searchQuery: Søgeforespørgsel (helt eller delvist webstedsnavn). Udelad at returnere de 20 mest tilgængelige websteder.

getSiteByPath

Løser et SharePoint websted ved hjælp af dets nøjagtige værtsnavn og serverrelative sti. Brug kun denne metode, når du har den komplette url-struktur for webstedet. Bruges findSite , når du kun kender et webstedsnavn.

Påkrævede parametre:

• Værtsnavn: Nøjagtigt værtsnavn (f.eks. 'contoso.sharepoint.com')
• serverRelativePath: Serverrelativ sti (f.eks. 'websteder/marketing'). Den foranstillede skråstreg er valgfri.

Vis undersider

Viser alle underordnede websteder (underwebsteder) på et SharePoint-websted.

Påkrævede parametre:

• siteId: Id for det overordnede SharePoint websted (format: 'værtsnavn,webstedCollectionId,webId')

listDokumentbibliotekerPåWebsted

Viser dokumentbiblioteker (drev) på det angivne SharePoint websted.

Valgfrie parametre:

• siteId: Id for det SharePoint websted (standard: 'root')

getDefaultDocumentLibraryInSite

Henter standarddokumentbiblioteket (drev) på et SharePoint websted.

Valgfrie parametre:

• siteId: Id for det SharePoint websted (standard: 'root')

getFolderChildren

Optæller de øverste 20 filer og mapper (DriveItems), der er indeholdt i en angivet overordnet mappe i et dokumentbibliotek (drev).

Påkrævede parametre:

• documentLibraryId: Id for dokumentbiblioteket (drev)

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

findFileOrFolder

Finder en fil eller mappe (DriveItem), der er tilgængelig for brugeren ved hjælp af søgeforespørgslen. Søger på tværs af alle websteder og dokumentbiblioteker, som brugeren har adgang til.

Påkrævede parametre:

• searchQuery: Søgeforespørgsel (helt eller delvist filnavn)

getFileOrFolderMetadata

Henter metadata for en fil eller mappe (DriveItem) fra et angivet dokumentbibliotek (drev) i SharePoint.

Påkrævede parametre:

• fileOrFolderId: Id for filen eller mappen (DriveItem)
• documentLibraryId: Id for dokumentbiblioteket (drev)

getFileOrFolderMetadataByUrl

Henter metadata for en fil eller mappe (DriveItem) fra en delings-URL. Det er kun brugere med eksisterende eksplicitte tilladelser til at få adgang til filen, der kan hente metadataene.

Påkrævede parametre:

• fileOrFolderUrl: URL-adressen til filen eller mappen. URL-adressen indløses ikke for at dele den med brugeren. de skal allerede have eksplicit adgang.

readSmallTextFile

Læser (downloader) en tekstfil mindre end 5 MB fra et specifikt dokumentbibliotek (drev).

Påkrævede parametre:

• fileId: Id for den fil (DriveItem), der skal læses eller downloades
• documentLibraryId: Id for dokumentbiblioteket (drev)

readSmallBinaryFile

Læser en binær fil, der er mindre end 5 MB, fra et bestemt dokumentbibliotek (drev). Filindholdet returneres som en base64-kodet streng.

Påkrævede parametre:

• fileId: Id for den fil (DriveItem), der skal læses eller downloades
• documentLibraryId: Id for dokumentbiblioteket (drev)

createSmallTextFile

Opretter eller uploader en tekstfil mindre end 5 MB til et specifikt dokumentbibliotek (drev).

Påkrævede parametre:

• Filnavn: Navnet på filen inklusive endelse.
• indholdTekst: Tekstindholdet af filen.
• documentLibraryId: Id for dokumentbiblioteket (drev)

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

createSmallBinaryFile

Opretter en binær fil, der er mindre end 5 MB, ved base64-kodning af dens indhold til et bestemt dokumentbibliotek (drev).

Påkrævede parametre:

• Filnavn: Navnet på filen inklusive endelse.
• base64Content: Binært filindhold kodet som en base64-streng.
• documentLibraryId: Id for dokumentbiblioteket (drev)

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

createFolder

Opretter en ny mappe (DriveItem) i et angivet dokumentbibliotek (drev). Hvis der findes en mappe med samme navn, tilføjer systemet et numerisk suffiks (f.eks. NewFolder (1)).

Påkrævede parametre:

• folderName: Navnet på mappen
• documentLibraryId: Id for dokumentbiblioteket (drev)

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

omdøbFilEllerMappe

Omdøber en fil eller mappe (DriveItem) i et angivet dokumentbibliotek (drev). Det nye navn skal overholde navngivningskonventionerne.

Påkrævede parametre:

• documentLibraryId: Id for dokumentbiblioteket (drev)
• fileOrFolderId: Id for den fil eller mappe, der skal omdøbes
• newFileOrFolderName: Det nye navn

Valgfrie parametre:

• Etag: ETag for samtidighedskontrol

deleteFileOrFolder

Sletter en fil eller mappe (DriveItem) fra et angivet dokumentbibliotek (drev).

Påkrævede parametre:

• documentLibraryId: Id for dokumentbiblioteket (drev)
• fileOrFolderId: Id for den fil eller mappe, der skal slettes

Valgfrie parametre:

• Etag: ETag for samtidighedskontrol

moveFileOrFolder

Flytter en fil eller mappe (DriveItem) til en destinationsmappe. Understøtter flytning på tværs af forskellige dokumentbiblioteker (drev) i SharePoint. Denne handling er asynkron. Bruges checkOperationStatus til at overvåge status.

Påkrævede parametre:

• sourcedoclibid: Id for kildedokumentbiblioteket (drev)
• sourcefileid: Id for den kildefil eller mappe, der skal flyttes
• destdoclibid: Id for destinationsdokumentbiblioteket (drev)
• destfolderid: Id'et for destinationsmappen (skal findes)

Valgfrie parametre:

• newfilename: Nyt navn til det flyttede element

kopierFilEllerMappe

Kopierer en fil eller mappe (DriveItem) til en destinationsmappe. Understøtter kopiering på tværs af forskellige dokumentbiblioteker i SharePoint. Denne handling er asynkron. Bruges checkOperationStatus til at overvåge status.

Påkrævede parametre:

• sourcedoclibid: Id for kildedokumentbiblioteket (drev)
• sourcefileid: Id for den kildefil eller mappe, der skal kopieres
• destdoclibid: Id for destinationsdokumentbiblioteket (drev)
• destfolderid: Id'et for destinationsmappen (skal findes)

Valgfrie parametre:

• newfilename: Nyt navn på det kopierede element

checkOperationStatus

Kontrollerer status for en asynkron handling, f.eks. en kopi eller flytning, ved hjælp af det handlingstoken, der blev returneret fra den oprindelige handling.

Påkrævede parametre:

• operationToken: Det handlingstoken, der returneres fra en asynkron handling, f.eks copyFileOrFolder . eller moveFileOrFolder

uploadFileFromUrl

Overfører en fil fra en SharePoint eller OneDrive URL-adresse til en destinationsmappe i et dokumentbibliotek (drev). Filen kopieres fra kilde-URL-adressen, så den oprindelige fil ændres ikke.

Påkrævede parametre:

• sourceUrl: Kilde-URL-adresse (skal være en gyldig URL-adresse til SharePoint eller OneDrive)
• destinationDocumentLibraryId: Id'et for destinationsdokumentbiblioteket. Brug me til brugerens OneDrive

Valgfrie parametre:

• destinationFolderId: ID på destinationsmappen (standardværdi: root)
• Filnavn: Nyt filnavn; er som standard det oprindelige filnavn

delFilEllerMappe

Sender en invitation til deling for at give læse- eller skrivetilladelser til en fil eller mappe (DriveItem) i et angivet dokumentbibliotek (drev).

Påkrævede parametre:

• documentLibraryId: Id for dokumentbiblioteket (drev)
• fileOrFolderId: Id for den fil eller mappe, der skal deles
• recipientEmails: Matrix af mailadresser på modtagere
• Roller: Matrix af roller: 'read', 'write' (skriv giver både læse- og skriveadgang)

Valgfrie parametre:

• Besked: Brugerdefineret meddelelse til invitationsmailen (standard: Her er den fil, vi samarbejder om).)
• sendInvitation: Om du vil sende en invitation til deling (standard: true)

indstillFølsomhedsmærkePåFil

Angiver følsomhedsmærkaten for en fil fra det angivne dokumentbibliotek (drev).

Påkrævede parametre:

• documentLibraryId: Id for dokumentbiblioteket (drev)
• fileId: ID på filen (DriveItem)
• sensitivityLabelId: Id'et for følsomhedsmærkaten eller en tom streng til at fjerne den

Valgfrie parametre:

• assignmentMethod: Tildelingsmetode: 'standard', 'privilegeret', 'auto' eller 'unknownFutureValue' (standard: 'privilegeret')
• justeringTekst: Begrundelsestekst til revisionsformål. påkrævet ved nedgradering eller fjernelse af en etiket (standard: 'Ændret af MCPServer')

listLists

Henter alle SharePoint lister, der er tilgængelige på et bestemt websted. Bruges til at finde ud af, hvilke lister der findes på et websted.

Påkrævede parametre:

• siteId: Id for det SharePoint websted (format: 'værtsnavn,webstedCollectionId,webId')

createList

Opretter en ny SharePoint list på et websted.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• Displayname: Vist navn på den nye liste

Valgfrie parametre:

• Kolonner: Samling af kolonner som nøgleværdipar: [{ Key: 'JobTitle', Value: 'text' }]. Gyldige typer: tekst, tekst, tekst med flere streger, tal, boolesk, dateTime, valg, opslag, personOrGroup, link, valuta, beregnet
• Skabelon: Listeskabelontype (standard: 'genericList'). Indstillinger: genericList, documentLibrary, hændelser, opgaver, meddelelser, kontakter, links, undersøgelse, issueTracking, discussionBoard

Slet liste

Sletter en SharePoint list fra et websted. Sletter hele listeobjektbeholderen og alle elementerne i den. Denne handling kan ikke fortrydes.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: Id for den liste, der skal slettes

Valgfrie parametre:

• Etag: ETag for samtidighedskontrol

sendInviteForList

Sender en invitation til deling for at tildele tilladelser til en SharePoint list.

Påkrævede parametre:

• listId: Id for det SharePoint list, der skal deles
• recipientEmails: Matrix af mailadresser på modtagere
• Rolle: Rolle: 'læs' (kun visning), 'bidrag' (visning, tilføj, opdater, slet elementer), 'rediger' (fuld redigering, herunder listestruktur)

Valgfrie parametre:

• siteUrl: URL-adresse til webstedet for det SharePoint websted, der indeholder listen
• sendEmail: Om du vil sende en mailmeddelelse (standard: true)

listListItems

Henter elementer (rækker/poster) fra en bestemt SharePoint list.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen

getListItem

Henter et enkelt element (række eller post) fra en SharePoint list via dets ID.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• itemId: Id for det specifikke listeelement

createListItem

Opretter et nyt element (række eller post) i en SharePoint list.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• FELTER: Nøgleværdipar for feltværdier, såsom [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Feltet 'Titel' er typisk påkrævet.

updateListItem

Opdaterer et eksisterende element (række eller post) i en SharePoint list. Det er kun de angivne felter, der opdateres. udeladte felter bevarer deres værdier.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• itemId: Id for det element, der skal opdateres
• Felter: Nøgleværdipar af felter, der skal opdateres

Valgfrie parametre:

• Etag: ETag for samtidighedskontrol

deleteListItem

Sletter et element (række eller en post) fra en SharePoint list.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• itemId: Id for det element, der skal slettes

Valgfrie parametre:

• Etag: ETag for samtidighedskontrol

listColumns

Henter alle kolonner fra en SharePoint list.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen

createColumn

Opretter en ny kolonne i en SharePoint list. Understøtter mange kolonnetyper, herunder tekst, tal, valg, dateTime, boolesk, bruger, opslag, beregnet og meget mere.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• Navn: Internt kolonnenavn (programmatisk identifikator)
• columnType: Kolonnetype: tekst, note, tal, heltal, boolesk, dateTime, valg, multichoice, valuta, opslag, bruger, URL, beregnet, term, multiterm, placering, geoplacering, miniature, tæller, beregnet, contentTypeId, fil, vedhæftet fil, guid, outcomeChoice, approvalStatus

Valgfrie parametre:

• columnProperties: Typespecifikke indstillinger (f.eks. { "maxLength": 255 } tekst, { "choices": ["A","B","C"] } valg)
• Beskrivelse: Beskrivelse af kolonnen
• Displayname: Vist navn, der vises i brugergrænsefladen (som standard 'navn')
• Kræves: Gør kolonnen påkrævet (standard: falsk)
• Skjulte: Skjul kolonne i visninger (standard: falsk)

opdaterKolonne

Opdaterer en eksisterende kolonne i en SharePoint list.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• columnId: Id for den kolonne, der skal opdateres

Valgfrie parametre:

• columnType: Kolonnetype (påkrævet, når der angives 'columnProperties')
• columnProperties: Typespecifikke egenskaber, der skal opdateres
• Beskrivelse: Ny beskrivelse
• Displayname: Nyt vist navn
• Skjulte: Skjul eller vis kolonne
• Kræves: Gør kolonne påkrævet eller valgfri

slet kolonne

Sletter en kolonne fra en SharePoint list. Advarsel: Denne handling fjerner alle data, der er gemt i kolonnen, for alle elementer.

Påkrævede parametre:

• siteId: Id for det SharePoint websted
• listId: ID for SharePoint-listen
• columnId: Id for den kolonne, der skal slettes

Vigtige funktioner

Administration af websted

• Find websteder efter navn, eller gennemse tilgængelige websteder.
• Hent et websted via den nøjagtige URL-sti.
• Vis en liste over underordnede websteder og delwebsteder.
• Omfattende navigation i webstedshierarki.

Administration af dokumentbibliotek

• Vis alle dokumentbiblioteker på et websted.
• Hent standarddokumentbiblioteket.
• Gennemse mappens indhold (op til 20 elementer).
• Opret og administrer mappestrukturer.

Filhandlinger

• Opret tekst- og binære filer (5 MB eller mindre).
• Læs tekst og binære filer (5 MB eller mindre).
• Slet, omdøb og flyt filer og mapper.
• Kopiér filer og mapper på tværs af dokumentbiblioteker.
• Overfør filer fra URL-adresser til SharePoint eller OneDrive.
• Søg efter filer og mapper på tværs af alle tilgængelige websteder.
• Hent fil- og mappemetadata.

Asynkrone operationer

• Kopiér og flyt filer og mapper asynkront på tværs af dokumentbiblioteker.
• Kontrollér status for asynkrone handlinger ved hjælp af handlingstokens.

Listeoperationer

• Opret, læs og slet lister.
• Understøttelse af flere listeskabeloner, herunder generiske, dokumentbibliotek, hændelser og opgaver.
• Del lister med rollebaserede tilladelser.
• Administrer listeelementer ved at oprette, læse, opdatere og slette dem.

Kolonneadministration

• Opret kolonner med en lang række typer, f.eks. tekst, note, tal, boolesk, dateTime, valg, opslag, bruger, URL-adresse, beregnet med mere.
• Opdater kolonneegenskaber og metadata.
• Konfigurer kolonnekrav og synlighed.
• Angiv typespecifikke kolonneegenskaber.

Deling og tilladelser

• Del filer, mapper og lister med brugere.
• Brug rollebaseret adgangskontrol med læse-, skrive-, bidrags- og redigeringsroller.
• E-mail-notifikationer til deling.
• Brugerdefinerede beskeder i invitationer.

Sikkerhed og overholdelse af angivne standarder

• Anvend og fjern følsomhedsmærkater.
• Brug flere tildelingsmetoder, herunder standard, privilegerede og automatiske.
• Understøtter revisionsberettigelse.
• Brug samtidighedskontrol med eTags.

Bemærkninger

• Filhandlinger er begrænset til filer, der er 5 MB eller mindre til overførsel og download.
• Kopierings- og flytningshandlinger er asynkrone. Bruges checkOperationStatus til at overvåge status.
• Kopierings- og flyttehandlinger understøtter handlinger på tværs af biblioteker i SharePoint.
• uploadFileFromUrl kræver en gyldig URL-adresse til SharePoint eller OneDrive kilde.
• eTags giver samtidighedskontrol for opdateringer og sletninger.
• Automatisk numerisk endelse for dublerede mappenavne.
• Sletning af lister kan ikke fortrydes.
• Kolonnesletning fjerner alle data, der er gemt i den pågældende kolonne.
• Søgehandlinger returnerer som standard de øverste 20 resultater.