Portalų žiniatinklio API apžvalga
Pastaba
Nuo 2022 m. spalio 12 d. „Power Apps“ portalai tampa „Power Pages“. Daugiau informacijos: „Microsoft Power Pages“ dabar yra visuotinai prieinama (tinklaraštis)
Greitai perkelsime ir suliesime „Power Apps“ portalų dokumentaciją su „Power Pages“ dokumentacija.
Portalų žiniatinklio API įgalina platesnę vartotojo patirtį „Power Apps“ portalų puslapiuose. Naudodami žiniatinklio API galite atlikti kūrimo, skaitymo, naujinimo ir naikinimo operacijas visose „Microsoft Dataverse” lentelėse iš savo portalų puslapių. Pavyzdžiui, galite sukurti naują abonementą, atnaujinti kontaktą arba pakeisti produkto lentelės teises naudodami žiniatinklio API, o ne Portalų valdymo programą.
Pastaba
Be to, galite naudoti portalų žiniatinklio API „Power Pages“. Daugiau informacijos: Kas yra Power Pages
Svarbu
- Kad veiktų ši funkcija, jūsų portalo versija turi būti 9.3.3.x arba naujesnė.
- Portalų žiniatinklio API yra sukurtas platesnės vartotojo patirties kūrimui portalo puslapiuose. Jis nėra optimizuotas trečiųjų šalių paslaugoms ar programos integravimui. Portalų žiniatinklio API naudojimas norint integruoti su kitomis „Power Apps“ portalų svetainėmis taip pat nepalaikomas.
- Portalų Žiniatinklio API operacijos atliekamos tik lentelėse, susijusiose su duomenimis—pavyzdžiui, paskyromis, kontaktais ar jūsų pasirinktinėmis lentelėmis. Konfigūracijos lentelės metaduomenys ar portalo konfigūracijos lentelės duomenys—pavyzdžiui, portalų lentelių, tokių kaip „adx_contentsnippet”, „adx_entityform”, arba „adx_entitylist”—konfigūravimas, nėra palaikomi su portalų Žiniatinklio API. Visą sąrašą rasite nepalaikomos konfigūracijos lentelės toliau šioje temoje.
- Portalų žiniatinklio API gauna naudos išserverio talpyklos, todėl vėlesnės žiniatinklio API iškvietos yra greitesnės nei pradinės. Atminkite, kad išvalius portalo serverio talpyklą efektyvumas laikinai suprastėja.
- Portalų žiniatinklio API operacijoms atlikti reikia „Power Apps“ portalų licencijos. Pavyzdžiui, anoniminių vartotojų atlikti žiniatinklio API skambučiai skaičiuojami į puslapių rodinio pajėgumą. Autentifikuotų vartotojų (vidinių arba išorinių) žiniatinklio API skambučiai neskaičiuojami į puslapio rodinius, tačiau reikia naudoti taikomas licencijas. Daugiau informacijos: „Power Apps“ DUK apie portalų licencijavimą
Žiniatinklio API operacijos
Portalų žiniatinklio API teikia papildomą galimybių rinkinį „Dataverse“ veiksmams, kuriuos galite atlikti naudodami „Dataverse“ API. Išlaikėme API formatą kuo panašesnį, kad palengvintume mokymąsi.
Pastaba
Žiniatinklio API operacijose skiriamos mažosios ir didžiosios raidės.
Žiniatinklio API operacijos, pasiekiamos portaluose
- Įrašų skaitymas iš lentelės
- Įrašo kūrimas lentelėje
- Įrašų naujinimas ir naikinimas lentelėje
- Lentelių susiejimas ir atsiejimas
Svetainės nustatymai žiniatinklio API
Turite įjungti svetainės nustatymus tam, kad įjungtumėte portalų žiniatinklio API savo portalui. Taip pat galite sukonfigūruoti lauko lygio žiniatinklio API, nulemiančią, ar lentelės laukai gali būti modifikuojami naudojant portalų žiniatinklio API, ar negali.
Pastaba
Naudokite lentelę loginis pavadinimas šiems parametrams (pavyzdžiui, paskyra).
| Svetainės pavadinimo nustatymas | Aprašą |
|---|---|
| Webapi/<table name>/enabled | Įjungia ar išjungia žiniatinklio API <table name>. Numatytoji reikšmė: False Galiojančios vertės: True, False |
| Webapi/<table name>/fields | Nustato kableliu atskirtų savybių sąrašą, kuris gali būti keičiamas su žiniatinklio API. Galimos reikšmės: - Visi atributai: * - Būdingi atributai: attr1,attr2,attr3 Pastaba: Vertė turi būti žvaigždute (*) ar kableliu atskirtų laukelio pavadinimų sąrašas. Svarbu: Šie svetainės nustatymai yra būtini. Jei šio nustatymo nėra, matysite klaidą „Nėra šiam objektui nustatytų laukelių." |
| WebAPI/error/innererror | Įjungia ar išjungia vidinę klaidą. Numatytoji reikšmė: False Galiojančios vertės: True, False |
| Webapi/<table name>/disableodatafilter | Įjungia arba išjungia „OData“ filtrą. Numatytoji reikšmė: False Tinkamos reikšmės: True, False Žr. žinomos problemos, jei reikia daugiau informacijos. Svetainės parametras pasiekiamas portalo versijoje 9.4.10.74 arba naujesnėje. |
Pastaba
Svetainės parametrai turi būti nustatyti kaip Aktyvūs, norint, kad jie įsigaliotų.
Pavyzdžiui, kad būtų rodoma atvejo lentelės žiniatinklio API, kurioje autentifikuotiems vartotojams leidžiama atlikti šio objekto kūrimo, naujinimo ir naikinimo operacijas, svetainės parametrai parodyti toliau pateiktoje lentelėje.
| Svetainės pavadinimo nustatymas | Svetainės nustatymo vertė |
|---|---|
| Webapi/incident/enabled | teisinga |
| Webapi/incident/fields | attr1, attr2, attr3 |
Saugumas su portalų žiniatinklio API
Galite konfigūruoti įrašais pagrįstą saugą atskiriems portalų įrašams naudodami lentelių teises. Portalų žiniatinklio API pasiekia lentelės (objektas) įrašus ir vadovaujasi lentelės teisėmis, suteiktomis vartotojams per susietą žiniatinklio vaidmenį.
Galite sukonfigūruoti stulpelių teises norėdami toliau apibrėžti atskirų lentelės stulpelių teises naudodami portalų žiniatinklio API.
Portalų žiniatinklio API užklausų autentifikavimas
Jums nereikia įtraukti autentifikavimo kodo, nes autentifikavimą ir įgaliojimą valdo programos seansas. Visi žiniatinklio API skambučiai turi apimti kryžminės svetainės užklausos klastojimo (CSRF) žymą.
EntitySetName naudojimas
Nurodant„ Dataverse“ lenteles naudojant portalų žiniatinklio API savo kode, jums reikės naudoti EntitySetName, pavyzdžiui, norint pasiekti paskyros lentelę; kodo sintaksė naudos paskyrų EntitySetName; /_api/accounts().
Pastaba
Naudokite lentelės loginį pavadinimą svetainės parametrams (pavyzdžiui, paskyra).
Galite nustatyti konkrečių lentelių EntitySetName atlikdami šiuos veiksmus:
Eikite į „https://make.powerapps.com“
Pasirinkite skirtuką Dataverse iš šoninio skydo ir pasirinkite lentelę.
Pasirinkite ... (Komandų parinktis) ir Išplėstinis, Įrankiai, Kopijuoti rinkinio pavadinimą norėdami nukopijuoti lentelės EntitySetName į savo mainų sritį.
Bendrasis duomenų apsaugos reglamentas (BDAR)
Visos užklausos antraštės turės kontaktinį ID, perduotą tikrinimo tikslais. Anoniminiam vartotojui, jis bus patikrintas kaip null.
Jei auditavimo prisijungimas yra įjungtas, vartotojas gali matyti visus audito įvykius „Office 365“ audito žurnale.
Daugiau informacijos:
Veiklos registravimo įjungimas ir naudojimas
Tikrinimo žurnalo įrašų eksportavimas, konfigūravimas ir peržiūra
Nepalaikomos konfigūracijos lentelės
Portalų žiniatinklio API negalima naudoti šiose konfigūracijos lentelėse:
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
Žinomos problemos
Vartotojai gaus CDS klaidą, jeigu iškvies GET žiniatinklio API užklausą lentelėms, kuriose yra keletas 1 su daugeliu arba daugelis su daugeliu lentelės teisių lygių su apibrėžta pirmine aprėptimi.
Norint išspręsti šią problemą, „OData“ užklausoje rekomenduojama naudoti FetchXML.
Arba nustatykite svetainės nuostatą Webapi/<table name>/disableodatafilter į True.
Svarbu
Pakeitus svetainės nuostatą Webapi/<table name>/disableodatafilter į True žiniatinklio API GET iškvietos gali veikti lėčiau.
Svetainės parametras pasiekiamas portalo versijoje 9.4.10.74 arba naujesnėje.
Tolesnis veiksmas
Užklausų duomenys naudojant portalų žiniatinklio API
Taip pat žr.
HTTP užklausų kūrimas ir klaidų taisymas
Portalų rašymo, naujinimo ir naikinimo operacijos su žiniatinklio API
Mokymo priemonė: portalo žiniatinklio API naudojimas
Pastaba
Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)
Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).