Etichete Liquid Dataverse

Etichetele Liquid Microsoft Dataverse sunt folosite pentru a încărca și a afișa date Dataverse sau pentru a folosi alte servicii de cadru pentru Power Pages. Aceste etichete sunt extensii specifice Dataverse pentru limbajul Liquid.

diagramă

Adaugă o o diagramă Power Apps de aplicație proiectată pe bază de model la o pagină web. Eticheta de diagramă poate fi adăugată în câmpul Copiați de pe o pagină web sau în câmpul Sursă dintr-un șablon web. Pentru pașii necesari pentru a adăuga o diagramă Power Apps de aplicație proiectată pe bază de model la o pagină web, consultați Adăugați o diagramă la o pagină web din Power Pages.

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

Parametri

Există doi parametri care trebuie furnizați cu eticheta diagramei: ID diagramă și viewid.

ID diagramă

ID-ul de vizualizare al diagramei. Puteți obține id-ul exportând diagrama.

viewid

ID-ul tabelului când se deschide în editorul de vizualizare.

powerbi

Adaugă rapoartele și tablourile de bord Power BI în pagini. Eticheta poate fi adăugată în câmpul Copiere de pe o pagină web sau în câmpul Sursă dintr-un șablon web. Ca să aflați pașii pentru adăugarea unui raport sau a unui tablou de bord Power BI la o pagină web din Power Pages, consultați Adăugați un raport sau un tablou de bord Power BI la o pagină web din Power Pages.

Parametri

Eticheta powerbi acceptă următorii parametri:

cale

Calea raportului sau tabloului de bord Power BI. Dacă raportul sau tabloul de bord Power BI este sigur, trebuie să furnizați tipul de autentificare.

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

tip_autentificare

Tipul de autentificare necesar pentru raportul sau tabloul de bord Power BI. Valorile valide pentru acest parametru sunt:

• Anonim: vă permite să încorporați rapoarte Publicare pe web Power BI . Tip de autentificare implicit este Anonim. Când utilizați tipul de autentificare ca anonim, trebuie să obțineți URL-ul raportului Power BI descris la: Publicați pe web din Power BI

• AAD: vă permite să partajați Power BI rapoarte sau tablouri de bord securizate la Power BI Microsoft Entra utilizatori autentificați cu ID.

• powerbiembedded: vă permite să partajați rapoarte sau tablouri de bord securizate pentru utilizatorii externi care nu au Power BI licență sau Power BI autentificare înființat. Microsoft Entra Pentru informații despre serviciul de configurare Power BI Embedded consultați Activați serviciul Power BI Embedded.

Când adăugați un raport sau un tablou de bord securizat Power BI , asigurați-vă că este partajat cu serviciile Power Pages Microsoft Entra sau 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" %}

De asemenea, aveți posibilitatea să filtrați raportul pentru una sau mai multe valori. Sintaxa pentru a filtra un raport este:

URL?filter=Table/Field eq 'value'

De exemplu, să presupunem că doriți să filtrați raportul pentru a vedea datele pentru o persoană de contact pe nume Bert Hair. Trebuie să adăugați URL-ul cu următoarele date:

?filter=Executives/Executive eq 'Bert Hair'

Codul complet este:

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

Mai multe informații despre filtrarea unui raport: Filtrarea unui raport utilizând parametri de șir de interogare în URL

De asemenea, puteți crea o cale dinamică utilizând variabila capture Lichid:

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

Mai multe informații despre variabila Lichid: Etichete de variabile

tileid

Afișează dala specificată din tabloul de bord. Trebuie să furnizați ID-ul dalei.

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

roluri

Roluri atribuite raportului Power BI. Acest parametru funcționează numai atunci când parametrul tip de autentificare este setat la powerbiembedded.

Dacă ați definit roluri în Power BI și le-ați atribuit rapoartelor, trebuie să specificați rolurile corespunzătoare în eticheta powerbi Liquid. Rolurile vă permit să filtrați datele care trebuie afișate într-un raport. Puteți specifica mai multe roluri separate printr-o virgulă. Pentru informații suplimentare despre definirea rolurilor în Power BI, consultați Securitate la nivel de rând (RLS) cu 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" %}

Dacă ați atribuit un rol unui Power BI raport și nu ați specificat parametrul roles în eticheta Liquid sau nu ați specificat un rol în parametrul, este afișată o eroare.

editabil

Redă un obiect Power Pages CMS ca editabil pe site, pentru utilizatori cu permisiuni de editare de conținut pentru acel obiect. Obiecte editabile includ pagină, fragmente și linkuri web.

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

Parametri

Primul parametru furnizat pentru editabil este obiectul editabil, cum ar fi un set de linkuri web, fragmente sau pagina curentă. Al doilea parametru opțional este pentru a specifica un nume de atribut sau o cheie din cadrul acelui obiect care urmează să fie redat și editat. Această valoare poate fi numele unui atribut de tabel sau un nume fragment, de exemplu.

După acești parametri inițiali, eticheta acceptă mai mulți parametri opționali denumiți.

clasă

Specifică o valoare de atribuit class pentru elementul rădăcină redat de această etichetă.

implicit

O valoare implicită redată în cazul în care elementul editabil nu are valoare.

evadare

O valoare Boolean care indică dacă o valoare redată de această etichetă este codificată HTML. În mod implicit, valoarea este False.

lichid

O valoare Boolean care indică dacă orice cod șablon Liquid găsit în valoarea textului redat de această etichetă trebuie procesat. Această valoare este true în mod implicit.

etichetă

Numele etichetelor HTML ale containerului redate de această etichetă. Această etichetă redă elemente div în mod implicit. Este recomandat să alegeți între div sau span ca valoare pentru acest parametru.

Numele etichetelor HTML ale containerului redate de această etichetă. Această etichetă redă div elementele în mod implicit. Este recomandat să alegeți între div sau span pentru acest parametru.

titlu

Specifică o etichetă pentru acest element editabil în interfața de editare a conținutului. Dacă nu este furnizat niciunul, o etichetă prietenoasă este generată automat.

tip

O valoare șir care indică tipul de interfață de editare care va fi prezentat, pentru valori de text editabile. Valorile valide pentru acest parametru sunt html sau text. Valoarea implicită este html.

listă de entități

Încarcă o listă dată, după nume sau ID. Proprietățile listei pot fi apoi accesate folosind un obiect listă de entități disponibil în blocul de etichete. Pentru a reda înregistrările de rezultate reale din listă, utilizați entityview în cadrul blocului.

Dacă lista este încărcată cu succes, conținutul din bloc este redat. Dacă lista nu este găsită, conținutul blocului nu este redat.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Implicit, obiectului entitylist i se dă numele variabilei entitylist. Opțional, se poate furniza un alt nume de variabilă.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Parametri

Furnizați doar unul dintre id, name sau key, pentru a selecta lista de încărcat.

id

Încarcă o listă după ID GUID. ID-ul trebuie să fie un șir ce poate fi analizat ca GUID.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

În general, șirurile GUID literale nu sunt folosite. În schimb, id este specificat folosind o proprietate GUID a unei alte variabile.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

nume

Încarcă o listă după nume.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

cheie

Încarcă o listă după ID sau nume. Dacă valoarea cheie furnizată poate fi analizată ca GUID, lista este încărcată după ID. În caz contrar, este încărcat după nume.

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

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

cod_limbă

Un cod de limbă număr întreg Dataverse pentru a selecta etichetele localizate ale listei ce vor fi încărcate. Dacă nu este furnizat niciun cod de limbă, se folosește limba implicită a conexiunii aplicației site Dataverse .

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Încarcă o vizualizare Dataverse dată, după nume sau ID. Proprietățile vizualizării - metadatele coloanei de vizualizare, înregistrările de rezultate paginate etc. pot fi apoi accesate folosind un obiect de vizualizare entitate care este disponibil în blocul de etichete.

Dacă vizualizarea este încărcată cu succes, conținutul din bloc este redat. Dacă vizualizarea nu este găsită, conținutul blocului nu este redat.

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

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

{% endentityview %}

Implicit, obiectului entityview i se dă numele variabilei entityview. Opțional, se poate furniza un alt nume de variabilă.

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

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

{% endentityview %}

Dacă entityview este imbricată într-un bloc de entitylist, moștenește configurația implicită (dimensiunea paginii de rezultate, opțiunile de filtrare etc.) din listă. Dacă nu sunt furnizați parametri de identificare sau nume de vizualizare pentru entityview, acesta încarcă vizualizarea implicită din lista de entități inclusă.

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

Parametri

Oferiți fie id, fie logical_name cu numele necesar pentru a selecta vizualizarea Dataverse de încărcat. Dacă niciunul nu este furnizat și eticheta entityview este imbricată într-o etichetă entitylist, se încarcă vizualizarea implicită a listei de entități incluse.

id

id trebuie să fie un șir ce poate fi analizat ca GUID.

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

Loaded entity view {{ entityview.name }}.

{% endentityview %}

În general, șirurile GUID literale nu sunt folosite. În schimb, id este specificat folosind o proprietate GUID a unei alte variabile.

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

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

{% endentityview %}

nume_logic

Numele logic al entității Dataverse a vizualizării de încărcat. Trebuie să fie utilizat în asociere cu name.

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

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

{% endentityview %}

nume

Numele Dataverse al vizualizării de încărcat. Trebuie să fie utilizat în asociere cu logical_name.

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

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

{% endentityview %}

filtra

Precizează dacă se filtrează rezultatele de vizualizare după utilizator sau cont. Trebuie să aibă o valoare șir „utilizator” sau „cont”.

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

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

{% endentityview %}

Un caz de utilizare comună este să setați acest parametru pe baza unei solicitări.

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

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

{% endentityview %}

metafiltru

Specifică expresia de filtru de metadate a listei după care se filtrează rezultatele de vizualizare. Acest parametru este valabil numai atunci când entityview este utilizat în asociere cu entitylist. În majoritatea cazurilor, acest parametru este stabilit pe baza unei solicitări.

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

comanda

Specifică o expresie de sortare pentru rezultatele vizualizării de ordonare. O expresie de sortare poate conține unul sau mai multe nume logice de atribute de entitate, urmată de o direcție de sortare ASC sau DESC.

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

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

{% endentityview %}

Un caz de utilizare comună este să setați acest parametru pe baza unei solicitări.

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

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

{% endentityview %}

pagină

Specifică pagina de rezultate de vizualizare de încărcat. Dacă acest parametru nu este specificat, se încarcă prima pagină de rezultate.

Acest parametru trebuie să fi trecut ca valoare de tip întreg sau ca șir de caractere care poate fi analizat ca număr întreg. Dacă este furnizată o valoare pentru acest parametru, dar valoarea este nulă sau altfel nu poate fi analizată ca număr întreg, se încarcă prima pagină de rezultate.

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

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

{% endentityview %}

Un caz de utilizare comună este să setați acest parametru pe baza unei solicitări.

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

Specifică numărul de rezultate de încărcat pentru pagina curentă de rezultate. Dacă nu este furnizată nicio valoare pentru acest parametru și entityview este utilizată într-un bloc entitylist , se utilizează dimensiunea paginii cu listă. Dacă nu este într-un bloc de listă de entități, este utilizată o valoare implicită de 10.

Acest parametru trebuie să fi trecut ca valoare de tip întreg sau ca șir de caractere care poate fi analizat ca număr întreg. Dacă este furnizată o valoare pentru acest parametru, dar valoarea este nulă sau altfel nu poate fi analizată ca număr întreg, se utilizează dimensiunea implicită a paginii.

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

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

{% endentityview %}

Un caz de utilizare comună este să setați acest parametru pe baza unei solicitări.

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

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

{% endentityview %}

căutare

Specifică o expresie de căutare după care să se filtreze rezultatele de vizualizare. Expresiile simple de căutare a cuvintelor cheie filtrează dacă atributele încep cu cuvântul cheie. Metacaracterele * pot fi, de asemenea, incluse în expresie.

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

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

{% endentityview %}

Un caz de utilizare comun este să setați acest parametru pe baza unei solicitări, pentru ca filtrul de căutare să fie setat în funcție de datele introduse de utilizator.

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

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

{% endentityview %}

cod_limbă

Un cod de limbă număr întreg Dataverse pentru a selecta etichetele localizate ale vizualizării de entitate (etichetele antetului de coloană, etc.) de încărcat. Dacă nu este furnizat niciun cod de limbă, se folosește limba implicită a conexiunii aplicației site-ului web Dataverse .

Dacă entityview este utilizat într-un bloc entitylist, entityview moștenește configurația codului de limbă de la entitylist.

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

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Efectuează o interogare comparativ cu indexul de căutare din site. Rezultatele care se potrivesc pot fi apoi accesate folosind un searchindex care este disponibil în blocul de etichete.

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

În mod implicit, obiectului index de căutare îi este dat numele variabilei searchindex. Opțional, se poate furniza un alt nume de variabilă.

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

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

...

{% endif %}

{% endsearchindex %}

Parametri

Eticheta searchindex acceptă următorii parametri.

interogare

Interogarea utilizată pentru a se potrivi cu rezultatele. Acest parametru este destinat să accepte partea specificată de utilizator a interogării de indexare (dacă există).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Un caz de utilizare comună este să setați acest parametru pe baza unei solicitări.

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

...

{% endsearchindex %}

Acest parametru acceptă sintaxa Lucene Query Parser.

filtra

O altă interogare folosită pentru a potrivi rezultatele. Acest parametru este destinat să accepte un filtru specificat de dezvoltator pentru rezultate, dacă se dorește.

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

...

{% endsearchindex %}

Acest parametru acceptă sintaxa Lucene Query Parser.

nume_logice

Dataverse Numele logice ale entităților la care rezultatele potrivire sunt restricționate, ca șir delimitat prin virgulă. Dacă nu sunt furnizate, toate entitățile care se potrivesc sunt returnate.

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

...
>
{% endsearchindex %}

pagină

Pagina cu rezultatele de căutare de returnat. Dacă nu este furnizată, prima pagină (1) este returnată.

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

...

{% endsearchindex %}

Un caz de utilizare comună este să setați acest parametru pe baza unei solicitări.

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

...

{% endsearchindex %}

page_size

Dimensiunea paginii de rezultate de returnat. Dacă nu este furnizată, se utilizează o dimensiune implicită de 10.

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

...

{% endsearchindex %}

entityform

Randează complet un formular pe bază de nume sau ID.

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

Parametri

nume

Numele formularului de bază pe care doriți să îl încărcați.

{% entityform name:My Basic Form %}

webform

Randează complet un formular cu mai mulți pași pe bază de nume sau ID. Eticheta webform este disponibilă pentru utilizare doar pentru conținutul randat într-un șablon de pagină bazat pe un șablon web. Încercarea de a utiliza eticheta în interiorul unui șablon de pagină bazat pe rescriere nu redă nimic. Puteți reda o singură etichetă de formular de entitate sau de formular web pe pagină. Etichetele Entityform sau webform după prima nu sunt redate.

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

Parametri

nume

Numele formularului cu mai mulți pași pe care doriți să îl încărcați.

{% webform name:My Multistep Form %}

codecomponent

Vă permite să încorporați componente de cod folosind o etichetă Liquid. De exemplu, adăugarea unui control particularizat pentru afișarea hărții la o pagină web.

Parametri

nume

ID-ul sau numele componentei de cod.

proprietate

Valorile proprietăților la care se așteaptă componenta de cod trebuie să fie transmise ca o pereche cheie/valoare separată prin două puncte (:), unde cheia este numele proprietății și valoarea este valoarea șirului JSON.

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

Vizualizați Utilizarea etichetei de șablon Liquid pentru componente de cod.

Consultați și

• Controlul etichetelor de flux
• Etichete de iterație
• Etichete variabile
• Etichete șablon