Tag Liquid Dataverse
Tag liquid Microsoft Dataverse digunakan untuk memuat dan menampilkan data Dataverse, atau menggunakan layanan kerangka Power Pages lain. Tag ini adalah ekstensi spesifik Dataverse ke bahasa Liquid.
diagram
Menambahkan diagram aplikasi yang diarahkan model Power Apps ke halaman web. Tag diagram dapat ditambahkan di bidang salinan pada halaman web atau di bidang sumber pada template Web. Untuk langkah-langkah untuk menambahkan diagram aplikasi yang diarahkan model Power Apps ke halaman web, lihat menambahkan diagram ke halaman web di Power Pages.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parameter
Ada dua parameter untuk diberikan dengan tag diagram: id bagan dan viewid.
chart id
ID Visualisasi diagram. Anda bisa mendapatkan id dengan mengekspor grafik.
viewid
ID tabel saat dibuka di editor tampilan.
powerbi
Menambahkan dasbor Power BI dan laporan dalam halaman. Tag diagram dapat ditambahkan di bidang salin pada halaman web atau di bidang sumber pada Web template. Untuk langkah-langkah menambahkan laporan Power BI atau dasbor ke halaman web di Power Pages, lihat menambahkan laporan Power BI atau dasbor ke halaman web di Power Pages.
Catatan
Agar tag berfungsi, Anda harus mengaktifkan integrasi Power BI dari Power Pages hub di pusat admin Power Platform. Jika integrasi Power BI tidak diaktifkan, dasbor atau laporan tidak akan ditampilkan.
Parameter
Tag powerbi menerima parameter berikut:
path
Jalur dasbor atau laporan Power BI. Jika laporan Power BI atau dasbor aman, Anda harus menyediakan jenis otentikasi.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
authentication_type
Jenis otentikasi yang diperlukan untuk laporan Power BI atau dasbor. Nilai valid untuk parameter ini adalah:
Anonim: memungkinkan Anda untuk menanam publikasi laporan Power BI web. Jenis otentikasi default adalah anonim. Bila menggunakan jenis autentikasi sebagai anonim, Anda harus mendapatkan URL laporan Power BI seperti yang dijelaskan di: publikasikan ke web dari Power BI
AAD: Memungkinkan Anda berbagi laporan atau dasbor aman Power BI ke Power BI Microsoft Entra pengguna yang diautentikasi ID.
powerbiembedded: Memungkinkan Anda berbagi laporan atau dasbor aman Power BI kepada pengguna eksternal yang tidak memiliki Power BI penyiapan lisensi atau Microsoft Entra autentikasi. Untuk informasi tentang konfigurasi layanan Power BI Embedded, lihat Aktifkan Layanan Power BI Embedded.
Saat menambahkan laporan atau dasbor aman Power BI , pastikan laporan atau dasbor dibagikan dengan Power Pages Microsoft Entra layanan OR Power BI Embedded .
Catatan
Nilai untuk parameter authentication_type itu peka besar huruf.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Anda juga dapat menyaring laporan pada satu atau beberapa nilai. Sintaks untuk memfilter laporan adalah:
URL?filter=Table/Field eq 'value'
Misalnya, Anda ingin filter laporan untuk melihat data untuk kontak bernama Bert Hair. Anda dapat menambahkan URL dengan data berikut ini:
?filter=Executives/Executive eq 'Bert Hair'
Kode lengkapnya adalah:
{% 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'" %}
Informasi lebih lanjut tentang pemfilteran laporan: memfilter laporan menggunakan parameter string kueri di URL
Catatan
Laporan anonim tidak mendukung pemfilteran.
Anda juga dapat membuat jalur dinamis dengan capture menggunakan variabel Liquid:
{% 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 %}
Informasi lebih lanjut tentang variabel Liquid: Tag variabel
tileid
Menampilkan ubin yang ditentukan di dasbor. Anda harus memberikan ID ubin.
{% 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" %}
roles
Peran yang ditetapkan ke laporan Power BI. Parameter ini berfungsi hanya bila parameter authentication_type diatur ke powerbiembedded.
Jika Anda telah menetapkan peran di Power BI dan menugaskannya ke laporan, Anda harus menentukan peran yang sesuai dalam Tag Liquid powerbi. Peran memungkinkan Anda memfilter data yang akan ditampilkan dalam laporan. Anda dapat menentukan beberapa peran yang dipisahkan dengan koma. Untuk informasi lebih lanjut tentang cara menentukan peran di Power BIlihat keamanan tingkat baris (RLS) dengan 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" %}
Jika Anda telah menetapkan peran ke laporan Power BI, dan tidak menentukan parameter peran pada tag Liquid atau tidak menentukan peran pada parameter, kesalahan akan ditampilkan.
Tip
Jika Anda ingin menggunakan peran web yang ditentukan di situs sebagai peran Power BI, Anda dapat menentukan variabel dan menetapkan peran web ke dalamnya. Selanjutnya Anda dapat menggunakan variabel yang ditentukan dalam tag Liquid.
Katakanlah Anda telah menentukan dua peran web sebagai Region_East dan Region_West di situs Anda. Anda dapat menggabungkan keduanya dengan menggunakan kode: {% assign webroles = user.roles | join: ", " %}
Pada cuplikan kode di atas, webroles adalah variabel dan peran web Region_East dan Region_West akan disimpan di dalamnya.
Gunakan variabel webroles sebagai berikut dalam tag 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%}
editable
Merender objek CMS Power Pages tertentu sebagai dapat diedit di situs, untuk pengguna dengan izin mengedit konten untuk objek itu. Objek yang dapat diedit termasuk halaman, snippets, dan weblinks.
{% 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 %}
Parameter
Parameter pertama yang diberikan untuk dapat diedit adalah objek yang dapat diedit, seperti kumpulan tautan web, cuplikan, atau halaman saat ini. Parameter opsional kedua adalah untuk mencantumkan nama atribut atau kunci dalam objek yang akan dirender dan diedit. Nilai ini mungkin nama atribut tabel, atau nama cuplikan, misalnya.
Setelah parameter awal, tag mendukung banyak parameter opsional bernama.
class
Menetapkan nilai atribut class untuk elemen akar yang dirender oleh tag ini.
default
Nilai default yang diberikan jika item yang dapat diedit tidak memiliki nilai.
escape
Nilai Boolean yang menunjukkan apakah nilai yang diberikan oleh tag ini dikodekan HTML. Nilai ini False secara default.
liquid
Nilai Boolean yang menunjukkan apakah kode template Liquid apa pun yang ditemukan dalam nilai teks yang diberikan oleh tag ini harus diproses. Secara default, nilai ditentukan true.
tag
Nama tag HTML kontainer yang diberikan oleh tag ini. Tag ini merender elemen div secara default. Disarankan bahwa Anda memilih antara div atau span sebagai nilai untuk parameter ini.
title
Menentukan label untuk item dapat diedit ini dalam antarmuka mengedit konten. Jika tidak ada yang disediakan, label ramah dihasilkan secara otomatis.
type
Nilai string yang menunjukkan jenis antarmuka pengeditan yang akan disajikan, untuk nilai-nilai teks yang dapat diedit. Nilai valid untuk parameter ini adalah html atau teks. Default-nya adalah html.
entitylist
Memuat daftar tertentu, menurut nama atau ID. Properti daftar kemudian dapat diakses menggunakan objek entitylist yang tersedia dalam blok tag. Untuk membuat rekaman hasil aktual dari daftar, gunakan tag entityview dalam blok.
Jika daftar berhasil dimuat, konten dalam blok akan dirender. Jika daftar tidak ditemukan, konten blokir tidak akan ditampilkan.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Secara default, objek entitylist diberi nama variabel entitylist. Opsional, nama variabel yang berbeda dapat disediakan.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parameter
Berikan hanya satu dari id, nama, atau kunci untuk memilih Daftar untuk dimuat.
id
Muat daftar dengan ID GUID. id harus menjadi string yang dapat diurai sebagai GUID.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Umumnya, string GUID literal tidak digunakan. Sebaliknya, id ditentukan menggunakan properti GUID dari variabel lain.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
name
Memuat daftar menurut nama.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
key
Memuat daftar menurut ID atau nama. Jika nilai kunci yang disediakan dapat diuraikan sebagai GUID, daftar dimuat menurut ID. Jika tidak, itu dimuat berdasarkan nama.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
Kode bahasa bilangan bulat Dataverse untuk memilih label lokal daftar untuk dimuat. Jika tidak ada language_code yang disediakan, bahasa default koneksi aplikasi Dataverse situs digunakan.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Memuat daftar tampilan Dataverse tertentu, menurut nama atau ID. Properti metadata kolom tampilan tampilan, rekaman hasil paginasi, dll. kemudian dapat diakses menggunakan objek entityview yang tersedia dalam blok tag.
Jika tampilan berhasil dimuat, konten dalam blok akan dirender. Jika tampilan tidak ditemukan, konten blokir tidak akan dirender.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Secara default, objek entityview diberi nama variabel entityview. Opsional, nama variabel yang berbeda dapat disediakan.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Jika entityview ditumpuk dalam blok entitylist, entityview mewarisi konfigurasi defaultnya (ukuran halaman hasil, opsi filter, dll.) dari daftar. Jika tidak ada id tampilan atau parameter nama yang disediakan untuk entityview, parameter tersebut akan memuat tampilan default dari entitylist terlampir.
{% 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 %}
Parameter
Berikan baik id maupun nama logis dengan nama untuk memilih tampilan Dataverse untuk dimuat. Jika tidak ada yang disediakan, dan tag entityview bersarang dalam tag entitylist, tampilan default entitylist terlampir dimuat.
id
id harus menjadi string yang dapat diurai sebagai GUID.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
Umumnya, string GUID literal tidak digunakan. Sebaliknya, id ditentukan menggunakan properti GUID dari variabel lain.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
Nama logis entitas Dataverse dari tampilan yang akan dimuat. Harus digunakan dalam kombinasi dengan name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
name
Nama Dataverse dari tampilan yang akan dimuat. Harus digunakan dalam kombinasi dengan logical_name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Menentukan apakah akan menyaring hasil tampilan menurut pengguna atau akun. Harus memiliki nilai string pengguna atau akun.
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Menentukan ekspresi filter metadata daftar yang digunakan untuk menyaring hasil tampilan. Parameter ini hanya berlaku ketika entityview digunakan dalam kombinasi dengan entitylist. Dalam kebanyakan kasus, parameter ini diatur berdasarkan request.
{% 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 %}
order
Menentukan ekspresi sortir untuk mengurutkan hasil tampilan. Ekspresi sortir dapat berisi satu atau lebih nama logis atribut entitas, diikuti oleh arah sortir baik ASC atau DESC.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page
Menentukan halaman hasil tampilan untuk dimuat. Jika parameter ini tidak ditentukan, halaman pertama hasil akan dimuat.
Parameter ini harus diteruskan baik nilai bilangan bulat, atau string yang dapat diurai sebagai bilangan bulat. Jika nilai disediakan untuk parameter ini, tetapi nilainya null atau tidak dapat diuraikan sebagai bilangan bulat, halaman pertama hasil akan dimuat.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request.
{% 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
Menentukan jumlah hasil untuk dimuat untuk halaman hasil aktif. Jika tidak ada nilai yang disediakan untuk parameter ini, dan entityview digunakan dalam blok entitylist , ukuran halaman daftar akan digunakan. Jika tidak dalam blok entitylist, nilai default 10 digunakan.
Parameter ini harus diteruskan baik nilai bilangan bulat, atau string yang dapat diurai sebagai bilangan bulat. Jika nilai disediakan untuk parameter ini, tetapi nilainya null atau tidak dapat diuraikan sebagai bilangan bulat, ukuran halaman default akan digunakan.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
search
Menentukan ekspresi pencarian yang digunakan untuk menyaring hasil tampilan. Ekspresi pencarian kata kunci sederhana memfilter berdasarkan apakah atribut dimulai dengan kata kunci. Wildcard * juga dapat dimasukkan dalam ekspresi.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request,, sehingga filter pencarian dapat diatur berdasarkan pada input pengguna.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
Kode bahasa bilangan bulat Dataverse untuk memilih label lokal tampilan entitas (label header kolom, dll.) yang akan dimuat. Jika tidak ada language_code yang disediakan, bahasa default koneksi aplikasi Dataverse situs web digunakan.
Jika entityview digunakan dalam blok entitylist, entityview mewarisi konfigurasi kode bahasanya dari entitylist.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Melakukan query terhadap pencarian situs web indeks. Hasil pencocokan kemudian dapat diakses menggunakan indeks pencarian yang tersedia di dalam blok tag.
{% 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>
Secara default, objek indeks pencarian diberi nama variabel searchindex. Opsional, nama variabel yang berbeda dapat disediakan.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parameter
Tag searchindex menerima parameter berikut.
query
Kueri yang digunakan untuk mencocokkan hasil. Parameter ini ditujukan untuk menerima bagian yang ditetapkan pengguna dari kueri Indeks (jika ada).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
Parameter ini mendukung sintaks Lucene Query Parser.
filter
Kueri lain yang digunakan untuk mencocokkan hasil. Parameter ini ditujukan untuk menerima filter ditentukan pengembang untuk hasil, jika diinginkan.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
Parameter ini mendukung sintaks Lucene Query Parser.
Catatan
Perbedaan antara filter dan query adalah bahwa meskipun keduanya akan menerima sintaks Lucene Query Parser, query dimaksudkan untuk menjadi lebih menerima tentang bagaimana sintaks ini diurai ߝ seperti yang diharapkan bahwa sebagian besar pengguna akhir tidak akan menyadari sintaks ini. Jadi, dalam kasus bahwa parsing query menurut sintaks ini gagal, seluruh permintaan akan lolos dan diajukan sebagai teks kueri. filter, di sisi lain, akan diurai secara ketat dan menghasilkan kesalahan jika kasus sintaks yang tidak valid.
logical_names
Nama logis entitas Dataverse untuk mana hasil yang cocok akan dibatasi, sebagai string dibatasi koma. Jika tidak disediakan, semua entitas yang cocok akan dikembalikan.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
page
Halaman hasil pencarian yang akan dihasilkan. Jika tidak disediakan, halaman pertama (1) dikembalikan.
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Kasus penggunaan umum adalah untuk menetapkan parameter ini didasarkan pada request.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
Ukuran halaman hasil pencarian yang akan dihasilkan. Jika tidak disediakan, ukuran default 10 digunakan.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Sepenuhnya merender formulir, menurut nama atau ID.
Catatan
Tag entityform ini hanya tersedia untuk digunakan dalam konten yang dirender di dalam template halaman berbasis web template–. Mencoba menggunakan tag di dalam Template halaman berbasis menulis ulang tidak akan menghasilkan apa-apa. Anda hanya dapat membuat satu tag entityform atau webform per halaman. Tag entityform atau webform setelah yang pertama tidak akan dirender.
{% entityform name: 'My Basic Form' %}
Parameter
name
Nama formulir dasar yang ingin Anda render.
{% entityform name:My Basic Form %}
webform
Sepenuhnya merender formulir multilangkah, menurut nama atau ID. Tag webform ini hanya tersedia untuk digunakan dalam konten yang dirender di dalam template halaman berbasis web template. Mencoba menggunakan tag di dalam Template halaman berbasis menulis ulang tidak akan menghasilkan apa-apa. Anda hanya dapat merender satu entityform atau tag webform per halaman. Tag entityform atau webform setelah yang pertama tidak akan dirender.
{% webform name: 'My Multistep Form' %}
Parameter
name
Nama formulir multilangkah yang ingin Anda render.
{% webform name:My Multistep Form %}
codecomponent
Memungkinkan Anda menanam komponen kode menggunakan tag Liquid. Contohnya, menambahkan kontrol kustom tampilan peta ke halaman web.
Parameter
name
ID atau nama komponen kode.
property
Nilai properti yang diperkirakan komponen kode harus diteruskan sebagai pasangan kunci/nilai yang dipisahkan oleh ":" (tanda titik dua), dengan kunci adalah nama properti dan nilainya adalah nilai string JSON.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Catatan
Properti yang diperlukan mungkin berbeda, tergantung pada komponen yang dipilih.
Lihat Menggunakan tag templat Liquid komponen kode.