Pregled spletnega API-ja za portale
Spletni API portalov omogoča gradnjo bogatejše uporabniške izkušnje znotraj Power Apps strani portalov. Spletni API lahko uporabite za izvajanje operacij ustvarjanja, branja, posodabljanja in brisanja v vseh Microsoft Dataverse tabelah na straneh vaših portalov. S spletnim API-jem portalov lahko namesto z aplikacijo za upravljanje portala za izdelek ustvarite na primer nov račun, posodobite stik ali spremenite dovoljenja za tabele.
Pomembno
- Za delovanje te funkcije morate imeti portal različice 9.3.3.x ali novejše.
- Spletni API portalov je bil ustvarjen za grajenje bogate uporabniške izkušnje znotraj strani portalov. Ni optimiziran za storitve tretjih ponudnikov ali integracijo aplikacij.
- Delovanje spletnih API-jev portalov je omejeno na tabele, povezane s podatki— na primer računi, stiki ali tabelami po meri. Konfiguriranje metapodatkov tabele ali podatkov konfiguracijske tabele portala— na primer konfiguriranje tabel portalov, kot so adx_contentsnippet, adx_entityform ali adx_entitylist— ni podprt s spletnim API-jem portalov. Za popoln seznam pojdite na nepodprte konfiguracijske tabele kasneje v tem tema.
- Spletni API portalov ima koristi predpomnjenje na strani strežnika, zato so nadaljnji klici spletnega API-ja hitrejši od začetnih klicev. Upoštevajte, da brisanje strežniškega predpomnilnika povzroči začasno slabše delovanje.
- Operacije spletnega API-ja portalov zahtevajo licenco za portale Power Apps. Na primer, klici spletnega API-ja, ki jih opravijo anonimni uporabniki, se štejejo v zmogljivost ogleda strani. Klici spletnega API-ja, ki jih opravijo overjeni uporabniki (notranji ali zunanji), se ne štejejo med oglede strani, vendar zahtevajo ustrezne licence. Več informacij: Pogosta vprašanja o licenciranju portalov Power Apps
Postopki spletnih API-jev
Spletni API portalov ponuja podnabor zmogljivosti za operacije Dataverse, ki jih lahko izvajate z uporabo API-ja Dataverse. Format API-ja smo ohranili čim bolj podoben, da zmanjšamo krivuljo učenja.
Postopki spletnih API-jev, ki so na voljo na portalih
- Preberite zapise iz tabele
- Ustvarjanje zapisa v tabeli
- Posodobitev in izbris zapisov v tabeli
- Povezovanje in ločevanje tabel
Nastavitve spletnega mesta za spletni API
Če želite za svoj portal omogočiti spletni API portalov, morate omogočiti nastavitev spletnega mesta. Prav tako lahko konfigurirate spletni API na ravni polja, ki določa polja tabele, ki jih lahko ali ne morete spreminjati s spletnim API-jem portalov.
| Ime nastavitve mesta | Opis |
|---|---|
| Webapi/<table name>/enabled | Omogoči ali onemogoči spletni API za <table name>. Privzeto: False Veljavne vrednosti: True, False |
| Webapi/<table name>/fields | Določa seznam atributov, ločenih z vejicami, ki jih je mogoče spremeniti s spletnim API-jem. Možne vrednosti: - Vsi atributi: * - Določeni atributi: attr1,attr2,attr3 Opomba: vrednost mora biti bodisi zvezdica (*_) ali seznam imen polj ločenih z vejico. _ Pomembno: to je obvezna nastavitev spletnega mesta. Če ta nastavitev manjka, se vam bo prikazala napaka »Za to entiteto ni določeno nobeno polje«. |
| Webapi/error/innererror | Omogoči ali onemogoči InnerError. Privzeto: False Veljavne vrednosti: True, False |
Opomba
Nastavitve mesta morajo biti nastavljene na Aktivno, da spremembe začnejo veljati.
Če želite na primer izpostaviti spletni API za tabelo primerov, kjer lahko uporabniki s preverjeno pristnostjo izvajajo postopke ustvarjanja, posodabljanja in brisanja te entitete, so nastavitve spletnega mesta prikazane v naslednji tabeli.
| Ime nastavitve mesta | Vrednost nastavitve mesta |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1,attr2,attr3 |
Varnost s spletnim API-jem portalov
Varnost na podlagi zapisov lahko za posamezne zapise na portalih konfigurirate z dovoljenji za tabele. Spletni API portalov dostopa do zapisov tabele (entitet) in sledi dovoljenjem tabele, ki so dana uporabnikom prek povezanih spletna vloga.
Preverjanje pristnosti zahtevkov spletnih API-jev za portale
Ni vam treba vključiti kode za preverjanje pristnosti, ker preverjanje pristnosti in avtorizacijo upravlja seja aplikacije. Vsi klici spletnega API-ja morajo vsebovati žeton za ponarejanje zahteve prek spletnih mest (CSRF).
Splošna uredba o varstvu podatkov (GDPR)
Vse glave zahtev bodo imele posredovan ID stika za namene revizije. Za anonimnega uporabnika bo posredovan kot null.
Če je beleženje revizije omogočeno, lahko uporabnik vidi vse revizijske dogodke v Office 365 revizijski dnevnik.
Več informacij:
Omogočite in uporabite beleženje dejavnosti
Izvozite, konfigurirajte in si oglejte zapise revizijskega dnevnika
Nepodprte konfiguracijske tabele
Spletni API portalov ni mogoče uporabiti za naslednje konfiguracijske tabele:
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
Naslednji korak
Poizvedovanje podatkov s spletnim API-jem portalov
Glejte tudi
Sestavljanje zahtev HTTP in obravnava napak Portali pišejo, posodabljajo in brišejo operacije s spletnim API-jem Vadnica: Uporabite portalski spletni API