Bagikan melalui

Tag template

  • Artikel

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 tentang kueri data menggunakan FetchXML di gunakan FetchXML untuk kueri 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 di variabel yang diberikan (seperti ' resultVariable ' di sampel di atas) menyimpan hasil kueri FetchXML 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>

  • TableName

    Mendapatkan Nama logis entitas.

  • ExtensionData

    Mendapatkan struktur yang berisi data tambahan.

  • MinActiveRowVersion

    Mendapatkan nilai versi baris aktif terendah.

  • MoreRecords

    Mendapatkan Apakah ada rekaman lainnya yang tersedia.

  • PagingCookie

    Mendapatkan informasi paging saat ini.

  • TotalRecordCount

    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 ' di sampel di atas) menyimpan kueri resultan yang dapat digunakan untuk mendapatkan data dari 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

Tag liquid Fetchxml mendukung atribut berikut, dan elemen anak.

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 Power Pages, sumber template lainnya ini umumnya akan berupa template web. Operator ini memungkinkan untuk menggunakan kembali fragmen template umum di banyak tempat.

Ketika template disertakan di lainnya, template yang disertakan akan memiliki akses ke setiap variabel yang didefinisikan dalam template induk.

{% include 'My Template' %}

Juga mungkin untuk meneruskan sejumlah parameter bernama ke tag include. Parameter ini kemudian dapat didefinisikan sebagai variabel dalam template 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.

Di Power Pages, nama template induk yang diberikan ke tag akan umumnya mengacu ke nama web template.

Ketika extends digunakan, itu harus menjadi konten pertama dalam template, dan hanya akan diikuti oleh satu atau lebih tag block.

Jika blok yang didefinisikan dalam template induk tidak diganti, isinya dalam template induk (jika ada) akan dirender.

komentar

Memungkinkan Anda untuk meninggalkan kode yang tidak render dalam template Liquid. Konten dalam blok tidak akan dirender, dan kode Liquid apapun di dalamnya tidak akan dijalankan.

Code

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Output

Hello. My name is Charles.

raw

Memungkinkan output kode Liquid di halaman tanpa diurai dan dieksekusi.

Output

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 aliran Kontrol
Tag iterasi
Tag variabel
Tag Liquid Dataverse
Menggunakan tag templat Liquid komponen kode