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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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:
{{ 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
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
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
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
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
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
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:
{{ 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
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
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
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 |
tautan Web
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 %}
Atribut kumpulan tautan web
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 }} |
Atribut tautan web
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 }} |
Atribut image tautan web
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.) |