SharePoint-viite (esikatselu)

Huomautus

Tämän artikkelin ominaisuudet perustuvat standardivaljaisiin, jotka käyttävät Lisensointi-osiossa kuvattuja laskutusvaihtoehtoja agenteille, jotka käyttävät standardivaljasta. Opi, miten pääset käsiksi standardeihin liittyviin ominaisuuksiin Accessin standardiagenteissa ja agenttivirroissa.

Important

Tämä on esiversiotoiminto.

  • Microsoft julkaisee esiversio-ominaisuuksia ennen virallista julkaisua, jotta asiakkaat voivat käyttää ja antaa palautetta ennen virallista julkaisua.
  • Esikatselutoiminnot toimivat rajoitetusti, eikä niitä ole tarkoitettu tuotantokäyttöön.
  • Microsoft saattavat muuttaa esikatselun MCP-työkalujen nimiä ja parametreja. Vältä kovakoodattuja riippuvuuksia. Microsoft ylläpitää skenaariotukea.
  • Esikatselutoimintoihin sovelletaan Microsoft lisäkäyttöehtoja.

Yleiskatsaus

Palvelintunnus Vuokraajatason URL-osoite Näyttönimi Kuvaus
mcp_SharePointRemoteServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/servers/
mcp_SharePointRemoteServer		 SharePoint Työkaluja SharePoint-toimintoihin. Palvelimen avulla voit hallita sivustoja, luetteloita, luettelokohteita, sarakkeita, tiedostokirjastoja, tiedostoja, kansioita ja tiedostojen jakamista. Tiedostotoiminnot on rajoitettu tiedostoihin, joiden koko on enintään 5 Mt.

Käytettävissä olevat työkalut

findSite

Etsii SharePoint sivustot, joihin sinulla on käyttöoikeus. Palauttaa tietyt sivustot, jotka vastaavat hakukyselyä, tai 20 parasta sivustoa, jos et anna kyselyä.

Valinnaiset parametrit:

  • searchQuery: Hakukysely (koko sivuston nimi tai osittainen sivuston nimi). Poista 20 parasta helppokäyttökohdetta.

getSiteByPath

Korjaa SharePoint sivuston käyttämällä sen tarkkaa isäntänimeä ja palvelinkohtaista polkua. Käytä tätä menetelmää vain, kun sinulla on täydellinen sivuston URL-rakenne. Käytä tätä findSite , kun tiedät vain sivuston nimen.

Pakolliset parametrit:

  • Hostname: Tarkka isäntänimi (esimerkiksi contoso.sharepoint.com)
  • serverRelativePath: Palvelimen suhteellinen polku (esimerkiksi sivustot/markkinointi). Ensimmäinen vinoviiva on valinnainen.

listSubsites

Näyttää luettelon SharePoint-sivuston kaikista alisivustoista (alisivustoista).

Pakolliset parametrit:

  • siteId:-tunnus SharePoint sivustolle (muoto: 'hostname,siteCollectionId,webId')

luetteloiDokumenttikirjastotSivustolla

Näyttää luettelon määritetyn SharePoint sivuston tiedostokirjastoista (asemista).

Valinnaiset parametrit:

  • SharePoint<>siteId: tunnus (oletus: 'root')

haeOletusDokumenttikirjastoSivustolta

Hakee SharePoint sivustossa olevan oletustiedostokirjaston (aseman).

Valinnaiset parametrit:

  • SharePoint<>siteId: tunnus (oletus: 'root')

getFolderChildren

Luetteloi 20 parasta tiedostoa ja kansiota (DriveItems), jotka sisältyvät määritettyyn pääkansioon tiedostokirjastossa (asema).

Pakolliset parametrit:

  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

Valinnaiset parametrit:

  • parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

etsiTiedostoTaiKansio

Etsii tiedoston tai kansion (DriveItem), jota käyttäjä voi käyttää hakukyselyllä. Haut kaikissa sivustoissa ja tiedostokirjastoissa, joihin käyttäjällä on käyttöoikeus.

Pakolliset parametrit:

  • searchQuery: Hakukysely (koko tiedostonimi tai osittainen tiedostonimi)

haeTiedostoTaiKansioMetatiedot

Hakee tiedoston tai kansion (DriveItem) metatiedot määritetystä tiedostokirjastosta (asemasta) SharePoint.

Pakolliset parametrit:

  • fileOrFolderId: Tiedoston tai kansion tunnus (DriveItem)
  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

getFileOrFolderMetadataByUrl

Saa metatiedot tiedostosta tai kansiosta (DriveItem) jaettavan URL-osoitteen kautta. Vain käyttäjät, joilla on olemassa olevat eksplisiittiset oikeudet käyttää tiedostoa, voivat saada metatiedot.

Pakolliset parametrit:

  • fileOrFolderUrl: Tiedoston tai kansion URL-osoite. URL-osoitetta ei lunastetaan, jotta se voidaan jakaa käyttäjälle. Niillä on jo oltava nimenomainen käyttöoikeus.

readSmallTextFile

Lukee (lataa) tekstitiedoston, joka on alle 5 MB tietystä asiakirjakirjastosta (asemasta).

Pakolliset parametrit:

  • fileId: Lue tai lataa tiedoston tunnus (DriveItem).
  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

readSmallBinaryFile

Lukee alle 5 Mt:n kokoisen binaaritiedoston tietystä tiedostokirjastosta (asemasta). Tiedoston sisältö palautetaan base64-koodattuna merkkijonona.

Pakolliset parametrit:

  • fileId: Lue tai lataa tiedoston tunnus (DriveItem).
  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

createSmallTextFile

Luo tai lataa alle 5 MB tekstitiedoston tiettyyn asiakirjakirjastoon (asemaan).

Pakolliset parametrit:

  • Tiedostonimi: Tiedoston nimi mukaan lukien pääte.
  • contentText: Tiedoston tekstisisältö.
  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

Valinnaiset parametrit:

  • parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

createSmallBinaryFile

Luo alle 5 Mt:n kokoisen binaaritiedoston koodaamalla sen sisällön tiettyyn tiedostokirjastoon (asemaan).

Pakolliset parametrit:

  • Tiedostonimi: Tiedoston nimi mukaan lukien pääte.
  • base64Content: Binaaritiedoston sisältö, joka on koodattu base64-merkkijonoksi.
  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

Valinnaiset parametrit:

  • parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

createFolder

Luo uuden kansion (DriveItem) määritettyyn tiedostokirjastoon (asemaan). Jos samanniminen kansio on olemassa, järjestelmä lisää numeerisen liitetiedoston (esimerkiksi NewFolder (1)).

Pakolliset parametrit:

  • folderName: Kansion nimi
  • documentLibraryId: Tiedostokirjaston (aseman) tunnus

Valinnaiset parametrit:

  • parentFolderId: Vanhemman kansion tunnus (oletus: 'root').

nimeäTiedostoTaiKansioUudelleen

Nimeää uudelleen tiedoston tai kansion (DriveItem) määritetyssä tiedostokirjastossa (asemassa). Uuden nimen on oltava nimeämiskäytäntöjen mukainen.

Pakolliset parametrit:

  • documentLibraryId: Tiedostokirjaston (aseman) tunnus
  • fileOrFolderId: Uudelleennimettävän tiedoston tai kansion tunnus
  • newFileOrFolderName: Uusi nimi

Valinnaiset parametrit:

  • Etag: Samanaikaisuuden hallinnan ETag

poistaTiedostoTaiKansio

Poistaa tiedoston tai kansion (DriveItem) määritetystä tiedostokirjastosta (asemasta).

Pakolliset parametrit:

  • documentLibraryId: Tiedostokirjaston (aseman) tunnus
  • fileOrFolderId: Poistettavan tiedoston tai kansion tunnus

Valinnaiset parametrit:

  • Etag: Samanaikaisuuden hallinnan ETag

Siirrä tiedosto tai kansio

Siirtää tiedoston tai kansion (DriveItem) kohdekansioon. Tukee liikkumista eri tiedostokirjastoissa (asemiin) SharePoint sisällä. Tämä toiminto on asynkroninen. Käytä - checkOperationStatus mittaria edistymisen seurantaan.

Pakolliset parametrit:

  • sourcedoclibid: Lähdetiedostokirjaston (aseman) tunnus
  • sourcefileid: Siirrettävän lähdetiedoston tai kansion tunnus
  • destdoclibid: Kohdetiedostokirjaston (aseman) tunnus
  • destfolderid: Kohdekansion tunnus (oltava olemassa)

Valinnaiset parametrit:

  • uusi tiedostonimi: Siirretyn kohteen uusi nimi

copyFileOrFolder

Kopioi tiedoston tai kansion (DriveItem) kohdekansioon. Tukee kopiointia eri asiakirjakirjastojen välillä SharePoint. Tämä toiminto on asynkroninen. Käytä - checkOperationStatus mittaria edistymisen seurantaan.

Pakolliset parametrit:

  • sourcedoclibid: Lähdetiedostokirjaston (aseman) tunnus
  • sourcefileid: Kopioittavan lähdetiedoston tai kansion tunnus
  • destdoclibid: Kohdetiedostokirjaston (aseman) tunnus
  • destfolderid: Kohdekansion tunnus (oltava olemassa)

Valinnaiset parametrit:

  • uusi tiedostonimi: Kopioidun kohteen uusi nimi

checkOperationStatus

Tarkistaa asynkronisen toiminnon, kuten kopion tai siirron, tilan alkuperäisestä toiminnosta palautetun toimintotunnuksen avulla.

Pakolliset parametrit:

  • operationToken: Asynkroniseksi toiminnoksi palautettu toimintotunnus, kuten copyFileOrFolder tai moveFileOrFolder

uploadFileFromUrl

Lataa tiedoston SharePoint tai OneDrive URL-osoitteesta tiedostokirjaston (aseman) kohdekansioon. Tiedosto kopioidaan lähde-URL-osoitteesta, joten alkuperäistä tiedostoa ei muuteta.

Pakolliset parametrit:

  • sourceUrl: Lähde-URL-osoite (sen on oltava kelvollinen SharePoint tai OneDrive URL-osoite)
  • destinationDocumentLibraryId: Kohdetiedostokirjaston tunnus. Käytä me käyttäjän OneDrivea varten

Valinnaiset parametrit:

  • destinationFolderId: Kohdekansion tunnus (oletus: root)
  • Tiedostonimi: Uusi tiedostonimi; alkuperäisen tiedostonimen oletusarvo on

jaaTiedostoTaiKansio

Lähettää jakamiskutsun ja myöntää luku- tai kirjoitusoikeudet tiedostoon tai kansioon (DriveItem) määritetyssä tiedostokirjastossa (asemassa).

Pakolliset parametrit:

  • documentLibraryId: Tiedostokirjaston (aseman) tunnus
  • fileOrFolderId: Jaettavan tiedoston tai kansion tunnus
  • recipientEmails: Vastaanottajien sähköpostiosoitteiden matriisi
  • Roolit: Roolimatriisi: "read", "write" (kirjoitus myöntää sekä lukemisen että kirjoittamisen)

Valinnaiset parametrit:

  • Viesti: Kutsusähköpostin mukautettu viesti (oletusarvo: Tässä on tiedosto, jota käsittelemme yhdessä.)
  • sendInvitation: Jakamiskutsun lähettäminen (oletus: true)

asetaHerkkyysMerkintaTiedostoon

Määrittää tiedoston luottamuksellisuustunnisteen määritetystä tiedostokirjastosta (asemasta).

Pakolliset parametrit:

  • documentLibraryId: Tiedostokirjaston (aseman) tunnus
  • fileId: Tiedoston tunnus (DriveItem)
  • sensitivityLabelId: luottamuksellisuustunnisteen tunnus tai tyhjä merkkijono, jos haluat poistaa sen

Valinnaiset parametrit:

  • assignmentMethod: Määritysmenetelmä: 'standard', 'privileged', 'auto' tai 'unknownFutureValue' (oletus: 'privileged')
  • justificationText: oikeutusteksti valvontaa varten; pakollinen, kun selitettä alennetaan tai poistetaan (oletus: MCPServer muutti sen)

listLists

Hakee kaikki tietyllä sivustolla käytettävissä olevat SharePoint luettelot. Selvitä tämän avulla, mitä luetteloita sivustossa on.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus (muoto: 'hostname,siteCollectionId,webId')

luo luettelo

Luo uuden SharePoint list sivustossa.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • Displayname: Uuden luettelon näyttönimi

Valinnaiset parametrit:

  • Sarakkeet: Sarakekokoelma avain-arvo-pareina: [{ Key: 'JobTitle', Value: 'text' }]. Kelvolliset tyypit: teksti, monirivinen teksti, numero, totuusarvo, päivämäärä/aika, valinta, haku, personOrGroup, hyperlinkki, valuutta, laskettu
  • Malli: Luettelo mallityypistä (oletusarvo: genericList). Vaihtoehdot: yleinen luettelo, tiedostokirjasto, tapahtumat, tehtävät, ilmoitukset, yhteystiedot, linkit, kysely, ongelmien seuranta, keskustelupalsta

poista luettelo

Poistaa SharePoint list sivustosta. Poistaa koko luettelosäilön ja sen sisältämät kohteet. Tätä toimintoa ei voi kumota.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: Poistettavan luettelon tunnus

Valinnaiset parametrit:

  • Etag: Samanaikaisuuden hallinnan ETag

lähetä kutsu listalle

Lähettää jakamiskutsun käyttöoikeuksien myöntämiseksi SharePoint list.

Pakolliset parametrit:

  • listId: jaettavan SharePoint-luettelon tunnus
  • recipientEmails: Vastaanottajien sähköpostiosoitteiden matriisi
  • Rooli: Rooli: 'vain luku' (vain näkymä), 'osallistuminen' (näytä, lisää, päivitä, poista kohteita), 'muokkaaminen' (täysi muokkaus mukaan lukien luettelorakenne)

Valinnaiset parametrit:

  • luettelon sisältävän SharePoint-sivuston siteUrl: Sivuston URL-osoite
  • sendEmail: Sähköposti-ilmoituksen lähettäminen (oletus: true)

listListItems

Hakee kohteita (rivejä/tietueita) tietystä SharePoint list.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus

getListItem

Saa yhden alkion (rivin tai tietueen) SharePoint list ID:llään.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • itemId: Tietyn luettelokohteen tunnus

createListItem

Luo uuden kohteen (rivin tai tietueen) SharePoint list.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • Kentät: Avain-arvoparit kenttäarvoille, kuten [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. 'Otsikko'-kenttä on yleensä pakollinen.

updateListItem

Päivittää olemassa olevan kohteen (rivin tai tietueen) SharePoint-luettelossa. Vain määritetyt kentät päivitetään. pois jätetyt kentät säilyttävät arvonsa.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • itemId: Päivitettävän kohteen tunnus
  • Kentät: päivitettävien kenttien avain-arvoparit

Valinnaiset parametrit:

  • Etag: Samanaikaisuuden hallinnan ETag

deleteListItem

Poistaa kohteen (rivin tai tietueen) SharePoint-luettelosta.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • itemId: Poistettavan kohteen tunnus

Valinnaiset parametrit:

  • Etag: Samanaikaisuuden hallinnan ETag

listColumns

Hakee kaikki sarakkeet SharePoint-luettelosta.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus

Luo sarake

Luo uuden sarakkeen SharePoint list. Tukee monia saraketyyppejä, kuten tekstiä, lukua, valintaa, päivämäärä/aika, totuusarvo, käyttäjä, haku, laskettu ja paljon muuta.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • Nimi: Sisäisen sarakkeen nimi (ohjelmallinen tunniste)
  • columnType: Saraketyyppi: text, note, number, integer, boolean, dateTime, choice, multichoice, currency, lookup, user, url, calculated, term, multiterm, location, geolocation, thumbnail, counter, computed, contentTypeId, file, attachment, guid, outcomeChoice, approvalStatus

Valinnaiset parametrit:

  • columnProperties: Tyyppikohtaiset asetukset (esimerkiksi { "maxLength": 255 } teksti, { "choices": ["A","B","C"] } valinta)
  • Kuvaus: Sarakkeen kuvaus
  • Displayname: Käyttöliittymässä näkyvä näyttönimi (oletusarvo on 'nimi')
  • Tarvitaan: Tee sarakkeesta pakollinen (oletusarvo: false)
  • Piilotettu: Piilota sarake näkymistä (oletusarvo: false)

päivitä sarake

Päivittää SharePoint list olemassa olevan sarakkeen.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • columnId: Päivitettävän sarakkeen tunnus

Valinnaiset parametrit:

  • columnType: Saraketyyppi (pakollinen, kun annat columnProperties-tiedot)
  • columnProperties: Päivitettävät tyyppikohtaiset ominaisuudet
  • Kuvaus: Uusi kuvaus
  • Displayname: Uusi näyttönimi
  • Piilotettu: Piilota tai näytä sarake
  • Tarvitaan: Tee sarakkeesta pakollinen tai valinnainen

deleteColumn

Poistaa sarakkeen SharePoint-luettelosta. Varoitus: Tämä toiminto poistaa kaikki sarakkeeseen tallennetut tiedot kaikista kohteista.

Pakolliset parametrit:

  • SharePoint-sivuston siteId: tunnus
  • listId: SharePoint-luettelon tunnus
  • columnId: Poistettavan sarakkeen tunnus

Tärkeimmät ominaisuudet

Sivuston hallinta

  • Etsi sivustot nimen mukaan tai selaa helppokäyttöisiä sivustoja.
  • Hae sivusto tarkan URL-polun mukaan.
  • Luettele lapsisivustot ja alisivustot.
  • Kattava siirtyminen sivustohierarkiassa.

Tiedostokirjastojen hallinta

  • Luettele kaikki sivuston tiedostokirjastot.
  • Hanki oletusarvoinen tiedostokirjasto.
  • Selaa kansion sisältöä (enintään 20 kohdetta).
  • Luo ja hallitse kansiorakenteita.

Tiedostotoiminnot

  • Luo teksti- ja binääritiedostoja (enintään 5 MB).
  • Lue tekstiä ja binääritiedostoja (5 MB tai vähemmän).
  • Tiedostojen ja kansioiden poistaminen, nimeäminen uudelleen ja siirtäminen.
  • Kopioi tiedostot ja kansiot tiedostokirjastojen välillä.
  • Lataa tiedostot SharePoint tai OneDrive URL-osoitteista.
  • Hae tiedostoja ja kansioita kaikista helppokäyttöisyyssivustoista.
  • Hae tiedoston ja kansion metatiedot.

Asynkroninen toiminnot

  • Tiedostojen ja kansioiden kopioiminen ja siirtäminen asynkronisesti tiedostokirjastojen välillä.
  • Tarkista asynkronisten toimintojen tila toimintotunnusten avulla.

Luettelon toiminnot

  • Luo, lue ja poista luetteloita.
  • Tuki useille luettelomalleille, kuten yleisille, tiedostokirjastoille, tapahtumille ja tehtäville.
  • Jaa luetteloita, joilla on roolipohjaiset käyttöoikeudet.
  • Hallitse luettelokohteita luomalla, lukemalla, päivittämällä ja poistamalla niitä.

Sarakkeiden hallinta

  • Luo sarakkeita monenlaisilla tyypeillä, kuten teksti, huomautus, numero, totuusarvo, päivämäärä ja aika, valinta, haku, käyttäjä, URL-osoite, laskettu ja paljon muuta.
  • Päivitä sarakkeen ominaisuudet ja metatiedot.
  • Määritä sarakevaatimukset ja näkyvyys.
  • Määritä tyyppikohtaiset sarakeominaisuudet.

Jakaminen ja käyttöoikeudet

  • Jaa tiedostoja, kansioita ja luetteloita käyttäjien kanssa.
  • Käytä roolipohjaista käyttöoikeuksien hallintaa luku-, kirjoitus-, osallistumista- ja muokkausrooleissa.
  • Sähköposti-ilmoitukset jakamista varten.
  • Mukautetut viestit kutsuissa.

Tietoturva ja yhteensopivuus

  • Ota luottamuksellisuustunnisteet käyttöön ja poista ne.
  • Käytä useita määritysmenetelmiä, kuten vakiomuotoista, etuoikeutettua ja automaattista.
  • Tue auditointiperusteita.
  • Käytä samanaikaisuuden hallintaa eTags-palvelun kanssa.

Huomautuksia

  • Tiedostotoiminnot on rajoitettu tiedostoihin, joiden lataaminen ja lataaminen on enintään 5 Mt.
  • Kopiointi- ja siirtotoiminnot ovat asynkronisia. Käytä - checkOperationStatus mittaria edistymisen seurantaan.
  • Kopiointi- ja siirtotoiminnot tukevat kirjastojen välillä toimimista SharePoint sisällä.
  • uploadFileFromUrl edellyttää kelvollista SharePoint tai OneDrive lähde-URL-osoitetta.
  • eTags tarjoaa samanaikaisuuden hallinnan päivityksiä ja poistoja varten.
  • Automaattinen numeerinen pääte kaksoiskansioiden nimille.
  • Luettelon poistamista ei voi kumota.
  • Sarakkeen poistaminen poistaa kaikki kyseiseen sarakkeeseen tallennetut tiedot.
  • Hakutoiminnot palauttavat oletusarvoisesti 20 parasta tulosta.
  • Last updated on