Objek Liquid yang tersedia
Catatan
Mulai 12 Oktober 2022, portal Power Apps menjadi Power Pages. Informasi selengkapnya: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan segera memigrasikan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages.
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 | KETERANGAN |
|---|---|
| entitas | Memungkinkan Anda untuk memuat tabel Power Apps menurut ID. Entitas Informasi selengkapnya: |
| sekarang | Sebuah objek tanggal/waktu yang merujuk kepada waktu UTC saat ini, pada saat template dirender. Catatan: nilai ini akan di-cache dengan aplikasi Web Portal dan tidak refresh setiap kali. Filter tanggal Informasi selengkapnya: |
| 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 Power Apps yang mendasari. Halaman Informasi selengkapnya: |
| params | Jalan pintas yang nyaman untuk request.params. Permintaan Informasi selengkapnya: |
| permintaan | Berisi informasi tentang permintaan HTTP saat ini. Permintaan Informasi selengkapnya: |
| pengaturan | Memungkinkan Anda untuk memuat segala pengaturan situs menurut nama. Pengaturan Informasi selengkapnya: |
| sitemap | Memungkinkan akses ke peta situs portal. Peta situs Informasi selengkapnya: |
| sitemarkers | Memungkinkan Anda untuk memuat segala penanda situs menurut nama. sitemarker Informasi selengkapnya: |
| potongan | Memungkinkan Anda untuk memuat segala potongan konten menurut nama. snippet Informasi selengkapnya: |
| pengguna | Merujuk ke pengguna portal saat ini, yang memungkinkan akses semua atribut rekaman kontak Power Apps yang mendasari. Jika tidak ada pengguna yang masuk, variabel ini akan null. Pengguna Informasi selengkapnya: |
| tautan Web | Memungkinkan Anda untuk memuat segala Web Link Set menurut nama atau ID. Tautan web Informasi selengkapnya: |
| situs web | Merujuk ke portal rekaman situs web, yang memungkinkan akses semua atribut rekaman situs web Power Apps (situs web_adx) untuk portal. Situs Web Informasi selengkapnya: |
iklan
Menyediakan kemampuan untuk mengakses dan membuat 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 | KETERANGAN |
|---|---|
| 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 | KETERANGAN |
|---|---|
| [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 yang tercantum di bawah.
| Atribut | KETERANGAN |
|---|---|
| Iklan | Menghasilkan koleksi objek iklan yang terkait dengan penempatan. Tag Iterasi dan filter larik 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 tercantum di bawah ini.
| Atribut | KETERANGAN |
|---|---|
| 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 ke pengguna dengan memilih iklan. |
Atribut gambar Iklan
| Atribut | KETERANGAN |
|---|---|
| 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. |
| width | Menghasilkan lebar dalam pixel untuk gambar |
blog
Menyediakan kemampuan untuk mengakses dan membuat 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. |
| judul | 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 Power Apps menurut ID. Jika ada tabel, objek tabel akan dihasilkan. Jika sebuah tabel dengan ID tertentu tidak ditemukan, null akan dihasilkan.
{% 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 %}
Entity
Objek entity menyediakan akses atribut rekaman tabel Power Apps.
| Atribut | KETERANGAN |
|---|---|
| Id | ID GUID dari tabel, sebagai string. Misalnya, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nama logis Power Apps tabel. |
| Catatan | Memuat segala catatan (annotation) yang terkait dengan tabel, yang diurutkan dari yang 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 portal Power Apps untuk tabel. Jika tabel tidak memiliki URL valid di situs yang sekarang, menghasilkan null. Umumnya, ini hanya akan menghasilkan nilai jenis tabel tertentu yang telah terintegrasi ke dalam portal CMS , kecuali Anda menyesuaikan penyedia URL dalam aplikasi Anda. |
| [nama atribut atau hubungan] | Anda dapat mengakses setiap atribut dari tabel Power Apps 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 kasus bahwa hubungan bersifat refleksif (yaitu referensi mandiri), sebuah objek hubungan refleksif akan dihasilkan. (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 Power Apps 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 | KETERANGAN |
|---|---|
| documentbody | Memuat atribut documentbody dari rekaman anotasi catatan, sebagai string Base64-encoded. Karena isi dari atribut ini mungkin besar, itu tidak dimuat dengan sisa atribut catatan, hanya diambil saat dibutuhkan. Catatan: Penggunaan atribut documentbody dapat berdampak negatif pada kinerja render 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 men-download 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 | KETERANGAN |
|---|---|
| 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. Menghasilkan false jika merekaadalah hasil default tanpa adanya izin yang secara eksplisit ditetapkan. |
Relasi refleksif
Upaya untuk memuat hubungan refleksif (yaitu referensial mandiri) pada entitas dihasilkan sebagai objek dengan atribut berikut.
| Atribut | KETERANGAN |
|---|---|
| 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 Power Apps Dataverse. Ini menyediakan akses ke semua atribut dari daftar tertentu.
Atribut
Catatan
| Atribut | KETERANGAN |
|---|---|
| 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 Power Apps untuk rekaman yang akan ditampilkan oleh daftar ini. Contohnya, contact. |
| filter_account_attribute_name | Menghasilkan nama logis atribut untuk lookup ke akun yang akan 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 | Menghasilkan nama logis atribut untuk lookup ke kontak yang akan digunakan untuk memfilter rekaman hasil menurut kontak pengguna portal saat ini. Contohnya, contactid |
| filter_website_attribute_name | Menghasilkan nama logis atribut untuk lookup ke adx_website yang akan digunakan untuk memfilter rekaman hasil menurut Situs Web portal saat ini. Contoh: adx_websiteid |
| language_code | Menghasilkan kode bahasa bilangan bulat Power Apps 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 daftar (adx_entitylist) Power Apps dengan nama logis, dengan cara yang sama seperti objek tabel. Misalnya, {{ entitylist.adx_name }} |
Atribut Lihat Daftar
| Atribut | KETERANGAN |
|---|---|
| kolom | Menghasilkan kolom dalam tampilan, sebagai objek kolom tampilan daftar. |
| entity_logical_name | Menghasilkan nama logis tabel Power Apps untuk rekaman yang termasuk dalam tampilan. Contohnya, contact. |
| Id | Menghasilkan GUID ID tampilan. |
| language_code | Menghasilkan kode bahasa bilangan bulat Power Apps yang akan digunakan untuk memilih semua label (kolom, header, dll.) untuk tampilan. |
| Nama | Menghasilkan nama tampilan Power Apps dari tampilan. |
| primary_key_logical_name | Menghasilkan nama logis kunci primer tabel Power Apps 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 | KETERANGAN |
|---|---|
| attribute_type | Menghasilkan nama jenis atribut Power Apps untuk kolom, sebagai string. Misalnya Lookup, Picklist, String, Boolean, DateTime |
| logical_name | Menghasilkan nama logis atribut Power Apps untuk kolom. Sebagai contoh, createdon |
| Nama | Menghasilkan nama tampilan Power Apps 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 Power Apps dari rekaman lihat hasil. Contohnya, contact. |
| first_page | Nomor halaman dari halaman pertama lihat hasil. Ini akan menjadi 1 kecuali tidak ada hasil, dalam hal ini akan menjadi null. |
| Id | ID GUID tampilan Power Apps yang mendefinisikan entityview ini. |
| language_code | Kode bahasa bilangan bulat Power Apps yang digunakan untuk memuat lokal label untuk tampilan yang aktif. |
| last_page | Nomor halaman dari halaman terakhir lihat hasil. Jika tidak ada hasil yang dimunculkan, ini akan null. |
| nama | Nama tampilan Power Apps yang mendefinisikan entityview ini, misalnya, kontak aktif. |
| next_page | Nomor halaman dari halaman berikutnya lihat hasil. Jika tidak ada halaman berikutnya dari hasil, ini akan 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 sebelumnya dari hasil, ini akan null. |
| primary_key_logical_name | Nama logika Power Apps 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
Menyediakan kemampuan untuk mengakses dan merender Aktivitas. 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 | KETERANGAN |
|---|---|
| occurences | 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 aktivitas dan menentukan rentang tanggal untuk kejadian yang akan diambil, dan mencapai pemberian halaman serta menggunakan filter Liquid
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
Perhatikan bahwa
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
juga dimungkinkan.
Atribut berikut terkait dengan objek eventoccurrences
| Atribut | KETERANGAN |
|---|---|
| Semua | Menghasilkan semua objek eventoccurance dalam koleksi. |
Objek eventoccurence
Mewakili terjadinya satu kejadian aktivitas. Atribut yang terkait diberikan di bawah ini:
| Atribut | KETERANGAN |
|---|---|
| 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.
Kode
{% 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
Menyediakan kemampuan untuk mengakses dan merender 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 | Description |
|---|---|
| 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 | KETERANGAN |
|---|---|
| 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 | KETERANGAN |
|---|---|
| author | Menghasilkan penulis untuk posting (yang hanya merupakan objek tabel kontak). |
| content | Konten posting. |
| is_answer | Apakah posting ini adalah jawaban untuk thread? |
pengetahuan
Menyediakan akses ke rekaman tabel kategori dan Power Apps 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 lain.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| Atribut | KETERANGAN |
|---|---|
| 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 lain.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| Atribut | KETERANGAN |
|---|---|
| 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
article adalah objek entitas, dengan semua atribut yang sama, selain yang tercantum di bawah ini.
| Atribut | KETERANGAN |
|---|---|
| article_public_number | Nomor publik artikel dari artikel. |
| comment_count | Nilai bilangan bulat dari jumlah berapa banyak komentar untuk artikel tertentu. |
| content | 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 tentang berapa kali artikel telah dilihat. |
Objek kategori
Objek kategori memungkinkan Anda bekerja dengan satu kategori untuk menampilkan rinciannya di portal.
Atribut
category adalah objek entitas, dengan semua atribut yang sama, selain yang tercantum di bawah ini.
| Atribut | KETERANGAN |
|---|---|
| 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.
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 Power Apps 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 | KETERANGAN |
|---|---|
| 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 Beranda, induk akan null. |
| judul | Judul halaman. |
| url | URL Halaman. |
| [nama atribut atau hubungan] | Anda dapat mengakses setiap atribut dari rekaman Power Apps 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 kasus bahwa hubungan bersifat refleksif (yaitu referensi mandiri), objek entities akan dihasilkan. (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 Power Apps Dataverse untuk memuat koleksi entitas. |
poling
Menyediakan kemampuan untuk mengakses dan membuat poling.
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 | KETERANGAN |
|---|---|
| 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 | KETERANGAN |
|---|---|
| [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 | KETERANGAN |
|---|---|
| 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 larik 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 | KETERANGAN |
|---|---|
| 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 iterasi dan entities 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 | Menghasilkan objek polloption yang dipilih oleh pengguna (jika mereka sudah memilih). |
| votes | Menghasilkan jumlah suara yang telah ditabulasi untuk poling. |
Atribut Pilihan Poling
Catatan
| Atribut | KETERANGAN |
|---|---|
| answer | Menghasilkan bidang Jawaban untuk poling. |
| percentage | Menghasilkan persentase suara dalam poling untuk opsi dalam angka desimal dari 0 hingga 100. |
| votes | Menghasilkan jumlah suara yang telah 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 portal Power Apps 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 Power Apps 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 | KETERANGAN |
|---|---|
| approximate_total_hits | Menghasilkan jumlah perkiraan jumlah hit yang cocok dengan query indeks. Karena cara indeks pencarian bekerja dalam hal keamanan penyaringan dan faktor-faktor lain Desain, angka ini hanya merupakan perkiraan, dan mungkin tidak sama persis jumlah 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 sebenarnya dari hasil yang diberikan untuk halaman (karena ini mungkin kurang dari ukuran halaman maksimal 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 kabur (~) dan kueri wildcard (*). Ini akan menjadi null dalam kasus-kasus itu. |
| Id | ID tabel Power Apps dari rekaman yang mendasari untuk hasilnya, sebagai string. Misalnya, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nama logis tabel Power Apps dari rekaman yang mendasari untuk hasilnya. Contoh: adx_webpage |
| Nomor | Jumlah hasil, di semua halaman hasil, mulai dari 1. Misalnya, untuk hasil pertama dari halaman kedua hasil, dengan ukuran halaman 10, nilai ini akan 11. |
| score | Skor Lucene hasil, sebagai nilai titik ambang. Hasil akan diberikan dengan urutan nilai ini. |
| judul | 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 mengandung HTML.) |
| Entitas | Menghasilkan entities yang mendasari dari node. Jika node tidak memiliki tabel yang mendasari, nilai ini akan 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 root node, induk akan null. |
| Jabatan | Nama entitas node. |
| url | Nama URL node. |
sitemarkers
Memungkinkan Anda untuk memuat segala penanda situs menurut nama. Jika ada sitemarker, objek sitemarker akan dihasilkan. Jika sitemarker dengan nama tertentu tidak ditemukan null akan dihasilkan.
{{ 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 | KETERANGAN |
|---|---|
| url | URL sitemarker target. |
| [nama logis atribut] | Anda dapat mengakses setiap atribut dari rekaman Power Apps target sitemarker menurut nama logis. Misalnya, {{ sitemarker.adx_name }} |
potongan
Memungkinkan Anda untuk memuat segala potongan konten menurut nama. Jika potongan dengan nama tertentu tidak ditemukan, Null akan dihasilkan.
{{ 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. |
pengguna
Merujuk ke pengguna portal saat ini, yang memungkinkan akses semua atribut rekaman kontak Power Apps yang mendasari. Jika tidak ada pengguna yang masuk, variabel ini akan null.
Pengguna adalah entity objek.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Catatan
Rilis portal Power Apps 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 membuat lencana untuk pengguna, Anda harus memasukkan 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 ada kumpulan tautan web, objek set tautan web akan dihasilkan. Jika tautan web diberi nama atau ID tidak ditemukan, null akan dihasilkan.
<!-- 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
Set tautan web adalah objek entitas, dengan semua atribut yang sama, selain yang tercantum di bawah ini.
| Atribut | Keterangan |
|---|---|
| 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 Power Apps kumpulan tautan web menurut nama logis. Misalnya: {{ weblinkset.createdon }} |
Atribut tautan web
Catatan
Tautan web adalah objek entitas, dengan semua atribut yang sama, selain yang tercantum di bawah ini.
| Atribut | Keterangan |
|---|---|
| Keterangan | 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. |
| Gambar | Objek image tautan web untuk tautan ini. Atribut ini akan menjadi 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 Power Apps 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 disediakan, atribut ini akan menjadi null. |
| url | URL image. |
| Lebar | Bilangan bulat yang mengandung lebar tertentu dari image. Jika tidak ada nilai lebar disediakan, atribut ini akan menjadi null. |
situs web
Merujuk ke situs web portal, yang memungkinkan akses semua atribut rekaman situs web Power Apps (adx_website) untuk portal.
Catatan
Situs web adalah objek entitas, dengan semua atribut yang sama.
Kode
{{ 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
Catatan
Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)
Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk