Dataverse Liquid žymos

Microsoft Dataverse Liquid žymės naudojamos norint įkelti ir rodyti Dataverse duomenis arba naudoti kitas Power Pages portalų sistemos paslaugas. Šios žymės yra „Dataverse“ skirti „Liquid“ kalbos plėtiniai.

diagrama

Įtraukite Power Apps grafiką į žiniatinklio puslapį į modeliu pagrįstą programą. Diagramos žymę galima įtraukti į tinklalapio lauką Kopijuoti arba žiniatinklio šablono lauką Šaltinis. Instrukcijas, kaip Power Apps diagramą įtraukti į tinklalapį, rasite dalyje Diagramos įtraukimas į portalo žiniatinklio puslapį Power Pages.

{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}

Parametrai

Diagramos žymėje turi būti nurodyti du parametrai: chart id ir viewid.

Diagramos ID

Diagramos visualizavimo ID. ID galite gauti eksportuodami diagramą.

ViewID

Lentelės ID, rodomas atidarius jį rodinių rengyklėje.

powerbi

Įtraukia „Power BI“ ataskaitų sritis ir ataskaitas į puslapius. Žymę galima įtraukti į tinklalapio lauką Kopija arba žiniatinklio šablono lauką Šaltinis. ataskaitos arba ataskaitų srities įtraukimo į portalo tinklalapį veiksmus žr. Power BI skirtus Power Pages, žr. Įtraukti Power BI ataskaitos arba ataskaitų srities įtraukimas į portalo tinklalap Power Pages.

Parametrai

„powerbi“ žymė priima šiuos parametrus:

kėlias

„Power BI“ ataskaitos arba ataskaitų srities kelias. Jei „Power BI“ ataskaita arba ataskaitų sritis yra saugi, turite nurodyti autentifikavimo tipą.

{% 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“ ataskaitai arba ataskaitų sričiai reikalingas autentifikavimo tipas. Tinkamos šio parametro reikšmės:

• Anonimas: leidžia įterpti Publikavimas žiniatinklyje Power BI ataskaitas. Numatytasis autentifikavimo tipas yra Anoniminis. Kai autentifikavimas naudojamas kaip anoniminis, būtina gauti „Power BI“ ataskaitos URL, kaip aprašyta: Publikavimas žiniatinklyje naudojant „Power BI“

• AAD: leidžia bendrinti saugias Power BI ataskaitas ar ataskaitų sritis su Power BI Microsoft Entra ID autentifikuotais vartotojais.

• powerbiembedded: leidžia bendrinti saugias Power BI ataskaitas arba ataskaitų sritis išoriniams vartotojams, kurie neturi Power BI licencijos ar Microsoft Entra autentifikavimo sąrankos. Informacijos apie „Power BI Embedded“ paslaugos sąranką ieškokite Paslaugos „Power BI Embedded“ įjungimas.

Kai pridedate saugią Power BI ataskaitą arba ataskaitų sritį, įsitikinkite, kad ji bendrinama su Power Pages Microsoft Entra "Or Power BI Embedded " paslaugomis.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

Taip pat galite filtruoti ataskaitą pagal vieną arba daugiau reikšmių. Ataskaitos filtravimo sintaksė yra:

URL?filter=Table/Field eq 'value'

Pvz., tarkime, norite filtruoti ataskaitą, kad pamatytumėte kontakto, vardu Bert Hair, duomenis. Prie URL turite pridėti šiuos duomenis:

?filter=Executives/Executive eq 'Bert Hair'

Visas kodas yra:

{% 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'" %}

Daugiau informacijos apie ataskaitos filtravimą: Ataskaitos filtravimas naudojant užklausos eilutės parametrus URL

Taip pat galite sukurti dinaminį kelią naudodami skystąjį capture kintamąjį:

{% 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 %}

Daugiau informacijos apie kintančius kintamuosius: Kintamosios žymės

Tileidas

Rodoma tam tikra ataskaitų srities plytelė. Turite pateikti plytelės 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" %}

Vaidmenys

„Power BI“ ataskaitai priskirti vaidmenys. Šis parametras veikia tik kai parametras authentication_type yra nustatytas į powerbiembedded.

Jei apibrėžėte vaidmenis Power BI ir priskyrėte juos ataskaitoms, turite nurodyti atitinkamus vaidmenis "powerbi Liquid" žymėje . Vaidmenys leidžia filtruoti ataskaitoje rodomus duomenis. Galite nurodyti kelis vaidmenis atskirdami juos kableliu. Daugiau informacijos apie „Power BI“ vaidmenų nustatymą ieškokite Eilutės lygio sauga (RLS) naudojant „Power BI“.

{% 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" %}

Jei ataskaitai Power BI priskyrėte vaidmenį ir nenurodėte vaidmenų parametro žymėje Liquid arba parametre nenurodėte vaidmens, rodoma klaida.

redaguojama

Vartotojams, kurie turi atitinkamo objekto turinio redagavimo teises, pateiktas Power Pages portalų CMS objektas generuojamas kaip redaguojamas portale. Redaguojami objektai: puslapis, fragmentai ir žiniatinklio saitai.

{% 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 %}

Parametrai

Pirmasis redaguojamas parametras yra redaguojamas objektas, pvz., žiniatinklio saitų rinkinys, fragmentai ar dabartinis puslapis. Pasirinktinis antrasis parametras nurodo atributo pavadinimą arba raktą objekte, kuris turi būti sugeneruotas ir suredaguotas. Ši reikšmė gali būti, pavyzdžiui, lentelės atributo pavadinimas arba fragmentas pavadinimas.

Po šių pradinių parametrų žymė palaiko daug pasirinktinių pavadintų parametrų.

klasė

Nurodo šios žymės sugeneruoto šakninio elemento klasės atributo reikšmę.

Numatytasis

Numatytoji reikšmė, sugeneruota tuo atveju, kai redaguojamas elementas neturi reikšmės.

ištrūkti

Bulio logikos reikšmė, nurodanti, ar šios žymės sugeneruota reikšmė yra užkoduota HTML. Pagal numatytuosius nustatymus ši reikšmė yra „false“.

skystis

Bulio logikos reikšmė, nurodanti, ar reikia apdoroti bet kurį "Liquid" šablono kodą, esantį šios žymos pateiktoje teksto vertėje. Pagal numatytuosius nustatymus ši reikšmė yra „true“.

žymė

Konteinerio HTML žymių, kurias pateikia ši žymė, pavadinimas. Ši žyma pagal numatytuosius nustatymus pateikia div elementus. Rekomenduojama pasirinkti šio parametro reikšmę „div“ arba „span“.

Konteinerio HTML žymių, kurias pateikia ši žymė, pavadinimas. Ši žymė pateikia div elementus pagal numatytuosius nustatymus. Rekomenduojama pasirinkti vieną iš div šio parametro arba span jį.

titulinis

Nurodo šio redaguojamo elemento etiketę turinio redagavimo sąsajoje. Jei jų nėra, draugiška etiketė sugeneruojama automatiškai.

rūšis

Eilutės reikšmė, kuri rodo, kokio tipo redagavimo sąsaja turi būti pateikta redaguojamo teksto reikšmėms. Tinkamos šio parametro reikšmės yra html arba tekstas. Numatytoji nuostata yra html.

entitylist

Įkelia pateiktą sąrašą pagal pavadinimą arba ID. Tada sąrašo ypatybes galima pasiekti naudojant objektų sąrašo objektą , pasiekiamą žymių bloke. Norėdami sugeneruoti sąrašo faktinių rezultatų įrašus, tame bloke naudokite „entityview” žymę.

Jei sąrašas sėkmingai įkeltas, generuojamas bloko turinys. Jei sąrašas nerastas, bloko turinys negeneruojamas.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Pagal numatytuosius nustatymus objektų sąrašo objektui suteikiamas kintamojo pavadinimo objektų sąrašas. Jei reikia, gali būti suteiktas kitas kintamojo pavadinimas.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Parametrai

Pateikite tik vieną ID, pavadinimą arba raktą, kad pasirinktumėte įkelti Sąrašą.

Id

Įkeltas sąrašas pagal GUID ID. turi būti eilutė, kurią būtų galima išanalizuoti kaip GUID.

{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Paprastai nenaudojamos pažodinės GUID eilutės. Vietoj to ID nurodomas naudojant kito kintamojo GUID ypatybę.

{% entitylist id:page.adx_entitylist.id %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

vardas, pavadinimas

Įkelia sąrašą pagal pavadinimą.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

raktas

Įkelia sąrašą pagal ID arba pavadinimą. Jei pateiktą rakto reikšmę galima išanalizuoti kaip GUID, sąrašas įkeliamas pagal ID. Priešingu atveju jis įkeliamas pagal pavadinimą.

<!-- key_variable can hold an ID or name -->

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

language_code

„Dataverse“ sveikojo skaičiaus kalbos kodas yra skirtas pasirinkti, kurias sąrašo lokalizuotas žymas reikia įkelti. Jei language_code nepateikiama, naudojama numatytoji svetainės taikomosios programos Dataverse ryšio kalba.

{% entitylist name:"My List", language_code:1033 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Įkelia pateiktą „Dataverse“ rodinį pagal pavadinimą arba ID. Tada rodinio ߝ peržiūros stulpelio metaduomenų, puslapių rezultatų įrašų ir kt. ypatybes galima pasiekti naudojant objekto peržiūros objektą , kuris yra pasiekiamas žymų bloke.

Jei rodinys sėkmingai įkeltas, generuojamas bloko turinys. Jei rodinys nerastas, bloko turinys negeneruojamas.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Pagal numatytuosius nustatymus objekto rodinio objektui suteikiamas kintamojo pavadinimas objekto rodinys. Jei reikia, gali būti suteiktas kitas kintamojo pavadinimas.

{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ my_view.total_records }} total records.

{% endentityview %}

Jei objekto rodinys įdėtas į objektų sąrašo bloką, jis iš sąrašo paveldi numatytąją konfigūraciją (rezultato puslapio dydį, filtro parinktis ir kt.). Jei objekto rodiniui nepateikiami jokie rodinio ID arba pavadinimo parametrai, jis įkelia numatytąjį rodinį iš pridedamo objektų sąrašo.

{% 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 %}

Parametrai

Pateikite arba id or logical_name su pavadinimu, kad pasirinktumėte Dataverse įkeltiną rodinį. Jei nė vienas iš jų nepateikiamas, o objekto rodinio žymė įdėta į objektų sąrašo žymę, įkeliamas numatytasis pridedamo objektų sąrašo rodinys.

Id

ID turi būti eilutė, kurią būtų galima išanalizuoti kaip GUID.

{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Paprastai nenaudojamos pažodinės GUID eilutės. Vietoj to ID nurodomas naudojant kito kintamojo GUID ypatybę.

{% entityview id:request.params.view %}

Loaded entity view {{ entityview.name }} using view query string request parameter.

{% endentityview %}

logical_name

Rodinio, kurį reikia įkelti, „Dataverse“ objekto loginis pavadinimas. Turi būti naudojama kartu su pavadinimu.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

vardas, pavadinimas

Rodinio, kurį reikia įkelti, „Dataverse“ pavadinimas. Turi būti naudojama kartu su logical_name.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

filtras

Nurodo, ar rodinio rezultatus filtruoti pagal vartotoją, ar klientą. Eilutės reikšmė turi būti „vartotojas“ arba „klientas“.

{% entityview id:request.params.view, filter:'user' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą.

{% entityview id:request.params.view, filter:request.params.filter %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

metafiltras

Nurodo Sąrašo metaduomenų filtro išraišką, pagal kurią turi būti filtruojami rodinio rezultatai. Šis parametras galioja tik tada, kai „entityview“ naudojamas kartu su „entitylist“. Daugeliu atvejų šis parametras nustatomas pagal užklausą.

{% 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 %}

įsakymas

Nurodo rūšiavimo išraišką rodinio rezultatams išdėstyti. Rūšiavimo išraiška gali apimti vieną ar daugiau objekto atributų loginių pavadinimų, po kurių seka ASC arba DESC rūšiavimo kryptis.

{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą.

{% entityview id:request.params.view, order:request.params.order %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

puslapis

Nurodo rodinio rezultatų puslapį, kurį reikia įkelti. Jei šis parametras nenurodytas, įkeliamas pirmasis rezultatų puslapis.

Šiam parametrui turi būti perduota sveikojo skaičiaus reikšmė arba eilutė, kurią galima išanalizuoti kaip sveikąjį skaičių. Jei šio parametro reikšmė pateikta, bet reikšmė yra nulinė arba jos negalima analizuoti kaip sveikojo skaičiaus, įkeliamas pirmasis rezultatų puslapis.

{% entityview id:request.params.view, page:2 %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą.

{% 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

Nurodo, kiek rezultatų įkelti esamame rezultatų puslapyje. Jei šiam parametrui nepateikta jokia reikšmė, o objekto rodinys naudojamas objektų sąrašo bloke , naudojamas sąrašo puslapio dydis. Jei ne objektų sąrašo bloke, naudojama numatytoji reikšmė 10.

Šiam parametrui turi būti perduota sveikojo skaičiaus reikšmė arba eilutė, kurią galima išanalizuoti kaip sveikąjį skaičių. Jei šiam parametrui pateikta reikšmė, bet reikšmė yra nulinė arba jos negalima išanalizuoti kaip sveikojo skaičiaus, naudojamas numatytasis puslapio dydis.

{% entityview id:request.params.view, page_size:20 %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą.

{% entityview id:request.params.view, page_size:request.params.pagesize %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

ieškoti

Nurodo ieškos išraišką, pagal kurią turi būti filtruojami rodinio rezultatai. Paprastos raktinių žodžių paieškos išraiškos filtruoja pagal tai, ar atributai prasideda raktiniu žodžiu. Pakaitos simbolius * taip pat galima įtraukti į išraišką.

{% entityview id:request.params.view, search:'John\*' %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą, kad ieškos filtrą būtų galima nustatyti pagal vartotojo įvestį.

{% entityview id:request.params.view, search:request.params.search %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

language_code

„Dataverse“ sveikojo skaičiaus kalbos kodas, skirtas įkeltinoms objekto rodinio lokalizuotoms etiketėms pasirinkti (stulpelių antraščių etiketės ir kt.). Jei language_code nepateikiama, naudojama numatytoji svetainės programos Dataverse ryšio kalba.

Jei objekto rodinys naudojamas objektų sąrašo bloke, objekto rodinys paveldi kalbos kodo konfigūraciją iš objektų sąrašo.

{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Atlieka užklausą dėl portalo ieškos rodyklės. Tada atitinkančius rezultatus galima pasiekti naudojant paieškos indeksą , kuris pasiekiamas žymų bloke.

{% 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>

Pagal numatytuosius nustatymus paieškos indekso objektui suteikiamas kintamojo pavadinimo paieškos indeksas. Jei reikia, gali būti suteiktas kitas kintamojo pavadinimas.

{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}

{% if liquid_search.results.size > 0 %}

...

{% endif %}

{% endsearchindex %}

Parametrai

„Searchindex“ žymė priima šiuos parametrus.

užklausa

Užklausa, naudojama rezultatams sugretinti. Šis parametras skirtas priimti rodyklės užklausos vartotojo nurodytą dalį (jei yra).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą.

{% searchindex query: request.params.query %}

...

{% endsearchindex %}

Šis parametras palaiko „Lucene“ užklausos analizatoriaus sintaksę.

filtras

Kita užklausa, naudojama rezultatams atitikti. Šis parametras skirtas, jei pageidaujama, priimti kūrėjo nurodytą rezultatų filtrą.

{% searchindex query: request.params.query, filter: '+statecode:0' %}

...

{% endsearchindex %}

Šis parametras palaiko „Lucene“ užklausos analizatoriaus sintaksę.

logical_names

Objekto Dataverse loginiai pavadinimai, kuriems taikomi sutampantys rezultatai, kaip kableliais atskirta eilutė. Jei nepateikta, grąžinami visi atitinkantys objektai.

{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}

...
>
{% endsearchindex %}

puslapis

Ieškos rezultatų puslapis, kuris turi būti pateiktas. Jei nepateikta, grąžinamas pirmasis puslapis (1).

{% searchindex query: request.params.query, page: 2 %}

...

{% endsearchindex %}

Bendras naudojimo atvejis yra nustatyti šį parametrą pagal užklausą.

{% searchindex query: request.params.query, page: request.params.page %}

...

{% endsearchindex %}

page_size

Ieškos rezultatų puslapis, kuris turi būti pateiktas. Jei nepateikta, naudojamas numatytasis dydis 10.

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

entityform

Sugeneruoja visą formą pagal pavadinimą ar ID.

{% entityform name: 'My Basic Form' %}

Parametrai

vardas, pavadinimas

Norimos įkelti Paprastosios formos pavadinimas.

{% entityform name:My Basic Form %}

webform

Sugeneruoja visą kelių veiksmų formą pagal pavadinimą ar ID. „Webform“ žymę galima naudoti tik turinyje, kuris sugeneruotas žiniatinklio šablonu pagrįstame puslapio šablone. Bandant naudoti žymę perrašymu pagrįstame puslapio šablone, nieko neatvaizduojama. Viename puslapyje galite generuoti tik vieną objekto arba žiniatinklio formos žymą. Objekto formos arba žiniatinklio formos žymės po pirmosios nėra generuojamos.

{% webform name: 'My Multistep Form' %}

Parametrai

vardas, pavadinimas

Norimos įkelti kelių veiksmų formos pavadinimas.

{% webform name:My Multistep Form %}

kodokomponentas

Leidžia įdėti kodo komponentus naudojant likvidžią žymę. Pavyzdžiui, į tinklalapį įtraukus struktūros rodomą pasirinktinį valdiklį.

Parametrai

vardas, pavadinimas

Kodo komponento ID arba pavadinimas.

nuosavybė

Ypatybių reikšmes, kurių tikisi kodo komponentas, reikia perduoti kaip rakto / reikšmės porą, atskirtą dvitaškiu (:), kur raktas yra ypatybės pavadinimas, o reikšmė yra JSON eilutės reikšmė.

{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

Žr. Kodo komponentų likvidžios šablono žymos naudojimas.

Taip pat žr.

• Srauto žymių valdymas
• Iteracijos žymės
• Kintamosios žymos
• Šablono žymės