Work IQ SharePoint-referanse (forhåndsversjon)

Viktig!

Dette er en evalueringsfunksjonalitet.

• Microsoft lanserer evalueringsfunksjonalitet før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.
• Evalueringsfunksjonalitet har begrenset funksjonalitet og er ikke ment for produksjonsbruk.
• Microsoft kan endre navn og parametere for MCP-verktøy i forhåndsversjon. Unngå hardkodede avhengigheter. Microsoft opprettholder støtte for scenarioer.
• Evalueringsfunksjonalitet må overholde Microsofts tilleggsvilkår.

Oversikt

Server-ID	Nettadresse på leiernivå	Visningsnavn	Description
mcp_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/ servers/mcp_SharePointRemoteServer	Work IQ SharePoint	MCP-server for SharePoint-operasjoner. Bruk denne serveren til å administrere nettsteder, 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-nettsteder som du har tilgang til. Returnerer bestemte SharePoint-nettsteder som matcher en søkeforespørsel, eller de 20 mest relevante nettstedene hvis du ikke oppgir en forespørsel.

Obligatoriske parametere:

• searchQuery: Søkespørring (helt eller delvis navn på nettsted). Hvis du utelater denne parameteren, returneres de 20 mest relevante tilgjengelige nettsteder.

getSiteByPath

Slår opp et SharePoint-nettsted ved å bruke dets eksakte vertsnavn og serverrelativ bane. Denne metoden skal bare brukes når du har hele nettstedets nettadressestruktur. Bruk findSite når du bare kjenner navnet på et nettsted.

Obligatoriske parametere:

• hostname: Nøyaktig vertsnavn (f.eks., 'contoso.sharepoint.com')
• serverRelativePath: Serverrelativ bane (f.eks. 'sites/Marketing'). Den ledende skråstreken er valgfri.

listSubsites

Lister opp alle undersider (undernettsteder) til et SharePoint-nettsted.

Obligatoriske parametere:

• siteId: ID-en til det overordnede SharePoint-nettstedet (format: 'hostname,siteCollectionId,webId')

listDocumentLibrariesInSite

Lister dokumentbiblioteker i det angitte SharePoint-nettstedet.

Obligatoriske parametere:

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

getDefaultDocumentLibraryInSite

Henter standard dokumentbibliotek (drive) i et SharePoint-nettsted.

Obligatoriske parametere:

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

getFolderChildren

Enumererer de 20 første filene og mappene (DriveItems) som finnes i en angitt overordnet mappe i et dokumentbibliotek (drive).

Obligatoriske parametere:

• documentLibraryId: ID til dokumentbiblioteket (drive)

Obligatoriske parametere:

• parentFolderId: ID til overordnet mappe (standardverdi: 'root')

findFileOrFolder

Finner en fil eller mappe (DriveItem) tilgjengelig for brukeren via søkespørring. Søker på tvers av alle nettsteder og dokumentbiblioteker 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 (drive) i SharePoint.

Obligatoriske parametere:

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

getFileOrFolderMetadataByUrl

Henter metadata om en fil eller mappe (DriveItem) fra en delingsnettadresse. Bare brukere med eksplisitte tillatelser til filen kan hente metadataene.

Obligatoriske parametere:

• fileOrFolderUrl: URL-adressen for filen eller mappen. URL-adressen brukes ikke til å dele med brukeren; de må allerede ha eksplisitt tilgang.

readSmallTextFile

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

Obligatoriske parametere:

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

readSmallBinaryFile

Leser en binær fil mindre enn 5 MB fra et bestemt dokumentbibliotek (drive). Filinnholdet returneres som en Base64-kodet streng.

Obligatoriske parametere:

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

createSmallTextFile

Oppretter eller laster ned en tekstfil mindre enn 5 MB til et bestemt dokumentbibliotek.

Obligatoriske parametere:

• filename: Filnavnet, inkludert filtypen
• contentText: Tekstinnhold i filen
• documentLibraryId: ID til dokumentbiblioteket (drive)

Obligatoriske parametere:

• parentFolderId: ID til overordnet mappe (standardverdi: 'root')

createSmallBinaryFile

Oppretter en binær fil som er mindre enn 5 MB, der innholdet er Base64-kodet, til et bestemt dokumentbibliotek (drive).

Obligatoriske parametere:

• filename: Filnavnet, inkludert filtypen
• base64Content: Binærfilens innhold kodet som en Base64-streng.
• documentLibraryId: ID til dokumentbiblioteket (drive)

Obligatoriske parametere:

• parentFolderId: ID til overordnet mappe (standardverdi: 'root')

createFolder

Oppretter en ny mappe (DriveItem) i et spesifisert dokumentbibliotek (drive). Hvis det finnes en mappe med samme navn, legger systemet til et numerisk suffiks (f.eks. NewFolder (1)).

Obligatoriske parametere:

• folderName: Navn på mappen
• documentLibraryId: ID til dokumentbiblioteket (drive)

Obligatoriske parametere:

• parentFolderId: ID til overordnet mappe (standardverdi: 'root')

renameFileOrFolder

Endrer navnet på en fil eller mappe (DriveItem) innenfor et spesifisert dokumentbibliotek (drive). Det nye navnet må etterleve navnekonvensjonene.

Obligatoriske parametere:

• documentLibraryId: ID til dokumentbiblioteket (drive)
• fileOrFolderId: ID-en til filen eller mappen som skal omdøpes
• newFileOrFolderName: Det nye navnet

Obligatoriske parametere:

• etag: Enhetskode for samtidighetskontroll

deleteFileOrFolder

Sletter en fil eller mappe (DriveItem) fra et spesifisert dokumentbibliotek (drive).

Obligatoriske parametere:

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

Obligatoriske parametere:

• etag: Enhetskode for samtidighetskontroll

moveFileOrFolder

Flytter en fil eller mappe (DriveItem) til en destinasjonsmappe. Støtter flytter på tvers av ulike dokumentbiblioteker (driver) i SharePoint. Denne operasjonen er asynkron. Bruk checkOperationStatus til å overvåke fremdriften.

Obligatoriske parametere:

• sourcedoclibid: ID for kildedokumentbiblioteket (drive)
• sourcefileid: ID-en til kildefilen eller mappen som skal flyttes
• destdoclibid: ID for destinasjonsdokumentbiblioteket (drive)
• destfolderid: ID for destinasjonsmappen (må eksistere)

Obligatoriske parametere:

• newfilename: Nytt navn for den flyttede filen eller mappen

copyFileOrFolder

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

Obligatoriske parametere:

• sourcedoclibid: ID for kildedokumentbiblioteket (drive)
• sourcefileid: ID for kildefilen eller mappen som skal kopieres
• destdoclibid: ID for destinasjonsdokumentbiblioteket (drive)
• destfolderid: ID for destinasjonsmappen (må eksistere)

Obligatoriske parametere:

• newfilename: Nytt navn for det kopierte elementet

checkOperationStatus

Sjekker status for en asynkron operasjon, som en kopi eller flytting, ved å bruke operasjonstokenet som ble returnert fra den opprinnelige operasjonen.

Obligatoriske parametere:

• operasjonstoken: Operasjonstokenet returnert fra en asynkron operasjon som copyFileOrFolder eller moveFileOrFolder

uploadFileFromUrl

Last opp en fil fra en SharePoint- eller OneDrive-nettadresse til en destinasjonsmappe i et dokumentbibliotek (drive). Filen blir kopiert fra kilde-nettadressen, så den opprinnelige filen endres ikke.

Obligatoriske parametere:

• sourceUrl: Kildenettadresse (må være en gyldig SharePoint- eller OneDrive-nettadresse)
• destinationDocumentLibraryId: ID til destinasjonsdokumentbiblioteket. Bruk me for brukerens OneDrive

Obligatoriske parametere:

• destinasjonsmappeId: ID til destinasjonsmappen (standard: root)
• filename: Nytt filnavn; standard er originalt filnavn

shareFileOrFolder

Sender en delingsinvitasjon for å gi lese- eller skrivetilgang til en fil eller mappe (DriveItem) i et spesifisert dokumentbibliotek (drive).

Obligatoriske parametere:

• documentLibraryId: ID til dokumentbiblioteket (drive)
• fileOrFolderId: ID-en til filen eller mappen som skal deles
• recipientEmails: Matrise med mottakernes e-postadresser
• roller: Matrise med roller: 'les', 'skriv' (skriv gir både lese- og skrivetilgang)

Obligatoriske parametere:

• melding: Egendefinert melding for invitasjons-e-posten (standard: Her er filen vi samarbeider om.)
• sendInvitation: Om en delingsinvitasjon skal sendes (standard: true)

setSensitivityLabelOnFile

Setter følsomhetsetiketten til en fil fra det angitte dokumentbiblioteket.

Obligatoriske parametere:

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

Obligatoriske parametere:

• assignmentMethod: Tildelingsmetode: 'standard', 'privileged', 'auto' eller 'unknownFutureValue' (default: 'privileged')
• justificationText: Begrunnelsestekst for revisjonsformål; kreves ved nedgradering eller fjerning av en etikett (default: 'Endret av MCPServer')

listLists

Henter alle SharePoint-lister tilgjengelig på et spesifikt område. Brukes til å finne ut hvilke lister som finnes på et nettsted.

Obligatoriske parametere:

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

createList

Oppretter en ny SharePoint-liste i et nettsted.

Obligatoriske parametere:

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

Obligatoriske parametere:

• kolonner: Samling av kolonner som nøkkelverdipar: [{ Key: 'JobTitle', Value: 'text' }]. Gyldige typer: tekst, multilineText, tall, boolsk, dateTime, valg, oppslag, personOrGroup, hyperkobling, valuta, beregnet
• mal: Listemaltype (standard: 'genericList'). Alternativer: genericList, documentLibrary, hendelser, oppgaver, kunngjøring, kontakter, koblinger, undersøkelse, issueTracking, discussionBoard

deleteList

Sletter en SharePoint-liste fra et nettsted. Sletter hele listebeholderen og alle elementene i den. Kan ikke angres.

Obligatoriske parametere:

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

Obligatoriske parametere:

• etag: Enhetskode for samtidighetskontroll

sendInviteForList

Sender en delingsinvitasjon for å tildele tilgang til en SharePoint-liste.

Obligatoriske parametere:

• listId: ID til SharePoint-listen som skal deles
• recipientEmails: Matrise med mottakernes e-postadresser
• rolle: Rolle: 'les' (bare visning), 'bidra' (vis, legg til, oppdater, slett elementer), 'rediger' (full redigering inkludert listestruktur)

Obligatoriske parametere:

• siteUrl: Nettadresse til SharePoint-nettstedet som inneholder listen
• sendEmail: Om du skal sende en e-postvarsling (standard: true)

listListItems

Henter elementer (rader/poster) fra en angitt SharePoint-liste.

Obligatoriske parametere:

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

getListItem

Henter et enkelt element (rad/post) fra en SharePoint-liste med ID.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• itemId: ID til det spesifikke listeelementet

createListItem

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

Obligatoriske parametere:

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

updateListItem

Oppdaterer et eksisterende element (rad eller post) i en SharePoint-liste. Kun spesifiserte felter oppdateres; utelatte felter beholder sine verdier.

Obligatoriske parametere:

• siteId: ID-en til SharePoint-nettstedet
• listId: ID-en til SharePoint-listen
• itemId: ID-en til elementet som skal oppdateres
• felter: nøkkelverdipar av felter som skal oppdateres

Obligatoriske parametere:

• etag: Enhetskode for samtidighetskontroll

deleteListItem

Sletter et element (rad eller oppføring) fra en SharePoint-liste.

Obligatoriske parametere:

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

Obligatoriske parametere:

• etag: Enhetskode for samtidighetskontroll

listColumns

Henter alle kolonner fra en SharePoint-liste.

Obligatoriske parametere:

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

createColumn

Oppretter en ny kolonne i en SharePoint-liste. Støtter mange kolonnetyper, inkludert tekst, tall, valg, dato/tid, boolsk, bruker, oppslag, beregnet og flere.

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, valg, flervalg, valuta, oppslag, bruker, nettadresser, beregnet, begrep, flerbegrep, plassering, geografisk plassering, miniatyrbilde, teller, databeregnet, contentTypeId, fil, vedlegg, GUID, outcomeChoice, approvalStatus

Obligatoriske parametere:

• kolonneegenskaper: Type-spesifikke innstillinger (f.eks. { "maxLength": 255 } for tekst, { "choices": ["A","B","C"] } for valg)
• beskrivelse:: Beskrivelse av kolonnen
• displayName: Visningsnavn som vises i brukergrensesnittet (standard: 'navn')
• påkrevd: Angir om kolonnen er påkrevd (standard: falsk)
• skjult: Skjul kolonnen fra visninger (standard: falsk)

updateColumn

Oppdaterer en eksisterende kolonne i en SharePoint-liste.

Obligatoriske parametere:

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

Obligatoriske parametere:

• columnType: Kolonnetype (påkrevd når du angir 'columnProperties')
• columnProperties: Typespesifikke egenskaper som skal oppdateres
• beskrivelse: Ny beskrivelse
• displayName: Nytt visningsnavn
• skjult: Skjul eller vis kolonnen
• påkrevd: Gjør kolonnen obligatorisk eller valgfri

deleteColumn

Sletter en kolonne fra en SharePoint-liste. Advarsel: Denne handlingen fjerner all data lagret i den kolonnen for alle elementer.

Obligatoriske parametere:

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

Nøkkelfunksjoner

Nettstedsadministrasjon

• Finn nettsteder etter navn eller bla gjennom tilgjengelige nettsteder.
• Hent et nettsted via nøyaktig nettadresse.
• List opp underordnede nettsteder og undersider.
• Omfattende navigering i nettstedhierarkiet.

Dokumentbibliotekadministrasjon

• List opp alle dokumentbiblioteker i et nettsted.
• Hent standard dokumentbibliotek
• Bla gjennom mappens innhold (opptil 20 elementer)
• Opprett og administrer mappestrukturer.

Filoperasjoner

• Opprett tekst- og binærfiler (≤5 MB).
• Les tekst- og binærfiler (≤5 MB).
• Slett, gi nytt navn og flytt filer og mapper.
• Kopier filer og mapper på tvers av dokumentbiblioteker.
• Last opp filer fra SharePoint- eller OneDrive-nettadresser.
• Søk etter filer og mapper på alle tilgjengelige nettsteder.
• Hent metadata for filer og mapper.

Asynkrone operasjoner

• Kopier og flytt filer og mapper asynkront på tvers av dokumentbiblioteker.
• Sjekk status for asynkrone operasjoner ved å bruke operasjonstoken.

Listeoperasjoner

• Opprett, les og slett lister.
• Støtte for flere listemaler, inkludert generiske lister, dokumentbibliotek, hendelser og oppgaver.
• Del lister med rollebaserte tillatelser.
• Administrer listeelementer ved å opprette, lese, oppdatere og slette dem.

Kolonnebehandling

• Opprett kolonner med et bredt utvalg av typer, slik som tekst, merknad, tall, boolsk, dato og klokkeslett, valg, oppslag, bruker, nettadresse, beregnet og mer.
• Oppdater kolonneegenskaper og metadata.
• Konfigurer kolonnekrav og synlighet.
• Sett typespesifikke kolonneegenskaper.

Deling og tillatelser

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

Sikkerhet og etterlevelse

• Påfør og fjern sensitivitetsetiketter.
• Bruk flere tildelingsmetoder, inkludert standard, privilegert og auto.
• Støtte for revisjonsbegrunnelse.
• Bruk samtidighetskontroll med eTags.

Merknader

• Filoperasjoner støtter kun filer på 5 MB eller mindre for opplasting og nedlasting.
• Kopierings- og flytteoperasjoner er asynkrone. Bruk checkOperationStatus til å overvåke fremdriften.
• Kopierings- og flytteoperasjoner støtter operasjoner på tvers av dokumentbiblioteker i SharePoint.
• uploadFileFromUrl krever en gyldig SharePoint- eller OneDrive-kildenettadresse.
• eTags gir samtidighetskontroll for oppdateringer og slettinger.
• Automatisk numerisk suffiks for dupliserte mappenavn
• Listesletting kan ikke angres.
• Kolonnesletting fjerner all data lagret i den kolonnen.
• Søkeoperasjoner returnerer som standard de 20 første resultatene.