Objek Liquid yang tersedia
Nota
Berkuat kuasa pada 12 Oktober 2022, portal Power Apps ialah Power Pages. Maklumat lanjut: Microsoft Power Pages kini tersedia secara umum (blog)
Kami akan memindahkan dan menggabungkan dokumentasi portal Power Apps dengan dokumentasi Power Pages tidak lama lagi.
Objek Liquid mengandungi atribut untuk mengoutput kandungan dinamik ke halaman. Contohnya, objek halaman mempunyai atribut dipanggil tajuk yang boleh digunakan untuk menghasilkan tajuk halaman semasa.
Untuk mengakses atribut objek mengikut nama, gunakan tanda titik (.). Untuk memaparkan atribut objek dalam templat, balutnya dalam {{ and }}.
Penting
Untuk mengelakkan isu skrip merentas tapak (XSS) yang berpotensi, sentiasa gunakan penapis lepas ke data mengekod HTML apabila menggunakan objek Liquid untuk membaca data yang tidak dipercayai yang diberikan oleh pengguna.
{{ page.title }}
Atribut objek juga boleh diakses menggunakan nama rentetan dan []. Format ini berguna sekiranya atribut yang dikehendaki ditentukan secara dinamik, atau nama atribut mengandungi aksara, ruang, aksara khas dan seterusnya, yang akan menjadi tidak sah apabila menggunakan tanda titik (.) di dalam sintaks.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Objek berikut boleh digunakan dan diakses di mana-mana saja, dalam mana-mana templat.
| Objek | Penerangan |
|---|---|
| entiti | Membolehkan anda memuatkan mana-mana jadual Power Apps mengikut ID. Maklumat lanjut: entiti |
| sekarang | Objek tarikh/masa yang merujuk kepada masa UTC semasa pada masa templat dipaparkan. Nota: Nilai ini dicache oleh aplikasi web portal dan tidak disegar semula setiap masa. Maklumat lanjut: Penapis tarikh |
| halaman | Merujuk kepada halaman permintaan portal semasa. Objek halaman menyediakan akses kepada sesuatu seperti jejak untuk halaman semasa, tajuk atau URL halaman semasa dan atribut atau entiti berkaitan lain bagi rekod Power Apps dasar. Maklumat lanjut: halaman |
| params | Pintasan mudah untuk request.params. Maklumat lanjut: permintaan |
| permintaan | Mengandungi maklumat tentang permintaan HTTP semasa. Maklumat lanjut: permintaan |
| tetapan | Membolehkan anda memuatkan sebarang Tetapan Tapak mengikut nama. Maklumat lanjut: tetapan |
| peta laman | Membenarkan akses kepada peta laman portal. Maklumat lanjut: peta laman |
| penanda tapak | Membolehkan anda memuatkan sebarang Penanda Tapak mengikut nama. Maklumat lanjut: penanda tapak |
| coretan | Membolehkan anda memuatkan sebarang Coretan Kandungan mengikut nama. Maklumat lanjut: coretan |
| pengguna | Merujuk kepada pengguna portal semasa, membolehkan akses kepada semua atribut rekod kenalan Power Apps dasar. Jika tiada pengguna didaftar masuk, pemboleh ubah ini akan menjadi nol. Maklumat lanjut: pengguna |
| pautan web | Membolehkan anda memuat sebarang Set Pautan Web mengikut nama atau ID. Maklumat lanjut: pautan web |
| tapak web | Merujuk kepada rekod Tapak Web portal, membolehkan akses kepada semua atribut rekod Tapak Web Power Apps (adx_website) untuk portal. Maklumat lanjut: tapak web |
iklan
Memberi keupayaan untuk mengakses dan mempersembahkan iklan.
Objek iklan membolehkan anda memilih iklan tertentu atau penempatan iklan:
<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 | Perihalan |
|---|---|
| penempatan | Mengembalikan objek adplacement. |
| [nama iklan atau id] | Anda boleh mengakses sebarang iklan mengikut sifat Id dan Namanya. {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Atribut Penempatan Iklan
| Atribut | Perihalan |
|---|---|
| [nama penempatan iklan atau id] | Anda boleh mengakses sebarang adplacement mengikut sifat Id dan Namanya.{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Atribut Penempatan Iklan
Peletakkan iklan ialah objek jadual dengan atribut umum yang sama, dan atribut yang disenaraikan di bawah.
| Atribut | Penerangan |
|---|---|
| Iklan | Mengembalikan koleksi objek iklan yang berkaitan dengan penempatan. Tag lelaran dan Penapis tatasusunan mungkin digunakan dengan koleksi ini. |
| Nama | Mengembalikan medan Nama untuk penempatan iklan. |
| placement_url | URL yang boleh digunakan untuk mendapatkan semula penempatan iklan yang dipersembahkan sepenuhnya oleh templat. |
| random_url | URL yang boleh digunakan untuk mendapatkan semula iklan rawak daripada penempatan yang dipersembahkan sepenuhnya oleh templat. |
Atribut iklan
Nota
Iklan ialah objek jadual, dengan semua atribut yang sama, di samping yang disenaraikan di bawah.
| Atribut | Perihalan |
|---|---|
| ad_url | URL yang boleh digunakan untuk mendapatkan semula iklan yang dipersembahkan sepenuhnya oleh templat. |
| Salin | Mengembalikan medan Salin untuk iklan. |
| imej | Mengembalikan objek imej (jika ada) untuk iklan. |
| Nama | Mengembalikan medan Nama untuk iklan. |
| open_in_new_window | Mengembalikan benar jika url yang ditentukan oleh redirect_url harus dibuka dalam tetingkap baharu. |
| redirect_url | URL yang pengguna akan dihalakan semula dengan memilih iklan. |
Atribut Imej Iklan
| Atribut | Perihalan |
|---|---|
| alternate_text | Kembalikan teks yang bertujuan untuk muncul dalam atribut alt tag . |
| tinggi | Mengembalikan tinggi dalam piksel untuk imej |
| url | Mengembalikan sumber URL untuk imej. |
| lebar | Mengembalikan lebar dalam piksel untuk imej |
blog
Menyediakan keupayaan untuk mengakses dan mempersembahkan Blog dan Siaran Blog.
Objek blog membolehkan anda memilih blog atau siaran blog tertentu.
{% 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 blog
Objek blog membolehkan anda mengakses mana-mana blog tertentu dalam portal atau untuk mengakses semua blog dalam portal.
Jadual berikut menerangkan atribut yang berkaitan dengan objek blog.
| Atribut | Perihalan |
|---|---|
| siaran | Mengembalikan objek blogpost yang mengandungi semua siaran blog dalam portal. |
| [nama blog atau id] | Anda boleh mengakses mana-mana blog mengikut sifat Id dan Namanya. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objek blog
Objek blog membolehkan anda bekerja dengan blog tunggal yang membolehkan anda untuk mengakses siaran untuk blog tersebut.
Jadual berikut menerangkan pelbagai atribut yang berkaitan dengan Objek blog.
| Atribut | Perihalan |
|---|---|
| siaran | Mengembalikan objek blogpost yang mengandungi semua siaran blog untuk blog. |
| Nama | Nama blog. |
| tajuk | Tajuk blog. |
| url | URL blog. |
Objek blogpost
Objek blogpost membolehkan anda mengakses koleksi objek siaran blog. Anda boleh menyusun siaran blog dan mencapai penghalaman serta menggunakan penapis liquid:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Pilihan lain yang ada:
blogs.posts.all(untuk mendapatkan semua hantaran blog)blogs.posts | from\_index: 0 | take: 2
Jadual berikut menerangkan pelbagai atribut yang berkaitan dengan Objek blogpost.
| Atribut | Perihalan |
|---|---|
| Semua | Mengembalikan semua objek blogpost dalam koleksi |
Objek blogpost
Merujuk kepada siaran blog tunggal.
Jadual berikut menerangkan pelbagai atribut yang berkaitan dengan Objek blogpost.
| Atribut | Penerangan |
|---|---|
| url | URL siaran. |
| kandungan | Mengembalikan medan Kandungan untuk siaran. |
| pengarang | Mengembalikan pengarang untuk siaran (yang merupakan objek jadual kenalan. |
| tajuk | Tajuk siaran. |
| comment_count | Mengembalikan nilai integer kiraan jumlah komen yang ada untuk siaran yang diberikan. |
| publish_date | Tarikh siaran diterbitkan. |
entiti
Awas
Untuk mengelakkan isu skrip silang tapak (XSS) yang berpotensi, sentiasa gunakan penapis lepas kepada data rentetan mengekod HTML apabila menggunakan objek Liquid entiti untuk membaca data yang diberikan oleh pengguna yang tidak boleh dipercayai.
Nota
Sesetengah kelaziman penamaan Dataverse telah berubah, sebagai contoh, entiti Dataverse kini dipanggil jadual. Perubahan nama tidak terpakai pada objek Liquid. Objek entiti Liquid akan terus dirujuk sebagai entiti.
Membolehkan anda memuatkan mana-mana jadual Power Apps mengikut ID. Jika jadual wujud, objek jadual akan dikembalikan. Jika jadual dengan ID yang diberikan tidak ditemukan, nol akan 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 %}
EntitI
Objek entiti memberikan capaian kepada atribut rekod jadual Power Apps.
| Atribut | Penerangan |
|---|---|
| ID | ID GUID jadual, sebagai rentetan. Sebagai contoh, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nama logik Power Apps jadual. |
| Nota | Memuatkan apa-apa nota (anotasi) yang dikaitkan dengan jadual, disusun mengikut yang paling lama sehingga yang paling baharu (createdon). Nota dikembalikan sebagai objek nota. |
| keizinan | Memuatkan hasil penerapan Keizinan Jadual untuk jadual. Hasil dikembalikan sebagai objek keizinan. |
| url | Mengembalikan laluan URL sistem pengurusan kandungan portal Power Apps untuk jadual. Jika jadual tidak mempunyai URL yang sah dalam laman web semasa, mengembalikan nol. Pada umumnya, ini hanya akan mengembalikan nilai untuk jenis jadual tertentu yang telah diintegrasikan ke dalam CMS portal, melainkan anda telah menyesuaikan Pembekal URL dalam aplikasi anda. |
| [atribut atau nama perhubungan] | Anda boleh mencapai mana-mana atribut jadual Power Apps mengikut nama logik. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Nilai kebanyakan atribut jadual memetakan kepada jenis Liquid secara terus: Medan Dua Pilihan dipetakan kepada Boolean, medan teks kepada rentetan, medan angka/mata wang kepada nombor, medan tarikh/masa kepada objek tarikh. Tetapi sesetengah jenis atribut dikembalikan sebagai objek:
{{ page.adx_webpage_entitylist.adx_name }}Sekiranya perhubungan adalah refleksif (iaitu, rujukan sendiri), objek perhubungan refleksif akan dikembalikan. (Jika tidak, hasil akan menjadi tidak jelas.){{ page.adx_webpage_webpage.referencing.adx_name }} Nota: Memuatkan bilangan entiti berkaitan yang besar atau mengakses bilangan perhubungan dalam templat tunggal yang besar, boleh memberi kesan negatif terhadap prestasi persembahan templat. Elakkan daripada memuatkan entiti berkaitan untuk setiap item dalam tatasusunan, dalam gelung. Jika boleh, gunakan tag jadual Dataverse untuk memuatkan koleksi entiti. |
Rujukan Jadual Berkaitan
Nilai atribut carian dikembalikan sebagai objek rujukan jadual yang dikaitkan, dengan atribut berikut.
| Atribut | Penerangan |
|---|---|
| ID | ID GUID jadual yang dirujuk, sebagai rentetan. Sebagai contoh, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nama logik Power Apps jadual yang dirujuk. |
| Nama | Atribut nama utama jadual yang dirujuk. |
Nota
Nota ialah objek jadual yang memberikan capaian kepada atribut dan perhubungan rekod anotasi. Selain daripada semua atribut objek jadual, nota mempunyai atribut tambahan berikut.
| Atribut | Perihalan |
|---|---|
| documentbody | Memuatkan atribut documentbody bagi rekod anotasi nota, sebagai rentetan dikodkan Base64. Oleh kerana kandungan atribut ini mungkin besar, ia tidak dimuatkan dengan atribut nota yang lain. Ia hanya dimuatkan atas permintaan. Nota: Penggunaan atribut documentbody boleh menyebabkan kesan negatif terhadap prestasi persembahan templat dan sepatutnya dilakukan dengan berhati-hati. Sebaliknya, jika boleh, gunakan atribut url untuk menyediakan pautan kepada lampiran nota. |
| url | Mengembalikan laluan URL untuk pengendali lampiran anotasi portal terbina dalam. Jika pengguna mempunyai keizinan dan nota mempunyai fail yang dilampirkan, permintaan kepada URL ini akan memuat turun lampiran fail nota. |
Nota
Nilai Set Pilihan
Nilai atribut Set Pilihan/Senarai Pilihan dikembalikan sebagai objek rujukan jadual yang dikaitkan, dengan atribut berikut.
| Atribut | Perihalan |
|---|---|
| Label | Label tempatan bagi nilai set pilihan/senarai pilihan. Contohnya, Aktif |
| Nilai | Nilai integer bagi nilai set pilihan/senarai pilihan. Contohnya, 0 |
Keizinan Jadual
Objek Keizinan Jadual memberikan capaian kepada hasil penerapan keizinan teragregat untuk jadual.
| Atribut | Penerangan |
|---|---|
| can_append | Mengembalikan benar jika pengguna semasa mempunyai keizinan untuk menambah rekod pada perhubungan rekod ini. Jika tidak, mengembalikan palsu. |
| can_append_to | Mengembalikan benar jika pengguna semasa mempunyai keizinan untuk menambah rekod ini pada perhubungan jadual lain. Jika tidak, mengembalikan palsu. |
| can_create | Mengembalikan benar jika pengguna semasa mempunyai keizinan untuk mencipta rekod baharu jenis jadual ini. Jika tidak, mengembalikan palsu. |
| can_delete | Mengembalikan benar jika pengguna semasa mempunyai keizinan untuk memadam rekod ini. Jika tidak, mengembalikan palsu. |
| can_read | Mengembalikan benar jika pengguna semasa mempunyai keizinan untuk membaca rekod ini. Jika tidak, mengembalikan palsu. |
| can_write | Mengembalikan benar jika pengguna semasa mempunyai keizinan untuk mengemas kini rekod ini. Jika tidak, mengembalikan palsu. |
| rules_exist | Mengembalikan benar jika hasil keizinan yang diwakili oleh objek ini adalah hasil peraturan keizinan yang ditakrifkan dengan jelas. Mengembalikan palsu jika terdapat hasil lalai dalam ketiadaan keizinan yang ditakrifkan dengan jelas. |
Perhubungan Refleksif
Mencuba memuatkan perhubungan refleksif (iaitu. rujukan sendiri) pada entiti dikembalikan sebagai objek dengan atribut berikut.
| Atribut | Perihalan |
|---|---|
| is_reflexive | Mengembalikan benar. Boleh digunakan untuk menguji sama ada objek yang dikembalikan oleh perhubungan adalah objek perhubungan refleksif. |
| dirujuk | Mengembalikan tatasusunan entiti yang dirujuk untuk perhubungan tertentu. |
| merujuk | Mengembalikan jadual perujuk perhubungan tertentu. Mengembalikan nol jika jadual perujuk tidak wujud. Jika perhubungan ialah banyak kepada banyak (N:N), mengembalikan tatasusunan entiti yang merujuk. |
entitylist
Objek senarai entiti digunakan dalam tag jadual Dataverse Power Apps. Ia memberikan capaian kepada semua atribut senarai yang diberikan.
Atribut
Nota
| Atribut | Perihalan |
|---|---|
| create_enabled | Mengembalikan benar jika penciptaan rekod baharu dikonfigurasikan untuk senarai. Jika tidak, mengembalikan palsu. |
| create_url | Mengembalikan laluan URL yang dikonfigurasikan untuk pautan/butang penciptaan untuk senarai. |
| detail_enabled | Mengembalikan benar jika pandangan terperinci untuk rekod individu dikonfigurasikan untuk senarai. Jika tidak, mengembalikan palsu. |
| detail_id_parameter | Mengembalikan nama parameter rentetan pertanyaan untuk tujuan ID rekod ketika membina URL gambaran terperinci rekod. Lihat URL penapis untuk butiran tentang menggunakan penapis Liquid untuk membina URL. Contohnya, id |
| detail_label | Mengembalikan label disetempatkan yang dikonfigurasikan untuk pautan/butang pandangan terperinci untuk senarai. |
| detail_url | Mengembalikan laluan URL yang dikonfigurasikan untuk pautan/butang pandangan terperinci untuk senarai. |
| empty_list_text | Mengembalikan teks disetempatkan yang dikonfigurasikan untuk dipaparkan apabila pandangan senarai tidak mengembalikan hasil. |
| enable_entity_permissions | Mengembalikan benar jika penapisan Keizinan Jadual didayakan untuk senarai ini. Jika tidak, mengembalikan palsu. |
| entity_logical_name | Mengembalikan nama logik jadual Power Apps untuk rekod yang akan dipaparkan oleh senarai ini. Sebagai contoh, kenalan |
| filter_account_attribute_name | Mengembalikan nama logik atribut bagi carian untuk akaun yang akan digunakan untuk menapis rekod hasil oleh akaun induk pengguna portal semasa. Contohnya, accountid |
| filter_apply_label | Mengembalikan label disetempatkan yang dikonfigurasikan yang akan digunakan untuk pautan/butang yang menggunakan penapis atribut lanjutan pada hasil senarai. |
| filter_definition | Mengembalikan takrif penapis atribut JSON untuk senarai. Lihat penapis Senarai untuk mengetahui butiran tentang cara menggunakan penapis Liquid metapenapis untuk memproses takrif ini. |
| filter_enabled | Mengembalikan benar jika penapisan atribut lanjutan didayakan untuk senarai ini. Jika tidak, mengembalikan palsu. |
| filter_portal_user_attribute_name | Mengembalikan nama logik atribut bagi carian untuk kenalan yang akan digunakan untuk menapis rekod hasil oleh kenalan pengguna portal semasa. Contohnya, contactid |
| filter_website_attribute_name | Mengembalikan nama logik atribut bagi carian untuk adx_website yang akan digunakan untuk menapis rekod hasil oleh tapak web portal semasa. Contohnya, adx_websiteid |
| language_code | Mengembalikan kod bahasa integer Power Apps yang akan digunakan untuk memilih semua label disetempatkan untuk senarai ini. |
| page_size | Mengembalikan saiz halaman hasil yang dikonfigurasikan untuk senarai. |
| primary_key_name | Mengembalikan nama logik atribut kunci utama untuk rekod yang akan dipaparkan oleh senarai ini. |
| search_enabled | Mengembalikan benar jika carian didayakan untuk senarai ini. Jika tidak, mengembalikan palsu. |
| search_placeholder | Mengembalikan teks disetempatkan yang dikonfigurasikan untuk ruang letak medan carian senarai. |
| search_tooltip | Mengembalikan teks disetempatkan yang dikonfigurasikan untuk petua alat carian senarai. |
| pandangan | Mengembalikan pandangan yang tersedia untuk senarai, seperti objek pandangan senarai. |
| [nama logik atribut] | Anda boleh mencapai mana-mana atribut rekod senarai (adx_entitylist) Power Apps mengikut nama logik, dengan cara yang sama seperti objek jadual. Sebagai contoh, {{ entitylist.adx_name }} |
Atribut Pandangan Senarai
| Atribut | Penerangan |
|---|---|
| lajur | Mengembalikan lajur pandangan sebagai objek lajur pandangan senarai. |
| entity_logical_name | Mengembalikan nama logik jadual Power Apps untuk rekod yang akan disertakan dalam pandangan. Sebagai contoh, kenalan |
| Id | Mengembalikan ID GUID bagi pandangan. |
| language_code | Mengembalikan kod bahasa integer Power Apps yang akan digunakan untuk memilih semua label tempatan (pengepala lajur, dsb.) untuk pandangan. |
| Nama | Mengembalikan nama paparan Power Apps bagi pandangan. |
| primary_key_logical_name | Mengembalikan nama logik kunci utama jadual Power Apps untuk rekod yang akan disertakan dalam pandangan. Contohnya, contactid |
| sort_expression | Mengembalikan ungkapan isihan lalai untuk pandangan. Contohnya, name ASC, createdon DESC. |
Atribut Lajur Pandangan Senarai
| Atribut | Penerangan |
|---|---|
| attribute_type | Mengembalikan nama jenis atribut Power Apps untuk lajur, sebagai rentetan. Contoh, Carian, Senarai Pilihan, Rentetan, Boolean, DateTime |
| logical_name | Mengembalikan nama logik atribut Power Apps untuk lajur. Contohnya, createdon |
| Nama | Mengembalikan nama paparan Power Apps tempatan untuk lajur. Contohnya, Dicipta Pada |
| sort_ascending | Mengembalikan rentetan ungkapan isihan untuk mengisih lajur dalam susunan menaik. Contohnya, createdon ASC |
| sort_descending | Mengembalikan rentetan ungkapan isihan untuk mengisih lajur dalam susunan menurun. Contohnya, createdon DESC |
| sort_disabled | Mengembalikan benar jika pengisihan dinyahdayakan untuk lajur. Jika tidak, mengembalikan palsu. |
| sort_enabled | Mengembalikan benar jika pengisihan didayakan untuk lajur. Jika tidak, mengembalikan palsu. |
| lebar | Mengembalikan lebar yang dikonfigurasikan untuk lajur, dalam piksel. |
entityview
Objek entityview digunakan dalam tag entityview dan memberi akses kepada metadata untuk pandangan, serta untuk melihat rekod hasil.
Atribut
| Atribut | Penerangan |
|---|---|
| lajur | Mengembalikan lajur dalam pandangan, sebagai objek lajur pandangan jadual. |
| entity_permission_denied | Mengembalikan benar jika capaian kepada hasil pandangan dinafikan kerana Keizinan Jadual untuk pengguna semasa tidak mencukupi. Mengembalikan palsu jika akses baca kepada hasil pandangan diberikan. |
| entity_logical_name | Nama logik jadual Power Apps rekod hasil pandangan. Sebagai contoh, kenalan |
| first_page | Nombor halaman bagi halaman pertama untuk hasil pandangan. Ini akan menjadi 1 melainkan tiada hasil dikembalikan, yang dalam kes ini akan menjadi nol. |
| Id | ID GUID pandangan Power Apps yang mentakrifkan entityview ini. |
| language_code | Kod bahasa integer Power Apps sedang digunakan untuk memuatkan label yang disetempatkan untuk pandangan semasa. |
| last_page | Nombor halaman bagi halaman terakhir untuk hasil pandangan. Jika tiada hasil dikembalikan, ini akan menjadi nol. |
| nama | Nama pandangan Power Apps yang mentakrifkan entityview ini., contohnya, Kenalan Aktif. |
| next_page | Nombor halaman bagi halaman seterusnya untuk hasil pandangan. Jika tiada halaman hasil seterusnya, ini akan menjadi nol. |
| Halaman | Nombor halaman bagi halaman semasa untuk hasil pandangan. |
| Halaman | Mengembalikan tatasusunan nombor halaman yang mengandungi semua halaman hasil bagi pandangan semasa. |
| page_size | Bilangan hasil yang dikembalikan setiap halaman untuk pandangan semasa. |
| previous_page | Nombor halaman bagi halaman seterusnya untuk hasil pandangan. Jika tiada halaman hasil sebelumnya, ini akan menjadi nol. |
| primary_key_logical_name | Nama logik Power Apps atribut kunci utama jadual hasil untuk pandangan ini. Sebagai contoh, contactid. |
| merekod | Halaman semasa rekod hasil untuk pandangan, sebagai objek jadual. |
| sort_expression | Ungkapan isihan lalai bagi pandangan. Sebagai contoh, nameASC, createdon DESC. |
| total_pages | Jumlah halaman hasil bagi pandangan. |
| total_records | Jumlah halaman hasil bagi pandangan (merentasi semua halaman). |
acara
Menyediakan keupayaan untuk mengakses dan mempersembahkan Peristiwa. Objek peristiwa membolehkan anda memilih acara tertentu atau semua acara.
Objek peristiwa
Objek peristiwa membolehkan anda mengakses mana-mana peristiwa tertentu dalam portal atau mengakses semua peristiwa dalam portal (tanpa mengira peristiwa).
Objek peristiwa mempunyai atribut berikut:
| Atribut | Penerangan |
|---|---|
| kejadian | Mengembalikan eventoccurancessobject yang mengandungi semua kejadian peristiwa dalam portal |
| [nama atau id peristiwa] | Anda boleh mengakses mana-mana peristiwa mengikut sifat Id dan Namanya. {% assign event = events["Nama Peristiwa"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objek peristiwa
Objek peristiwa membolehkan anda bekerja dengan peristiwa tunggal yang membolehkan anda untuk mengakses jadual dan kejadian peristiwa tersebut.
Objek peristiwa mempunyai atribut berikut:
| Atribut | Penerangan |
|---|---|
| kejadian | Mengembalikan eventoccurrencesobject yang mengandungi semua kejadian untuk peristiwa. |
| nama | Nama peristiwa. |
| url | URL peristiwa. |
Objek eventoccurences
Objek eventoccurrences membolehkan anda mengakses koleksi objek kejadian peristiwa. Anda boleh menyusun kejadian peristiwa dan menentukan julat tarikh bagi kejadian untuk memperoleh semula, dan mencapai penghalaman dengan menggunakan penapis cecair
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
ambil perhatian bahawa
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
juga boleh dilakukan.
Atribut berikut dikaitkan dengan objek eventoccurrences
| Atribut | Perihalan |
|---|---|
| Semua | Mengembalikan semua objek eventoccurance dalam koleksi. |
Objek eventoccurence
Mewakili kejadian peristiwa tunggal. Atribut yang berkaitan ditentukan di bawah:
| Atribut | Perihalan |
|---|---|
| url | URL kejadian. |
| is_all_day_event | Adakah ini peristiwa sepanjang hari? |
| start_time | Masa mula untuk peristiwa. |
| end_time | Masa tamat untuk peristiwa. |
forloop
Mengandungi sifat yang berguna dengan blok gelung for.
Nota
gelung untuk hanya boleh digunakan dalam tag untuk.
Kod
{% 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 | Perihalan |
|---|---|
| pertama | Mengembalikan benar jika ia lelaran pertama gelung. Mengembalikan palsu jika ia bukan lelaran pertama. |
| indeks | Kedudukan item semasa dalam koleksi, item pertama mempunyai kedudukan 1. |
| indeks0 | Kedudukan item semasa dalam koleksi, item pertama mempunyai kedudukan 0. |
| Terakhir | Mengembalikan benar jika ia lelaran terakhir gelung. Mengembalikan palsu jika ia bukan lelaran terakhir. |
| panjang | Mengembalikan bilangan lelaran untuk gelung ߝ bilangan item dalam koleksi sedang terlelar. |
| rindeks | Bilangan item yang tinggal dalam gelung (panjang - indeks) yang mana 1 ialah indeks item terakhir. |
| rindeks0 | Bilangan item yang tinggal dalam gelung (panjang - indeks) yang mana 0 ialah indeks item terakhir. |
forum
Menyediakan keupayaan untuk mengakses dan mempersembahkan Forum dan Jaluran Forum. Keupayaan untuk menggunakan Liquid untuk memaparkan data forum dilanjutkan kepada siaran, tetapi untuk mencipta siaran atau jaluran baharu, anda mesti menggunakan Templat Halaman borang berbilang langkah ASP.NET dengan kefungsian terbina dalam yang disebut (seperti Jaluran Forum dan Templat Halaman Siaran Forum lalai).
Objek forum membolehkan anda memilih Forum atau Jaluran 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 membolehkan anda mengakses mana-mana forum tertentu dalam portal atau untuk mengakses semua jaluran forum dalam portal (tanpa mengira forum).
Objek forum membolehkan anda bekerja dengan forum tunggal yang membolehkan anda untuk mengakses jaluran untuk forum tersebut.
Objek forumthread membolehkan anda mengakses koleksi objek forumthread. Anda boleh menyusun jaluran forum dan mencapai penghalaman serta menggunakan penapis liquid.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
Jaluran Forum Tunggal
Objek forumpost membolehkan anda mengakses koleksi objek forumpost.
Atribut
| Atribut | Perihalan |
|---|---|
| jaluran | Mengembalikan objek forumthreads yang mengandungi semua objek forumthread dalam portal. |
| Semua | Mengembalikan semua objek forum dalam portal. Ambil perhatian bahawa website.forums juga bersamaan. |
| thread_count | Mengembalikan nilai integer kiraan jumlah jaluran yang ada dalam seluruh tapak web. |
| post_count | Mengembalikan nilai integer jumlah siaran dalam portal. |
| [nama atau id forum] | Anda boleh mengakses mana-mana forum mengikut sifat Id dan Namanya. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Objek forum
Atribut
Nota
| Atribut | Description |
|---|---|
| jaluran | Mengembalikan objek forumthreads yang mengandungi semua jaluran forum untuk forum. |
| Nama | Nama Forum. |
| thread_count | Mengembalikan nilai integer kiraan jumlah jaluran yang ada dalam forum. |
| post_count | Mengembalikan nilai integer kiraan jumlah siaran yang ada dalam seluruh forum. |
Objek forumthread
Atribut
| Atribut | Perihalan |
|---|---|
| Semua | Mengembalikan semua objek forumthread dalam koleksi. |
Objek forumthread
Atribut
Nota
| Atribut | Perihalan |
|---|---|
| siaran | Mengembalikan objek forumposts yang mengandungi semua siaran forum untuk jaluran. |
| pengarang | Mengembalikan pengarang untuk jaluran (yang merupakan objek jadual kenalan). |
| latest_post | Mengembalikan siaran terkini dalam jaluran. |
| first_post | Mengembalikan siaran pertama dalam jaluran. |
| post_count | Mengembalikan nilai integer kiraan jumlah siaran yang ada dalam jaluran. |
| is_answered | Adakah jaluran dijawab atau tidak? |
| is_sticky | Adakah jaluran merupakan jaluran melekit? |
Objek forumpost
Atribut
| Atribut | Perihalan |
|---|---|
| Semua | Mengembalikan semua objek forumthread dalam koleksi. |
Siaran Forum Tunggal
Atribut
Nota
| Atribut | Perihalan |
|---|---|
| pengarang | Mengembalikan pengarang untuk siaran (yang merupakan objek jadual kenalan). |
| kandungan | Kandungan siaran. |
| is_answer | Adakah siaran ini jawapan untuk jaluran? |
pengetahuan
Memberikan capaian kepada artikel pengetahuan Power Apps dan rekod jadual kategori untuk mempersembahkan artikel dan kategori dalam portal.
Atribut
| Atribut | Perihalan |
|---|---|
| artikel | Mengembalikan objek artikel yang mengandungi objek artikel untuk rekod jadual artikel pengetahuan yang tersedia dalam portal. |
| kategori | Mengembalikan objek kategori yang mengandungi objek kategori untuk rekod jadual kategori yang tersedia dalam portal. |
Objek artikel
Objek artikel membolehkan anda mengakses koleksi objek artikel. Anda boleh menyusun artikel dan mencapai penghalaman serta menggunakan penapis cecair.
{% 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 | Perihalan |
|---|---|
| popular | Mengembalikan koleksi objek artikel yang mengandungi kebanyakan pandangan. {% assign popular_articles = knowledge.articles.popular %} |
| terbaharu | Mengembalikan koleksi objek artikel yang mengandungi tarikh terakhir diubah suai. {% assign recent_articles = knowledge.articles.recent %} |
| atas | Mengembalikan koleksi objek artikel yang mengandungi rating tertinggi. {% assign top_articles = knowledge.articles.top %} |
Penapis
Penapis berikut boleh menerima parameter pilihan untuk saiz dan bahasa halaman. Parameter pertama ialah bilangan rekod untuk didapatkan semula. Saiz halaman lalai ialah 5. Parameter kedua ialah kod bahasa untuk mendapatkan semula artikel bagi bahasa tertentu. Penapis mungkin digabungkan dengan penapis Liquid lain.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| Atribut | Perihalan |
|---|---|
| popular | Mengembalikan koleksi objek artikel yang mengandungi kebanyakan pandangan. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
| terbaharu | Mengembalikan koleksi objek artikel yang mengandungi tarikh terakhir diubah suai. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
| atas | Mengembalikan koleksi objek artikel yang mengandungi rating tertinggi. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
objek kategori
Objek kategori membolehkan anda mengakses koleksi objek kategori. Anda boleh menyusun kategori dan mencapai penghalaman serta menggunakan penapis cecair.
{% 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 | Perihalan |
|---|---|
| terbaharu | Mengembalikan koleksi objek kategori yang mengandungi tarikh terakhir diubah suai. |
| top_level | Mengembalikan koleksi objek kategori yang tidak mempunyai kategori induk. |
Penapis
Penapis berikut boleh menerima parameter pilihan yang menunjukkan saiz halaman. Saiz halaman lalai ialah 5. Penapis mungkin digabungkan dengan penapis Liquid lain.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| Atribut | Perihalan |
|---|---|
| terbaharu | Mengembalikan koleksi objek kategori yang mengandungi tarikh terakhir diubah suai. Anda boleh memberikan parameter {% assign recent_categories = knowledge.categories \| recent: 10 %} |
| top_level | Mengembalikan koleksi objek kategori yang tidak mempunyai kategori induk. {% assign root_categories = knowledge.categories \| top_level %} |
Objek artikel
Objek artikel membolehkan anda bekerja dengan artikel pengetahuan tunggal untuk memaparkan butiran artikel tersebut dalam portal.
Atribut
artikel ialah objek entiti, dengan semua atribut yang sama, selain daripada yang disenaraikan di bawah.
| Atribut | Perihalan |
|---|---|
| article_public_number | Nombor Awam Artikel bagi artikel. |
| comment_count | Nilai integer kiraan jumlah komen yang ada untuk artikel tertentu. |
| kandungan | Kandungan artikel. |
| current_user_can_comment | Mengembalikan nilai Boolean yang menunjukkan sama ada pengguna semasa boleh menambah komen pada artikel atau tidak. |
| is_rating_enabled | Mengembalikan nilai boolean yang menunjukkan sama ada rating pada artikel didayakan. |
| kata kunci | Kata kunci pada artikel. |
| nama | Alias alternatif untuk tajuk artikel. |
| rating | Nilai rating perpuluhan pada artikel. |
| tajuk | Tajuk artikel. |
| view_count | Nilai integer bilangan kali artikel telah dilihat. |
Objek kategori
Objek kategori membolehkan anda bekerja dengan kategori tunggal untuk memaparkan butirannya dalam portal.
Atribut
kategori ialah objek entiti, dengan semua atribut yang sama, selain daripada yang disenaraikan di bawah.
| Atribut | Perihalan |
|---|---|
| categorynumber | Nombor kategori bagi kategori. |
| nama | Alias alternatif untuk tajuk kategori. |
| tajuk | Tajuk kategori. |
bahasa
Menyediakan nama bahasa semasa dan kod bahasa jika sokongan berbilang bahasa didayakan.
Atribut
| Atribut | Penerangan |
|---|---|
| url | URL permintaan semasa yang ditetapkan dengan kod bahasa semasa. |
| url_substitution | Awalan URL permintaan semasa ditetapkan dengan kod bahasa semasa memintas cache output halaman. |
| nama | Tajuk bahasa semasa. |
| kod | Kod bahasa kepada bahasa. |
Sebagai contoh, template web Ke bawah Bahasa secara lalai menggunakan objek cecair ini untuk menyenaraikan bahasa yang tersedia apabila berbilang bahasa tersedia.
halaman
Merujuk kepada halaman permintaan portal semasa. Objek ini menggabungkan atribut peta tapak dan permintaan semasa entiti (biasanya halaman web).
Objek halaman menyediakan akses kepada sesuatu seperti jejak untuk halaman semasa, tajuk atau URL halaman semasa dan atribut atau entiti berkaitan lain bagi rekod Power Apps dasar.
<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
Nota
| Atribut | Perihalan |
|---|---|
| jejak | Mengembalikan objek nod peta tapak jejak untuk halaman, bermula dari nod akar peta tapak dan berakhir di induk. |
| anak | Mengembalikan objek nod peta tapak anak bagi halaman. |
| induk | Mengembalikan objek nod peta tapak induk bagi halaman. Jika halaman ini halaman Utama, indu akan menjadi nol. |
| tajuk | Tajuk halaman. |
| url | URL halaman. |
| [atribut atau nama perhubungan] | Anda boleh mengakses sebarang atribut rekod Power Apps dasar halaman mengikut nama logik.{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}Nilai kebanyakan atribut jadual memetakan kepada jenis Liquid secara terus: Medan Dua Pilihan dipetakan kepada Boolean, medan teks kepada rentetan, medan angka/mata wang kepada nombor, medan tarikh/masa kepada objek tarikh. Tetapi sesetengah jenis atribut dikembalikan sebagai objek:
{{ page.adx_webpage_entitylist.adx_name }}Dalam kes perhubungan adalah refleksif (iaitu, rujukan sendiri), objek entiti akan dikembalikan. (Jika tidak, hasil akan menjadi tidak jelas.) {{ page.adx_webpage_webpage.referencing.adx_name }} Nota: Memuatkan bilangan entiti berkaitan yang besar atau mengakses bilangan perhubungan dalam templat tunggal yang besar, boleh memberi kesan negatif terhadap prestasi persembahan templat. Elakkan daripada memuatkan entiti berkaitan untuk setiap item dalam tatasusunan, dalam gelung. Jika boleh, utamakan penggunaan tag jadual Dataverse Power Apps untuk memuatkan koleksi entiti. |
pungutan suara
Menyediakan keupayaan untuk mengakses dan mempersembahkan pungutan suara.
Objek pungutan suara membolehkan anda memilih pungutan suara atau penempatan pungutan suara 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 Pungutan Suara
| Atribut | Perihalan |
|---|---|
| penempatan | Kembalikan objek pollplacement. |
| [nama atau id pungutan suara] | Anda boleh mengakses mana-mana pungutan suara mengikut sifat Id dan Namanya. {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Atribut Penempatan Pungutan Suara
| Atribut | Perihalan |
|---|---|
| [nama atau id penempatan pungutan suara] | Anda boleh mengakses mana-mana penempatan pungutan suara mengikut sifat Id dan Namanya.{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Atribut Penempatan Pungutan Suara
Nota
| Atribut | Perihalan |
|---|---|
| Nama | Mengembalikan medan Nama untuk penempatan pungutan suara. |
| placement_url | URL yang boleh digunakan untuk mendapatkan kembali penempatan pungutan suara yang dipersembahkan sepenuhnya oleh templat. |
| pungutan suara | Mengembalikan koleksi objek pungutan suara yang berkaitan dengan penempatan. Tag lelaran dan Penapis tatasusunan mungkin digunakan dengan koleksi ini. |
| random_url | URL yang boleh digunakan untuk mendapatkan kembali pungutan suara rawak daripada penempatan yang dipersembahkan sepenuhnya oleh templat. |
| submit_url | URL bagi pungutan suara lengkap diserahkan. |
Atribut Pungutan Suara
Nota
| Atribut | Perihalan |
|---|---|
| has_user_voted | Mengembalikan benar jika pengguna semasa (didaftar masuk atau tanpa nama) sudah mengundi dalam pungutan suara ini. |
| Nama | Mengembalikan medan Nama untuk pungutan suara. |
| pilihan | Mengembalikan koleksi objek pilihan pungutan suara yang berkaitan dengan pungutan suara. Tag lelaran dan entiti boleh digunakan dengan koleksi ini. |
| poll_url | URL yang boleh digunakan untuk mendapatkan kembali pungutan suara yang dipersembahkan sepenuhnya oleh templat. |
| soalan | Mengembalikan medan Soalan untuk pungutan suara. |
| submit_button_label | Mengembalikan rentetan yang boleh digunakan untuk menggantikan label butang serah untuk pungutan suara. |
| submit_url | URL bagi pungutan suara lengkap diserahkan. |
| user_selected_option | Mengembalikan objek polloption yang dipilih oleh pengguna (jika ia telah mengundi). |
| undi | Mengembalikan bilangan undi yang telah dijadualkan untuk pungutan suara. |
Atribut Pilihan Pungutan Suara
Nota
| Atribut | Perihalan |
|---|---|
| jawapan | Mengembalikan medan Jawapan untuk pungutan suara. |
| peratusan | Mengembalikan peratusan undi dalam pungutan suara untuk pilihan sebagai nombor perpuluhan dari 0 hingga 100. |
| undi | Mengembalikan bilangan undi yang telah dijadualkan untuk pilihan. |
permintaan
Mengandungi maklumat tentang permintaan HTTP semasa.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Nota
- Anda boleh membina URL secara dinamik dalam Cecair menggunakan Penapis URL.
- URL yang digunakan dalam request.url boleh menjadi sebarang nilai yang diminta, dan mendapatkan cache untuk permintaan seterusnya. Untuk memastikan nilai yang betul dalam request.url, pertimbangkan menggunakan tag penggantian, URL separa seperti ~{laluan fail web} atau menyimpan URL Portal dalam Tetapan Tapak.
- Portal Power Apps versi keluaran 9.3.8.x atau kemudian akan mempunyai penapis Liquid mematikan yang dikuat kuasakan secara lalai untuk pengguna dan meminta objek Liquid. Untuk menyahdayakan konfigurasi lalai ini dan membenarkan objek Liquid ini tanpa mematikan penapis Liquid, lihat tetapan tapak portal - Site/EnableDefaultHtmlEncoding.
Atribut
| Atribut | Penerangan |
|---|---|
| params | Nilai parameter bernama untuk permintaan semasa. params ialah gabungan parameter rentetan pertanyaan URL, parameter siaran borang dan kuki. |
| Laluan | Laluan URL permintaan semasa. /profile/ |
| path_and_query | Laluan dan pertanyaan URL permintaan semasa. /profile/?foo=1&bar=something |
| pertanyaan | Bahagian pertanyaan URL permintaan semasa. ?foo=1&bar=something |
| url | URL penuh permintaan semasa. https://www.example.com/profile/?foo=1&bar=something |
searchindex
Objek indeks carian digunakan dalam tag jadual Dataverse Power Apps dan memberikan capaian kepada hasil pertanyaan.
{% 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 | Perihalan |
|---|---|
| approximate_total_hits | Mengembalikan anggaran kiraan jumlah kenaan yang sepadan dengan pertanyaan indeks. Disebabkan oleh cara indeks carian berfungsi berkenaan penapisan keselamatan dan faktor reka bentuk lain, bilangan ini hanyalah anggaran dan mungkin tidak benar-benar sepadan dengan jumlah bilangan hasil yang tersedia untuk pengguna semasa dalam situasi tertentu. |
| Halaman | Mengembalikan nombor halaman pertanyaan semasa. |
| page_size | Mengembalikan saiz halaman maksimum pertanyaan semasa. Jika adan mahu bilangan hasil yang sebenar dikembalikan untuk halaman semasa (kerana ini mungkin kurang daripada saiz halaman maksimum yang ditentukan), gunakan results.size. |
| hasil | Mengembalikan halaman hasil pertanyaan, sebagai objek hasil indeks carian. |
Hasil Indeks Carian
| Atribut | Perihalan |
|---|---|
| entiti | Entiti pendasar untuk hasil. |
| pecahan | Pecahan teks ringkas berkaitan untuk hasil, dengan terma yang sepadan dengan pertanyaan tertentu yang diserlahkan menggunakan tag HTML <em>. Jenis pertanyaan tertentu tidak menyokong pecahan yang diserlahkan seperti pertanyaan kabur (~) dan pertanyaan bebas (*). Sifat ini akan menjadi nol dalam kes tersebut. |
| ID | ID jadual Power Apps rekod pendasar untuk hasil, sebagai rentetan. Sebagai contoh, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nama logik jadual Power Apps rekod pendasar untuk hasil. Contohnya, adx_websiteid |
| Nombor | Bilangan hasil, merentasi semua halaman hasil, bermula dari 1. Contohnya, untuk hasil pertama bagi halaman hasil kedua, dengan saiz halaman 10, nilai ini akan menjadi 11. |
| skor | Skor Lucene hasil, sebagai nilai titik-apungan. Hasil akan dikembalikan disusun mengikut nilai ini. |
| tajuk | Tajuk hasil. |
| url | URL untuk hasil. Ini biasanya akan—tetapi tidak semestinya—menjadi laluan mutlak untuk aplikasi semasa, berbanding URL penuh. Sebagai contoh: /articles/article1/ |
tetapan
Membolehkan anda memuatkan sebarang tetapan tapak mengikut nama. Jika tetapan dengan nama yang diberikan tidak ditemui, nol akan dikembalikan.
Nota
Tetapan dikembalikan sebagai rentetan, tetapi anda boleh menggunakan Penapis jenis untuk menukarnya kepada 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 %}
peta laman
Membenarkan akses kepada peta laman 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 Tapak
| Atribut | Perihalan |
|---|---|
| Semasa | Mengembalikan objek nod peta laman untuk halaman semasa. |
| Akar | Mengembalikan objek nod peta laman untuk halaman (utama) akan bagi tapak web. |
Atribut Nod Peta Tapak
| Atribut | Perihalan |
|---|---|
| Breadcrumb | Mengembalikan objek nod peta tapak jejak untuk nod, bermula dari nod akar peta tapak dan berakhir di induk. |
| Anak | Mengembalikan objek nod peta laman anak bagi nod. |
| Perihalan | Kandungan perihalan/ringkasan untuk nod. (Medan ini mungkin mengandungi HTML.) |
| Entiti | Mengembalikan entiti bagi nod. Jika nod tidak mempunyai jadual pendasar, nilai ini akan menjadi nol. |
| is_sitemap_ancestor | Mengembalikan benar jika nod peta tapak ialah moyang nod semasa, jika tidak palsu. |
| is_sitemap_current | Mengembalikan benar jika nod peta tapak ialah nod semasa, jika tidak palsu. |
| Induk | Mengembalikan objek nod peta laman induk bagi nod. Jika nod ialah nod akar, induk akan menjadi nol. |
| Jawatan | Tajuk nod. |
| url | URL nod. |
penanda tapak
Membolehkan anda memuatkan sebarang penanda tapak mengikut nama. Jika penanda tapak wujud, objek penanda tapak akan dikembalikan. Jika penanda tapak dengan nama yang diberikan tidak ditemui, nol akan 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 Penanda Tapak
| Atribut | Perihalan |
|---|---|
| url | URL sasaran penanda tapak. |
| [nama logik atribut] | Anda boleh mengakses sebarang atribut rekod Power Apps sasaran penanda tapak mengikut nama logik. Contohnya, {{ sitemarker.adx_name }} |
coretan
Membolehkan adan memuatkan sebarang coretan kandungan mengikut nama. Jika cebisan dengan nama yang diberikan tidak ditemui, nol akan dikembalikan.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Mengandungi sifat yang berguna dalam blok gelung tag lelaran.
Nota
tablerowloop hanya boleh digunakan dalam tag tag lelaran.
Atribut
| Atribut | Perihalan |
|---|---|
| Laj | Mengembalikan indeks baris semasa, bermula pada 1. |
| col0 | Mengembalikan indeks baris semasa, bermula pada 0. |
| col_first | Mengembalikan benar jika lajur semasa ialah lajur pertama dalam baris, mengembalikan palsu jika sebaliknya. |
| col_last | Mengembalikan benar jika lajur semasa ialah lajur terakhir dalam baris, mengembalikan palsu jika sebaliknya. |
| Pertama | Mengembalikan benar jika ia lelaran pertama gelung. Mengembalikan palsu jika ia bukan lelaran pertama. |
| Indeks | Kedudukan item semasa dalam koleksi, item pertama mempunyai kedudukan 1. |
| indeks0 | Kedudukan item semasa dalam koleksi, item pertama mempunyai kedudukan 0. |
| Terakhir | Mengembalikan benar jika ia lelaran terakhir gelung. Mengembalikan palsu jika ia bukan lelaran terakhir. |
| Panjang | Mengembalikan bilangan lelaran untuk gelung ߝ bilangan item dalam koleksi sedang terlelar. |
| Rindeks | Bilangan item yang tinggal dalam gelung (panjang - indeks) yang mana 1 ialah indeks item terakhir. |
| rindeks0 | Bilangan item yang tinggal dalam gelung (panjang - indeks) yang mana 0 ialah indeks item terakhir. |
pengguna
Merujuk kepada pengguna portal semasa, membolehkan akses kepada semua atribut rekod kenalan Power Apps dasar. Jika tiada pengguna didaftar masuk, pemboleh ubah ini akan menjadi nol.
pengguna ialah objek entiti.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Nota
Portal Power Apps versi keluaran 9.3.8.x atau kemudian akan mempunyai penapis Liquid mematikan yang dikuat kuasakan secara lalai untuk pengguna dan meminta objek Liquid. Untuk menyahdayakan konfigurasi lalai ini dan membenarkan objek Liquid ini tanpa mematikan penapis Liquid, lihat tetapan tapak portal - Site/EnableDefaultHtmlEncoding.
Atribut
Selain daripada mempunyai semua atribut objek entity, pengguna mempunyai atribut berikut.
| Atribut | Perihalan |
|---|---|
| peranan | Mengembalikan peranan yang pengguna miliki, sebagai tatasusunan.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}Perhatian: Anda juga boleh menggunakan penapis has_role untuk menguji keahlian peranan individu. |
| basic_badges_url | Mengembalikan url Perkhidmatan untuk mendapatkan lencana pengguna. Untuk memaparkan lencana untuk pengguna yang anda mesti masukkan tag dengan atribut "data lencana" dan "data uri". Untuk memaparkan lencana pengguna semasa: <div data-badge data-uri='{{user.basic_badges_url }}'></div>Untuk memaparkan lencana pengguna mengikut id (id pengguna boleh ubah): `<div data-badge data-uri='{{user.basic_badges_url |
pautan web
Membolehkan anda memuat sebarang pautan web mengikut nama atau ID.
Jika set pautan web wujud, objek set pautan web akan dikembalikan. Jika set pautan web dengan nama atau ID yang diberikan tidak ditemui, nol akan 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 Set Pautan Web
Nota
Set pautan web ialah objek entiti, dengan semua atribut yang sama, selain daripada yang disenaraikan di bawah.
| Atribut | Perihalan |
|---|---|
| Salin | Salinan set pautan web HTML. |
| Nama | Nama set pautan web. |
| Jawatan | Tajuk set pautan web. |
| Pautan web | Tatasusunan objek pautan web yang berkaitan dengan set pautan web. |
| [nama logik atribut] | Anda boleh mengakses sebarang atribut rekod Power Apps set pautan web mengikut nama logik. Sebagai contoh, {{ weblinkset.createdon }} |
Atribut Pautan Web
Nota
Pautan web ialah objek entiti, dengan semua atribut yang sama, selain daripada yang disenaraikan di bawah.
| Atribut | Perihalan |
|---|---|
| Perihalan | Perihalan set pautan web HTML. |
| display_image_only | Atribut Boolean yang menunjukkan sama ada pautan web harus dipaparkan sebagai imej sahaja, tanpa teks pautan. |
| display_page_child_links | Atribut Boolean yang menunjukkan sama ada pautan web harus menunjukkan pautan untuk halaman anak peta tapak bagi halaman yang dipautkan, sebagai subpautan. |
| Imej | Objek imej pautan web untuk pautan ini. Atribut ini akan menjadi nol jika tiada imej. |
| is_external | Atribut Boolean yang menunjukkan sama ada URL pautan web sasaran adalah untuk tapak luaran (bukannya untuk halaman portal dalaman). |
| is_sitemap_ancestor | Mengembalikan benar jika URL pautan web merujuk moyang nod peta tapak semasa, jika tidak palsu. |
| is_sitemap_current | Mengembalikan benar jika URL pautan web merujuk nod peta tapak semasa, jika tidak palsu. |
| Nama | Nama/tajuk pautan web. |
| Nofollow | Atribut Boolean menunjukkan sama ada pautan web harus ditandakan sebagai rel=nofollow. |
| open_in_new_window | Atribut Boolean menunjukkan sama ada pautan web harus dibuka dalam tetingkap/tab pelayar baharu apabila dipilih. |
| Tooltip | Teks petua alat untuk pautan web. |
| url | URL pautan web. |
| Pautan web | Tatasusunan objek pautan web anak yang berkaitan dengan pautan web. |
| [nama logik atribut] | Anda boleh mengakses sebarang atribut rekod Power Apps pautan web mengikut nama logik. Sebagai contoh, {{ weblink.createdon }} |
Atribut Imej Pautan Web
| alternate_text | Teks alternatif untuk imej. |
|---|---|
| Tinggi | Integer yang mengandungi tinggi tertentu imej. Jika nilai tinggi tidak diberikan, atribut ini akan menjadi nol. |
| url | URL imej. |
| Lebar | Integer yang mengandungi lebar tertentu imej. Jika nilai lebar tidak diberikan, atribut ini akan menjadi nol. |
tapak web
Merujuk kepada tapak web portal, membolehkan akses ke semua atribut rekod Tapak Web Power Apps (adx_website) untuk portal.
Nota
Tapak web adalah objek entiti, dengan semua atribut yang sama.
Kod
{{ website.adx_name }} ({{ website.id }})
Output
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Atribut
Jadual berikut menyenaraikan atribut untuk tag ini yang boleh digunakan untuk menggantikan lalai untuk mengelakkan caching.
| lalai | Gantian (mengelakkan caching) | Contoh |
|---|---|---|
| sign_in_url | sign_in_url_substitution | Lalai: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Penggantian (mengelakkan caching): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("halaman-gantian" dalam contoh ini menggantikan URL dicache lalai.) |
| sign_out_url | sign_out_url_substitution | Lalai: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Penggantian (mengelakkan caching): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("halaman-gantian" dalam contoh ini menggantikan URL dicache lalai.) |
Lihat juga
Jenis Liquid
Tag Liquid
Penapis Liquid
Nota
Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)
Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).