Jagamisviis:

Portaalide veebi API ülevaade

Portaalide veebi-API võimaldab luua rikkamat kasutajakogemust teenuse Power Pages saitidel. Veebi-API abil saate luua, lugeda, värskendada ja kustutada oma veebilehtedelt kõiki rakenduse Microsoft Dataverse tabeleid. Näiteks saate portaalide veebi API abil luua uue konto, uuendada kontakti ilma vormi või mitmeetapilise vormita veebi API portaaalide abil.

Oluline

  • Selle funktsiooni toimimiseks peab teie Power Pages saidi versioon olema 9.3.3.x või uuem.
  • 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 teenuse Power Pages saitidega integreerimiseks.
  • Portaalide API toimingud on piiratud tabelitega, mis on seotud andmetega nt kontode, kontaktide või teie kohandatud tabelitega. Tabelite metaandmete või portaali seadistus-tabeli andmete konfigureerimine, nt portaalide tabelite konfigureerimine, näiteks adx_contentsnippet, adx_entityform või adx_entitylistpole portaalide API-ga toetatud. Täieliku loendi leiate selle artikli lõpus asuvatest toetamata konfiguratsioonitabelitest .
  • Portaalid saavad veebi-API serveripoolse vahemälust kasu, seega ka järgnevad kutsed veebi-API-le on kiiremad, kui algsed. Portaali serveripoolse vahemälu tühjendamine põhjustab jõudluse ajutist halvenemist.
  • Portaalide veebi-API toimingud nõuavad teenuse Power Pages litsentsi. Näiteks anonüümsete kasutajate poolt tehtud Veebi API kõned loendatakse anonüümse kasutaja võimsuseks. Autenditud kasutajate (sise- või väliskasutajate) tehtud veebi-API kõnesid ei arvestata lehevaatamiste hulka, vaid need nõuavad rakendatavaid autenditud kasutajamahu litsentse. Lisateave: Power Pages llitsentsimise KKK

Veebi-API toimingud

Portaalide veebi-API pakub võimalusi Dataverse allüksuste toimingute jaoks, mida saate teha Dataverse API abil. Hoidsime API-vormingu võimalikult sarnasena, et vähendada õppimiskõverat.

Märkus.

Veebi-API toimingud on tõstutundlikud.

Teenuse Power Pages saadaval veebi-API toimingud

Märkus.

Helistamistoiminguid ja -funktsioone portaalide Web API abil 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/<tabeli nimi>/lubatud Lubab või keelab veebi-API <tabelinime> jaoks.
Vaikimisi:False
Kehtivad väärtused:TrueFalse
Webapi/<tabeli nimi>/väljad Määratleb komaga eraldatud loendi atribuutidest, mida saab veebi-API abil muuta.
Võimalikud väärtused:
- Kõik atribuudid:*
- Spetsiifilised atribuudid:attr1,attr2,attr3
Märkus: Väärtus peab olema kas tärn (*) või komaeraldusega väljanimede loend.
See säte on kohustuslik saidisäte. Kui see säte puudub, näete tõrget "Selle olemi jaoks pole välju määratletud".
Webapi/error/innererror Lubab või keelab sisemised vead.
Vaikimisi:False
Kehtivad väärtused:TrueFalse
Webapi/<tabeli nimi>/disableodatafilter Lubab või keelab OData filtri.
Vaikimisi:False
Kehtivad väärtused:True,Lisateavet False leiate teadaolevatest probleemidest . 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/intsident/lubatud true
Webapi/intsident/väljad 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

Autentimiskoodi pole vaja lisada, kuna rakenduse seanss haldab autentimist ja autoriseerimist. Kõik veebi-API kõned peavad sisaldama saidiülese päringu võltsimise (CSRF) luba.

Atribuudi EntitySetName kasutamine

Kui viitate tabelitele Dataverse , mis kasutavad teie koodis portaalide Web API-d, peate kasutama üksust EntitySetName, näiteks kontotabelile juurdepääsemiseks kasutab koodisüntaks kontode üksust 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.

    Kuidas leida rakenduse Dataverse tabeli atribuut EntitySetName.

Privaatsusseadused ja regulatsioonid

Kõik päringu päised kasutavad auditeerimise eesmärgil edastatud kontakti ID-d. Anonüümse kasutaja jaoks edastatakse see väärtus kui null.

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

Auditilogi kuvatõmmis Office 365 .

Lisateave:
Tegevuste logimise lubamine ja kasutamine
Auditilogi kirjete 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-i tõrke, kui nad käivitavad GET Web API taotluse tabelite kohta, millel on mitu taset 1 kuni palju või palju kuni paljutabeliõigusi , kui vanem-, ** kontakti- või kontoulatused lisavad päringule rohkem tingimusi.

Selle probleemi lahendamiseks on soovitatav kasutada FetchXML OData päringut.

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

Oluline

Saidisätte Webapi/<table name>/disableodatafilter muutmine võib True aeglustada Web API GET kõnede jõudlust.

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

Järgmine etapp

Andmete pärimine portaalide Web API abil