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.
Notă
Pentru ca eticheta să funcționeze, trebuie să activați integrarea Power BI din hubul Power Pages în centrul de administrare Power Platform. Dacă integrarea Power BI nu este activată, tabloul de bord sau raportul nu se vor afișa.
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" %}
authentication_type
Tipul de autentificare necesar pentru raportul sau tabloul de bord Power BI. Valorile valide pentru acest parametru sunt:
Anonim: vă permite să încorporați și să publicați pe web rapoartele 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 rapoarte sau tablouri de bord securizate Power BI pentru a Power BI Microsoft Entra identifica utilizatorii autentificați.
powerbiembedded: Vă permite să partajați rapoartele sau tablourile de bord securizate Power BI utilizatorilor externi care nu au Power BI configurare de licență sau Microsoft Entra autentificare. Pentru informații despre serviciul de configurare Power BI Embedded consultați Activați serviciul Power BI Embedded.
În timp ce adăugați raportul securizat sau tabloul de bord securizat Power BI , asigurați-vă că este partajat cu Power Pages Microsoft Entra serviciile sau Power BI Embedded .
Notă
Valorile pentru parametrul authentication_type nu sunt sensibile la litere mari sau mici.
{% 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
Notă
Raportul anonim nu acceptă filtrare.
De asemenea, puteți crea un traseu dinamic utilizând variabila Lichid: 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 %}
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 alocat rapoartelor, trebuie să specificați rolurile corespunzătoare în eticheta Liquid powerbi. 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 raport Power BI și nu ați specificat parametrul roluri în eticheta Liquid sau nu ați specificat un rol în parametru, este afișată o eroare.
Sfat
Dacă doriți să utilizați rolurile web definite în site-ul dvs. ca roluri Power BI, puteți defini o variabilă și îi puteți atribui roluri web. Apoi, puteți utiliza variabila definită în eticheta Liquid.
Să presupunem că ați definit două roluri web ca Region_East și Region_West în site-ul dvs. Vă puteți alătura folosind codul: {% assign webroles = user.roles | join: ", " %}
În fragmentul de cod de mai sus, webroles este o variabilă și rolurile web Region_East și Region_West vor fi stocate în ea.
Utilizați variabila webroles după cum urmează în eticheta Liquid:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}
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, de exemplu, numele unui atribut de tabel sau un nume fragment.
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ă.
default
O valoare implicită redată în cazul în care elementul editabil nu are valoare.
escape
O valoare booleană care indică dacă o valoare redată de această etichetă este codificată HTML. În mod implicit, valoarea este False.
liquid
O valoare booleană care indică dacă trebuie procesat vreun cod de șablon lichid găsit în valoarea text redată de această etichetă. Această valoare este true în mod implicit.
etichetă
Numele etichetelor HTML ale containerului redate de această etichetă. Această etichetă redă elementele div în mod implicit. Este recomandat să alegeți între div sau span ca valoare pentru acest parametru.
titlu
Specifică o etichetă pentru acest element editabil în interfața de editare a conținutului. Dacă nu este furnizată niciuna, se generează automat o etichetă prietenoasă.
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 utilizând un obiect entitylist 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 %}
În mod implicit, obiectul entitylist primește 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, nu se utilizează șiruri GUID literale. În schimb, id este specificat utilizând 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 cheii furnizate 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 %}
language_code
Un cod de limbă număr întreg Dataverse pentru a selecta etichetele localizate ale listei ce vor fi încărcate. Dacă nu este furnizată nicio language_code, se utilizează limba implicită a conexiunii aplicației Dataverse site.
{% 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 metadatelor coloanei de vizualizare, înregistrările de rezultate paginate etc. pot fi apoi accesate utilizând un obiect entityview 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 %}
În mod 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 entitylist, acesta moștenește configurația implicită (dimensiunea paginii de rezultate, opțiunile de filtrare etc.) din listă. Dacă nu sunt furnizați id-uri de vizualizare sau parametri de nume către entityview, aceasta încarcă vizualizarea implicită din lista de entități anexată.
{% 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ă niciuna nu este furnizată și eticheta entityview este imbricată într-o etichetă entitylist, se încarcă vizualizarea implicită a listei de entități anexate.
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, nu se utilizează șiruri GUID literale. În schimb, id este specificat utilizând o proprietate GUID a unei alte variabile.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
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 %}
filtru
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 %}
comandă
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ă cu 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 î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 de listă de entități, se utilizează dimensiunea paginii de listă. Dacă nu se află într-un bloc entitylist, se utilizează 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 î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 %}
language_code
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ă nicio language_code, se utilizează limba implicită a conexiunii aplicației Dataverse site-ului web.
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 corespund pot fi apoi accesate utilizând un index de căutare disponibil în blocul etichetei.
{% 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 se dă 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.
filtru
O altă interogare utilizată 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.
Notă
Diferența dintre filtru și interogare este că, deși ambele vor accepta sintaxa Lucene Query Parser, interogare este proiectat să fie mai permisiv în legătură cu modul în care această sintaxă este analizată ߝ deoarece se presupune că majoritatea utilizatorilor finali nu vor ști această sintaxă. Deci, în cazul în care analizarea query în conformitate cu această sintaxă nu reușește, întreaga interogare va fi abandonată și transmisă ca text de interogare. filtru, pe de altă parte, va fi analizat strict și va returna o eroare în cazul unei sintaxe nevalide.
logical_names
Numele logice ale entității Dataverse pentru care vor fi limitate rezultatele de potrivire, ca șir delimitat prin virgule. 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.
Notă
Eticheta entityform este disponibilă pentru utilizare doar pentru conținutul randat într-un șablon de pagină bazat pe un șablon web. Încercarea de a folosi eticheta în interiorul un șablon de pagină pe bază de rescriere nu va reda nimic. Puteți reda o singură etichetă entityform sau webform per pagină. Etichetele entityform sau webform de după prima etichetă nu vor fi randate.
{% 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 folosi eticheta în interiorul un șablon de pagină pe bază de rescriere nu va reda nimic. Puteți reda o singură entitateformă sau etichetă de formular web pe pagină. Etichetele entityform sau webform de după prima etichetă nu vor fi randate.
{% 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 pe care estimate de componenta de cod trebuie să fie transmise ca o pereche cheie/valoare separată prin ":" (semnul 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> %}
Notă
Proprietățile necesare pot fi diferite în funcție de componenta pe care o alegeți.
Vizualizați Utilizarea etichetei de șablon Liquid pentru componente de cod.