Portaalide veebi API ülevaade

Märkus

Alates 12. oktoobrist 2022 on Power Appsi portaalid Power Pages. Lisateave: Microsoft Power Pages on nüüd üldiselt saadaval (ajaveebipostitus)
Peagi migreerime ja ühendame Power Appsi portaalide dokumentatsiooni Power Pagesi dokumentatsiooniga.

Portaalide veebi-API võimaldab luua rikkamat kasutajakogemust Power Appsi portaalide lehtedel. Veebi-API abil saate luua, lugeda, värskendada ja kustutada oma portaalide lehtedelt kõiki Microsoft Dataverse tabeleid. Näiteks saate luua uue konto, värskendada kontakti või muuta toote tabeli õigusi, kasutades portaali halduse rakenduse asemel portaalide veebirakendust.

Märkus

Saate rakenduses Power Pages ka portaalide veebi-API-id kasutada Lisateave: Mis on Power Pages

Oluline

• Teie portaali versioon peab olema 9.3.3.x või uuem, et see funktsioon töötaks.
• Portaalide veebi-API on ehitatud rikkama kasutajakogemuse loomiseks portaalide lehtedel. See pole optimeeritud kolmanda osapoole teenuste ega rakenduste integreerimise jaoks. Samuti ei toetata portaalide veebi-API kasutamist teiste Power Appsi portaalide saitidega integreerimiseks.
• Portaalide API toimingud on piiratud tabelitega, mis on seotud andmetega—näiteks kontode, kontaktide või teie kohandatud tabelitega. Tabelite metaandmete või portaali seadistustabeli andmete konfigureerimine—näiteks portaalide tabelite konfigureerimine, näiteks adx_contentsnippet, adx_entityform või adx_entitylist—pole portaalide API-ga toetatud. Täieliku loendi saamiseks vaadake toetamata konfiguratsioonitabeleid (toodud hiljem käesolevas jaotises).
• Portaalid saavad veebi-API serveripoolse vahemälust kasu, seega ka järgnevad kutsed veebi-API-le on kiiremad, kui algsed. Pidage meeles, et portaali serveripoolse vahemälu tühjendamise järel halveneb jõudlus ajutiselt.
• Portaalide veebi-API toimingud nõuavad Power Appsi portaalide litsentsi. Näiteks anonüümsete kasutajate poolt tehtud Veebi API kõned loendatakse lehevaate võimsusesks. Veebi API kõned, mis on tehtud autentitud kasutajate poolt (sise või välis) eiole arvestatud lehevaate poole, vaid nõuavad kohalduvaid litsentse. Lisateave: Power Apps portaalide litsentside KKK

Veebi-API toimingud

Portaalide veebi-API pakub võimalusi Dataverse allüksuste toimingute jaoks, mida saate teha Dataverse API abil. Õppimiskõvera vähendamiseks oleme hoidnud API-vormingut nii sarnasena kui võimalik.

Märkus

Veebi-API toimingud on tõstutundlikud.

Portaalides saadaval veebi-API toimingud

• Kirjete lugemine tabelist
• Looge tabelis kirje
• Kirjete värskendamine ja kustutamine tabelist
• Tabelite seostamine ja eraldamine

Märkus

Portaalide veebi-API-sid kasutades toimingute ja funktsioonide kutsumist ei toetata.

Veebi-API veebisätted

Peate lubama saidi sätted, et lubada portaalide veebi-API oma portaalis. Lisaks saate konfigureerida väljataseme veebi-API, mis määrab tabeliväljad, mida saab või ei saa portaalide veebi-API abil muuta.

Märkus

Kasutage nende sätete jaoks tabelis loogilist nime (näiteks konto).

Saidi sätte nimi	Kirjeldus
Webapi/<table name>/enabled	Lubab või keelab veebi-API jaoks <table name>. Vaikeväärtus: False Sobivad väärtused: True False
Webapi/<table name>/fields	Määratleb komaga eraldatud loendi atribuutidest, mida saab veebi-API abil muuta. Võimalikud väärtused: - Kõik atribuudid: * - Konkreetsed atribuudid: attr1,attr2,attr3 Märkus: väärtus peab olema kas tärn (*) või väljanimede komaeraldusega loend. Tähtis: see on saidi kohustuslik säte. Kui see säte puudub, kuvatakse tõrketeade "selle olemi jaoks pole väljad määratletud".
Webapi/error/innererror	Lubab või keelab sisemised vead. Vaikeväärtus: False Sobivad väärtused: True False
Webapi/<table name>/disableodatafilter	Lubab või keelab OData filtri. Vaikeväärtus: False Sobivad väärtused: True, False Lisateavet leiate teemast teadaolevad probleemid. Saidi säte on saadaval portaali versioonis 9.4.10.74 või hilisemas.

Märkus

Muudatuste jõustumiseks peavad saidisätted olema seatud aktiivseks.

Näiteks selleks, et eksponeerida veebiliidese juhtumitabeli jaoks, kus autentitud kasutajad saavad selle olemiga luua, värskendada ja kustutada, kuvatakse saidi sätted järgmises tabelis.

Saidi sätte nimi	Saidisätte väärtus
Webapi/incident/enabled	true
Webapi/incident/fields	attr1, attr2, attr3

Turvalisus portaalide veebi-API abil

Kirjepõhise turvalisuse saate konfigureerida portaalide üksikute kirjete jaoks, kasutades tabeli õigusi. Portaalide veebiliides pääseb juurde tabelikirjetele (olem) ja järgib seostatud veebirolli kaudu kasutajatele antud tabeli lubasid.

Portaalide veebi-API-d kasutades saate veeruõiguseid konfigureerida tabeli üksikute veergude jaoks täiendavate õiguste määratlemiseks.

Portaalide veebi-API päringute autentimine

Te ei pea lisama autentimiskoodi, kuna autentimist ja autoriseerimist haldab rakenduse seanss. Kõik veebi-API kõned peavad sisaldama saidiülese päringu võltsimise (CSRF) luba.

Atribuudi EntitySetName kasutamine

Portaalide veebi-API-t kasutades oma koodis Dataverse’i tabelitele viitamisel peate kasutama väärtust EntitySetName. Näiteks konto tabelile juurdepääsuks kasutab koodisüntaks kontode jaoks väärtust EntitySetName; /_api/accounts().

Märkus

Kasutage saidi sätete jaoks tabelis loogilist nime (näiteks konto).

Kindlate tabelite atribuudi EntitySetName määramiseks tehke järgmist.

1. Avage https://make.powerapps.com

2. Valige külgpaneelil vahekaart Dataverse ja valige tabel.

3. Valige suvand ... (Käsud) ja seejärel valige Täpsem, Tööriistad ja Kopeeri kogumi nimi, et kopeerida tabeli atribuut EntitySetName oma lõikelauale.

   

Isikuandmete kaitse üldmäärus (GDPR)

Kõigil taotluse päistel on auditeerimise eesmärkidel edastatud kontakti ID. Anonüümsele kasutajale saadetakse see edasi kui null.

Kui auditi logimine on lubatud, saab kasutaja kontrollida kõiki auditeerimise sündmusi Office 365 auditeerimise Logis.

Lisateave:
Tegevuslogi lubamine ja kasutamine
Auditi logide eksportimine, konfigureerimine ja vaatamine

Toetamata konfiguratsioonitabelid

Portaalide veebi-API-d ei saa kasutada järgmiste konfiguratsioonitabelite jaoks.

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

Teadaolevad probleemid

Kasutajad saavad CDS-tõrke, kui nad käivitavad tabelite jaoks veebi-API taotluse GET, millel on mitu taset üks-mitmele või mitu-mitmele tabeli õigused koos määratud ulatusega ülemüksus.

Probleemi lahendamiseks on soovitatav kasutada OData päringus atribuuti FetchXML.

Teise võimalusena määrake saidi sätte Webapi/<table name>/disableodatafilter väärtuseks True.

Oluline

Saidi sätte Webapi/<table name>/disableodatafilter väärtuse muutmine väärtuseks True võib veebi-API kutseid GET aeglustada.

Saidi säte on saadaval portaali versioonis 9.4.10.74 või hilisemas.

Järgmine etapp

Portaalide veebi API-ga andmete päring

Vt ka

HTTP-taotluste koostamine ja vigade käsitlemine
Portaalide kirjutamis-, värskendamis- ja kustutamistoimingu veebi-API-d kasutades
Õpetus: Portaali veebi-API kasutamine

Märkus

Kas saaksite meile dokumentatsiooniga seotud keele-eelistustest teada anda? Osalege lühikeses uuringus. (Uuring on ingliskeelne.)

Uuringus osalemine võtab umbes seitse minutit. Isikuandmeid ei koguta (privaatsusavaldus).