Portaalien verkko-ohjelmointirajapinnan yleiskuvaus
Portaalien verkko-ohjelmointirajapinta mahdollistaa monipuolisemman kokemuksen Power Pages -sivustoissa. Verkko-ohjelmointirajapinnan avulla voit suorittaa luonti-, luku-, päivitys- ja poistotoimintoja kaikissa Microsoft Dataverse -taulukoissa verkkosivuiltasi. Voit esimerkiksi luoda uuden tilin, päivittää yhteyshenkilön ilman lomaketta tai monivaiheista lomaketta portaalien verkkorajapinnan avulla.
Tärkeä
- Power Pages -sivuston version on oltava 9.3.3.x tai uudempi, jotta tämä toiminto toimii oikein.
- Portaalien verkko-ohjelmointirajapinta on suunniteltu luomaan monipuolinen käyttökokemus portaalin sivuille. Sitä ei ole optimoitu kolmannen osapuolen palvelujen tai sovellusten integrointiin. Myöskään portaalien verkkorajapinnan käyttöä muiden Power Pages -sivustojen integroimiseen ei tueta.
- Portaalien verkko-ohjelmointirajapinnan toiminnot tietoihin liittyviin taulukoihin, kuten tileihin, yhteyshenkilöihin tai mukautettuihin taulukoihin. Taulukon metatietojen tai portaalin määritystaulukon tietojen määrittämistä, kuten portaalin adx_contentsnippet-, adx_entityform- tai adx_entitylist-taulukoiden määrittämistä, ei tueta portaalien verkko-ohjelmointirajapinnassa. Täydellinen luettelo on jäljempänä tämän aiheen kohdassa Määritystaulukot, joita ei tueta.
- Portaalien Web API hyötyy palvelinpuolen välimuistista, joten web-ohjelmointirajapinnan myöhemmät kutsut ovat nopeampia kuin alkuperäiset kutsut. Huomaa, että portaalin palvelin puolen välimuistin tyhjennys heikentää suorituskykyä tilapäisesti.
- Portaalien verkko-ohjelmointirajapintatoiminnot edellyttävät Power Pages -käyttöoikeutta. Esimerkiksi anonyymien käyttäjien tekemät verkko-ohjelmointirajapintakutsut lasketaan mukaan anonyymikäyttäjien kapasiteettiin. Todennettujen (sisäisten tai ulkoisten) käyttäjien tekemät verkko-ohjelmointirajapintakutsuja ei lasketa mukaan sivunäkymiin mutta niitä varten tarvitaan soveltuvat todennettujen käyttäjien kapasiteetin käyttöoikeudet. Lisätietoja: Power Pages -käyttöoikeuksia koskevat usein kysytyt kysymykset
Verkko-ohjelmointirajapinnan toiminnot
Portaalien verkko-ohjelmointirajapintaa sisältää Dataverse -toimintojen ominaisuuksien alijoukon, joita voidaan tehdä Dataverse -ohjelmointirajapinnalla. Ohjelmointirajapinnan muoto on pidetty mahdollisimman samanlaisena, jotta uutta opeteltavaa ei olisi paljon.
Muistiinpano
Verkko-ohjelmointirajapinnan toiminnot ovat merkkikokoriippuvaisia.
Power Pagesissa käytettävissä olevat verkko-ohjelmointirajapinnan toiminnot
- Tietueiden lukeminen taulukosta
- Tietueen luominen taulukkoon
- Taulukon tietueiden päivittäminen ja poistaminen
- Taulukoiden yhdistäminen ja erottaminen
Muistiinpano
Toimintojen ja funktioiden kutsumista portaalien verkko-ohjelmointirajapintojen avulla ei tueta.
Verkko-ohjelmointirajan sivuston asetukset
Portaalin verkko-ohjelmointirajapinnan käyttöönotto edellyttää, että sivuston asetus on otettu käyttöön. Voit myös määrittää kenttätason Web API:n, joka määrittää taulukkokentät, joita voidaan tai joita ei voi muokata portaalien Web API:lla.
Muistiinpano
Käytä taulukon loogista nimeä näille asetuksille (esimerkiksi tili).
| Sivuston asetuksen nimi | Description |
|---|---|
| Webapi/<table name>/enabled | Ottaa kohteen <table name> verkko-ohjelmointirajapinnan käyttöön tai poistaa sen käytöstä. Oletus: False Kelvolliset arvot: True, False |
| Webapi/<table name>/fields | Määrittää pilkuin erotellun luettelon määritteistä, joita voidaan muokata verkko-ohjelmointirajapinnan avulla. Mahdolliset arvot: - Kaikki määritteet: * - Tietyt määritteet: attr1,attr2,attr3 Huomautus: arvon on oltava joko tähti (*) tai pilkuin eroteltu kenttänimiluettelo. Tärkeää: Tämä on pakollinen sivuston asetus. Jos tämä asetus puuttuu, näkyviin tulee virhe Entiteetille ei ole määritetty yhtään kenttää. |
| Webapi/error/innererror | InnerError otetaan käyttöön tai poistetaan käytöstä. Oletus: False Kelvolliset arvot: True, False |
| Webapi/<table name>/disableodatafilter | Ottaa OData-suodattimen käyttöön tai poistaa sen käytöstä. Oletus: False Kelvolliset arvot: True,False Lisätietoja on tunnettuja ongelmia käsittelevässä kohdassa. Sivustoasetus on käytettävissä portaalin versiosta 9.4.10.74 alkaen. |
Muistiinpano
Sivuston asetuksissa on valittava Aktiivinen, jotta muutokset otetaan käyttöön.
Seuraavassa taulukossa ovat sivustoasetukset, jolla voidaan tuoda näkyviin palvelupyyntötaulukon verkko-ohjelmointirajapinta, jolla todennetut käyttäjät voivat suorittaa kyseisessä entiteetissä luonti-, päivitys- ja poistotoimintoja.
| Sivuston asetuksen nimi | Sivuston asetuksen arvo |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1, attr2, attr3 |
Suojaus portaalien verkko-ohjelmointirajapinnan avulla
Tietuepohjainen suojaus voidaan määrittää portaalin yksittäisiin tietueisiin käyttämällä taulukko-oikeuksia. Portaalien verkko-ohjelmointirajapinta käyttää taulukon (entiteettien) tietueita ja noudattaa taulukkoon liittyviä käyttöoikeuksia, jotka on annettu käyttäjille liittyvän verkkoroolin kautta.
Voit määrittää sarakeoikeudet määrittämään lisäoikeuksia yksittäisiin taulukon sarakkeisiin portaalien verkko-ohjelmointirajapinnan avulla.
Portaalien verkko-ohjelmointirajapinnan pyyntöjen todentaminen
Todennuskoodia ei tarvitse lisätä, koska sovellusistunto hallitsee todennusta ja valtuutusta. Kaikissa verkko-ohjelmointirajapintakutsuissa on oltava CSRF (jaetun julkaisuoikeuspyynnön väärentäminen) -tunnus.
EntitySetName-nimen käyttö
Kun viittaat Dataverse-taulukoihin koodissa portaalien verkkorajapinnan avulla, sinun täytyy käyttää esimerkiksi EntitySetName-nimeä tili-taulukon käyttämiseen. Koodisyntaksi käyttää tilien EntitySetName-nimeä; /_api/accounts().
Muistiinpano
Käytä sivustoasetusten loogista nimeä näille asetuksille (esimerkiksi tili).
Voit määrittää tiettyjen taulukoiden EntitySetName-nimen seuraavasti:
Siirry https://make.powerapps.com:een
Valitse Dataverse-välilehti sivupaneelista ja valitse taulukko.
Valitse ... (Komennot-vaihtoehto) ja kopioi taulukon EntitySetName-nimi leikepöydälle valitsemalla Lisäasetukset, Työkalut ja Kopioi joukon nimi.
Tietosuojalait ja -määräykset
Kaikille pyynnön otsikoille välitetään yhteyshenkilön tunnus valvontaa varten. Anonyymin käyttäjän osalta lähetetään null.
Jos valvontalokiin kirjaus on otettu käyttöön, käyttäjä näkee kaikki valvontatapahtumat Office 365:n valvontalokissa.
Lisätietoja:
Toimien lokiin kirjaamisen ottaminen käyttöön ja sen käyttäminen
Valvontalokin tietueiden vieminen, määrittäminen ja näyttäminen
Määritystaulukot, joita ei tueta
Portaalien verkko-ohjelmointirajapintaa ei voi käyttää seuraavissa määritystaulukoissa:
adx_contentaccesslevel
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_entitypermission_webrole
adx_externalidentity
adx_pagealert
adx_pagenotification
adx_pagetag
adx_pagetag_webpage
adx_pagetemplate
adx_portallanguage
adx_publishingstate
adx_publishingstatetransitionrule
adx_publishingstatetransitionrule_webrole
adx_redirect
adx_setting
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_urlhistory
adx_webfile
adx_webfilelog
adx_webform
adx_webformmetadata
adx_webformsession
adx_webformstep
adx_weblink
adx_weblinkset
adx_webnotificationentity
adx_webnotificationurl
adx_webpage
adx_webpage_tag
adx_webpageaccesscontrolrule
adx_webpageaccesscontrolrule_webrole
adx_webpagehistory
adx_webpagelog
adx_webrole_systemuser
adx_website
adx_website_list
adx_website_sponsor
adx_websiteaccess
adx_websiteaccess_webrole
adx_websitebinding
adx_websitelanguage
adx_webtemplate
Tunnetut ongelmat
Käyttäjät saavat CDS-virheen, jos he käynnistävät GET-verkko-ohjelmointirajapinnan pyynnön tauluille, joissa on useita yksi moneen- tai monta moneen -taulun käyttöoikeutta, kun Ylätaso-, Yhteyshenkilö- tai Asiakas-laajuudet lisäävät kyselyyn ehtoja.
Voit ratkaista tämän ongelman käyttämällä FetchXML OData-kyselyssä.
Vaihtoehtoisesti sivuston asetuksen Webapi/<table name>/disableodatafilter arvoksi voidaan määrittää True.
Tärkeä
Jos sivuston asetuksen Webapi/<table name>/disableodatafilter arvoksi muutetaan True, verkko-ohjelmointirajapinnan GET-kutsut voivat hidastua.
Sivustoasetus on käytettävissä portaalin versiosta 9.4.10.74 alkaen.
Seuraava vaihe
Tietojen kysely portaalien Web API:n avulla