Bagikan melalui


Objek Liquid yang tersedia

Objek-objek Liquid berisi atribut untuk konten dinamis output ke halaman. Sebagai contoh, objek halaman mempunyai atribut yang disebut title yang dapat digunakan untuk menampilkan judul halaman aktif.

Untuk mengakses atribut objek menurut nama, gunakan titik (.). Untuk merender sebuah atribut objek dalam sebuah template, bungkus dalam {{ and }}.

Penting

Untuk menghindari kemungkinan masalah XSS (skrip antar-situs), selalu gunakan filter escape untuk mengkode HTML data setiap kali menggunakan objek Liquid untuk membaca data tidak tepercaya yang diberikan oleh pengguna.

{{ page.title }}

Atribut objek juga dapat diakses dengan menggunakan nama string dan []. Format ini berguna bila atribut yang diinginkan ditentukan secara dinamis, atau nama atribut berisi karakter, spasi, karakter khusus, dan seterusnya yang akan invalid ketika menggunakan titik (.) di dalam sintaks.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Objek berikut dapat digunakan dan diakses di mana saja, dalam setiap template.

Objek Deskripsi
entitas Memungkinkan Anda untuk memuat tabel Microsoft Dataverse menurut ID. Informasi lebih lanjut: entities
sekarang Sebuah objek tanggal/waktu yang merujuk kepada waktu UTC saat ini, pada saat template dirender.
Catatan: Aplikasi web portal menyimpan nilai ini dan tidak disegarkan setiap saat. Informasi selengkapnya: Filter tanggal
halaman Merujuk ke halaman permintaan portal saat ini. Objek halaman menyediakan akses ke hal-hal seperti remah roti untuk halaman saat ini, judul, atau URL halaman sekarang, dan atribut atau entitas terkait rekaman Dataverse yang mendasari. Informasi lebih lanjut: page
params Jalan pintas yang nyaman untuk request.params. Informasi lebih lanjut: request
permintaan Berisi informasi tentang permintaan HTTP saat ini. Informasi lebih lanjut: request
pengaturan Memungkinkan Anda untuk memuat segala pengaturan situs menurut nama. Informasi selengkapnya: settings
sitemap Memungkinkan akses ke peta situs portal. Informasi selengkapnya: sitemap
sitemarkers Memungkinkan Anda untuk memuat segala penanda situs menurut nama. Informasi selengkapnya: sitemarkers
potongan Memungkinkan Anda untuk memuat segala potongan konten menurut nama. Informasi selengkapnya: snippets
pengguna Merujuk ke pengguna portal saat ini, yang memungkinkan akses semua atribut rekaman kontak Dataverse yang mendasari. Jika tidak ada pengguna yang masuk, variabel ini null. Informasi lebih lanjut: user
tautan Web Memungkinkan Anda untuk memuat segala Web Link Set menurut nama atau ID. Informasi selengkapnya: weblinks
situs web Merujuk ke portal rekaman situs web, yang memungkinkan akses semua atribut rekaman situs web Dataverse (adx_website) untuk portal. Informasi selengkapnya: website

iklan

Mengaktifkan pengambilan dan tampilan iklan.

Objek ads memungkinkan Anda untuk memilih iklan atau penempatan iklan tertentu:

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

Atribut iklan

Atribut Deskripsi
placements Menghasilkan objek adplacements.
[nama iklan atau id] Anda dapat mengakses setiap iklan menurut sifat nama atau Id.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atribut Penempatan Iklan

Atribut Deskripsi
[nama penempatan atau id] Anda dapat mengakses setiap adplacement menurut sifat nama atau Id.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atribut Penempatan Iklan

Penempatan iklan adalah objek tabel dengan atribut umum yang sama, dan atribut berikut:

Atribut Description
Iklan Menghasilkan koleksi objek iklan yang terkait dengan penempatan. Tag iterasi dan filter Array dapat digunakan dengan koleksi ini.
Nama Menghasilkan bidang nama untuk penempatan iklan.
placement_url URL yang dapat digunakan untuk mengambil penempatan iklan yang dirender sepenuhnya oleh template.
random_url URL yang dapat digunakan untuk mengambil iklan acak dari penempatan yang dirender sepenuhnya oleh template.

Atribut iklan

Catatan

Iklan adalah objek tabel, dengan semua atribut yang sama selain yang berikut:

Atribut Description
ad_url URL yang dapat digunakan untuk mengambil iklan yang dirender sepenuhnya oleh template.
Salin Menghasilkan bidang Copy untuk iklan.
image Menghasilkan objek gambar (jika ada) untuk iklan.
Nama Menghasilkan bidang Nama untuk iklan.
open_in_new_window Menghasilkan nilai true apabila URL yang ditentukan oleh redirect_url harus membuka di jendela baru.
redirect_url URL yang diarahkan pengguna dengan memilih iklan.

Atribut gambar Iklan

Atribut Deskripsi
alternate_text Menghasilkan teks yang dimaksudkan untuk muncul dalam atribut alt tag.
tinggi Menghasilkan tinggi dalam pixel untuk gambar
url Menghasilkan sumber URL untuk gambar.
lebar Menghasilkan lebar dalam pixel untuk gambar

blog

Memungkinkan pengambilan dan tampilan Blog dan Posting Blog.

Objek blogs memungkinkan Anda untuk memilih blog tertentu atau posting blog.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

objek blogs

Objek blog memungkinkan Anda untuk mengakses blog tertentu di portal, atau untuk mengakses semua posting blog di portal.

Tabel berikut menjelaskan atribut yang diasosiasikan dengan objek blogs.

Atribut KETERANGAN
posts Menghasilkan objek blogposts yang mengandung semua posting blog di portal.
[nama atau id blog] Anda dapat mengakses setiap blog menurut sifat nama atau Id.
{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

Objek blog

Objek blog memungkinkan Anda untuk bekerja dengan satu blog, memungkinkan Anda untuk mengakses posting untuk blog itu.

Tabel berikut menjelaskan berbagai atribut yang diasosiasikan dengan objek blog.

Atribut KETERANGAN
posts Menghasilkan objek blogposts yang mengandung semua posting untuk blog itu.
Nama Nama blog.
judul Judul blog.
url URL Blog.

Objek blogposts

Objek blogposts memungkinkan Anda untuk mengakses koleksi benda-benda posting blog. Anda dapat mengurutkan posting blog dan mencapai penomoran halaman serta menggunakan penyaring Liquid:

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Pilihan lain yang mungkin:

  • blogs.posts.all (untuk mendapatkan semua posting blog)
  • blogs.posts | from\_index: 0 | take: 2

Tabel berikut menjelaskan berbagai atribut yang diasosiasikan dengan objek blogposts.

Atribut KETERANGAN
Semua Menghasilkan semua objek blogpost dalam koleksi

Objek blogpost

Mengacu pada posting blog tunggal.

Tabel berikut menjelaskan berbagai atribut yang diasosiasikan dengan objek blogpost.

Atribut KETERANGAN
url URL posting.
konten Menghasilkan bidang Konten untuk posting.
author Menghasilkan penulis untuk posting (yang hanya merupakan objek tabel kontak.
title Judul posting.
comment_count Menghasilkan nilai bilangan bulat dari jumlah berapa banyak komentar untuk posting tertentu.
publish_date Tanggal di mana posting diterbitkan.

entitas

Perhatian

Untuk menghindari kemungkinan masalah XSS (skrip antar-situs), selalu gunakan filter escape ke HTML encode string data setiap kali menggunakan objek Liquid entitas untuk membaca data tidak tepercaya yang diberikan oleh pengguna.

Catatan

Beberapa aturan penamaan Dataverse telah diubah , misalnya, entitas Dataverse sekarang disebut tabel. Perubahan nama tidak berlaku untuk objek Liquid. Objek entitas Liquid akan terus dirujuk sebagai entitas.

Memungkinkan Anda untuk memuat tabel Dataverse menurut ID. Jika tabel ada, objek tabel dikembalikan. Jika tabel dengan ID yang diberikan tidak ditemukan,null dikembalikan.

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Entitas

Objek entitas menyediakan akses ke atribut Dataverse rekaman tabel.

Atribut KETERANGAN
Id ID GUID dari tabel, sebagai string. Misalnya, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nama logis Dataverse tabel.
Catatan Memuat catatan apa pun (anotasi) yang terkait dengan tabel, diurutkan dari terlama ke terbaru (createdon). Catatan akan dihasilkan sebagai objek catatan.
izin Memuat hasil pernyataan izin tabel untuk tabel. Hasil akan diberikan sebagai objek izin.
url Menghasilkan jalur URL sistem manajemen konten Power Pages untuk tabel. Jika tabel tidak memiliki URL valid di situs yang sekarang, menghasilkan null. Umumnya, ini hanya mengembalikan nilai untuk jenis tabel tertentu yang telah diintegrasikan ke dalam portal CMS, kecuali Anda menyesuaikan Penyedia URL dalam aplikasi Anda.
[nama atribut atau hubungan] Anda dapat mengakses setiap atribut dari tabel Dataverse menurut nama logis. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Nilai-nilai sebagian besar atribut tabel terpetakan langsung ke Jenis Liquid: Dua bidang pilihan terpetakan ke Boolean, bidang teks ke string, bidang numerik/mata-uang ke angka, bidang tanggal/waktu ke objek tanggal. Namun, beberapa jenis atribut dihasilkan sebagai objek:
  • Bidang pencarian (Referensi Tabel Terkait) dikembalikan sebagai objek referensi tabel terkait.
  • Bidang rangkaian pilihan/daftar pilihan dikembalikan sebagai objek nilai rangkaian pilihan.
  • Anda juga dapat memuat setiap entitas terkait menurut nama skema hubungan.
  • {{ page.adx_webpage_entitylist.adx_name }}Dalam hal suatu hubungan bersifat refleksif (yaitu, referensi diri), objek hubungan refleksif dikembalikan. (Jika tidak, hasil akan ambigu.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Catatan: Memuat entitas terkait dalam jumlah besar, atau mengakses sejumlah besar hubungan dalam satu template, dapat memiliki dampak negatif pada kinerja render template. Hindari memuat entitas terkait untuk setiap item dalam larik, dalam sebuah loop. Bila mungkin, gunakan tag tabel Dataverse untuk memuat koleksi entitas.

Referensi Tabel Terkait

Nilai atribut Lookup kembali sebagai objek referensi tabel terkait dengan atribut berikut.

Atribut KETERANGAN
Id ID GUID dari tabel yang dirujuk, sebagai string.
Misalnya, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nama logis Dataverse tabel yang direferensikan.
Nama Atribut nama primer tabel yang direferensikan.

Catatan

Catatan adalah objek tabel yang menyediakan akses ke atribut dan hubungan rekaman anotasi. Selain semua atribut objek tabel, catatan memiliki atribut tambahan berikut.

Atribut Description
documentbody Memuat atribut documentbody dari rekaman anotasi catatan, sebagai string Base64-encoded. Karena konten atribut ini mungkin besar, atribut ini tidak dimuat dengan atribut note lainnya, atribut ini hanya dimuat sesuai permintaan.
Catatan: Penggunaan atribut documentbody dapat berdampak negatif pada performa rendering template, dan harus dilakukan dengan hati-hati.
Sebaliknya, gunakan atribut url untuk memberikan link ke lampiran catatan, jika mungkin.
url Menghasilkan jalur URL untuk handler lampiran anotasi portal bawaan. Jika pengguna memiliki izin, dan catatan memiliki file lampiran, permintaan ke URL ini akan mengunduh lampiran file catatan.

Catatan

Filter Tambahan

Nilai Rangkaian Pilihan

Nilai atribut rangkaian pilihan/daftar pilihan dikembalikan sebagai objek referensi tabel terkait, dengan atribut berikut.

Atribut KETERANGAN
Label Label lokal nilai atribut rangkaian pilihan/daftar pilihan. Misalnya, Aktif
Nilai Nilai bilangan bulat lokal nilai atribut rangkaian pilihan/daftar pilihan. Contoh, 0

Izin Tabel

Objek izin Tabel menyediakan akses ke hasil pernyataan gabungan izin untuk tabel.

Atribut Deskripsi
can_append Menghasilkan true jika pengguna saat ini memiliki izin untuk menambahkan rekaman ke hubungan rekaman ini. Jika tidak, menghasilkan false.
can_append_to Menghasilkan true jika pengguna saat ini memiliki izin untuk menambahkan rekaman ini ke hubungan tabel lainnya. Jika tidak, menghasilkan false.
can_create Menghasilkan true jika pengguna saat ini memiliki izin untuk membuat rekaman baru tipe tabel ini. Jika tidak, menghasilkan false.
can_delete Menghasilkan true jika pengguna saat ini memiliki izin untuk menghapus rekaman ini. Jika tidak, menghasilkan false.
can_read Menghasilkan true jika pengguna saat ini memiliki izin untuk membaca rekaman ini. Jika tidak, menghasilkan false.
can_write Menghasilkan true jika pengguna saat ini memiliki izin untuk pembaruan rekaman ini. Jika tidak, menghasilkan false.
rules_exist Menghasilkan true jika hasil izin yang diwakili oleh objek ini adalah hasil dari aturan izin yang secara eksplisit ditetapkan. Mengembalikan false jika merupakan hasil default tanpa adanya izin yang ditentukan secara eksplisit.

Relasi refleksif

Upaya untuk memuat hubungan refleksif (yaitu referensial mandiri) pada entitas dihasilkan sebagai objek dengan atribut berikut.

Atribut Deskripsi
is_reflexive Mengembalikan nilai true. Dapat digunakan untuk menguji jika sebuah objek yang dihasilkan oleh hubungan adalah objek relasi refleksif.
referenced Menghasilkan larik entitas yang direferensikan untuk relasi tertentu.
referencing Menghasilkan tabel pereferensi untuk relasi tertentu. Menghasilkan null jika tidak ada tabel pereferensi. Jika relasi banyak-ke-banyak (N:N), menghasilkan larik dari entitas pereferensi.

entitylist

Objek daftar entitas digunakan dalam tag tabel Dataverse. Ini menyediakan akses ke semua atribut dari daftar tertentu.

Atribut

Catatan

entities

Atribut Deskripsi
create_enabled Menghasilkan true jika pembuatan rekaman baru dikonfigurasi untuk daftar. Jika tidak, menghasilkan false.
create_url Menghasilkan jalur URL dikonfigurasi untuk pembuatan tautan/tombol untuk daftar.
detail_enabled Menghasilkan true jika tampilan detail untuk masing-masing rekaman dikonfigurasi untuk daftar. Jika tidak, menghasilkan false.
detail_id_parameter Menghasilkan nama parameter string kueri untuk menggunakan ID rekaman ketika membangun URL tampilan detail rekaman. Lihat filter URL untuk rincian tentang menggunakan filter Liquid untuk membangun URL. Misalnya, id
detail_label Menghasilkan label lokal dikonfigurasi untuk tautan/tombol tampilan detail untuk daftar.
detail_url Menghasilkan jalur URL dikonfigurasi untuk tautan/tombol tampilan detail untuk daftar.
empty_list_text Menghasilkan teks lokal dikonfigurasi untuk ditampilkan ketika tampilan daftar tidak memberikan hasil.
enable_entity_permissions Menghasilkan true jika penyaringan izin tabel diaktifkan untuk daftar ini. Jika tidak, menghasilkan false.
entity_logical_name Menghasilkan nama logis tabel Dataverse untuk rekaman yang akan ditampilkan oleh daftar ini. Contohnya, contact.
filter_account_attribute_name Mengembalikan nama logis atribut untuk pencarian ke akun yang digunakan untuk memfilter rekaman hasil menurut akun induk pengguna portal saat ini. Contoh: accountid
filter_apply_label Menghasilkan label lokal dikonfigurasi untuk digunakan untuk tombol/link yang menerapkan filter atribut lanjutan untuk hasil daftar.
filter_definition Menghasilkan definisi filter atribut JSON untuk daftar. Lihat filter daftar untuk rincian tentang bagaimana menggunakan filter Liquid metafilters untuk memproses definisi ini.
filter_enabled Menghasilkan true jika pemfilteran atribut lanjutan diaktifkan untuk daftar. Jika tidak, menghasilkan false.
filter_portal_user_attribute_name Mengembalikan nama logis atribut untuk pencarian ke kontak yang digunakan untuk memfilter rekaman hasil menurut kontak pengguna portal saat ini. Contohnya, contactid
filter_website_attribute_name Mengembalikan nama logis atribut untuk pencarian ke adx_website yang digunakan untuk memfilter rekaman hasil oleh situs web portal saat ini. Contoh: adx_websiteid
language_code Menghasilkan kode bahasa bilangan bulat Dataverse yang akan digunakan untuk memilih semua label lokal untuk daftar ini.
page_size Menghasilkan ukuran halaman hasil dikonfigurasi untuk daftar.
primary_key_name Menghasilkan nama logis atribut kunci primer untuk rekaman yang akan ditampilkan oleh daftar ini.
search_enabled Menghasilkan true jika pencarian diaktifkan untuk daftar ini. Jika tidak, menghasilkan false.
search_placeholder Menghasilkan teks lokal dikonfigurasi untuk placeholder bidang Cari daftar.
search_tooltip Menghasilkan teks lokal dikonfigurasi untuk tooltip pencarian daftar.
tampilan Menghasilkan tampilan yang tersedia untuk daftar, sebagai objek tampilan daftar.
[Nama Logis Atribut] Anda dapat mengakses setiap atribut dari rekaman Dataverse daftar (adx_entitylist) dengan nama logis, dengan cara yang sama seperti objek tabel. Misalnya: {{ entitylist.adx_name }}

Atribut Lihat Daftar

Atribut Deskripsi
kolom Menghasilkan kolom dalam tampilan, sebagai objek kolom tampilan daftar.
entity_logical_name Menghasilkan nama logis tabel Dataverse untuk rekaman yang termasuk dalam tampilan. Contohnya, contact.
Id Menghasilkan GUID ID tampilan.
language_code Mengembalikan Dataverse kode bahasa bilangan bulat yang digunakan untuk memilih semua label yang dilokalkan (header kolom, dll.) untuk tampilan.
Nama Menghasilkan nama tampilan Dataverse dari tampilan.
primary_key_logical_name Menghasilkan nama logis kunci primer tabel Dataverse untuk rekaman yang termasuk dalam tampilan. Contohnya, contactid
sort_expression Menghasilkan default ekspresi sortir untuk tampilan. Sebagai contoh, name ASC, createdon DESC

Atribut Kolom Tampilan Daftar

Atribut Deskripsi
attribute_type Menghasilkan nama jenis atribut Dataverse untuk kolom, sebagai string. Misalnya Lookup, Picklist, String, Boolean, DateTime
logical_name Menghasilkan nama logis atribut Dataverse untuk kolom. Sebagai contoh, createdon
Nama Menghasilkan nama tampilan Dataverse lokal untuk kolom. Sebagai contoh, Created On
sort_ascending Menghasilkan string ekspresi sortir untuk menyortir kolom dengan urutan naik. Sebagai contoh, createdon ASC
sort_descending Menghasilkan string ekspresi sortir untuk menyortir kolom dengan urutan turun. Sebagai contoh, createdon DESC
sort_disabled Menghasilkan true jika penyortiran dinonaktifkan untuk kolom. Jika tidak, menghasilkan false.
sort_enabled Menghasilkan true jika penyortiran diaktifkan untuk kolom. Jika tidak, menghasilkan false.
width Menghasilkan lebar dikonfigurasikan dalam kolom, dalam piksel.

entityview

Objek entityview digunakan dalam entityview tag, dan menyediakan akses metadata untuk tampilan, di samping rekaman hasil tampilan.

Atribut

Atribut KETERANGAN
kolom Menghasilkan kolom dalam tampilan, sebagai objek kolom tampilan tabel.
entity_permission_denied Menghasilkan true jika akses untuk melihat hasil ditolak karena izin tabel yang tidak cukup untuk pengguna saat ini. Menghasilkan false jika akses baca untuk melihat hasil diberikan.
entity_logical_name Nama logis tabel Dataverse dari rekaman lihat hasil. Contohnya, contact.
first_page Nomor halaman dari halaman pertama lihat hasil. Ini adalah 1 kecuali tidak ada hasil yang dikembalikan, dalam hal ini null.
Id ID GUID tampilan Dataverse yang mendefinisikan entityview ini.
language_code Kode bahasa bilangan bulat Dataverse yang digunakan untuk memuat lokal label untuk tampilan yang aktif.
last_page Nomor halaman dari halaman terakhir lihat hasil. Jika tidak ada hasil yang dikembalikan, nilai ini adalah null.
nama Nama tampilan Dataverse yang mendefinisikan entityview ini, misalnya, kontak aktif.
next_page Nomor halaman dari halaman berikutnya lihat hasil. Jika tidak ada halaman hasil berikutnya, nilai ini adalah null.
Halaman Nomor halaman dari halaman saat ini dari lihat hasil.
pages Menghasilkan rangkaian jumlah halaman yang berisi semua halaman hasil untuk tampilan yang aktif.
page_size Nomor hasil yang dimunculkan per halaman untuk tampilan saat ini.
previous_page Nomor halaman dari halaman berikutnya lihat hasil. Jika tidak ada halaman hasil sebelumnya, ini null.
primary_key_logical_name Nama logika Dataverse atribut kunci utama dari tabel hasil untuk tampilan ini. Contohnya, contactid.
data Hasil saat ini dari rekaman hasil untuk tampilan, sebagai objek tabel.
sort_expression Default ekspresi sortir untuk tampilan. Sebagai contoh, nameASC, createdon DESC.
total_pages Jumlah total halaman hasil untuk tampilan.
total_records Jumlah total halaman hasil untuk tampilan (di semua halaman).

aktivitas

Memungkinkan pengambilan dan tampilan acara. Objek events memungkinkan Anda untuk memilih aktivitas atau semua aktivitas.

Objek events

Objek events memungkinkan Anda untuk mengakses aktivitas tertentu di portal, atau untuk mengakses semua posting aktivitas di portal (terlepas dari aktivitas).

Objek events memiliki atribut berikut:

Atribut Description
kemunculan Menghasilkan eventoccurancessobject yang mengandung semua kejadian aktivitas di portal
[nama atau id aktivitas] Anda dapat mengakses aktivitas apa pun menurut properti atau Id namanya.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objek event

Objek event memungkinkan Anda untuk bekerja dengan satu aktivitas, memungkinkan Anda untuk mengakses jadwal dan kejadian untuk aktivitas itu.

Objek event memiliki atribut berikut:

Atribut KETERANGAN
kemunculan Menghasilkan eventoccurrencesobject yang mengandung semua untuk aktivitas.
nama Nama aktivitas.
url URL aktivitas.

Objek eventoccurences

Objek eventoccurrences memungkinkan Anda untuk mengakses objek kejadian aktivitas. Anda dapat mengurutkan kejadian peristiwa dan menentukan rentang tanggal untuk kejadian yang akan diambil, dan mencapai paginasi juga dengan menggunakan filter cairan:

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

Opsi berikut juga dimungkinkan:

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

Atribut berikut terkait dengan objek eventoccurrences

Atribut KETERANGAN
Semua Menghasilkan semua objek eventoccurance dalam koleksi.

Objek eventoccurence

Mewakili terjadinya satu kejadian aktivitas. Berikut ini adalah atribut terkait:

Atribut Description
url URL kejadian.
is_all_day_event Apakah ini aktivitas sepanjang hari?
start_time Waktu mulai aktivitas.
end_time Waktu akhir aktivitas.

forloop

Mengandung sifat yang berguna dalam blok loop for.

Catatan

forloop hanya dapat digunakan dalam tag for.

Code

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Output

This is the first child page!

This is child page number 2.

This is child page number 3.

Atribut

Atribut Keterangan
pertama Menghasilkan true jika merupakan iterasi pertama dari loop. Menghasilkan false jika tidak merupakan iterasi pertama.
index Posisi saat ini item dalam koleksi, di mana item pertama memiliki posisi 1.
index0 Posisi saat ini item dalam koleksi, di mana item pertama memiliki posisi 0.
Terakhir Menghasilkan true jika merupakan iterasi terakhir dari loop. Menghasilkan false jika tidak merupakan iterasi terakhir.
length Menghasilkan jumlah iterasi untuk loop ߝ jumlah item dalam koleksi yang diulangi.
rindex Jumlah item yang tersisa di loop (panjang - indeks) di mana 1 adalah indeks dari item terakhir.
rindex0 Jumlah item yang tersisa di loop (panjang - indeks) di mana 0 adalah indeks dari item terakhir.

forum

Memungkinkan pengambilan dan tampilan Forum dan Thread Forum. Kemampuan untuk menggunakan Liquid untuk membuat forum data meluas ke posting, tapi untuk membuat posting baru atau thread, Anda harus menggunakan template halaman formulir multilangkah ASP.NET dengan fungsionalitas tersebut berupa bawaan (seperti Thread Forum default dan template halaman posting Forum).

Objek Forum memungkinkan Anda untuk memilih sebuah Forum atau Thread Forum:

<div class=content-panel panel panel-default>

<div class=panel-heading>

<h4>

<span class=fa fa-comments aria-hidden=true></span>

{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}

</h4>

</div>

{% for forum in website.forums %}

<ul class=list-group>

<li class=list-group-item>

<div class=row>

<div class=col-sm-6>

<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>

<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>

</div>

<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>

<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>

</div>

</li>

</ul>

{% endfor %}

</div>

objek Forum

Objek forum memungkinkan Anda untuk mengakses forum tertentu di portal, atau untuk mengakses semua posting forum di portal (terlepas dari forum).

Objek forum memungkinkan Anda untuk bekerja dengan satu forum, memungkinkan Anda untuk mengakses thread untuk forum itu.

Objek forumthreads memungkinkan Anda untuk mengakses koleksi objek forumthread. Anda dapat mengurutkan thread forum dan mencapai penomoran halaman serta menggunakan penyaring Liquid.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Sebuah Thread Forum tunggal

Objek forumposts memungkinkan Anda untuk mengakses koleksi pembelanjaan forumpost.

Atribut

Atribut KETERANGAN
threads Menghasilkan objek forumthreads yang mengandung semua posting forumthread di portal.
Semua Menghasilkan semua objek forum dalam portal. Perhatikan bahwa website.forums juga setara.
thread_count Menghasilkan nilai bilangan bulat dengan hitungan berapa banyak thread ada di seluruh situs web.
post_count Menghasilkan nilai bilangan bulat jumlah posting di portal.
[nama atau id forum] Anda dapat mengakses forum apa pun menurut properti atau Id namanya.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

objek forum

Atribut

Catatan

entities

Atribut Deskripsi
threads Menghasilkan objek forumthreads yang mengandung semua thread forum untuk forum itu.
Nama Nama Forum.
thread_count Menghasilkan nilai bilangan bulat dengan hitungan berapa banyak thread ada di forum.
post_count Menghasilkan nilai bilangan bulat dengan hitungan berapa banyak posting di seluruh forum.

objek forumthreads

Atribut

Atribut KETERANGAN
Semua Menghasilkan semua objek forumthread dalam koleksi.

objek forumthread

Atribut

Catatan

entities

Atribut Deskripsi
posts Menghasilkan objek forumposts yang mengandung semua posting forum untuk thread itu.
author Menghasilkan penulis untuk thread (yang hanya merupakan objek tabel kontak).
latest_post Menghasilkan posting terbaru di thread.
first_post Menghasilkan posting pertama di thread.
post_count Menghasilkan nilai bilangan bulat dengan hitungan berapa banyak posting ada di thread.
is_answered Thread dijawab atau tidak?
is_sticky Apakah thread merupakan thread lengket?

objek forumposts

Atribut

Atribut KETERANGAN
Semua Menghasilkan semua objek forumthread dalam koleksi.

Sebuah Posting Forum tunggal

Atribut

Catatan

entities

Atribut Deskripsi
author Menghasilkan penulis untuk posting (yang hanya merupakan objek tabel kontak).
konten Konten posting.
is_answer Apakah posting ini adalah jawaban untuk thread?

pengetahuan

Menyediakan akses ke rekaman tabel kategori dan Dataverse knowledgearticle untuk membuat artikel dan kategori dalam portal.

Atribut

Atribut KETERANGAN
artikel Menghasilkan objek artikel yang berisi objek artikel untuk rekaman tabel knowledgearticle yang tersedia di portal.
penghargaan Menghasilkan objek kategori yang berisi objek kategori untuk rekaman tabel kategori yang tersedia di portal.

objek artikel

Objek artikel memungkinkan Anda untuk mengakses koleksi objek artikel. Anda dapat mengurutkan artikel dan mencapai penomoran halaman serta dengan menggunakan penyaring Liquid.

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

Atribut

Atribut KETERANGAN
populer Menghasilkan kumpulan artikel objek yang berisi tampilan terbanyak. {% assign popular_articles = knowledge.articles.popular %}
terbaru Menghasilkan kumpulan artikel objek yang berisi tanggal modifikasi terakhir. {% assign recent_articles = knowledge.articles.recent %}
atas Menghasilkan kumpulan artikel objek yang berisi nilai tertinggi. {% assign top_articles = knowledge.articles.top %}

Filter

Filter berikut dapat menerima parameter opsional untuk ukuran halaman dan bahasa. Parameter pertama adalah jumlah atau rekaman untuk diambil. Ukuran halaman default-nya adalah 5. Parameter kedua adalah kode bahasa untuk mengambil artikel untuk bahasa tertentu. Filter dapat dikombinasikan dengan filter Liquid lainnya.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atribut Description
populer Menghasilkan kumpulan artikel objek yang berisi tampilan terbanyak. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
terbaru Menghasilkan kumpulan artikel objek yang berisi tanggal modifikasi terakhir. {% assign recent_articles = knowledge.articles \| recent: 5 %}
atas Menghasilkan kumpulan artikel objek yang berisi nilai tertinggi. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

objek kategori

Objek kategori memungkinkan Anda untuk mengakses koleksi objek kategori. Anda dapat mengurutkan kategori dan mencapai penomoran halaman serta dengan menggunakan penyaring Liquid.

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

Atribut

Atribut KETERANGAN
terbaru Menghasilkan kumpulan objek kategori yang berisi tanggal modifikasi terakhir.
top_level Menampilkan kumpulan objek kategori yang tidak memiliki kategori induk.

Filter

Filter berikut dapat menerima parameter opsional yang menunjukkan ukuran halaman. Ukuran halaman default-nya adalah 5. Filter dapat dikombinasikan dengan filter Liquid lainnya.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atribut Description
terbaru Menghasilkan kumpulan objek kategori yang berisi tanggal modifikasi terakhir. Anda dapat memberikan parameter {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Menampilkan kumpulan objek kategori yang tidak memiliki kategori induk. {% assign root_categories = knowledge.categories \| top_level %}

Objek artikel

Objek artikel memungkinkan Anda bekerja dengan satu knowledgearticle untuk menampilkan rincian artikel tersebut di portal.

Atribut

Artikel adalah objek entitas , dengan semua atribut yang sama, selain atribut berikut:

Atribut Description
article_public_number Nomor publik artikel dari artikel.
comment_count Nilai bilangan bulat dari hitungan berapa banyak komentar yang ada untuk artikel tertentu.
konten Konten artikel.
current_user_can_comment Menghasilkan nilai Boolean yang menunjukkan apakah pengguna saat ini dapat menambahkan komentar pada artikel.
is_rating_enabled Menghasilkan nilai boolean yang menunjukkan apakah peringkat pada artikel diaktifkan.
kata kunci Kata kunci pada artikel.
nama Alias alternatif untuk judul artikel.
nilai Nilai peringkat desimal pada artikel.
title Judul entitas.
view_count Nilai bilangan bulat dari berapa kali artikel dilihat.

Objek kategori

Objek kategori memungkinkan Anda bekerja dengan satu kategori untuk menampilkan rinciannya di portal.

Atribut

Kategori adalah objek entitas , dengan semua atribut yang sama, selain atribut berikut:

Atribut Description
categorynumber Nomor kategori dari kategori.
nama Alias alternatif untuk judul kategori.
judul Judul kategori.

bahasa

Menyediakan nama bahasa saat ini, dan kode bahasa jika dukungan multi-bahasa diaktifkan.

Atribut

Atribut KETERANGAN
url URL permintaan saat ini diawali dengan kode bahasa saat ini.
url_substitution URL permintaan saat ini diawali dengan kode bahasa saat ini yang melewati cache output halaman.
nama Judul bahasa saat ini.
kode Kode bahasa dari bahasa tersebut.

Misalnya, template web Languages Dropdown secara default menggunakan objek liquid ini untuk mencantumkan bahasa yang tersedia bila tersedia dalam beberapa bahasa.

batang

Pembuat memiliki kemampuan untuk memasukkan pernyataan log dalam kode Liquid mereka. Saat situs Power pages berjalan, log yang ditambahkan oleh pembuat dalam kode Liquid ditampilkan dalam Power Pages ekstensi alat pengembang. Log ini, yang disematkan oleh pembuat, ditampilkan di ekstensi alat pengembang saat pengaturan diagnostik diaktifkan.

Sintaks berikut dapat digunakan dalam kode Liquid untuk mencatat pesan kustom:

{% log message:'Custom message' level:'Warning' %}

Atribut log

Atribut Description
batang Nama objek cair
pesan String yang mewakili pesan kustom apa pun untuk dicatat
tingkat Catat pesan sebagai Info, Peringatan, atau Kesalahan

Contoh:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

halaman

Merujuk ke halaman permintaan portal saat ini. Objek ini menggabungkan atribut sitemap dan permintaan entities saat ini (biasanya webpage).

Objek halaman menyediakan akses ke hal-hal seperti remah roti untuk halaman saat ini, judul, atau URL halaman sekarang, dan atribut atau entitas terkait rekaman Dataverse yang mendasari.

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

Atribut halaman

Catatan

entities

Atribut Deskripsi
breadcrumbs Kembali peta situs node objek breadcrumb untuk halaman, mulai dari node root peta situs dan berakhir di induk.
children Menghasilkan objek node peta situs anak dari halaman.
parent Menghasilkan node peta situs induk dari halaman. Jika halaman adalah halaman Beranda, induk adalah null.
title Judul halaman.
url URL Halaman.
[nama atribut atau hubungan] Anda dapat mengakses setiap atribut dari rekaman Dataverse yang mendasari halaman menurut nama logis.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Nilai-nilai sebagian besar atribut tabel terpetakan langsung ke Jenis Liquid: Dua bidang pilihan terpetakan ke Boolean, bidang teks ke string, bidang numerik/mata-uang ke angka, bidang tanggal/waktu ke objek tanggal. Namun, beberapa jenis atribut dihasilkan sebagai objek:
  • Bidang pencarian (Referensi Tabel Terkait) dikembalikan sebagai objek referensi tabel terkait.
  • Bidang rangkaian pilihan/daftar pilihan dikembalikan sebagai objek nilai rangkaian pilihan.
  • Anda juga dapat memuat setiap entitas terkait menurut nama skema hubungan.
    {{ page.adx_webpage_entitylist.adx_name }}
    Dalam hal hubungan refleksif (yaitu, referensi diri), objek entitas dikembalikan. (Jika tidak, hasil akan ambigu.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Catatan: Memuat entitas terkait dalam jumlah besar, atau mengakses sejumlah besar hubungan dalam satu template, dapat memiliki dampak negatif pada kinerja render template. Hindari memuat entitas terkait untuk setiap item dalam larik, dalam sebuah loop. Bila mungkin, pilih menggunakan tag tabel Dataverse untuk memuat koleksi entitas.

poling

Memungkinkan pengambilan dan tampilan polling.

Objek polls memungkinkan Anda untuk memilih poling atau penempatan poling tertentu:

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

Atribut polls

Atribut Deskripsi
placements Menghasilkan objek pollplacements.
[nama atau id jajak pendapat] Anda dapat mengakses setiap poling menurut sifat nama atau Id. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atribut Penempatan poling

Atribut Deskripsi
[nama atau id jajak pendapat] Anda dapat mengakses setiap penempatan jajak pendapat menurut sifat nama atau Id.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atribut Penempatan Poling

Catatan

entities

Atribut Deskripsi
Nama Menghasilkan bidang nama untuk penempatan poling.
placement_url URL yang dapat digunakan untuk mengambil penempatan poling yang dirender sepenuhnya oleh template.
poling Menghasilkan koleksi objek poling yang terkait dengan penempatan. Tag iterasi dan filter Array dapat digunakan dengan koleksi ini.
random_url URL yang dapat digunakan untuk mengambil poling acak dari penempatan yang dirender sepenuhnya oleh template.
submit_url URL yang dikirimkan poling yang selesai.

Atribut Poling

Catatan

entities

Atribut Deskripsi
has_user_voted Menghasilkan nilai true jika pengguna saat ini (masuk atau anonim) telah memilih dalam poling ini.
Nama Menghasilkan bidang nama untuk poling.
options Menghasilkan koleksi objek pilihan jajak pendapat yang terkait dengan poling. Tag dan entitas iterasi dapat digunakan dengan koleksi ini.
poll_url URL yang dapat digunakan untuk mengambil poling yang dirender sepenuhnya oleh template.
Pertanyaan Menghasilkan bidang Pertanyaan untuk poling.
submit_button_label Menghasilkan sebuah string yang dapat digunakan untuk menggantikan label tombol Kirim untuk polling.
submit_url URL yang dikirimkan poling yang selesai.
user_selected_option Mengembalikan objek polloption yang dipilih oleh pengguna (jika mereka sudah memberikan suara).
votes Mengembalikan jumlah suara yang ditabulasi untuk polling.

Atribut Pilihan Poling

Catatan

entities

Atribut Deskripsi
answer Menghasilkan bidang Jawaban untuk poling.
percentage Menghasilkan persentase suara dalam poling untuk opsi dalam angka desimal dari 0 hingga 100.
votes Mengembalikan jumlah suara yang ditabulasi untuk opsi.

permintaan

Berisi informasi tentang permintaan HTTP saat ini.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Catatan

  • Anda dapat membangun URL secara dinamis dalam Liquid dengan menggunakan filter URL.
  • 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.
  • Rilis Power Pages versi 9.3.8.x atau yang lebih baru secara default akan menerapkan filter Liquid escape untuk pengguna dan meminta objek Liquid. Untuk menonaktifkan konfigurasi default ini dan memungkinkan objek Liquid ini tanpa filter Liquid escape, lihat pengaturan situs portal - Site/EnableDefaultHtmlEncoding.

Atribut

Atribut KETERANGAN
params Nilai parameter bernama untuk permintaan saat ini. params adalah kombinasi dari parameter string kueri URL, parameter posting formulir, dan kuki.
Jalur Jalur URL permintaan saat ini.
/profile/
path_and_query Jalur dan kueri URL permintaan saat ini.
/profile/?foo=1&bar=something
query Bagian kueri URL permintaan saat ini.
?foo=1&bar=something
url URL lengkap permintaan saat ini.
https://www.example.com/profile/?foo=1&bar=something

searchindex

Objek searchindex digunakan dalam tag tabel Dataverse, dan menyediakan akses ke hasil kueri.

{% 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 %}

Atribut

Atribut Deskripsi
approximate_total_hits Menghasilkan jumlah perkiraan jumlah hit yang cocok dengan query indeks. Karena cara kerja indeks pencarian sehubungan dengan penyaringan keamanan dan faktor desain lainnya, angka ini hanya perkiraan, dan mungkin tidak sama persis dengan jumlah total hasil yang tersedia untuk pengguna saat ini dalam beberapa situasi.
Halaman Menghasilkan jumlah halaman kueri saat ini.
page_size Menghasilkan ukuran halaman maksimum kueri saat ini. Jika Anda ingin jumlah aktual hasil yang ditampilkan untuk halaman saat ini (karena ini mungkin kurang dari ukuran halaman maksimum yang ditentukan), gunakan results.size.
hasil Menghasilkan laman hasil kueri, seperti objek hasil indeks pencarian.

Hasil Indeks Pencarian

Atribut KETERANGAN
entitas entities yang mendasari untuk hasil.
fragment Fragmen teks pendek yang relevan untuk hasilnya, dengan istilah yang cocok dengan kueri tertentu disorot menggunakan HTML tag <em>. Jenis kueri tertentu tidak mendukung fragmen yang disorot, seperti kueri fuzzy (~) dan kueri wildcard (*). Properti ini null dalam kasus tersebut.
Id ID tabel Dataverse dari rekaman yang mendasari untuk hasilnya, sebagai string. Misalnya, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nama logis tabel Dataverse dari rekaman yang mendasari untuk hasilnya. Contoh: adx_webpage
Nomor Jumlah hasil, di semua halaman hasil, mulai dari 1. Misalnya, untuk hasil pertama dari hasil halaman kedua, dengan ukuran halaman 10, nilai ini adalah 11.
score Skor Lucene hasil, sebagai nilai titik ambang. Hasil dikembalikan diurutkan berdasarkan nilai ini.
title Judul hasil.
url URL yang mendasari untuk hasil. Ini biasanya akan—tetapi tidak perlu—menjadi jalur absolut untuk aplikasi saat ini, daripada URL lengkap. Misalnya: /articles/article1/

pengaturan

Memungkinkan Anda untuk memuat segala pengaturan situs menurut nama. Jika potongan dengan nama tertentu tidak ditemukan null akan dihasilkan.

Catatan

Pengaturan dihasilkan sebagai string, namun Anda dapat menggunakan Filter Type untuk mengkonversikannya ke jenis lain.

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

sitemap

Memungkinkan akses ke peta situs portal.

<h1>{{ sitemap.root.title }}</h1>

<ul class=breadcrumb>

{% for crumb in sitemap.current.breadcrumbs %}

<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>

{% endfor %}

<li class=active>{{ sitemap.current.title }}</li>

</ul>

{% for child in sitemap.current.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

It's also possible to load a site map node by URL path:

{% assign node = sitemap[/content/page1/] %}

{% if node %}

{% for child in node.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

{% endif %}

Atribut Peta Situs

Atribut KETERANGAN
Saat Ini Menghasilkan objek node peta situs untuk halaman saat ini.
Akar Menghasilkan objek node peta situs untuk halaman (beranda) akar dari situs web.

Atribut Node Peta Situs

Atribut KETERANGAN
Breadcrumb Kembali peta situs node objek breadcrumb untuk node, mulai dari node root peta situs dan berakhir di induk.
Anak-Anak Menghasilkan objek node peta situs anak dari node.
KETERANGAN Konten ringkasan/Deskripsi untuk node. (Bidang ini mungkin berisi HTML.)
Entitas Menghasilkan entities yang mendasari dari node. Jika node tidak memiliki tabel yang mendasarinya, nilai ini adalah null.
is_sitemap_ancestor Menghasilkan true jika node peta situs adalah moyang node saat ini, jika tidak false.
is_sitemap_current Menghasilkan true jika node peta situs adalah node saat ini, jika tidak false.
Induk Menghasilkan node peta situs induk dari node. Jika node adalah node akar, induk adalah null.
Titel Nama entitas node.
url Nama URL node.

sitemarkers

Memungkinkan Anda untuk memuat segala penanda situs menurut nama. Jika sitemarker ada, objek sitemarker dikembalikan. Jika penanda situs dengan nama yang diberikan tidak ditemukan,null dikembalikan.

{{ sitemarkers[Login].url }}

{% assign my_sitemarker = sitemarkers["My Site Marker"] %}

{% if my_sitemarker %}

<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Atribut Sitemarker

Atribut Deskripsi
url URL sitemarker target.
[Nama Logis Atribut] Anda dapat mengakses setiap atribut dari rekaman Dataverse target sitemarker menurut nama logis. Misalnya: {{ sitemarker.adx_name }}

potongan

Memungkinkan Anda untuk memuat segala potongan konten menurut nama. Jika cuplikan dengan nama yang diberikan tidak ditemukan,null dikembalikan.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Mengandung sifat yang berguna dalam blok loop tag Iterasi.

Catatan

tablerowloop hanya dapat digunakan dalam tag tag iterasi.

Atribut

Atribut KETERANGAN
Col Menghasilkan indeks dari baris saat ini, mulai dari 1.
col0 Menghasilkan indeks dari baris saat ini, mulai dari 0.
col_first Menghasilkan true jika kolom saat ini adalah kolom pertama dalam satu baris, menghasilkan false jika tidak.
col_last Menghasilkan true jika kolom saat ini adalah kolom terakhir dalam satu baris, menghasilkan false jika tidak.
Depan Menghasilkan true jika merupakan iterasi pertama dari loop. Menghasilkan false jika tidak merupakan iterasi pertama.
Indeks Posisi saat ini item dalam koleksi, di mana item pertama memiliki posisi 1.
index0 Posisi saat ini item dalam koleksi, di mana item pertama memiliki posisi 0.
Terakhir Menghasilkan true jika merupakan iterasi terakhir dari loop. Menghasilkan false jika tidak merupakan iterasi terakhir.
Length Menghasilkan jumlah iterasi untuk loop ߝ jumlah item dalam koleksi yang diulangi.
Rindex Jumlah item yang tersisa di loop (panjang - indeks) di mana 1 adalah indeks dari item terakhir.
rindex0 Jumlah item yang tersisa di loop (panjang - indeks) di mana 0 adalah indeks dari item terakhir.

User

Merujuk ke pengguna portal saat ini, yang memungkinkan akses semua atribut rekaman kontak Dataverse yang mendasari. Jika tidak ada pengguna yang masuk, variabel ini null.

Pengguna adalah objek entitas .

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Catatan

Rilis Power Pages versi 9.3.8.x atau yang lebih baru secara default akan menerapkan filter Liquid escape untuk pengguna dan meminta objek Liquid. Untuk menonaktifkan konfigurasi default ini dan memungkinkan objek Liquid ini tanpa filter Liquid escape, lihat pengaturan situs portal - Site/EnableDefaultHtmlEncoding.

Atribut

Selain memiliki semua atribut objek entity, pengguna memiliki atribut berikut.

Atribut Keterangan
peran Menghasilkan peran milik pengguna , sebagai larik.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Catatan: Anda juga dapat menggunakan filter has_role untuk menguji keanggotaan peran masing-masing.
basic_badges_url Menghasilkan url layanan untuk mengambil lencana pengguna.
Untuk merender badge bagi pengguna, Anda harus menyertakan tag dengan atribut "data-badge" dan "data-uri". Untuk membuat lencana pengguna saat ini:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Untuk membuat pengguna lencana menurut id (variabel userid):
`<div data-badge data-uri='{{user.basic_badges_url

Memungkinkan Anda untuk memuat segala weblinks menurut nama atau ID.

Jika rangkaian tautan web ada, objek rangkaian tautan web dikembalikan. Jika rangkaian tautan web dengan nama atau ID yang diberikan tidak ditemukan, null dikembalikan.

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Catatan

Rangkaian tautan web adalah objek entitas , dengan semua atribut yang sama, selain atribut berikut:

Atribut Description
Salin Salinan HTML kumpulan tautan web.
Nama Nama kumpulan tautan web.
Jabatan Judul kumpulan tautan web.
Weblinks Larik objek tautan web terkait dengan kumpulan tautan web.
[Nama Logis Atribut] Anda dapat mengakses setiap atribut dari rekaman Dataverse kumpulan tautan web menurut nama logis. Misalnya: {{ weblinkset.createdon }}

Catatan

Web tautkan adalah objek entitas , dengan semua atribut yang sama, selain atribut berikut:

Atribut Description
Description Deskripsi HTML tautan web.
display_image_only Atribut Boolean menunjukkan apakah tautan web harus ditampilkan sebagai gambar saja, tanpa teks tautan.
display_page_child_links Atribut Boolean yang mengindikasikan Apakah tautan web harus menunjukkan tautan ke anak halaman sitemap dari halaman terkait, sebagai sub-tautan.
Image Objek image tautan web untuk tautan ini. Atribut ini null jika tidak ada gambar.
is_external Atribut Boolean menunjukkan apakah URL target tautan web ke situs eksternal (bukan ke halaman portal internal).
is_sitemap_ancestor Menghasilkan true jika URL weblink mereferensi moyang node sitemap saat ini, jika tidak false.
is_sitemap_current Menghasilkan true jika URL weblink mereferensi node sitemap saat ini, jika tidak false.
Nama Nama/judul tautan web.
Nofollow Atribut Boolean yang mengindikasikan Apakah tautan web harus ditandai sebagai rel=nofollow.
open_in_new_window Atribut Boolean yang menunjukkan apakah tautan web harus dibuka di jendela/tab browser baru ketika dipilih.
Tooltip Teks Tooltip untuk tautan web.
url URL tautan web.
Weblinks Larik objek tautan web anak terkait dengan tautan web.
[Nama Logis Atribut] Anda dapat mengakses setiap atribut dari rekaman Dataverse tautan web menurut nama logis. Misalnya: {{ weblink.createdon }}
alternate_text Teks alternatif untuk image.
Tinggi Bilangan bulat yang mengandung ketinggian tertentu dari image. Jika tidak ada nilai tinggi yang diberikan, atribut ini null.
url URL image.
Lebar Bilangan bulat yang mengandung lebar tertentu dari image. Jika tidak ada nilai lebar yang diberikan, atribut ini adalah null.

situs web

Merujuk ke situs web portal, yang memungkinkan akses semua atribut rekaman situs web Dataverse (adx_website) untuk portal.

Catatan

Situs web adalah objek entitas, dengan semua atribut yang sama.

Code

{{ website.adx_name }} ({{ website.id }})

Output

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Atribut

Tabel berikut mencantumkan atribut untuk tag ini yang dapat digunakan menggantikan default untuk menghindari caching.

Default Substitute (menghindari caching) Contoh
sign_in_url sign_in_url_substitution Default: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Substitusi (menghindari caching): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("halaman pengganti" dalam contoh ini menggantikan URL cache default.)
sign_out_url sign_in_url_substitution Default: website.sign_in_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Substitusi (menghindari caching): website.sign_in_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("halaman pengganti" dalam contoh ini menggantikan URL cache default.)

Lihat juga

Jenis Liquid
Tag Liquid
Filter Liquid