Pregled web API-ja za portale
Napomena
Od 12. listopada 2022. portali Power Apps postaju Power Pages. Više informacija: Usluga Microsoft Power Pages je sada javno dostupna (blog)
Uskoro ćemo migrirati i spojiti dokumentaciju za portale Power Apps s dokumentacijom za Power Pages.
Web API portali omogućuju bogatiji korisnički doživljaja na stranicama portala Power Apps. Web API možete upotrijebiti za provođenje operacija stvaranja, ažuriranja i brisanja svih tablica platforme Microsoft Dataverse sa stranica portala. Na primjer, možete stvoriti novi račun, ažurirati ugovor ili promijeniti dozvole tablice za proizvod upotrebom web-API-ja portala umjesto aplikacije za upravljanje portalima.
Napomena
Portale Web API-ja možete koristiti i u usluzi Power Pages. Dodatne informacije: Što je Power Pages
Važno
- Verzija vašeg portala mora biti 9.3.3.x ili novija da bi ova značajka radila.
- Web API portala namijenjen je za stvaranje bogatog korisničkog doživljaja na stranicama portala. Nije optimiziran za servise trećih strana ili integraciju aplikacija. Upotreba portala Web API za integraciju s drugim stranicama portala Power Apps također nije podržana.
- Operacije web-API-ja portala ograničene su na tablice koje se odnose na podatke—primjerice na račune, ugovore ili vaše prilagođene tablice. Konfiguriranje metapodatka tablice ili podataka tablice konfiguracije—primjerice konfiguriranje tablice portala kao što su adx_contentsnippet, adx_entityform ili adx_entitylist—nije podržano s web-API-jem portala. Potpuni popis možete pronaći u tablicama nepodržanih konfiguracija kasnije u ovoj temi.
- Portali Web API iskorištava prednosti predmemorije na strani poslužitelja pa su naknadni pozivi za Web API brži od početnih poziva. Napominjemo da brisanje predmemorije na strani poslužitelja uzrokuje privremeno pogoršanje performansi.
- Operacije portala Web API zahtijevaju licencu za portale platforme Power Apps. Na primjer, pozivi web API-jeva anonimnih korisnika računaju se u kapacitet pregleda stranice. Pozivi web API-jeva korisnika kojima je provjerena autentičnost (unutarnji ili vanjski) ne računaju se u prikaze stranice, ali zahtijevaju odgovarajuće licence. Dodatne informacije: Najčešća pitanja o licenciranju portala Power Apps
Web API portala pruža podskup mogućnosti za radnje servisa Dataverse koje možete obaviti s pomoću API-ja servisa Dataverse. API format zadržali smo što sličnijim da bismo skratili proces učenja.
Napomena
Operacije Web API-ja razlikuju velika i mala slova.
- Čitanje zapisa iz tablice
- Stvaranje zapisa u tablici
- Ažuriranje i brisanje zapisa u tablici
- Pridruživanje i poništavanje pridruživanja tablica
Morate omogućiti postavku web-mjesta da biste omogućili Web API portala za svoj portal. Isto tako možete konfigurirati Web API na razini polja koji određuje polja tablice koja se mogu ili ne mogu izmjenjivati putem portala Web API.
Napomena
Upotrijebite tablicu logički naziv za ove postavke (na primjer račun).
Naziv postavke web-mjesta | Opis |
---|---|
Webapi/<table name>/enabled | Omogućuje ili onemogućuje Web API za <table name>. Zadano: False Valjane vrijednosti: True , False |
Webapi/<table name>/fields | Definira popis atributa odvojenih zarezom koji se mogu mijenjati s pomoću Web API-ja. Moguće vrijednosti: - Svi atributi: * - Specifični atributi: attr1,attr2,attr3 Bilješka: Vrijednost mora biti zvjezdica (*) ili popis naziva polja odvojenih zarezom. Važno: Ovo je obavezna postavka web-mjesta. Ako ta postavka nedostaje, vidjet ćete pogrešku Za ovaj entitet nisu definirana polja. |
Webapi/error/innererror | Omogućuje ili onemogućuje InnerError. Zadano: False Valjane vrijednosti: True , False |
Webapi/<table name>/disableodatafilter | Omogućuje ili onemogućuje OData filter. Zadano: False Valjane vrijednosti: True , False Više informacija potražite u odjeljku poznati problemi. Postavka web-mjesta dostupna je u verziji portala 9.4.10.74 ili kasnijoj verziji. |
Napomena
Postavke web-mjesta moraju biti postavljene na Aktivno da bi promjene stupile na snagu.
Na primjer, za izlaganje web-API-ja za tablicu Slučaj, gdje je korisnici kojima je provjerena autentičnost dopušteno da provedu operacije stvaranja, ažuriranja i brisanja na ovom entitetu, postavke web-mjesta prikazane su u sljedećoj tablici.
Naziv postavke web-mjesta | Vrijednost postavke web-mjesta |
---|---|
Webapi/incident/enabled | true |
Webapi/incident/fields | attr1, attr2, attr3 |
Sigurnost na temelju zapisa možete konfigurirati za individualne zapise na portalima s pomoću dozvola tablice. Portali Web API pristupaju zapisima tablice (entitet) i prate dozvole tablice koje su dodijeljene korisnicima putem pridružene web-uloge.
Možete konfigurirati dopuštenja za stupce za dodatno utvrđivanje povlastica za pojedinačne stupce unutar tablice dok upotrebljavate portale Web API.
Ne morate uključiti kôd za provjeru autorizacije jer sesija aplikacije upravlja provjerom autentičnosti i autorizacijom. Svi pozivi Web API-ja moraju sadržavati token za Krivotvorene zahtjeve s drugih web-mjesta (CSRF).
Kada se odnosi na tablice usluge Dataverse pomoću portala Web API-ja, trebate upotrijebiti opciju EntitySetName, na primjer za pristup tablici računa, sintaksa koda upotrijebit će opciju EntitySetName od računa; /_api/accounts()
.
Napomena
Upotrijebite tablicu logički naziv za postavke web-mjesta (na primjer račun).
Možete odrediti opciju EntitySetName određenih tablica slijedeći ove korake:
Idite na https://make.powerapps.com
Odaberite karticu Dataverse na bočnoj ploči i odaberite tablicu.
Odaberite ... (Mogućnost naredbi), a zatim odaberite Napredna, Alati i Kopiraj naziv skupa da biste kopirali EntitySetName tablice u međuspremnik.
Sva zaglavlja zahtjeva imat će ID kontakta proslijeđen u svrhu nadzora. Za anonimnog će se korisnika proslijediti kao null
.
Ako je omogućeno zapisivanje nadzora, korisnik može vidjeti sve događaje nadzora u zapisniku nadzora Office 365.
Dodatne informacije:
Omogućivanje i upotreba aktivnosti prijave u sustav
Izvezite, konfigurirajte i prikažite zapise zapisnika nadzora
Portali Web API portali ne mogu se upotrijebiti za sljedeće tablice konfiguracija:
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
Korisnici će dobiti poruku o CDS pogrešci ako pozovu GET
Web API zahtjev za tablice koje imaju više razina 1 prema mnogima ili mnogi prema mnogima dozvole za tablicu s definiranim nadređenim djelokrugom.
Za rješavanje ovog problema preporučuje se upotreba FetchXML u OData upitu.
Umjesto toga, postavite postavku web-mjesta Webapi/<table name>/disableodatafilter na True
.
Važno
Promjena postavke web-mjesta Webapi/<table name>/disableodatafilter na True
može dovesti do sporijeg rada za Web API GET
pozive.
Postavka web-mjesta dostupna je u verziji portala 9.4.10.74 ili kasnijoj verziji.
Slanje upita za podatak pomoću Web API-ja
Sastavljanje HTTP zahtjeva i rješavanje pogrešaka
Portali dodaju, ažuriraju i brišu operacije pomoću Web API-ja
Vodič: upotreba portala Web API-ja
Napomena
Možete li nam reći više o željenim jezicima za dokumentaciju? Ispunite kratki upitnik. (imajte na umu da je upitnik na engleskom jeziku)
Ispunjavanje upitnika će trajati otprilike sedam minuta. Osobni podaci se ne prikupljaju (izjava o zaštiti privatnosti).