Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
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 tai päivittää yhteyshenkilön käyttämättä lomaketta tai monivaiheista lomaketta käyttämällä portaalien WWW-ohjelmointirajapintaa.
Www-ohjelmointirajapinta käyttää /_api reittiä (esimerkiksi https://yoursite.powerappsportals.com/_api/accounts) ja noudattaa Dataverse Web API:n kanssa samankaltaista RESTful-mallia.
Tärkeä
- Portaalien verkko-ohjelmointirajapinta on suunniteltu luomaan monipuolinen käyttökokemus portaalin sivuille. Sitä ei ole optimoitu kolmannen osapuolen palvelujen tai sovellusten integrointiin. Portaalien VERKKO-ohjelmointirajapinnan käyttämistä integrointeihin muihin Power Pages sivustoihin 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ä esimerkiksi portaalitaulukoiden, kuten adx_contentsnippet, adx_entityform tai adx_entitylist, määrittämistä ei tueta portaalien WWW-ohjelmointirajapinnan avulla. Täydellinen luettelo on jäljempänä tässä artikkelissa olevassa artikkelissa, jossa ei tueta määritystaulukoita .
- Portaalien Web API hyötyy palvelinpuolen välimuistista, joten web-ohjelmointirajapinnan myöhemmät kutsut ovat nopeampia kuin alkuperäiset kutsut. Portaalin palvelinpuolen välimuistin tyhjennys heikentää suorituskykyä tilapäisesti.
- Portaalien verkko-ohjelmointirajapintatoiminnot edellyttävät Power Pages -käyttöoikeutta. Esimerkiksi anonyymin käyttäjän tekemät WWW-ohjelmointirajapintakutsut lasketaan anonyymiin käyttäjäkapasiteettiin. Todennetut käyttäjät (sisäiset tai ulkoiset) verkko-ohjelmointirajapinnan kutsut eivät näy sivunäkymissä, vaan ne edellyttävät soveltuvia todennettuja käyttäjäkapasiteetin käyttöoikeuksia. Lisätietoja on artikkelissa Power Pages käyttöoikeuksien usein kysytyt kysymykset.
- Toimintojen ja funktioiden kutsumista WWW-ohjelmointirajapinnan avulla ei tueta.
Verkko-ohjelmointirajapinnan toiminnot
Portaalien verkko-ohjelmointirajapintaa sisältää Dataverse -toimintojen ominaisuuksien alijoukon, joita voidaan tehdä Dataverse -ohjelmointirajapinnalla. Ohjelmointirajapinnan muoto on mahdollisimman samankaltainen oppimiskäyrän pienentämiseksi.
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
Verkko-ohjelmointirajan sivuston asetukset
Tärkeä
Yleismerkkiarvon (*) tuki sivustoasetuksessa Webapi/<table-name>/fields on vanhentunut.
Korvaa * pilkuin eroteltuun luetteloon, joka sisältää sivustosi edellyttämät sarakkeet. Power Pages WWW-ohjelmointirajapinnan pyynnöt taulukoille, jotka on määritetty vikasietoisina*, kunnes määrität eksplisiittiset sarakkeiden nimet.
Jos haluat ottaa portaalien VERKKO-ohjelmointirajapinnan käyttöön portaalissasi, ota sivuston asetus käyttöön. Voit myös määrittää kenttätason WWW-ohjelmointirajapinnan, joka määrittää taulukon kentät, joita käyttäjät voivat tai eivät voi muokata portaalien WWW-ohjelmointirajapinnan avulla.
Muistiinpano
Käytä taulukon loogista nimeä näille asetuksille (esimerkiksi tilille).
| Sivuston asetuksen nimi | Description |
|---|---|
| Webapi/<taulukon nimi>/käytössä | Ottaa kohteen <table name> verkko-ohjelmointirajapinnan käyttöön tai poistaa sen käytöstä. Oletusarvo: False Kelvolliset arvot: True, False |
| Webapi/<taulukon nimi>/kentät | Määrittää pilkuin eroteltujen määritteiden luettelon, jota käyttäjät voivat muokata WWW-ohjelmointirajapinnan avulla. Mahdolliset arvot: - Tietyt määritteet: attr1,attr2,attr3 Tärkeää: Tämä asetus on pakollinen sivuston asetus. Jos tämä asetus puuttuu, näkyviin tulee virhe Entiteetille ei ole määritetty yhtään kenttää. |
| Webapi/virhe/innererror | InnerError otetaan käyttöön tai poistetaan käytöstä. Oletusarvo: False Kelvolliset arvot: True, False |
Voit esimerkiksi näyttää Verkko-ohjelmointirajapinnan Tapaus-taulukolle, jossa todennetut käyttäjät voivat luoda, päivittää ja poistaa tietueita tälle entiteetille, käyttämällä seuraavassa taulukossa näkyviä sivuston asetuksia.
| Sivuston asetuksen nimi | Sivuston asetuksen arvo |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1, attr2, attr3 |
Suojaus portaalien verkko-ohjelmointirajapinnan avulla
Voit määrittää tietuepohjaisen suojauksen yksittäisille tietueille portaaleissa käyttämällä taulukon käyttö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 sisällyttää, sillä 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 käyttämällä portaalien verkko-ohjelmointirajapintaa koodissasi, käytä EntitySetName-nimeä. Esimerkiksi tilitaulukon käyttämiseksi koodin syntaksi käyttää tilien EntitySetName-nimeä; /_api/accounts()Paljonko kello on?
Muistiinpano
Käytä sivustoasetusten loogista nimeä näille asetuksille (esimerkiksi tili).
Voit selvittää tiettyjen taulukoiden EntitySetName-arvon seuraavasti:
Siirry kohtaan https://make.powerapps.com
Valitse Dataverse-välilehti sivupaneelista ja valitse taulukko.
Valitse ... (Komennot-vaihtoehto) ja kopioi sitten taulukon EntitySetName leikepöydälle valitsemalla Lisäasetukset, Työkalut ja Kopioi joukon nimi.
Tietosuojalait ja -määräykset
Kaikissa pyynnön otsikoissa käytetään yhteystiedon tunnusta valvontaan. Anonyymin käyttäjän arvo on 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-ohjelmointirajapintapyynnön taulukoille, joilla on useita tasoja yksi moneen- tai monta moneen -taulukkokäyttöoikeuksia, kun Ylätaso-, **Yhteyshenkilö- tai Tili-vaikutusalueet lisäävät kyselyyn enemmän ehtoja.
Voit korjata tämän ongelman käyttämällä FetchXML:ää OData-kyselyssä.
Seuraava vaihe
Tietojen kysely portaalien Web API:n avulla