Bagikan melalui


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