Tag template

Artikel
03/14/2023

Catatan

Mulai 12 Oktober 2022, portal Power Apps menjadi Power Pages. Informasi selengkapnya: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan segera memigrasikan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages.

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 webtemplate.

<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	pemetaan versi jumlah halaman paging-cookie utc-offset agregat distinct min-active-row-version output-format returntotalrecordcount no-lock	pesanan entitas
pesanan	atribut alias besar ke kecil
entitas	nama all-attributes no-attrs atribut	pesanan filter link-entity
filter	jenis petunjuk isquickfindfields	kondisi filter
link-entity	nama dari kepada alias link-type terlihat perpotongan all-attributes no-attrs atribut	pesanan filter link-entity
kondisi	kolom entityname atribut operator agregat alias uiname uitype uihidden nilai	nilai

include

Mencakup isi dari satu template lain, menurut nama. Di portal Power Apps, sumber template lainnya ini umumnya akan berupa template web. Hal 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. Ini kemudian dapat didefinisikan sebagai variabel dalam template yang disertakan.

{% include 'My Template' a:x, b:y %}

block

Digunakan dalam hubungannya dengan extends untuk memberikan warisan template. Lihat extends untuk penggunaan.

extends

Digunakan dalam hubungannya dengan tag block, memberikan warisan template. Hal ini memungkinkan beberapa template untuk menggunakan tata letak bersama, sementara menimpa daerah tertentu tata letak induk.

Di portal Power Apps, 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.

Kode

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. Hal 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.

Bagikan melalui