Portaalide veebi API ülevaade
Portaalid Web API võimaldab luua rikkama kasutajakogemuse Power Apps portaalide lehtedel. Veebi-API abil saate teha oma portaalide lehtedelt kõigi Microsoft Dataverse tabelite loomise, lugemise, värskendamise ja kustutamise toiminguid. Näiteks saate luua uue konto, värskendada kontakti või muuta toote tabeli õigusi, kasutades portaali halduse rakenduse asemel portaalide veebirakendust.
Oluline
- Teie portaali versioon peab olema 9.3.3.x või uuem, et see funktsioon töötaks.
- Portaalide veebi-API on ehitatud rikkama kasutajakogemuse loomiseks portaalide lehtedel. See pole optimeeritud kolmanda osapoole teenuste ega rakenduste integreerimise jaoks.
- Portaalide veebiliidese toimingud on piiratud tabelitega, mis on seotud näiteks andmetega, kontode, kontaktide või teie kohandatud tabelitega. Tabelite metaandmete või portaali seadistustabeli andmete konfigureerimine, näiteks portaalide tabelite konfigureerimine, näiteks adx_contentsnippet, adx_entityform või adx_entitylist pole portaalide veebiliidestega toetatud. Täieliku loendi saamiseks avage hiljem selles teemas toetamata konfiguratsioonitabelid.
- Portaalid Web API saab kasu serveripoolsest vaheajast, nii et järgnevad kõned veebi API-le on kiiremad kui esialgsed kõned. Pidage meeles, et portaali serveripoolse vahemälu tühjendamise järel halveneb jõudlus ajutiselt.
- Portaalid Web API toimingud nõuavad Power Apps portaalide litsentsi. Näiteks anonüümsete kasutajate poolt tehtud Veebi API kõned loendatakse lehevaate võimsusesks. Veebi API kõned, mis on tehtud autentitud kasutajate poolt (sise või välis) eiole arvestatud lehevaate poole, vaid nõuavad kohalduvaid litsentse. Lisateave: Power Apps portaalid, mis litsentsivad KKK-d
Veebi-API toimingud
Portaalid Web API pakub Dataverse toimingute jaoks alamhulka, mida saate teha Dataverse API abil. Oleme hoidnud API-vormingut võimalikult sarnasena, et vähendada õppimiskõverat.
Portaalides saadaval veebi-API toimingud
- Kirjete lugemine tabelist
- Looge tabelis kirje
- Kirjete värskendamine ja kustutamine tabelist
- Tabelite seostamine ja eraldamine
Veebi-API veebisätted
Peate lubama saidi sätted, et lubada portaalide veebi-API oma portaalis. Samuti saate konfigureerida väljataseme veebi API, mis määrab tabeliväljad, mida saab või ei saa portaalidega muuta Veebi API.
| Saidi sätte nimi | Kirjeldus |
|---|---|
| Webapi/<table name>/enabled | Lubab või keelab veebi-API jaoks <table name>. Vaikeväärtus: False Sobivad väärtused: True False |
| Webapi/<table name>/fields | Määratleb komaga eraldatud loendi atribuutidest, mida saab veebi-API abil muuta. Võimalikud väärtused: - Kõik atribuudid: * - Konkreetsed atribuudid: attr1,attr2,attr3 Märkus: Väärtus peab olema tärn ( *) või väljanimede komaeraldusega loend. Oluline: see on kohustuslik saidi säte. Kui see säte puudub, kuvatakse tõrketeade "selle olemi jaoks pole väljad määratletud". |
| Webapi/error/innererror | Lubab või keelab sisemised vead. Vaikeväärtus: False Sobivad väärtused: True False |
Märkus
Muudatuste jõustumiseks peavad saidisätted olema seatud aktiivseks.
Näiteks selleks, et eksponeerida veebiliidese juhtumitabeli jaoks, kus autentitud kasutajad saavad selle olemiga luua, värskendada ja kustutada, kuvatakse saidi sätted järgmises tabelis.
| Saidi sätte nimi | Saidisätte väärtus |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1,attr2,attr3 |
Turvalisus portaalide veebi-API abil
Kirjepõhise turvalisuse saate konfigureerida portaalide üksikute kirjete jaoks, kasutades tabeli õigusi. Portaalide Web API pääseb juurde tabeli (olemi) kirjetele ja järgib seotud veebirolli kaudu kasutajatele antud tabeliõigusi.
Portaalide veebi-API päringute autentimine
Autentimiskoodi ei pea lisama, sest autentimist ja autoriseerimise haldab rakenduse seanss. Kõik veebi-API kõned peavad sisaldama saidiülese päringu võltsimise (CSRF) luba.
Isikuandmete kaitse üldmäärus (GDPR)
Kõigil päringupäistel edastatakse auditeerimise eesmärgil kontakti ID. Anonüümsele kasutajale saadetakse see edasi kui null.
Kui auditi logimine on lubatud, näeb kasutaja kõiki auditisündmusi Office 365 auditilogis.
Lisateave:
Tegevuste logimise lubamine ja kasutamine
Auditilogi kirjete eksportimine, konfigureerimine ja kuvamine
Toetamata konfiguratsioonitabelid
Portaalid Web API ei saa kasutada järgmistes konfiguratsioonitabelites.
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
Järgmine etapp
Päringuandmed portaalide veebi API abil
Vt ka
HTTP-taotluste koostamine ja vigade käsitlemine Portaalid kirjutavad, värskendavad ja kustutavad toiminguid veebi API abil Õpetus: Portaali Web API kasutamine