Pregled Web API-ja za portale

Napomena

Od 12. oktobra 2022. Power Apps portali postaju Power Pages. Više informacija: Usluga Microsoft Power Pages je sada opštedostupna (blog)
Uskoro ćemo migrirati i objediniti dokumentaciju o Power Apps portalima sa dokumentacijom o usluzi Power Pages.

Web API za portale omogućava izgradnju bogatijeg korisničkog iskustva na stranicama Power Apps portala. Web API možete koristiti za izvršavanje operacija kreiranja, čitanja, ažuriranja i brisanja u svim Microsoft Dataverse tabelama sa stranica portala. Na primer, možete da napravite novi nalog, ažurirate kontakt ili promenite dozvole za tabelu za proizvod korišćenjem Web API-ja portala umesto aplikacije Portal Management.

Napomena

Web API za portale možete da koristite i u usluzi Power Pages. Još informacija: Šta je to Power Pages

Važno

• Verzija vašeg portala mora biti 9.3.3.x ili novija da bi ova funkcija mogla da funkcioniše.
• 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 za portale za integrisanje sa drugim Power Apps portalima 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 za portale zahtevaju licencu za Power Apps portale. Na primer, pozivi Web API-ja koje upućuju anonimni korisnici računaju se u kapacitetu prikaza stranice. 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. Još informacija: Najčešća pitanja o licenciranju Power Apps portala

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.

Operacije Web API-ja dostupne na portalima

• Čitanje zapisa iz tabele
• Kreiranje zapisa u tabeli
• Ažuriranje i brisanje zapisa u tabeli
• Pridruživanje i razdvajanje tabela

Napomena

Pozivanje radnji i funkcija pomoću Web API-ja za portale nije podržano.

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/<table name>/enabled	Omogućava ili onemogućava Web API za <table name>. Podrazumevano: False Važeće vrednosti: True, False
Webapi/<table name>/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/<table name>/disableodatafilter	Omogućava ili onemogućava OData filter. Podrazumevano: False Važeće vrednosti: True, FalseViš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:

1. Idi u https://make.powerapps.com

2. Izaberite karticu Dataverse sa bočne table i izaberite tabelu.

3. Izaberite ... (opcija Komande) i odaberite Napredno, Alatke i Kopiraj ime skupa da biste kopirali EntitySetName tabele u ostavu.

   

Opšta uredba o zaštiti podataka (GDPR)

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 nadgledanja

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 CDS grešku ako pozovu Web API zahtev GET za tabele koje imaju više 1 prema više ili više prema više dozvola za tabelu sa definisanim nadređenim opsegom.

Da biste rešili ovaj problem, preporučeno rešenje je korišćenje jezika FetchXML u OData upitu.

Druga mogućnost je da podesite postavku lokacije Webapi/<table name>/disableodatafilter na True.

Važno

Promena postavke lokacije Webapi/<table name>/disableodatafilter na True dovesti do sporijih performansi za Web API GET pozive.

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

Pogledajte i ovo

Sastavljanje HTTP zahteva i obrada grešaka
Operacije pisanja, ažuriranja i brisanja na portalima pomoću Web API-ja
Vodič: Korišćenje Web API-ja za portale

Napomena

Možete li nam reći o svojim željenim postavkama jezika u dokumentaciji? Ispunite kratku anketu. (imajte na umu da je ova anketa na engleskom jeziku)

Anketa će trajati oko sedam minuta. Ne prikupljaju se lični podaci (izjava o privatnosti).