Pregled Web API-ja za portale
Web API za portale omogućava izgradnju bogatijeg korisničkog iskustva unutar Power Pages lokacija. Web API možete koristiti za izvršavanje operacija kreiranja, čitanja, ažuriranja i brisanja u svim Microsoft Dataverse tabelama sa veb-stranica. Na primer, možete da kreirate novi nalog, ažurirate kontakt bez korišćenja obrasca ili obrasca sa više koraka pomoću Web API-ja.
Važno
- Verzija vaše Power Pages lokacije mora biti 9.3.3.x ili novija da bi ova funkcija mogla da radi.
- Web API za portale je izgrađen za kreiranje bogatog korisničkog iskustva unutar stranica portala. On nije optimizovan za usluge nezavisnih proizvođača ili za integraciju aplikacija. Korišćenje Web API portala za integrisanje sa drugim Power Pages lokacijama takođe nije podržano.
- Web API operacije za portale su ograničene na tabele povezane sa podacima – na primer, kontakti, poslovni kontakti ili prilagođene tabele. Konfigurisanje metapodataka tabele ili podataka tabele konfiguracije portala – na primer, konfigurisanje tabela portala kao što su adx_contentsnippet, adx_entityform ili adx_entitylist – nije podržano Web API-jem za portale. Za kompletnu listu idite na odeljak o nepodržanim tabelama konfiguracije kasnije u ovoj temi.
- Web API za portale ima koristi od keširanja na strani servera, pa prema tome, naredni pozivi Web API-ja su brži od početnih poziva. Imajte na umu da brisanje keša na strani servera portala uzrokuje privremenu degradaciju performansi.
- Operacije Web API-ja zahtevaju licencu za Power Pages. Na primer, pozivi Web API-ja koje upućuju anonimni korisnici računaju se u kapacitetu anonimnih korisnika. Pozivi Web API-ja koje su uputili korisnici sa potvrđenim identitetom (interni ili eksterni) ne računaju se u prikaze stranica, ali zahtevaju odgovarajuće licence za kapacitet ovlašćenih korisnika. Još informacija: Najčešća pitanja o licenciranju usluge Power Pages
Operacije Web API-ja
Web API za portale nudi podskup mogućnosti za radnje portala Dataverse koje možete izvršiti koristeći API za Dataverse. Održali smo format API-ja što je moguće sličnijim, kako bismo ublažili krivu učenja.
Napomena
Web API operacije su osetljive na mala i velika slova.
Web API operacije dostupne u usluzi Power Pages
- Čitanje zapisa iz tabele
- Kreiranje zapisa u tabeli
- Ažuriranje i brisanje zapisa u tabeli
- Pridruživanje i razdvajanje tabela
Postavke lokacije za Web API
Morate omogućiti podešavanje lokacije da biste omogućili Web API za portale za svoj portal. Takođe, možete da konfigurišete Web API na nivou polja, koji određuje polja tabele koja se mogu ili ne mogu menjati pomoću Web API-ja za portale.
Napomena
Koristite logičko ime tabele za ove postavke (na primer poslovni kontakt).
| Naziv podešavanja lokacije | Opis |
|---|---|
| Webapi/<naziv tabele>/enabled | Omogućava ili onemogućava Web API za <naziv tabele>. Default: False Važeće vrednosti: True, False |
| Webapi/<naziv tabele>/fields | Definiše listu atributa odvojenih zarezom koji se mogu izmeniti pomoću Web API-ja. Moguće vrednosti: - Svi atributi: * - Specifični atributi: attr1,attr2,attr3 Napomena: Vrednost mora biti ili zvezdica (*) ili spisak naziva polja odvojenih zarezom. Važno: Ovo je obavezno podešavanje lokacije. Kada ovo podešavanje nedostaje, videćete grešku „Za ovaj entitet nisu definisana polja“. |
| Webapi/error/innererror | Omogućuje ili onemogućuje InnerError. Podrazumevano: False Važeće vrednosti: True, False |
| Webapi/<naziv tabele>/disableodatafilter | Omogućava ili onemogućava OData filter. Podrazumevano: False Važeće vrednosti: True, False Više informacija potražite u odeljku Poznati problemi. Postavka lokacije je dostupna na portalu verzije 9.4.10.74 ili novijem. |
Napomena
Postavke lokacije moraju biti postavljena na Aktivno da bi promene stupile na snagu.
Na primer, da biste izložili Web API za tabelu Predmeta gde je ovlašćenim korisnicima dozvoljeno da obavljaju operacije kreiranja, ažuriranja i brisanja ovog entiteta, podešavanja lokacije su prikazana u sledećoj tabeli.
| Naziv podešavanja lokacije | Vrednost podešavanja lokacije |
|---|---|
| Webapi/incident/enabled | true |
| Webapi/incident/fields | attr1, attr2, attr3 |
Bezbednost pomoću Web API-ja za portale
Možete da konfigurišete zaštitu zasnovanu na zapisima za pojedinačne zapise na portalima koristeći dozvole za tabele. Web API za portale pristupa zapisima tabele (entiteta) i prati dozvole za tabele date korisnicima putem pridruženih veb-uloga.
Možete da konfigurišete dozvole za kolone tako da dodatno definišu privilegije pojedinačnim kolonama unutar tabele dok koristite Web API za portale.
Zahtevi za potvrdu identiteta za Web API za portale
Ne morate da uključujete kôd za potvrdu identiteta, jer potvrdom identiteta i autorizacijom upravlja sesija aplikacije. Svi pozivi Web API-ja moraju da sadrže token falsifikovanja unakrsnih zahteva između lokacija (CSRF).
Korišćenje funkcije EntitySetName
Kada se pozivate na Dataverse tabele koje koriste Web API za portale u kodu, potrebno je da koristite EntitySetName, na primer, za pristup tabeli poslovnog kontakta, sintaksa koda će koristiti EntitySetName za poslovne kontakte, /_api/accounts().
Napomena
Koristite logičko ime tabele za postavke lokacije (na primer poslovni kontakt).
Možete odrediti EntitySetName određenih tabela tako što ćete pratiti ove korake:
Izaberite karticu Dataverse sa bočne table i izaberite tabelu.
Izaberite ... (opcija Komande) i odaberite Napredno, Alatke i Kopiraj ime skupa da biste kopirali EntitySetName tabele u ostavu.
Zakoni i propisi o privatnosti
Sva zaglavlja zahteva će imati ID kontakta prosleđen u svrhe nadgledanja. Za anonimnog korisnika ovo će se proslediti kao null.
Ako je evidentiranje revizije omogućeno, korisnik može videti sve događaje revizije u Office 365 evidenciji revizije.
Još informacija:
Omogućavanje i korišćenje evidentiranja aktivnosti
Izvoz, konfigurisanje i prikaz zapisa evidencije nadzora
Nepodržane tabele konfiguracije
Web API za portale se ne može koristiti za sledeće tabele konfiguracije:
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
Poznati problemi
Korisnici će dobiti grešku CDS-a ako pozovu zahtev za GET Veb API za tabele koje imaju više nivoa od KSNUMKS do mnogih ili mnogih do mnogihdozvola za tabele kada opseg roditeljskih, kontaktnih ili naloga doda dodatne uslove upitu.
Da biste rešili ovaj problem, preporučeno rešenje je da se koristi FetchXML u OData upitu.
Druga mogućnost je da podesite postavku lokacije Webapi/<naziv tabele>/disableodatafilter na True.
Važno
Promena postavke lokacije Webapi/<naziv tabele>/disableodatafilter na True može dovesti do sporijih performansi za Web API pozive GET.
Postavka lokacije je dostupna na portalu verzije 9.4.10.74 ili novijem.
Sledeći korak
Podaci upita pomoću Web API-ja za portale