SharePoint-referanse (forhåndsvisning)

Bemerkning

Funksjonene i denne artikkelen drives av standardledningsnettet, som bruker faktureringsalternativene beskrevet i Lisensiering for agenter drevet av standardledningsnettet. Lær hvordan du får tilgang til standardfunksjoner i Access standardagenter og agentflyter.

Important

Dette er en forhåndsvisningsfunksjon.

• Microsoft utgir forhåndsvisningsfunksjoner før en offisiell utgivelse, slik at kundene kan få tidlig tilgang og gi tilbakemelding.
• Forhåndsvisningsfunksjoner har begrenset funksjonalitet og er ikke ment for produksjonsbruk.
• Microsoft kan endre mcp-verktøynavn og parametere for forhåndsvisning. Unngå hardkodede avhengigheter. Microsoft opprettholder scenariostøtte.
• Forhåndsvisningsfunksjoner er underlagt Microsoft ekstra vilkår for bruk.

Oversikt

Server-ID	URL på leiernivå	Visningsnavn	Beskrivelse
mcp_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_SharePointRemoteServer	SharePoint	Verktøy for SharePoint-operasjoner. Bruk denne serveren til å administrere områder, lister, listeelementer, kolonner, dokumentbiblioteker, filer, mapper og fildeling. Filoperasjoner er begrenset til filer som er 5 MB eller mindre.

Tilgjengelige verktøy

findSite

Finner SharePoint områder du har tilgang til. Returnerer bestemte områder som samsvarer med en søkespørring, eller de 20 mest relevante områdene hvis du ikke angir en spørring.

Valgfrie parametere:

• searchQuery: Søkespørring (helt eller delvis områdenavn). Utelat å returnere de 20 beste tilgjengelige nettstedene.

getSiteByPath

Løser et SharePoint område ved hjelp av det nøyaktige vertsnavnet og den relative serverbanen. Bruk denne metoden bare når du har den fullstendige url-strukturen for området. Brukes findSite når du bare vet et områdenavn.

Obligatoriske parametere:

• Vertsnavn: Nøyaktig vertsnavn (for eksempel contoso.sharepoint.com)
• serverRelativePath: Server-relativ bane (for eksempel områder/markedsføring). Den innledende skråstreken er valgfri.

Vis underområder

Viser alle sekundære områder (underordnede områder) for et SharePoint område.

Obligatoriske parametere:

• siteId:-ID for det overordnede SharePoint området (format: vertsnavn, siteCollectionId,webId')

listDokumentbibliotekerISide

Viser dokumentbiblioteker (stasjoner) på det angitte SharePoint området.

Valgfrie parametere:

• siteId: ID-en til SharePoint-nettstedet (standard: 'root')

hentStandardDokumentbibliotekPåNettsted

Henter standard dokumentbibliotek (stasjon) på et SharePoint nettsted.

Valgfrie parametere:

• siteId: ID-en til SharePoint-nettstedet (standard: 'root')

getFolderChildren

Nummererer de 20 mest populære filene og mappene (DriveItems) i en angitt overordnet mappe i et dokumentbibliotek (stasjon).

Obligatoriske parametere:

• documentLibraryId: ID-en til dokumentbiblioteket (drive)

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

findFileOrFolder

Finner en fil eller mappe (DriveItem) tilgjengelig for brukeren ved hjelp av søkespørring. Søker på tvers av alle områder og dokumentbiblioteker som brukeren har tilgang til.

Obligatoriske parametere:

• searchQuery: Søkespørring (helt eller delvis filnavn)

getFileOrFolderMetadata

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

Obligatoriske parametere:

• fileOrFolderId: ID for filen eller mappen (DriveItem)
• documentLibraryId: ID-en til dokumentbiblioteket (drive)

getFileOrFolderMetadataByUrl

Henter metadata for en fil eller mappe (DriveItem) fra en delings-URL. Bare brukere med eksisterende eksplisitte tillatelser til å få tilgang til filen, kan få metadataene.

Obligatoriske parametere:

• fileOrFolderUrl: URL-adressen til filen eller mappen. URL-adressen er ikke løst inn for å dele den med brukeren. de må allerede ha eksplisitt tilgang.

readSmallTextFile

Leser (laster ned) en tekstfil mindre enn 5 MB fra et spesifikt dokumentbibliotek (stasjon).

Obligatoriske parametere:

• fileId: ID for filen (DriveItem) som skal leses eller lastes ned
• documentLibraryId: ID-en til dokumentbiblioteket (drive)

readSmallBinaryFile

Leser en binærfil som er mindre enn 5 MB fra et bestemt dokumentbibliotek (stasjon). Filinnholdet returneres som en base64-kodet streng.

Obligatoriske parametere:

• fileId: ID for filen (DriveItem) som skal leses eller lastes ned
• documentLibraryId: ID-en til dokumentbiblioteket (drive)

createSmallTextFile

Oppretter eller laster opp en tekstfil mindre enn 5 MB til et spesifikt dokumentbibliotek (disk).

Obligatoriske parametere:

• Filnavn: Navnet på filen, inkludert filendelse.
• innholdTekst: Tekstinnholdet i filen.
• documentLibraryId: ID-en til dokumentbiblioteket (drive)

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

createSmallBinaryFile

Oppretter en binærfil som er mindre enn 5 MB i et bestemt dokumentbibliotek (stasjon) ved å base64-kode innholdet.

Obligatoriske parametere:

• Filnavn: Navnet på filen, inkludert filendelse.
• base64Content: Binært filinnhold kodet som en base64-streng.
• documentLibraryId: ID-en til dokumentbiblioteket (drive)

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

createFolder

Oppretter en ny mappe (DriveItem) i et angitt dokumentbibliotek (stasjon). Hvis det finnes en mappe med samme navn, legger systemet til et numerisk suffiks (for eksempel NewFolder (1)).

Obligatoriske parametere:

• Mappenavn: Navnet på mappen
• documentLibraryId: ID-en til dokumentbiblioteket (drive)

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

endreNavnPåFilEllerMappe

Gir nytt navn til en fil eller mappe (DriveItem) i et angitt dokumentbibliotek (stasjon). Det nye navnet må være i samsvar med navnekonvensjoner.

Obligatoriske parametere:

• documentLibraryId: ID-en til dokumentbiblioteket (drive)
• fileOrFolderId: ID for filen eller mappen for å gi nytt navn
• newFileOrFolderName: Det nye navnet

Valgfrie parametere:

• Etag: ETag for samtidighetskontroll

sletteFilEllerMappe

Sletter en fil eller mappe (DriveItem) fra et angitt dokumentbibliotek (stasjon).

Obligatoriske parametere:

• documentLibraryId: ID-en til dokumentbiblioteket (drive)
• fileOrFolderId: ID for filen eller mappen som skal slettes

Valgfrie parametere:

• Etag: ETag for samtidighetskontroll

flytt fil eller mappe

Flytter en fil eller mappe (DriveItem) til en målmappe. Støtter flytting på tvers av ulike dokumentbiblioteker (stasjoner) i SharePoint. Denne operasjonen er asynkron. Brukes checkOperationStatus til å overvåke fremdriften.

Obligatoriske parametere:

• sourcedoclibid: ID for kildebiblioteket for dokumenter (disk)
• sourcefileid: ID for kildefilen eller mappen som skal flyttes
• destdoclibid: ID til dokumentbiblioteket for målet (drive)
• destfolderid: ID for målmappen (må finnes)

Valgfrie parametere:

• newfilename: Nytt navn for det flyttede elementet

kopierFilEllerMappe

Kopierer en fil eller mappe (DriveItem) til en målmappe. Støtter kopiering på tvers av ulike dokumentbiblioteker i SharePoint. Denne operasjonen er asynkron. Brukes checkOperationStatus til å overvåke fremdriften.

Obligatoriske parametere:

• sourcedoclibid: ID for kildebiblioteket for dokumenter (disk)
• sourcefileid: ID for kildefilen eller mappen som skal kopieres
• destdoclibid: ID til dokumentbiblioteket for målet (drive)
• destfolderid: ID for målmappen (må finnes)

Valgfrie parametere:

• newfilename: Nytt navn for det kopierte elementet

checkOperationStatus

Kontrollerer statusen for en asynkron operasjon, for eksempel en kopi eller flytting, ved hjelp av operasjonstokenet som returneres fra den opprinnelige operasjonen.

Obligatoriske parametere:

• operationToken: Operasjonstokenet som returneres fra en asynkron operasjon som copyFileOrFolder eller moveFileOrFolder

uploadFileFromUrl

Laster opp en fil fra en SharePoint eller OneDrive URL-adresse til en målmappe i et dokumentbibliotek (stasjon). Filen kopieres fra url-adressen for kilden, slik at den opprinnelige filen ikke endres.

Obligatoriske parametere:

• sourceUrl: URL-adresse for kilde (må være en gyldig url-adresse for SharePoint eller OneDrive)
• destinationDocumentLibraryId: ID for måldokumentbiblioteket. Bruk me for brukerens OneDrive

Valgfrie parametere:

• destinationFolderId: ID for målmappen (standard: root)
• Filnavn: Nytt filnavn; standarder for det opprinnelige filnavnet

delFilEllerMappe

Sender en delingsinvitasjon for å gi lese- eller skrivetillatelser for en fil eller mappe (DriveItem) i et angitt dokumentbibliotek (stasjon).

Obligatoriske parametere:

• documentLibraryId: ID-en til dokumentbiblioteket (drive)
• fileOrFolderId: ID for filen eller mappen som skal deles
• recipientEmails: Matrise med e-postadresser til mottakere
• Roller: Matrise med roller: «lese», «skrive» (skrive gir både lese- og skrivetilgang)

Valgfrie parametere:

• Melding: Egendefinert melding for invitasjons-e-postmeldingen (standard: Her er filen vi samarbeider om.)
• sendInvitation: Om du vil sende en delingsinvitasjon (standard: sann)

settFølsomhetsMerkePåFil

Angir følsomhetsetiketten for en fil fra det angitte dokumentbiblioteket (stasjon).

Obligatoriske parametere:

• documentLibraryId: ID-en til dokumentbiblioteket (drive)
• fileId: ID-en til filen (DriveItem)
• sensitivityLabelId: ID for følsomhetsetiketten eller tom streng for å fjerne den

Valgfrie parametere:

• assignmentMethod: Tildelingsmetode: standard, privilegert, auto eller ukjentFutureValue (standard: Privilegert)
• justificationText: Justeringstekst for overvåkingsformål; kreves når du nedgraderer eller fjerner en etikett (standard: «Endret av MCPServer»)

listLists

Henter alle SharePoint lister som er tilgjengelige på et bestemt nettsted. Brukes til å finne ut hvilke lister som finnes på et område.

Obligatoriske parametere:

• siteId:-ID for SharePoint-området (format: 'hostname,siteCollectionId,webId')

createList

Oppretter en ny SharePoint list i et område.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• Displayname: Visningsnavn for den nye listen

Valgfrie parametere:

• Kolonner: Samling av kolonner som nøkkelverdipar: [{ Key: 'JobTitle', Value: 'text' }]. Gyldige typer: tekst, flerlinjet tekst, tall, boolsk, dateTime, valg, oppslag, personOrGroup, hyperkobling, valuta, beregnet
• mal: Type listemal (standardverdi: 'genericList'). Valg: egendefinert liste, dokumentbibliotek, hendelser, oppgaver, kunngjøringer, kontakter, koblinger, undersøkelse, problemsporing, diskusjonsforum

slett liste

Sletter en SharePoint list fra et område. Sletter hele listebeholderen og alle elementene i den. Denne handlingen kan ikke angres.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID for listen som skal slettes

Valgfrie parametere:

• Etag: ETag for samtidighetskontroll

send invitasjon for liste

Sender en delingsinvitasjon for å gi tillatelser på en SharePoint list.

Obligatoriske parametere:

• listId: ID-en til SharePoint-listen som skal deles
• recipientEmails: Matrise med e-postadresser til mottakere
• Rolle: Rolle: Lese (bare vise), bidra (vise, legge til, oppdatere, slette elementer), «redigere» (fullstendig redigering inkludert listestruktur)

Valgfrie parametere:

• siteUrl: URL-adresse for område for SharePoint-området som inneholder listen
• sendEmail: Om du vil sende et e-postvarsel (standard: sann)

listListItems

Henter elementer (rader/poster) fra en bestemt SharePoint list.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen

getListItem

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

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• Itemid: ID for det bestemte listeelementet

createListItem

Oppretter et nytt element (rad eller post) i en SharePoint list.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• Felt: Nøkkelverdipar for feltverdier, som [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. Feltet 'Tittel' kreves vanligvis.

updateListItem

Oppdaterer et eksisterende element (rad eller post) i en SharePoint list. Bare angitte felt oppdateres. Utelatte felt beholder verdiene.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• Itemid: ID for elementet som skal oppdateres
• Felt: Nøkkelverdipar med felt som skal oppdateres

Valgfrie parametere:

• Etag: ETag for samtidighetskontroll

deleteListItem

Sletter et element (rad eller post) fra en SharePoint list.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• Itemid: ID for elementet som skal slettes

Valgfrie parametere:

• Etag: ETag for samtidighetskontroll

listColumns

Henter alle kolonner fra en SharePoint list.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen

opprettKolonne

Oppretter en ny kolonne i en SharePoint list. Støtter mange kolonnetyper, inkludert tekst, tall, valg, dateTime, boolsk, bruker, oppslag, beregnet og mer.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• navn: Internt kolonnenavn (programmatisk identifikator)
• columnType: Kolonnetype: tekst, notat, tall, heltall, boolsk, dateTime, choice, multichoice, currency, lookup, user, url, calculated, term, multiterm, location, geolocation, thumbnail, counter, computed, contentTypeId, file, attachment, guid, outcomeChoice, approvalStatus

Valgfrie parametere:

• columnProperties: Typespesifikke innstillinger (for eksempel { "maxLength": 255 } for tekst, { "choices": ["A","B","C"] } for valg)
• Beskrivelse: Beskrivelse av kolonnen
• Displayname: Visningsnavn som vises i brukergrensesnittet (standardnavn)
• Nødvendig: Gjør kolonnen obligatorisk (standard: usann)
• Skjult: Skjul kolonne fra visninger (standard: usann)

oppdater kolonne

Oppdaterer en eksisterende kolonne i en SharePoint list.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• columnId: ID for kolonnen som skal oppdateres

Valgfrie parametere:

• columnType: Kolonnetype (obligatorisk når du oppgir columnProperties)
• columnProperties: Typespesifikke egenskaper som skal oppdateres
• Beskrivelse: Ny beskrivelse
• Displayname: Nytt visningsnavn
• Skjult: Skjule eller vise kolonne
• Nødvendig: Gjør kolonnen obligatorisk eller valgfri

Slett kolonne

Sletter en kolonne fra en SharePoint list. Advarsel: Denne handlingen fjerner alle data som er lagret i denne kolonnen, for alle elementer.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• columnId: ID for kolonnen som skal slettes

Viktige funksjoner

Områdebehandling

• Finn områder etter navn eller bla gjennom tilgjengelige områder.
• Hent et nettsted ut fra den nøyaktige URL-banen.
• List opp underordnede nettsteder og delnettsteder.
• Omfattende områdehierarkinavigasjon.

Behandling av dokumentbibliotek

• Vis alle dokumentbiblioteker på et område.
• Hent standard dokumentbibliotek.
• Bla gjennom mappens innhold (opptil 20 elementer).
• Opprett og administrer mappestrukturer.

Filoperasjoner

• Lag tekst- og binærfiler (5 MB eller mindre).
• Les tekst og binære filer (5 MB eller mindre).
• Slette, gi nytt navn til og flytte filer og mapper.
• Kopier filer og mapper på tvers av dokumentbiblioteker.
• Last opp filer fra SharePoint eller OneDrive URL-adresser.
• Søk etter filer og mapper på tvers av alle tilgjengelige områder.
• Hent fil- og mappemetadata.

Async-operasjoner

• Kopier og flytt filer og mapper asynkront på tvers av dokumentbiblioteker.
• Kontroller statusen for aync-operasjoner ved hjelp av operasjonstokener.

Listeoperasjoner

• Opprette, lese og slette lister.
• Støtte for flere listemaler, inkludert generisk, dokumentbibliotek, hendelser og oppgaver.
• Dele lister med rollebaserte tillatelser.
• Behandle listeelementer ved å opprette, lese, oppdatere og slette dem.

Kolonneadministrasjon

• Opprett kolonner med en rekke typer, for eksempel tekst, notat, tall, boolsk, dateTime, valg, oppslag, bruker, NETTADRESSE, beregnet og mer.
• Oppdater kolonneegenskaper og metadata.
• Konfigurer kolonnekrav og synlighet.
• Angi typespesifikke kolonneegenskaper.

Deling og tillatelser

• Dele filer, mapper og lister med brukere.
• Bruk rollebasert tilgangskontroll med lese-, skrive-, bidra- og redigeringsroller.
• E-postvarsler for deling.
• Egendefinerte meldinger i invitasjoner.

Sikkerhet og samsvar

• Bruk og fjern følsomhetsetiketter.
• Bruk flere tildelingsmetoder, inkludert standard, privilegert og automatisk.
• Støtt revisjonsbegrunnelse.
• Bruk samtidighetskontroll med eTags.

Merknader

• Filoperasjoner er begrenset til filer som er 5 MB eller mindre for opplasting og nedlasting.
• Kopier og flytt operasjoner er asynkrone. Brukes checkOperationStatus til å overvåke fremdriften.
• Kopier og flytt operasjoner støtter operasjoner på tvers av biblioteker i SharePoint.
• uploadFileFromUrl krever en gyldig URL-adresse for SharePoint eller OneDrive kilde.
• eTags gir samtidighetskontroll for oppdateringer og slettinger.
• Automatisk numerisk suffiks for dupliserte mappenavn.
• Sletting av listen kan ikke angres.
• Sletting av kolonner fjerner alle data som er lagret i denne kolonnen.
• Søkeoperasjoner returnerer de 20 beste resultatene som standard.