A Portálok webes API áttekintése

Megjegyzés

2022. október 12-től a Power Apps-portálok a Power Pages nevet kapják. További információ: A Microsoft Power Pages már általánosan elérhető (blog)
      A Power Apps-portál dokumentációját hamarosan áttelepítjük és egyesítjük a Power Pages dokumentációjával.

A Portálok webes API-val teljesebb felhasználói élmény biztosítható a Power Apps-portálok oldalain. A webes API segítségével műveleteket hozhat létre, olvashat, frissíthet és törölhet az összes Microsoft Dataverse-táblában a portáloldalakról. Létrehozhat például egy új partnert, frissíthet egy kapcsolattartót, vagy módosíthatja a termékre vonatkozó táblaengedélyeket a portálok webes API használatával a Portálkezelő alkalmazás helyett.

Megjegyzés

A portálok webes API-t Power Pages keretében is használhatja. További információ: Mi a Power Pages?

Fontos

• A portálverziónak 9.3.3.x-nek vagy újabbnak kell lennie, hogy ez a funkció működjön.
• A Portálok webes API-t úgy alakítottuk ki, hogy teljesebb felhasználói élményt lehessen vele biztosítani a portálok oldalain. Nincs külső felek szolgáltatásaihoz vagy az alkalmazások integrálására optimalizálva. A portálok webes API használata más Power Apps portálwebhelyekkel való integrációra szintén nem támogatott.
• A portálok webes API-műveletei csak az adatokhoz kapcsolódó táblákra korlátozottak — például partner, kapcsolattartók vagy egyéni táblákra. A táblametaadatok vagy a portálkonfigurációs táblaadatok konfigurálása — például a portáltáblák (mint az adx_contentsnippet, adx_entityform vagy adx_entitylist) konfigurálása — nem támogatott a portálok webes API-val. A teljes listát lásd a nem támogatott konfigurációs táblák szakaszban a témakör későbbi részében.
• A Portálok webes API kihasználja a kiszolgálóoldali gyorsítótárazás előnyei, így a webes API későbbi meghívásai gyorsabbak az első hívásoknál. Ne feledje, hogy a portál kiszolgálóoldali gyorsítótárazásának törlése ideiglenes teljesítménycsökkenést okozhat.
• A portálok webes API-műveleteihez Power Apps portálok licenc szükséges. A névtelen felhasználók által készített webes API-hívásokat például a rendszer az oldalnézet kapacitásába számítja. A hitelesített felhasználók (belső vagy külső) webes API-hívásait nem számítja bele a rendszer az oldalnézetekbe, hanem a megfelelő licenceket igénylik. További információk: Power Apps portálok licencelése GYIK

Webes Api-műveletek

A Portálok webes API a Dataverse API használatával megvalósítható Dataverse-műveletekhez nyújt szolgáltatásokat. A lehető legkevesebbet módosítottunk az API formátumán, hogy mielőbb el lehessen sajátítani a használati módot.

Megjegyzés

A webes API-műveletek megkülönböztetik a kis- és nagybetűket.

A portálokon elérhető webes API-műveletek

• Bejegyzések olvasása táblából
• Rekord létrehozása táblában
• Bejegyzések frissítése és törlése táblázatban
• Táblák társítása és társításának megszüntetése

Megjegyzés

Műveletek és függvények hívása a portálok webes API használatával nem támogatott.

A webes API webhelybeállításai

Ha engedélyezni szeretné a portáljához a Portálok webes API-t, engedélyeznie kell a webhelybeállításokat. Ezenkívül konfigurálhatja azt a mezőszintű webes API-t, amely a portál webes API-val módosítható vagy nem módosítható táblamezőket határozza meg.

Megjegyzés

A beállításokhoz használja a tábla logikai nevét (például fiók).

Webhelybeállítás neve	Description
Webapi/<table name>/enabled	Engedélyezi vagy letiltja a webes API-t a következő entitáshoz: <table name>. Alapértelmezett: False Érvényes értékek: True, False
Webapi/<table name>/fields	A webes API-val módosítható attribútumok vesszővel tagolt listáját határozza meg. Lehetséges értékek: - Minden attribútum: * - Bizonyos attribútumok: attr1,attr2,attr3 Megjegyzés: az értéknek vagy csillagnak (*) vagy mezőnevek vesszővel tagolt listájának kell lennie. Fontos: ez kötelező webhely-beállítás. Ha ez a beállítás hiányzik, a következő hibaüzenet jelenik meg: „Nincsenek mezők definiálva ehhez az entitáshoz”.
Webapi/hiba/innererror	Engedélyezi vagy letiltja az InnerError elemet. Alapértelmezett: False Érvényes értékek: True, False
Webapi/<table name>/disableodatafilter	Engedélyezi vagy letiltja az OData szűrőt. Alapértelmezett: False Érvényes értékek: True, False További információkért lásd a tevékenységekkel kapcsolatos ismert problémákkal foglalkozó témakört. A webhelybeállítás a 9.4.10.74-es vagy újabb portálverzióban érhető el.

Megjegyzés

A változtatások érvénybe léptetéséhez a webhely beállításait Aktív értékre kell állítani.

Például ha fel szeretné venni a webes API-t az Eset táblához, ahol a hitelesített felhasználók számára engedélyezett a létrehozási, frissítési és törlési műveletek végrehajtása ezen az entitáson, a webhely beállításai a következő táblázatban láthatók.

Webhelybeállítás neve	Webhelybeállítás értéke
Webapi/incidens/engedélyezve	true
Webapi/esemény/mezők	attr1, attr2, attr3

A portálok webes API biztonsági szolgáltatásai

A rekordalapú biztonságot a portálok egyes rekordjai számára táblajogosultságok segítségével konfigurálhatja. A portálok webes API-ja hozzáfér a táblarekordokhoz (entitásrekordokhoz), és követi a társított webes szerepkör segítségével a felhasználóknak adott táblaengedélyeket.

Az oszlopengedélyek konfigurálhatóak, hogy a portálok webes API használata közben tovább definiálja a tábla egyes oszlopainak jogosultságait.

A portálok webes API-kérések hitelesítése

A hitelesítési kódot nem kell felvenni, mert a hitelesítést és az engedélyezést az alkalmazási munkamenet kezeli. A webes API összes hívásának tartalmaznia kell a webhelyközi kérések hamisításának (CSRF) kódját.

Az EntitySetName használata

Amikor a kódban a portálok webes API-t használó Dataverse-táblákra hivatkozik, az EntitySetName nevet kell használnia például a fiók táblához való hozzáféréshez, a kód szintaxisa a fiókok EntitySetName fájlját fogja használni; /_api/accounts().

Megjegyzés

A webhelybeállításokhoz használja a tábla logikai nevét (például fiók).

A következő lépésekkel meghatározhatja az adott táblák EntitySetName értékét:

1. A https://make.powerapps.com megnyitása

2. Válassza ki a Dataverse lapot az oldalpanelen, majd válassza ki a táblát.

3. Válassza a ... (Parancsok) lehetőséget, majd válassza a Speciális, Eszközök és a Készlet másolása parancsot a tábla EntitySetName elemének vágólapra másolásához.

   

Általános adatvédelmi rendelet (GDPR)

Az összes kérésfejlécben megtalálható a naplózási célra átadott kapcsolattartói azonosító. Névtelen felhasználó esetén az átadott érték null.

Ha az auditnaplózás engedélyezve van, a felhasználó láthatja az összes naplózási eseményt az Office 365 auditnaplójában.

További információ:
Tevékenység naplózásának engedélyezése és használata
Az auditnaplók rekordjainak exportálása, konfigurálása és megtekintése

Nem támogatott konfigurációs táblák

A portálok webes API-ja nem használható a következő konfigurációs táblákhoz:

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

Ismert problémák

A felhasználók CDS-hibaüzenetet kapnak, ha egy GET webes API-kérelmet hívnak meg olyan táblákhoz, amelyeknél az 1 a sokhoz vagy sok a sokhoz táblaengedély létezik fölérendelt hatókörrel.

A probléma megoldásához az ajánlott megoldás a FetchXML használata az OData lekérdezésben.

Másik lehetőségként állítsa a Webapi/<table name>/disableodatafilter webhelybeállítást True értékre.

Fontos

Ha módosítja a Webapi/<table name>/disableodatafilter True webhelybeállítást, előfordulhat, hogy a webes API GET-hívások teljesítménye csökken.

A webhelybeállítás a 9.4.10.74-es vagy újabb portálverzióban érhető el.

Következő lépés

Adatok lekérdezése portálok webes API-val

Kapcsolódó információk

HTTP-kérelmek összeállítása és hibák kezelése
Portálműveletek írása, frissítése és törlése a webes API használatával
Oktatóanyag: Portálok webes API-jának használata

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).