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šeg Power Pages sajta mora biti 9.3.3.k ili novija da bi ova funkcija radila.
- 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 nepodržane tabele konfiguracije kasnije u ovom članku.
- 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. 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 Veb API-ja napravljeni od strane autentifikovanih korisnika (internih ili eksternih) ne računaju se prema prikazima stranica, ali zahtevaju važeće autentifikovane licence za kapacitet 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. Zadržali smo API format što je moguće sličniji kako bismo smanjili krivulju 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
- Kreirajte zapis u tabeli
- Ažurirajte i izbrišite zapise u tabeli
- Tabele saradnika i razdvajanja
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/<ime> tabele/omogućeno | Omogućava ili onemogućava Web API za <naziv tabele>. Podrazumevani: False Važeće vrednosti: True, False |
| Webapi/<ime> tabele/polja | 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 beleške: Vrednost mora biti ili zvezdica (*) ili lista imena polja razdvojena zarezom. Važno: Ova postavka je obavezno podešavanje sajta. Kada ova postavka nedostaje, videćete grešku "Nema polja definisana za ovaj entitet." |
| Vebapi / greška / innererror | Omogućuje ili onemogućuje InnerError. Podrazumevani: False Važeće vrednosti: True, False |
| Webapi/<table name>/disableodatafilter | Omogućava ili onemogućava OData filter. Podrazumevani: False Važeće vrednosti: True, False Pogledajte poznate probleme za više informacija. 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 |
|---|---|
| Vebapi / incident / omogućeno | true |
| Webapi/incident/polja | 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čite kod za autentifikaciju jer sesija aplikacije upravlja autentifikacijom i autorizacijom. 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 Veb API portala u vašem kodu, potrebno je da koristite EntitySetName, na primer, da biste pristupili tabeli računa , sintaksa koda koristi EntitySetName naloga ; /_api/accounts()
Belešku
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 koriste ID kontakta koji je prosleđen u svrhu revizije. Za anonimnog korisnika, ova vrednost se prosleđuje kao null.
Ako je evidentiranje revizije omogućeno, korisnik može videti sve događaje revizije u Office 365 evidenciji revizije.
Još informacija:
Omogućite i koristite prijavljivanje aktivnosti
Izvoz, konfigurisanje i pregled zapisa dnevnika revizije
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 dobijaju 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 objedlozi roditeljskih, ** kontaktnih ili naloga dodaju više uslova 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 podešavanja sajta Vebapi /< table name> / disableodatafilter može True dovesti do sporijih performansi za Veb API GET pozive.
Postavka lokacije je dostupna na portalu verzije 9.4.10.74 ili novijem.
Sledeći korak
Upitajte podatke koristeći portale Veb API