Portalų žiniatinklio API apžvalga
Portalų žiniatinklio API įgalina platesnę vartotojo patirtį „Power Pages“ svetainėse. Naudodami žiniatinklio API galite atlikti kūrimo, skaitymo, naujinimo ir naikinimo operacijas visose „Microsoft Dataverse” lentelėse iš savo tinklalapių. Pavyzdžiui, galite sukurti naują abonementą, atnaujinti kontaktą, nesinaudodami forma ar kelių objektų formos naudodami žiniatinklio API portalą.
Svarbu
- Jūsų Power Pages svetainės versija turi būti 9.3.3.x ar vėlesnė kad veikų ši funkcija.
- 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 integruoti su kitomis svetainėmis Power Pages 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 Pages“ licencijos. Pavyzdžiui, anoniminių vartotojų atlikti žiniatinklio API skambučiai skaičiuojami anonimimo vartotojo pajėgumą. Autentifikuotų vartotojų (vidinių arba išorinių) žiniatinklio API skambučiai neskaičiuojami į puslapio rodinius, tačiau reikia naudoti taikomas autentifikuoto naudotojo apimities licencijas. Daugiau informacijos: Power Pages“ leidimų DUK.
Ž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 Power Pages
- Į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" /< lentelės pavadinimas> / įjungtas | Įjungia ar išjungia žiniatinklio API <lentelės pavadinimą>. Numatytasis: False Tinkamos reikšmės: True , False |
"Webapi" /< lentelės pavadinimas>/laukai | Nustato kableliu atskirtų savybių sąrašą, kuris gali būti keičiamas su žiniatinklio API. Galimos reikšmės: - Visi atributai: * - Būdingi atsibutai: 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ą. Numatytasis: False Tinkamos reikšmės: True , False |
"Webapi" /< lentelės pavadinimas>/duomenų filtro išjungimas | Įjungia arba išjungia „OData“ filtrą. Numatytasis: False Tinkamos reikšmės: True , False Žr. žinomos problemos kad gautumėte 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į.
Privatumo įstatymai ir taisyklės
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:
Veiklų registravimo įjungimas ir naudojimas
Eksportuoti, konfigūruoti ir peržiūrėti audito žurnalo įrašus.
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ą, jei iškvies GET
žiniatinklio API užklausą lentelėms, turinčioms kelis lygius nuo 1 iki daugelio arba nuo daugelio iki daugeliolentelių teisių, kai pirminės , kontaktinės arbapaskyros aprėptis į užklausą įtrauks papildomų sąlygų.
Norint išspręsti šią problemą, „OData“ užklausoje rekomenduojama naudoti FetchXML.
Arba nustatykite svetainės parametro Webapi/ lentelės< pavadinimas> / disableodatafilter reikšmę True
.
Svarbu
Pakeitus svetainės parametrą Webapi /<lentelės pavadinimas>/disableodatafilterTrue
, žiniatinklio API GET
iškvietimai gali sulėtinti efektyvumą.
Svetainės parametras pasiekiamas portalo versijoje 9.4.10.74 arba naujesnėje.
Tolesnis veiksmas
Užklausų duomenys naudojant portalų žiniatinklio API