Tag template
Tag template mengontrol output template dalam berbagai cara, dan memungkinkan kombinasi dari beberapa template ke output tunggal.
FetchXML
Memungkinkan pengguna untuk mengkueri data dari Microsoft Dataverse dan merender hasilnya di halaman.
Catatan
Anda dapat mempelajari lebih lanjut cara mengkueri data menggunakan fetchxml yang digunakan FetchXML untuk mengkueri data.
{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}
Saat menggunakan fetchxml untuk kueri data, pastikan Anda tidak menggunakan tag penutupan mandiri. Contohnya, daripada <attribute name="title"/>
, gunakan <attribute name="title"></attribute>
dengan tag penutupan eksplisit </attribute>
.
Atribut hasil
Atribut hasil dalam variabel yang disediakan (seperti 'resultVariable' dalam sampel sebelumnya) menyimpan FetchXML hasil kueri dan beberapa atribut lainnya.
Entitas
Atribut ini berisi hasil kueri fetchxml. Anda dapat mengulang hasil dan menggunakannya di template web.
<table> {% for entityVariable in resultVariable.results.entities %} <tr> <td>Attribut-1: {{ entityVariable.attribute1 }}</td> <td>Attribut-2: {{ entityVariable.attribute2 }}</td> </tr> {% endfor %} </table>
Nama Tabel
Mendapatkan Nama logis entitas.
Data Ekstensi
Mendapatkan struktur yang berisi data tambahan.
Versi MinActiveRow(Bahasa Inggris)
Mendapatkan nilai versi baris aktif terendah.
Catatan Lainnya
Mendapatkan Apakah ada rekaman lainnya yang tersedia.
PagingCookie
Mendapatkan informasi paging saat ini.
Jumlah Rekaman Total
Mendapatkan jumlah total rekaman dalam koleksi.
ReturnTotalRecordCount benar ketika kueri dieksekusi.TotalRecordCountLimitExceeded
Mendapatkan Apakah hasil kueri melebihi jumlah total rekaman.
Atribut XML
Atribut XML dalam variabel yang disediakan (seperti 'resultVariable' dalam sampel sebelumnya) menyimpan kueri hasil yang dapat digunakan untuk mendapatkan data Microsoft Dataverse. Atribut ini berguna untuk tujuan debugging bila Anda ingin memahami cara penerapan izin tabel pada tag fetchxml ini.
Elemen dan atribut lain yang didukung
Fetchxml liquid mendukung atribut berikut, dan elemen turunan.
Elemen/Elemen Anak | Atribut | Elemen anak |
---|---|---|
fetch | mapping version count page paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock |
order entitas |
pesanan | attribute alias besar ke kecil |
|
entitas | name all-attributes no-attrs atribut |
order filter link-entity |
filter | type hint isquickfindfields |
condition filter |
link-entity | name from to alias link-type visible intersect all-attributes no-attrs atribut |
order filter link-entity |
kondisi | column entityname attribute operator aggregate alias uiname uitype uihidden nilai |
nilai |
include
Mencakup isi dari satu template lain, menurut nama. Di dalam Power Pages, sumber template lain ini umumnya adalah template web. Operator ini memungkinkan untuk menggunakan kembali fragmen template umum di banyak tempat.
Ketika templat disertakan dalam templat lain, templat yang disertakan memiliki akses ke variabel apa pun yang ditentukan dalam templat induk.
{% include 'My Template' %}
Juga mungkin untuk meneruskan sejumlah parameter bernama ke tag include. Parameter ini didefinisikan sebagai variabel dalam templat yang disertakan.
{% include 'My Template' a:x, b:y %}
block
Digunakan dengan extends untuk memberikan warisan template. Lihat extends untuk penggunaan.
extends
Digunakan dengan tag block, memberikan warisan template. Operator ini memungkinkan beberapa template untuk menggunakan tata letak bersama, sementara menimpa daerah tertentu tata letak induk.
Dalam itu Power Pages, nama template induk yang diberikan ke tag umumnya mengacu pada nama template web.
Ketika extends digunakan, itu harus menjadi konten pertama dalam template, dan hanya akan diikuti oleh satu atau lebih tag block.
Jika blok yang ditentukan dalam templat induk tidak ditimpa, isinya dalam templat induk (jika ada) dirender.
komentar
Memungkinkan Anda untuk meninggalkan kode yang tidak render dalam template Liquid. Konten apa pun di dalam blok tidak dirender, dan kode Liquid apa pun di dalamnya tidak dieksekusi.
Kode
Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.
Hasil
Hello. My name is Charles.
raw
Fitur ini memungkinkan Anda menampilkan kode Liquid pada halaman tanpa mengurai atau menjalankannya.
Hasil
Hello, {{ user.fullname }}. My name is Charles.
Penggantian
Anda dapat menggunakan tag ini saat mengaktifkan cache header dan footer, dan ingin menghindari cache dari keluaran bagian tertentu. Tag ini menyediakan blok konten di header atau footer dengan output dari blok konten terbungkus yang tidak masuk dalam cache. Operator ini sangat membantu dalam skenario di mana pengguna menggunakan objek yang sering kali diperbarui, seperti permintaan, halaman, bahasa, dan tanggal. Misalnya, lihat skenario header dan footer kode sumber template web saat caching header dan footer diaktifkan.
Tip
URL yang digunakan di request.url dapat berupa nilai yang diminta, dan akan di- cache untuk permintaan berikutnya. Untuk memastikan nilai yang benar di request.url, pertimbangkan penggunaan tag substitusi, URL parsial seperti jalur ~{WebFile} atau penyimpanan URL portal di pengaturan situs.
codecomponent
Lihat Pahami tag entitas Dataverse codecomponent, Gunakan tag template Liquid komponen kode.
Baca juga
Tag alur kontrol
Tag iterasi
Tag variabel
Dataverse Tag cair
Menggunakan komponen kode Tag template Liquid