Značky Dataverse Liquid

Značky Liquid Microsoft Dataverse sa používajú na načítanie a zobrazenie údajov Dataverse alebo použitie iných rámcových služieb Power Pages. Tieto značky sú Dataverse rozšírenia menlivého jazyku.

graf

Pridajte graf modelom riadenej aplikácie Power Apps na webovú stránku. Značku grafu sa môže pridať do poľa Kópia na webovej stránke alebo do poľa Zdroj na webovej šablóne. Kroky na pridanie grafu modelom riadenej aplikácie Power Apps na webovú stránku sú v časti Pridanie grafu na webovú stránku v Power Pages.

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

Parametre

Existujú dva parametre, ktoré sa poskytujú so značkou grafu: chart id a viewid.

id grafu

ID vizualizácie grafu. Identifikátor môžete získať exportovaním grafu.

viewid

ID tabuľky pri otvorení v editore zobrazení.

powerbi

Pridá tabule Power BI a zostavy v rámci stránok. Značku možno pridať do poľa Kópia na webovej stránke alebo do poľa Zdroj na webovej šablóne. Kroky na pridanie zostavy Power BI alebo tabule na webovú stránku v Power Pages sú uvedené v časti Pridanie zostavy služby Power BI alebo tabule na webovú stránku v Power Pages.

Parametre

Značka powerbi akceptuje nasledovné parametre:

cesta

Cesta k zostave Power BI alebo tabuli. Ak je zostava Power BI alebo tabuľa zabezpečená, musíte uviesť typ overenia.

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

autentifikačný_typ

Typ overenia je požadovaný pre zostavu Power BI alebo tabuľu. Platnými hodnotami pre tento parameter sú:

• Anonymné: Umožňuje vložiť publikovanie do webových Power BI prehľadov. Predvolený typ overenia je Anonymný. Ak používate typ overenia ako anonymný, musíte získať adresa URL zostavy Power BI, ako je opísaná na: Publikovanie na web z Power BI

• AAD: Umožňuje vám zdieľať zabezpečené Power BI zostavy alebo informačné panely s Power BI Microsoft Entra používateľmi s overením ID.

• powerbiembedded: Umožňuje vám zdieľať zabezpečené Power BI zostavy alebo informačné panely s externými používateľmi, ktorí nemajú Power BI licenciu alebo Microsoft Entra overenie nastavenie. Informácie o nastavení služby Power BI Embedded sa dozviete v časti Povolenie služby Power BI Embedded.

Keď pridáte zabezpečený Power BI prehľad alebo informačný panel, uistite sa, že je zdieľaný so službami Power Pages Microsoft Entra alebo Power BI Embedded .

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

Môžete tiež filtrovať správy na jednu alebo viacero hodnôt. Syntax na filter zostavy je:

URL?filter=Tabuľka/Pole rovná sa 'hodnota'

Povedzme, že chcete filtrovať zostavu na zobrazenie údajov pre kontakt s názvom Bert Hair. K adrese URL musíte pridať nasledovné údaje:

?filter=Executives/Executive eq 'Bert Hair'

Kompletný kód je:

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

Ďalšie informácie o filtrovaní zostavy: Filtrovanie zostavy pomocou parametrov reťazca dotazu v adrese URL

Dynamickú cestu môžete vytvoriť aj pomocou premennej capture Kvapalina:

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

Ďalšie informácie o menlivých premenných: Premenné značky

dlaždice

Zobrazí špecifikovanú dlaždicu tabule. Musíte zadať ID dlaždice.

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

rolí

Roly priradené k zostave Power BI. Tento parameter funguje len vtedy, keď je parameter authentication_type nastavený na powerbiembedded.

Ak ste definovali roly v Power BI a priradili ste ich k prehľadom, musíte príslušné roly špecifikovať v značke powerbi Liquid. Roly vám umožňujú filtrovať údaje, ktoré sa majú zobraziť v zostave. Môžete zadať viacero rolí oddelených čiarkou. Viac informácií o definovaní rolí v Power BI sa dozviete v časti Zabezpečenie na úrovni riadku (RLS) s 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" %}

Ak ste k prehľadu Power BI priradili rolu a nešpecifikovali ste parameter role v značke Liquid alebo ste nešpecifikovali rolu v parametra, zobrazí sa chyba.

upraviteľné

Zobrazuje daný objekt CMS Power Pages ako upraviteľný na lokalite pre používateľov, ktorí majú pre tento objekt oprávnenie na jeho úpravu. Upraviteľné objekty zahŕňajú stránka, úryvky a webové odkazy .

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

Parametre

Prvý parameter poskytnutý upraviteľnému objektu je upraviteľný objekt, ako napríklad množina webových prepojení, úryvky alebo aktuálna stránka. Voliteľný druhý parameter určuje názov atribútu alebo kľúč v rámci tohto objektu, ktorý má byť poskytnutý a upravovaný. Touto hodnotou môže byť napríklad názov atribútu tabuľky alebo názov úryvku.

Po týchto počiatočných parametroch podporuje označenie mnoho voliteľne pomenovaných parametrov.

trieda

Určuje hodnotu atribútu triedy hlavného prvku zobrazovaného touto značkou.

predvolená

Predvolená hodnota vykreslená v prípade, že upraviteľná položka nemá žiadnu hodnotu.

uniknúť

Boolovská hodnota označujúca, či je hodnota vykreslená touto značkou zakódovaná v HTML. Táto hodnota je predvolene nastavená ako False.

kvapalina

Boolovská hodnota označujúca, či sa má spracovať kód šablóny Liquid nájdený v textovej hodnote vykreslenej touto značkou. Predvolená hodnota je True.

tag

Názov kontajnerových značiek HTML vykreslených touto značkou. Táto značka štandardne vykresľuje prvky div. Odporúča sa vybrať si medzi div alebo span ako hodnotou pre tento parameter.

Názov kontajnerových značiek HTML vykreslených touto značkou. Táto značka predvolene vykresľuje div prvky. Pre tento parameter sa odporúča vybrať medzi div alebo span .

titul

Určuje označenie tejto upraviteľnej položky v rámci rozhrania úpravy obsahu. Ak nie je zadaný žiadny, automaticky sa vygeneruje priateľský štítok.

typu

Hodnota reťazca označujúca prezentovaný typ rozhrania úprav pre upraviteľné textové hodnoty. Platnými hodnotami pre tento parameter sú html alebo text. predvolená možnosť je html.

zoznam entít

Načíta daný zoznam podľa názvu alebo identifikátora. K vlastnostiam zoznamu je potom možné pristupovať pomocou objektu zoznamu entít dostupného v bloku značiek. Na vykreslenie skutočného výsledku záznamov zoznamu použite značku entityview v rámci bloku.

Ak sa zoznam úspešne načíta, vykreslí sa obsah v rámci bloku. Ak sa zoznam nenájde, obsah bloku sa nevykreslí.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

V predvolenom nastavení má objekt entitylist názov premennej entitylist. Voliteľné možno zadať iný názov premennej.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Parametre

Zadajte iba jedno z ID, názvu alebo kľúča, čím zvolíte zoznam na načítanie.

id

Načíta zoznam podľa GUID ID. id musí byť reťazec, ktorý môže byť analyzovaný ako GUID.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Vo všeobecnosti sa doslovné reťazce GUID nepoužívajú. Namiesto toho sa id zadáva pomocou vlastnosti GUID inej premennej.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

meno

Načíta zoznam podľa názvu.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

kľúč

Načíta zoznam podľa ID alebo názvu. Ak je možné poskytnutú hodnotu kľúča analyzovať ako GUID, zoznam sa načíta podľa ID. V opačnom prípade sa načíta podľa názvu.

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

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

kód_jazyka

Celé číslo kódu jazyka Dataverse na výber v zozname lokalizovaných označení na načítanie. Ak nie je zadaný kód jazyka, použije sa predvolený jazyk pripojenia aplikácie lokality Dataverse .

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

zobrazenie entity

Načíta dané zobrazenie Dataverse podľa názvu alebo ID. K vlastnostiam metadát stĺpca zobrazenia, stránkovaným záznamom výsledkov atď. možno potom pristupovať pomocou objektu entityview , ktorý je dostupný v bloku značiek.

Ak sa zobrazenie úspešne načíta, vykreslí sa obsah v rámci bloku. Ak sa zobrazenie nenájde, obsah bloku sa nevykreslí.

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

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

{% endentityview %}

V predvolenom nastavení má objekt entityview názov premennej entityview. Voliteľné možno zadať iný názov premennej.

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

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

{% endentityview %}

Ak je entityview vnorené do bloku zoznamu entít, zdedí svoju predvolenú konfiguráciu (veľkosť stránky s výsledkami, možnosti filtrovania atď.) zo zoznamu. Ak pre entityview nie sú zadané žiadne parametre ID alebo názvu zobrazenia, načíta sa predvolené zobrazenie z priloženého zoznamu entít.

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

Parametre

Zadajte buď id alebo logical_name s názvom na výber zobrazenia Dataverse na načítanie. Ak nie je poskytnuté ani jedno a značka entityview je vnorená do značky entitylist, načíta sa predvolené zobrazenie pripájajúceho zoznamu entít.

id

id musí byť reťazec, ktorý môže byť analyzovaný ako GUID.

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

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Vo všeobecnosti sa doslovné reťazce GUID nepoužívajú. Namiesto toho sa id zadáva pomocou vlastnosti GUID inej premennej.

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

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

{% endentityview %}

logický_názov

Logický názov entity Dataverse zobrazenia na načítanie. Musí byť použitý v kombinácii s názvom.

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

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

{% endentityview %}

meno

Názov entity Dataverse zobrazenia na načítanie. Musí byť použitý v kombinácii s logical_name.

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

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

{% endentityview %}

filter

Určuje, či filtrovať výsledky zobrazenia podľa používateľa alebo konta. Musí mať hodnotu reťazca používateľa alebo obchodného vzťahu.

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

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

{% endentityview %}

Bežný prípad použitia je nastavenie parametrov na základe žiadosti.

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

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

{% endentityview %}

metafilter

Určuje výraz filtra metaúdajov zoznamu, ktorým chcete filtrovať zobrazenie výsledkov. Tento parameter je platný len pri použití zobrazení entity v kombinácii so zoznamom entít. Vo väčšine prípadov je tento parameter založený na žiadosti.

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

poriadku

Určuje výraz zoradenia pre zoradenie výsledkov zobrazenia. Zoradenie výrazu môže obsahovať jednu alebo viaceré logické názvy atribútov entity, za ktorými nasleduje smer zoradenia ASC alebo DESC.

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

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

{% endentityview %}

Bežný prípad použitia je nastavenie parametrov na základe žiadosti.

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

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

{% endentityview %}

stránku

Určuje zobrazenie výsledku strany na načítanie. Ak tento parameter nie je zadaný, načíta sa prvá stránka výsledkov.

Tento parameter musí byť posunutý buď ako hodnota celého čísla, alebo ako reťazec, ktorý možno analyzovať ako celé číslo. Ak je pre tento parameter zadaná hodnota, ale hodnota je nulová alebo sa inak nedá analyzovať ako celé číslo, načíta sa prvá stránka s výsledkami.

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

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

{% endentityview %}

Bežný prípad použitia je nastavenie parametrov na základe žiadosti.

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

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

{% endentityview %}

veľkosť_strany

Určuje počet výsledkov na načítanie aktuálnej stránky s výsledkami. Ak pre tento parameter nie je zadaná žiadna hodnota a entityview sa použije v rámci bloku entitylist , použije sa veľkosť stránky zoznamu. Ak nie je v bloku zoznamu entít, použije sa predvolená hodnota 10.

Tento parameter musí byť posunutý buď ako hodnota celého čísla, alebo ako reťazec, ktorý možno analyzovať ako celé číslo. Ak je pre tento parameter zadaná hodnota, ale hodnota je nulová alebo sa inak nedá analyzovať ako celé číslo, použije sa predvolená veľkosť stránky.

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

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

{% endentityview %}

Bežný prípad použitia je nastavenie parametrov na základe žiadosti.

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

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

{% endentityview %}

hľadať

Určuje vyhľadávací výraz, podľa ktorého sa majú filtrovať výsledky zobrazenia. Jednoduché výrazy vyhľadávania kľúčových slov filtruje podľa toho, či atribúty začínajú kľúčovým slovom. Zástupné znaky* môžu byť zahrnuté vo výraze.

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

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

{% endentityview %}

Spoločný prípad použitia je nastavenie tohto parametra na základe žiadosti tak, že na filter hľadania môžete nastaviť podľa vstupu používateľa.

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

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

{% endentityview %}

kód_jazyka

Celé číslo kódu jazyka Dataverse na označenie entity zobrazenia lokalizovaných označení (hlavičky stĺpcov, atď.) na načítanie. Ak nie je zadaný kód jazyka, použije sa predvolený jazyk pripojenia webovej aplikácie Dataverse .

Ak sa entityview používa v rámci bloku entitylist, entityview zdedí svoju konfiguráciu kódu jazyka zo zoznamu entít.

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

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

index vyhľadávania

Vykoná dotaz proti indexu vyhľadávania webovej lokality. K zodpovedajúcim výsledkom je potom možné pristupovať pomocou indexu vyhľadávania , ktorý je dostupný v bloku značiek.

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

V predvolenom nastavení má objekt indexu vyhľadávania názov premennej searchindex. Voliteľné možno zadať iný názov premennej.

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

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

...

{% endif %}

{% endsearchindex %}

Parametre

Značka index vyhľadávania akceptuje nasledovné parametre.

dotaz

Dotaz sa používa na porovnávanie výsledkov. Tento parameter je určený na prijatie používateľom stanovenej časti indexu dotazu (ak je k dispozícii).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Bežný prípad použitia je nastavenie parametrov na základe žiadosti.

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

...

{% endsearchindex %}

Tento parameter podporuje syntax Lucene Query Parser.

filter

Ďalší dopyt použitý na zhodu výsledkov. Tento parameter má prijať vývojárom stanovený filter pre požadované výsledky.

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

...

{% endsearchindex %}

Tento parameter podporuje syntax Lucene Query Parser.

logické_názvy

Logické názvy Dataverse entít, na ktoré sú vyhovujúce výsledky obmedzené, ako reťazec oddelený čiarkou. Ak nie sú poskytnuté, vrátia sa všetky zodpovedajúce entity.

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

...
>
{% endsearchindex %}

stránku

Stránka s výsledkami, ktorá sa má vrátiť. Ak nie je poskytnutá, vráti sa prvá strana (1).

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

...

{% endsearchindex %}

Bežný prípad použitia je nastavenie parametrov na základe žiadosti.

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

...

{% endsearchindex %}

veľkosť_strany

Veľkosť stránky s výsledkami, ktorá sa má vrátiť. Ak nie je zadaná, použije sa predvolená veľkosť 10.

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

...

{% endsearchindex %}

formulár entity

Úplne zobrazuje formulár podľa názvu alebo identifikátora.

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

Parametre

meno

Názov základného formulára určeného na načítanie.

{% entityform name:My Basic Form %}

webový formulár

Úplne zobrazuje formulár s viacerými krokmi podľa názvu alebo identifikátora. Označenie webového formulára je dostupné len na použitie iba pri obsahu zobrazenom vnútri šablóny stránky na základe webovej šablóny. Pri pokuse o použitie značky v šablóne stránky založenej na prepísaní sa nič nevykreslí. Na stránku môžete vykresliť iba jednu značku entityform alebo webform. Značky entityform alebo webform po prvej sa nevykreslia.

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

Parametre

meno

Názov formulára s viacerými krokmi určeného na načítanie.

{% webform name:My Multistep Form %}

codecomponent

Umožňuje vložiť komponenty kódu pomocou značky Liquid. Napríklad pridanie vlastného ovládacieho prvku zobrazenia mapy na webovú stránku.

Parametre

meno

ID alebo názov komponentu kódu.

majetku

Hodnoty vlastností, ktoré komponent kódu očakáva, je potrebné odovzdať ako pár kľúč/hodnota oddelený dvojbodkou (:), kde kľúč je názov vlastnosti a hodnota je hodnota reťazca JSON.

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

Prečítajte si Používanie značky šablóny Liquid v rámci súčastí kódu.

Pozrite si tiež

• Kontrolné značky toku
• Iteračné značky
• Variabilné značky
• Štítky šablón