Dataverse Liquid sildid
Microsoft Dataverse Liquidi silte kasutatakse rakenduse Dataverse andmete laadimiseks ja kuvamiseks või muude teenuse Power Pages raamistikuteenuste kasutamiseks. Need sildid on Dataverse-i-spetsiifilised laiendid Liquid-keelele.
Diagramm
Võimaldab lisada veebilehele rakenduse Power Apps Embeddedi lehe lisamine mudelipõhisele rakendusele mudelipõhise rakenduste graafiku. Diagrammi sildi saab lisada veebilehe väljal Koopia või veebimalli väljal Allikas. Etapid teenuse Power Apps mudelipõhise rakenduse diagrammi lisamiseks veebilehele on esitatud jaotises Diagrammi lisamine veebilehele teenuses Power Pages.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parameetrid
Diagrammi sildile tuleb lisada kaks parameetrit: diagrammi ID ja vaate ID.
diagrammi id
Diagrammi visualiseerimise ID. ID saamiseks eksportige diagramm.
viewid
Vaateredaktoris avatud tabeli ID.
powerbi
Lisab lehtedele Power BI armatuurlauad ja aruanded. Silti saab lisada veebilehe koopiaväljalt või veebimalli lähteväljalt. Juhiseid selle kohta, kuidas teenuses Power Pages veebilehele lisada Power BI aruanne või armatuurlaud, vt Power BI aruande või armatuurlaua lisamine teenuse Power Pages veebilehele.
Märkus.
Selleks, et silt toimiks, peate lubama Power BI integreerimise teenuse Power Pages keskusest, mis asub halduskeskuses Power Platform. Kui Power BI integratsioon pole lubatud, armatuurlauda või aruannet ei kuvata.
Parameetrid
Silt powerbi aktsepteerib järgmisi parameetreid:
tee
Power BI aruande või armatuurlaua tee. Kui Power BI aruanne või armatuurlaud on kaitstud, peate sisestama autentimistüübi.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
authentication_type
Power BI aruande või armatuurlaua jaoks nõutud autentimistüüp. Sobivad väärtused selle parameetri jaoks on.
Anonüümne: võimaldab manustada veebi avaldamise Power BI aruandeid. Vaikimisi autentimise tüüp on Anonüümne. Kui kasutate autentimistüüpi anonüümne, peate tooma Power BI aruande URL-i, nagu on kirjeldatud lehel Avaldamine veebivormiPower BI
AAD: võimaldab jagada turvalisi Power BI aruandeid või armatuurlaudu ID autenditud kasutajatele Power BI Microsoft Entra .
powerbiembedded: võimaldab teil jagada turvalisi Power BI aruandeid või armatuurlaudu väliskasutajatele, kellel pole Power BI litsentsi või Microsoft Entra autentimise seadistust. Teabe saamiseks Power BI Embedded teenuse seadistamise kohta vt Power BI Embedded teenuse lubamine.
Turvalise Power BI aruande või armatuurlaua lisamisel veenduge, et seda jagataks or-teenustega Power Pages Microsoft Entra Power BI Embedded .
Märkus.
Parameetri authentication_type väärtused on tõstutundlikud.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Samuti saate aruandeid ühe või mitme väärtuse alusel filtreerida. Aruande filtreerimise süntaks on
URL?filter=Tabel/Väli eq 'väärtus'
Näiteks oletame, et soovite filtreerida aruannet, et näha kontakti nimega Bert Hair andmeid. Peate lisama järgnevate andmetega URL-i.
?filter=Tegevjuht/tegevjuhid eq 'Bert Hair'
Täielik kood on:
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}
Aruande filtreerimise kohta leiate lisateavet teemast Aruande filtreerimine URL-is päringustringi parameetreid kasutades
Märkus.
Anonüümne aruanne filtreerimist ei toeta.
Dünaamilise tee saate luua ka muutuja Liquid abil capture :
{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}
Lisateavet likviidsete muutujate kohta leiate teemast Muutuja sildid
tileid
Kuvab armatuurlaua teatud paani. Peate sisestama paani ID.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}
rollid
Power BI aruandele määratud rollid. See parameeter töötab ainult juhul, kui parameetri authentication_type väärtuseks on seatud powerbiembedded.
Kui olete Power BI-s rollid määratlenud ja need aruannetesse määranud, peate vastavad rollid powerbi Liquidi sildil täpsustama. Rollid võimaldavad filtreerida aruandes kuvatavaid andmeid. Komaga eraldatuna saate määrata mitu rolli. Lisateabe saamiseks Power BI-s rollide määratlemise kohta vt Rea tasemel turve (RLS) Power BI-ga.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}
Kui määrate Power BI aruandele rolli, kuid parameetrit rollid Liquid sildil ei ole täpsustatud või rolli parameetris määratud, kuvatakse veateade.
Jootraha
Kui soovite kasutada enda saidil määratletud veebirolle Power BI rollidena, saate luua muutuja ja sellele veebirolle määrata. Seejärel saate määratud muutujat Liquid sildil kasutada.
Oletame, et olete oma saidil määratlenud kaks veebirolli Region_East ja Region_West. Nendega saate liituda kasutades koodi:{% assign webroles = user.roles | join: ", " %}
Ülaltoodud koodi väljavõttes on webroles muutuja ning selles talletatakse Region_East ja Region_West veebirolle.
Kasutage webroles muutujat Liquid sildis järgmiselt.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}
redigeeritav
Renderdab antud teenuse Power Pages CMS-objekti saidil redigeeritavaks kasutajatele, kellel on selle objekti sisu redigeerimise õigus. Redigeeritavate objektide hulka kuuluvad leht, koodilõigud ja veebilingid .
{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}
{% editable snippets Header type: 'html' %}
<!--
An editable web link set required a specific DOM structure, with
certain classes on the containing element, as demonstrated here.
-->
{% assign primary_nav = weblinks[Primary Navigation] %}
{% if primary_nav %}
<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>
<ul>
<!-- Render weblinks... -->
</ul>
{% editable primary_nav %}
</div>
{% endif %}
Parameetrid
Esimene redigeeritav parameeter on redigeeritav objekt, nt veebilinkide kogum, koodilõigud või praegune leht. Väljund See väärtus võib olla tabeliatribuudi nimi või näiteks lõigend nimi.
Pärast esialgseid parameetreid toetab silt paljusid valikulisi nimega parameetreid.
klass
Täpsustab klassi atribuudi väärtuse selle sildi poolt renderdatava juurelemendi jaoks.
vaikesäte
Renderdatud vaikeväärtus juhul, kui redigeeritaval üksusel pole väärtust.
pääs
Loogikaväärtus, mis näitab, kas selle sildi renderdatud väärtus on HTML-kodeeringus. See väärtus on vaikimisi väär.
liquid
Boole’i väärtus, mis näitab, kas selle sildi renderdatud tekstiväärtusest leitud vedela malli koodi tuleks töödelda. See väärtus on vaikimisi tõene.
silt
Selle sildi renderdatud konteineri HTML-siltide nimi. See silt renderdab vaikimisi div-elemente. Selle parameetri puhul soovitatakse valida väärtuste div või vahe vahel.
pealkiri
Määrab sellele redigeeritavale kirjele sisu redigeerimise liideses märgise. Kui seda ei pakuta, luuakse automaatselt sõbralik silt.
tüüp
Stringi väärtus, mis näitab esitatava redigeerimisliidese tüüpi redigeeritavate tekstiväärtuste jaoks. Sobiv väärtus selle parameetri jaoks on html või text. Vaikesäte on html.
olemiloend
Laadib antud loendi nime või ID järgi. Loendi atribuutidele pääseb seejärel juurde olemiloendi objekti abil, mis on saadaval sildiplokis. Loendi tegelike tulemuste kirjete renderdamiseks kasutage ploki olemivaate silti.
Kui loendi laadimine õnnestub, renderdatakse ploki sisu. Kui loendit ei leita, siis ploki sisu ei renderdata.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Vaikimisi antakse olemiloendi objektile muutuja nimi olemiloend. Soovi korral võib määrata teise nime.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parameetrid
Loendi laadimiseks valige ainult üks ID, nimi või võti.
id
Laeb GUID-i loendi ID. id peab olema string, mida saab sõeluda GUID-na.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Üldiselt ei kasutata sõnasõnalisi GUID-stringe. Selle asemel määratakse id, kasutades teise muutuja GUID-atribuuti.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
nimi
Laadib loendi nime kaudu.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
võti
Laadib loendi ID või nime järgi. Kui esitatud võtme väärtust saab sõeluda GUID-na , laaditakse loend ID-ga. Vastasel juhul laaditakse see nime järgi.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
Dataverse-i täisarvuline keelekood loendi lokaliseeritud siltide laadimiseks valimiseks. Kui language_code ei esitata, kasutatakse saidirakenduse Dataverse ühenduse vaikekeelt.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Laadib antud Dataverse-i vaate nime või ID järgi. Vaate atribuutidele ߝ vaateveeru metaandmed, lehitsetud tulemikirjed jne pääseb seejärel juurde olemivaate objekti abil , mis on saadaval sildiplokis.
Kui vaade on edukalt laaditud, renderdatakse ploki sisu. Kui vaadet ei leita, siis blokeeritavat sisu ei renderdata.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Vaikimisi antakse objektile olemivaade muutuja nimi olemivaade. Soovi korral võib määrata teise nime.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Kui olemivaade on pesastatud olemiloendi plokis, pärib see loendist selle vaikekonfiguratsiooni (tulemuse lehekülje suurus, filtrisuvandid jne). Kui olemivaatele ei esitata vaate ID ega nime parameetreid, laadib see vaikevaate ümbritsevast olemiloendist.
{% entitylist id:page.adx_entitylist.id %}
{% entityview %}
Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.
{% endentityview %}
{% endentitylist %}
Parameetrid
Andke kas id või logical_name koos nimega, et valida rakenduse Dataverse vaade, mida laadida. Kui kumbagi pole pakutud ja olemivaate märgend on pesastatud olemiloendi sildi sisse, laaditakse ümbritseva olemiloendi vaikevaade.
id
id peab olema string, mida saab sõeluda GUID-na.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
Üldiselt ei kasutata sõnasõnalisi GUID-stringe. Selle asemel määratakse id, kasutades teise muutuja GUID-atribuuti.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
Laaditava vaate Dataverse-i olemi loogiline nimi. Tuleb kasutada koos üksusega nimi.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
nimi
Laaditava vaate Dataverse-i nimi. Tuleb kasutada koos üksusega logical_name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Määrab, kas vaate tulemused filtreeritakse kasutaja või konto järgi. Kasutaja või konto stringiväärtus peab olemas olema.
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Tavaliselt määratakse see parameeter taotluse järgi.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Määrab loendi metaandmete filtri väljenduse, mille järgi vaate tulemusi filtreeritakse. See parameeter kehtib ainult siis, kui koos olemiloendiga on kasutusel olemivaade. Enamasti määratakse see parameeter taotluse järgi.
{% entitylist id:page.adx_entitylist.id %}
{% entityview id:request.params.view, metafilter:request.params.mf %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
{% endentitylist %}
tellimus
Määrab vaate tulemuste tellimiseks sortimisavaldise. Sortimisavaldis sisaldab ühe või mitme olemiatribuudi loogilisi nimesid, millele järgneb ASC või DESC sortimissuund.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Tavaliselt määratakse see parameeter taotluse järgi.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
leht
Määrab laaditava vaate tulemuste lehe. Kui seda parameetrit pole määratud, laaditakse tulemuste esimene leht.
See parameeter tuleb edastada täisarvulise väärtuse või stringina, mida saab täisarvuna sõeluda. Kui selle parameetri jaoks on ette nähtud väärtus, kuid väärtus on null või seda ei saa muul viisil täisarvuna sõeluda, laaditakse tulemuste esimene leht.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Tavaliselt määratakse see parameeter taotluse järgi.
{% entityview id:request.params.view, page:request.params.page %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page_size
Määrab praegusel tulemuse lehel laaditavate tulemuste arvu. Kui sellele parameetrile pole väärtust antud ja olemivaadet kasutatakse olemiloendi plokis , kasutatakse loendilehe suurust. Kui olemiloendi plokis pole, kasutatakse vaikeväärtust 10.
See parameeter tuleb edastada täisarvulise väärtuse või stringina, mida saab täisarvuna sõeluda. Kui selle parameetri jaoks on ette nähtud väärtus, kuid väärtus on null või seda ei saa muul viisil täisarvuna sõeluda, kasutatakse lehekülje vaikesuurust.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Tavaliselt määratakse see parameeter taotluse järgi.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
otsing
Määrab otsinguavaldise, mille järgi vaate tulemusi filtreerida. Lihtsad märksõnaotsingu avaldised filtreerivad selle järgi, kas atribuudid algavad märksõnaga. Avaldises saab kasutada ka metamärke *.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Tavaliselt määratakse see parameeter taotluse järgi, et otsingufiltrit oleks võimalik määrata kasutaja sisendi põhjal.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
Dataverse-i täisarvuline keelekood laaditavate olemivaate lokaliseeritud siltide (veergude pealkirjade siltide jne) valimiseks. Kui language_code ei esitata, kasutatakse veebisaidi rakenduse Dataverse ühenduse vaikekeelt.
Kui olemivaadet kasutatakse olemiloendi plokis, pärib olemivaade selle keelekoodi konfiguratsiooni olemiloendist.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Teeb päringu veebisaidi otsingu registri suhtes. Seejärel pääseb vastavatele tulemustele juurde sildiplokis saadaoleva searchindexi abil.
{% searchindex query: 'support', page: params.page, page_size: 10 %}
{% if searchindex.results.size > 0 %}
<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>
<ul>
{% for result in searchindex.results %}
<li>
<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>
<p>{{ result.fragment }}</p>
</li>
{% endfor %}
</ul>
{% else %}
<p>Your query returned no results.</p>
{% endif %}
{% endsearchindex %}
<style>
.highlight {background-color: #FFFCAC;}
</style>
Vaikimisi antakse otsinguindeksi objektile muutuja nimi searchindex. Soovi korral võib määrata teise nime.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parameetrid
Silt otsinguregister aktsepteerib järgmisi parameetreid.
päring
Päringut kasutatakse tulemuste ühitamiseks. See parameeter peaks aktsepteerima kasutaja poolt määratud osa registripäringust (kui üldse).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Tavaliselt määratakse see parameeter taotluse järgi.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
See parameeter toetab Lucene'i päringu sõelasüntaksit.
filter
Teine päring, mida kasutatakse tulemite vastendamiseks. See parameeter peaks soovi korral aktsepteerima arendaja poolt tulemustele määratud filtrit.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
See parameeter toetab Lucene'i päringu sõelasüntaksit.
Märkus.
Erinevus üksuste filter ja päring vahel on, et kuigi mõlemad aktsepteerivad Lucene'i päringu sõelasüntaksit, on päringu süntaksi sõelumise suhtes leplikum ߝ, kuna eeldatakse, et enamik kasutajad ei ole sellest süntaksist teadlikud. Kui päringu sõelumine selle süntaksi järgi ebaõnnestub, pagendatakse kogu päring ja edastatakse päringu tekstina. filter aga sõelutakse rangelt ning vale süntaksi korral antakse vastuseks viga.
logical_names
Dataverse-i olemi loogilised nimed, millega ühtivad tulemused on piiratud, komaga eraldatud stringina. Kui seda ei esitata, tagastatakse kõik sobivad olemid.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
leht
Vastuseks antav otsingutulemuste leht. Kui seda ei esitata, tagastatakse esimene lehekülg (1).
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Tavaliselt määratakse see parameeter taotluse järgi.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
Vastuseks antava tulemuste lehe suurus. Kui seda ei esitata, kasutatakse vaikesuurust 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Renderdab vormi täielikult nime või ID järgi.
Märkus.
Silt olemivorm on saadaval ainult veebimalli-põhise lehemalli sees renderdatud sisus kasutamiseks. Kui seda silti proovitakse kasutada ümberkirjutamisel põhineva lehemalli sees, ei muuda see midagi. Renderdada võib ainult ühte olemivormi või veebivormi silti lehe kohta. Silte olemivorm või veebivorm pärast esimest ei renderdata.
{% entityform name: 'My Basic Form' %}
Parameetrid
nimi
Põhivormi nimi, mida soovite laadida.
{% entityform name:My Basic Form %}
veebivorm
Renderdab mitmeetapilise vormi täielikult nime või ID järgi. Veebivormi silti on võimalik kasutada ainult veebimallil põhineva lehemalli sees renderdatud sisu korral. Kui seda silti proovitakse kasutada ümberkirjutamisel põhineva lehemalli sees, ei renderdata midagi. Ühe lehe kohta saate renderdada ainult ühe olemivormi või veebivormi sildi. Olemivormi või veebivormi silte pärast esimest ei renderdata.
{% webform name: 'My Multistep Form' %}
Parameetrid
nimi
Mitmeastmelise vormi nimi, mida soovite laadida.
{% webform name:My Multistep Form %}
codecomponent
Võimaldab manustada manuskoodi komponente, kasutades Liquid silti. Näiteks saate lisada veebilehele kaardis kuvatava kohandatud juhtelemendi.
Parameetrid
nimi
Koodikomponendi ID või nimi.
atribuut
Nende atribuutide väärtused, mida koodikomponent eeldab, tuleb sisestada võtme/väärtuse paaridena, mis on eraldatud märgiga ":" (koolon), kus võti on atribuudi nimi ja väärtus on JSON-stringi väärtus.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Märkus.
Nõutavad atribuudid võivad sõltuvalt teie valitud komponendist olla erinevad.
Vaata teemat Koodikomponentide Liquidi mallisildi kasutamine.