Kullanılabilir Liquid nesneleri
Not
12 Ekim 2022 tarihi itibarıyla Power Apps portalları, Power Pages olarak adlandırılmıştır. Daha fazla bilgi: Microsoft Power Pages genel kullanıma sunuldu (blog)
Yakında Power Apps portalları belgelerini taşıyıp Power Pages belgeleri ile birleştireceğiz.
Liquid nesneleri, sayfaya dinamik içerik gönderilmesini sağlayan öznitelikler içerir. Örneğin; sayfa nesnesi, başlık olarak adlandırılan ve mevcut sayfanın başlığının gönderilmesi için kullanılabilecek bir öznitelik içerir.
Bir nesne özniteliğine adıyla erişmek için bir nokta (.) öğesi kullanın. Bir nesnenin bir şablondaki özniteliğini işlemek için bunu {{ and }} içine yerleştirin.
Önemli
Olası siteler arası komut dosyası çalıştırma (XSS) sorunlarını önlemek için, her zaman Liquid nesnelerini kullanarak, kullanıcı tarafından sağlanan güvenilmeyen verileri okumak üzere veri kodlamak için kaçış filtresini kullanın.
{{ page.title }}
Nesnenin özniteliklerine bir dize adı ve [] kullanılarak da erişilebilir. Gerekli özniteliğin dinamik olarak belirlendiği veya öznitelik adının karakterler, boşluk, özel karakterler vb. içerdiği durumlarda bu biçim yararlıdır. Söz diziminde nokta (.) kullanıldığında bu geçersiz olur.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Aşağıdaki nesneler herhangi bir şablonda kullanılabilir ve bunlara şablonlardan erişilebilir.
Nesne | Açıklama |
---|---|
varlıklar | Herhangi bir Power Apps tablosunu kimliğine göre yüklemenize izin verir. Daha fazla bilgi: varlıklar |
şimdi | Şablonun işlendiği sırada güncel UTC saatine karşılık gelen bir tarih/saat nesnesi. Not: Bu değer, portal web uygulaması tarafından önbelleğe alınır ve her seferinde yenilenmez. Daha fazla bilgi: Tarih filtreleri |
sayfa | Mevcut portal talep sayfasına bakın. Sayfa nesnesi mevcut sayfa için içerik haritaları, mevcut sayfanın başlığı veya URL'si veya alttaki Power Apps kaydının diğer öznitelikleri veya ilgili varlıkları gibi öğelere erişim sağlar. Daha fazla bilgi: sayfa |
params | Request.params için uygun bir kısayol. Daha fazla bilgi: istek |
istek | Geçerli HTTP talebi hakkında bilgiler içerir. Daha fazla bilgi: istek |
ayarlar | Herhangi bir Site Ayarını ada göre yüklemenizi sağlar. Daha fazla bilgi: ayarlar |
sitemap | Portal sitesi haritasına erişim sağlar. Daha fazla bilgi: site haritası |
sitemarkers | Herhangi bir Site İşaretçisini ada göre yüklemenizi sağlar. Daha fazla bilgi: sitemarkers |
kod parçacıkları | Herhangi bir İçerik Kod Parçacığını ada göre yüklemenizi sağlar. Daha fazla bilgi: kod parçacıkları |
kullanıcı | Geçerli portal kullanıcısın başvurur, böylece alttaki Power Apps ilgili kişi kaydının tüm özniteliklerine erişim sağlar. Hiçbir kullanıcı oturum açmamışsa bu değişken boş olur. Daha fazla bilgi: kullanıcı |
weblinks | Herhangi bir Web Bağlantısı Kümesini ada veya kimliğe göre yüklemenizi sağlar. Daha fazla bilgi: weblinks |
web sitesi | Portal Web sitesi kaydına başvurur, böylece portalın Power Apps Web sitesi (adx_website) kaydının tüm özniteliklerine erişim sağlar. Daha fazla bilgi: web sitesi |
reklamlar
Bir reklama erişim sağlama ve oluşturma olanağı sağlar.
Reklamlar nesnesi, belirli bir reklamı veya reklam yerleşimini seçmenize olanak verir:
<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>
Reklamlar öznitelikleri
Öznitelik | Açıklama |
---|---|
yerleştirmeler | adplacements nesnesini döndürür. |
[reklam adı veya kimliği] | Herhangi bir reklama adı veya kimlik özniteliği ile erişebilirsiniz. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Reklam Yerleştirmeleri öznitelikleri
Öznitelik | Açıklama |
---|---|
[reklam yerleşimi veya kimliği] | Herhangi bir adplacement adı veya kimlik özniteliği ile erişebilirsiniz.{% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Reklam Yerleştirme öznitelikleri
Reklam yerleşimi, aynı genel özniteliklere ve aşağıda listelenen özniteliklere sahip bir tablo nesnesidir.
Öznitelik | Açıklama |
---|---|
Reklamlar | Yerleşim ile ilişkilendirilmiş reklam nesnelerinin koleksiyonunu döndürür. Yineleme etiketleri ve Dizi filtreleri bu koleksiyon ile kullanılabilir. |
Name | Reklam yerleşiminin İsim alanını döndürür. |
placement_url | Tamamen şablon tarafından oluşturulan reklam yerleşiminin alınmasında kullanılabilecek URL. |
random_url | Tamamen şablon tarafından oluşturulan yerleşimden rastgele bir reklamın alınmasında kullanılabilecek URL. |
Reklam öznitelikleri
Not
Reklam aşağıda listelenenlerin tümünün yanı sıra aynı özniteliklere sahip bir tablo nesnesidir.
Öznitelik | Açıklama |
---|---|
ad_url | Tamamen şablon tarafından oluşturulan reklamın alınmasında kullanılabilecek URL. |
Kopyala | Reklam yerleşiminin Metin alanını döndürür. |
resim | Reklamın resim nesnesini (mevcutsa) döndürür. |
Name | Reklamın Ad alanını döndürür. |
open_in_new_window | redirect_url tarafından belirtilen url yeni bir pencerede açılacaksa doğru olarak döner. |
redirect_url | Kullanıcının reklamı seçtiğinde yönlendirileceği URL. |
Reklam resmi öznitelikleri
Öznitelik | Açıklama |
---|---|
alternate_text | Etiketinin alt özniteliğinde görünmesi amaçlanan metni döndürür. |
yükseklik | Resmin yüksekliğini piksel cinsinden döndürür. |
URL | Resmin URL kaynağını döndürür. |
genişlik | Resmin genişliğini piksel cinsinden döndürür. |
bloglar
Blogları ve Blog postalarını işlemeye ve erişim sağlamaya olanak sağlar.
Bloglar nesnesi, belirli bir blog veya blog postalarını seçmenize olanak verir.
{% 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>
bloglar Nesnesi
Bloglar nesnesi, portaldaki belirli herhangi bir bloga veya portaldaki tüm blog gönderilerine erişmenize olanak sağlar.
Aşağıdaki tabloda bloglar nesnesi ile ilişkili öznitelikler açıklanmıştır.
Öznitelik | Açıklama |
---|---|
gönderiler | Portaldaki tüm blog gönderilerini içeren bir blogposts nesnesi döndürür. |
[blog adı veya kimliği] | Herhangi bir bloga adı veya kimlik özniteliği ile erişebilirsiniz. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
blog Nesnesi
Blog nesnesi, tüm gönderilerine erişim sağlayabileceğiniz tek bir blog ile çalışmanıza olanak sağlar.
Aşağıdaki tabloda blog Nesnesi ile ilişkili çeşitli öznitelikler açıklanmıştır.
Öznitelik | Açıklama |
---|---|
gönderiler | Blogdaki tüm blog postalarını içeren bir blogposts nesnesi döndürür. |
Name | Blogun adı. |
title | Blogun başlığı. |
URL | Blogun URL'si. |
blogposts Nesnesi
blogposts nesnesi blog gönderi nesnelerinin bir koleksiyonuna erişmenize olanak verir. Blog gönderilerini ve sayfa numaralandırmasını liquid filtreler kullanarak da yapabilirsiniz:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Diğer olası seçenekler:
blogs.posts.all
(tüm blog gönderilerini almak için)blogs.posts | from\_index: 0 | take: 2
Aşağıdaki tabloda blogposts Nesnesi ile ilişkili çeşitli öznitelikler açıklanmıştır.
Öznitelik | Açıklama |
---|---|
Tümü | Koleksiyondaki tüm blogpost nesnelerini döndürür. |
blogpost Nesnesi
Tek bir blog gönderisine başvurur.
Aşağıdaki tabloda blogpost Nesnesi ile ilişkili çeşitli öznitelikler açıklanmıştır.
Öznitelik | Açıklama |
---|---|
URL | Gönderinin URL'si. |
content | Gönderinin İçerik alanını getirir. |
author | Gönderi (yalnızca bir ilgili kişi tablo nesnesi olan) için yazarları döndürür. |
başlık | Gönderinin başlığı |
comment_count | Söz konusu gönderinin kaç adet yorumunun olduğunu tamsayı değer olarak getirir. |
publish_date | Gönderinin yayımlandığı tarih. |
varlıklar
Dikkat
Olası siteler arası betik çalıştırma (XSS) sorunlarını engellemek için, kullanıcı tarafından sağlanan güvenilmeyen verileri okumak üzere varlıklar Liquid nesnesini kullanırken daima HTML kodlama dizesi verilerine kaçış filtresi kullanın.
Not
Dataverse uygulamasının bazı adlandırma kuralları değişti. Örneğin Dataverse varlıkları artık tablolar olarak adlandırılıyor. Ad değişiklikleri Liquid nesneleri için geçerli değildir. Liquid varlıklar nesnesi varlıklar olarak anılmaya devam edecek.
Herhangi bir Power Apps tablosunu kimliğine göre yüklemenize izin verir. Tablo mevcutsa bir tablo nesnesi döndürülür. Verilen kimliğe sahip bir tablo bulunamazsa boş değeri döndürülür.
{% 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
Bir varlık nesnesi bir Power Apps tablo kaydının özniteliklerine erişim sağlar.
Öznitelik | Açıklama |
---|---|
Kimlik | Bir dize olarak, tablonun GUID kimliği. Örneğin, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Tablonun Power Apps mantıksal adı. |
Notlar | Tabloyla ilişkili mevcut notları (notlar) en eskiden en yeniye sıralı olarak yükler (createdon). Notlar, not nesneleri olarak üretilir. |
izinler | Tablo için Tablo İzni onaylama sonuçlarını yükler. Sonuçlar bir izinler nesnesi olarak üretilir. |
URL | Tablo için Power Apps portalları içerik yönetim sistemi URL yolunu üretir. Tablo mevcut web sitesinde geçerli bir URL içermiyorsa null döndürülür. Genel olarak, uygulamanızda URL Sağlayıcıyı özelleştirmediğiniz sürece portal CMS'sine entegre edilen belirli tablo türleri için sadece bir değer üretilir. |
[öznitelik veya ilişki adı] | Power Apps tablosunun herhangi bir özniteliğine mantıksal adından erişebilirsiniz. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Doğrudan Liquid türleriyle eşitlenen birçok tablo özniteliğinin değerleri : Boole değerlerine İki Seçenek alanları eşlemesi, dizelere metin alanları, rakamlara sayısal/para birimi alanları, tarih nesnelerine tarih/saat alanları. Ancak bazı öznitelik türleri nesne olarak döndürülür:
{{ page.adx_webpage_entitylist.adx_name }} Yansıma ilişkisi (yani kendine başvuran) olduğu durumda, bir yansıma ilişkisi nesnesi döndürülür. (Aksi takdirde, sonuç belirsiz olacaktır.){{ page.adx_webpage_webpage.referencing.adx_name }} Not: Çok sayıda ilgili varlık yüklenmesi veya tek bir şablonda çok sayıda ilişkiye erişilmesi şablon işleme performansı üzerinde olumsuz bir etkiye sahip olabilir. Bir döngü içindeki bir dizideki her bir öğe için ilgili varlıklar yüklemekten kaçının. Mümkün olan yerlerde varlık koleksiyonlarını yüklemek için Dataverse tablo etiketlerini kullanın. |
İlişkili Tablo Başvurusu
Arama özniteliği değerleri, aşağıdaki özniteliklerle birlikte ilgili tablo başvuru nesneleri olarak üretilir.
Öznitelik | Açıklama |
---|---|
Kimlik | Bir dize olarak, başvurulan tablonun GUID kimliği. Örneğin, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Başvurulan tablonun Power Apps mantıksal adı. |
Adı | Başvurulan tablonun temel ad özniteliği. |
Not
Not, bir not kaydının özniteliklerine ve ilişkilerine erişim sağlayan tablo nesneleridir. Bir tablo nesnesinin özniteliklerine ek olarak, bir not şu ilave özniteliklere sahiptir.
Öznitelik | Açıklama |
---|---|
documentbody | Notun not kaydının documentbody özniteliğini Base64 kodlu bir dize olarak yükler. Bu özniteliğin içeriği büyük olabileceğinden not özniteliklerinin geri kalanıyla birlikte yüklenmez, yalnızca talep üzerine yüklenir. Not: documentbody özniteliğinin kullanılması, şablon işleme performansı üzerinde olumsuz bir etkiye sahip olabilir, bu nedenle dikkatli şekilde kullanılmalıdır. Bunun yerine, mümkünse not eklentisine bir bağlantı vermek için url özniteliğini kullanın. |
URL | Dahili portal onay eklenti işleyici için URL yolunu üretir. Kullanıcı izne sahipse ve notta bir eklenen dosya bulunuyorsa, bu URL'ye yapılan talepler not dosyası eklentisini indirir. |
Not
Seçenek Kümesi Değeri
Seçenek Kümesi/Seçim Listesi özniteliği değerleri, aşağıdaki özniteliklerle birlikte ilgili tablo başvuru nesneleri olarak üretilir.
Öznitelik | Açıklama |
---|---|
Etiket | Seçenek kümesi/seçim listesi özniteliği değerinin yerelleştirilmiş etiketi. Örneğin, Etkin |
Değer | Seçenek kümesi/seçim listesi özniteliği değerinin tamsayı değeri. Örneğin, 0 |
Tablo İzinleri
Tablo İzinleri nesnesi, bir tablo için toplanan izin onay sonuçlarına erişim sağlar.
Öznitelik | Açıklama |
---|---|
can_append | Mevcut kullanıcı, bu kayıt ilişkilerine yapılan kayıtları düzenleme iznine sahipse doğru döndürülür. Aksi halde Yanlış döndürür. |
can_append_to | Mevcut kullanıcı, başka bir tablonun bir ilişkisine yapılan kayıtları düzenleme iznine sahipse doğru döndürür. Aksi halde Yanlış döndürür. |
can_create | Mevcut kullanıcı, bu tablo türünde yeni kayıtlar üretmek için gerekli izne sahipse doğru döndürülür. Aksi halde Yanlış döndürür. |
can_delete | Mevcut kullanıcı bu kaydı silmek için gerekli izne sahipse doğru döndürür. Aksi halde Yanlış döndürür. |
can_read | Mevcut kullanıcı bu kaydı okumak için gerekli izne sahipse doğru döndürür. Aksi halde Yanlış döndürür. |
can_write | Mevcut kullanıcı bu kaydı güncelleştirmek için gerekli izne sahipse doğru döndürür. Aksi halde Yanlış döndürür. |
rules_exist | Bu nesne tarafından temsil edilen izin sonuçları, harici olarak tanımlanan izin kurallarının bir sonucu ise doğru değeri döndürür. Açık şekilde tanımlanan izinler yokken varsayılan sonuçlarsa yanlış değeri döndürür. |
Yansıma İlişkisi
Varlıklar üzerindeki yansıma (ör. kendi kendine başvuran) ilişkileri yükleme denemeleri sonucu aşağıdaki özniteliklere sahip nesneler üretilir.
Öznitelik | Açıklama |
---|---|
is_reflexive | Doğru değerini döndürür. İlişki tarafından üretilen bir nesnenin bir yansıma ilişkisi olup olmadığının test edilmesi için kullanılabilir. |
başvurulan | Belirli bir ilişki için başvurulan varlıkların bir dizisini üretir. |
başvuran | Belirli bir ilişki için bir başvuru tablosunu üretir. Hiçbir başvuru tablosu bulunmuyorsa null değeri döndürür. İlişki, çoktan çoğa (N:N) ise başvuru varlıklarının bir dizesi üretilir. |
entitylist
entitylist nesnesi Power Apps Dataverse tablo etiketleri içinde kullanılır. Belirli bir listedeki tüm özniteliklere erişim sağlar.
Öznitelikler
Not
Öznitelik | Açıklama |
---|---|
create_enabled | Yeni kayıtlarının oluşturulması için liste yapılandırdıysanız doğru değeri döndürür. Aksi halde Yanlış döndürür. |
create_url | Listede oluşturma bağlantı/düğmesi için yapılandırılmış URL yolunu döndürür. |
detail_enabled | Listenin tek tek kayıtları için bir ayrıntı görünümü varlık listesi için yapılandırılmışsa doğru değeri döndürür. Aksi halde Yanlış döndürür. |
detail_id_parameter | Bir kayıt kimliği için kayıt ayrıntı görünümü URL oluşturma sırasında kullanmak üzere sorgu dizesi parametre adını döndürür. Liquid filtrelerini URL'ler oluşturmada kullanmak hakkında detaylar için bkz. URL filtreleri. Örneğin, kimlik |
detail_label | Listede ayrıntı görüntüleme bağlantısı/düğmesi için yapılandırılmış yerelleştirilmiş etiketi döndürür. |
detail_url | Listede ayrıntı görünüm bağlantısı/düğmesi için yapılandırılmış URL yolunu döndürür. |
empty_list_text | Liste görünümü hiçbir sonuç döndürmediğinde görüntülenecek özelleştirilmiş metni döndürür. |
enable_entity_permissions | Tablo İzni filtrelemesi bu liste için etkinse, doğru değeri döndürür. Aksi halde Yanlış döndürür. |
entity_logical_name | Bu liste tarafından görüntülenecek kayıtların Power Apps tablosu mantıksal adını döndürür. Örneğin, ilgili kişi |
filter_account_attribute_name | Sonuçları geçerli portal kullanıcısının ana firması tarafından filtrelenmekte kullanılacak firma araması için öznitelik mantıksal adını döndürür. Örneğin, accountid |
filter_apply_label | Liste sonuçlarına gelişmiş bir öznitelik filtresi uygulayan bağlantı/düğme üzerinde kullanılmak üzere bir yapılandırılmış özelleştirilmiş etiket döndürür. |
filter_definition | Liste için JSON öznitelik filtresi tanımını döndürür. metafilters Liquid filtresini bu tanımı işlemek için nasıl kullanılacağına dair ayrıntı için bkz. Liste filtreleri. |
filter_enabled | Gelişmiş öznitelik filtrelemesi liste için etkinleştirilmişse, doğru değerini döndürür. Aksi halde Yanlış döndürür. |
filter_portal_user_attribute_name | Sonuçları geçerli portal kullanıcısının ilgili kişisi tarafından filtrelenmekte kullanılacak ilgili kişi araması için öznitelik mantıksal adını döndürür. Örneğin, contactid |
filter_website_attribute_name | Sonuçları geçerli portal web sitesi tarafından filtrelenmekte kullanılacak adx_website araması için öznitelik mantıksal adını döndürür. Örneğin, adx_websiteid |
language_code | Tüm yerelleştirilmiş etiketleri bu listeden seçmek için kullanılan Power Apps tamsayı dil kodunu döndürür. |
page_size | Liste için yapılandırılmış sonuç sayfa boyutunu döndürür. |
primary_key_name | Bu liste tarafından görüntülenecek kayıtların birincil anahtar öznitelik mantıksal adını döndürür. |
search_enabled | Arama bu liste için etkinse, doğru değerini döndürür. Aksi halde Yanlış döndürür. |
search_placeholder | Liste arama alanı yer tutucusu için yapılandırılmış yerelleştirilmiş metni döndürür. |
search_tooltip | Liste arama araç ipucu için yapılandırılmış yerelleştirilmiş metni döndürür. |
görünümler | Liste için kullanılabilir görünümleri liste görünümü nesneleri olarak döndürür. |
[öznitelik mantıksal adı] | Liste (adx_entitylist) Power Apps kaydının herhangi bir özniteliğine mantıksal ad ile, tablo nesnesiyle aynı şekilde erişebilirsiniz. Örneğin, {{ entitylist.adx_name }} |
Liste Görünümü Öznitelikleri
Öznitelik | Açıklama |
---|---|
sütunlar | Görünümün sütunlarını, liste görünümü sütun nesneleri olarak döndürür. |
entity_logical_name | Görünümde bulunan kayıtların Power Apps tablo mantıksal adını döndürür. Örneğin, ilgili kişi |
Kimlik | Görünümün GUID Kimliğini döndürür. |
language_code | Görünüm için tüm yerelleştirilmiş etiketleri (sütunlar, başlıklar v.b) seçmek için kullanılan Power Apps tamsayı dil kodunu döndürür. |
Name | Görünümün Power Apps görünen adını döndürür. |
primary_key_logical_name | Görünümde bulunan kayıtların Power Apps tablo birincil ana mantıksal adını döndürür. Örneğin, contactid |
sort_expression | Görünüm için varsayılan sıralama deyimini döndürür. Örneğin, nameASC, createdon DESC |
Liste Görünümü Sütun Öznitelikleri
Öznitelik | Açıklama |
---|---|
attribute_type | Sütun için Power Apps öznitelik tür adını, bir dize olarak döndürür. Örneğin; Arama, Seçim Listesi, Dize, Boole, Tarih/Saat |
logical_name | Sütun için Power Apps öznitelik mantıksal adını döndürür. Örneğin, createdon |
Ad | Sütun için yerelleştirilmiş Power Apps görünen adını döndürür. Örneğin, Oluşturma Tarihi |
sort_ascending | Sütunu artan sıralama ile sıralamak için bir sıralama deyimi döndürür. Örneğin, createdon ASC |
sort_descending | Sütunu azalan sıralama ile sıralamak için bir sıralama deyimi döndürür. Örneğin, createdon DESC |
sort_disabled | Sütun için sıralama devre dışı bırakılmış ise doğru değerini döndürür. Aksi halde Yanlış döndürür. |
sort_enabled | Sütun için sıralama etkinleştirilmişse doğru değerini döndürür. Aksi halde Yanlış döndürür. |
genişlik | Sütun için yapılandırılmış genişliği, piksel cinsinden döndürür. |
entityview
Entityview nesnesi, entityview etiketi içinde kullanılır ve görünüm için meta verilere erişim sağlar ve sonuç kayıtlarını görüntüler.
Öznitelikler
Öznitelik | Açıklama |
---|---|
sütunlar | Görünümün sütunlarını, tablo görünümü sütun nesneleri olarak döndürür. |
entity_permission_denied | Görünüm sonuçlarına erişim talebi, mevcut kullanıcının Tablo İzinlerinin yetersiz olması nedeniyle iptal edilirse doğru değerini döndürür. Görünüm sonuçlarına okuma erişimi verilirse yanlış değerini döndürür. |
entity_logical_name | Görünüm sonucu kayıtlarının Power Apps tablosu mantıksal adı. Örneğin, ilgili kişi |
first_page | Görünüm sonuçlarının ilk sayfasının sayfa numarası. Görüntülenen sonuç olmadığı sürece 1 olur, aksi takdirde null olur. |
Kimlik | Bu entityview öğesini tanımlayan Power Apps görünümüne ilişkin GUID kimliği. |
language_code | Mevcut görünüm için yerelleştirilmiş etiketlerin yüklenilmesi için kullanılan Power Apps tamsayı dil kodu. |
last_page | Görünüm sonuçlarının son sayfasının sayfa numarası. Hiçbir sonuç görüntülenmiyorsa null görüntülenir. |
Ad | Bu entityview öğesini tanımlayan Power Apps görünümünün adı, örneğin Etkin İlgili Kişiler. |
next_page | Görünüm sonuçlarının sonraki sayfasının sayfa numarası. Sonraki sayfa sonuçları yok ise null görüntülenir. |
Sayfa | Görünüm sonuçlarının geçerli sayfasının sayfa numarası. |
pages | Mevcut görünüm için tüm sonuç sayfalarını içeren bir sayfa numaraları dizisi görüntüler. |
page_size | Mevcut görünüm için sayfa başına görüntülenen sonuç sayısı. |
previous_page | Görünüm sonuçlarının sonraki sayfasının sayfa numarası. Önceki sayfa sonuçları yok ise null görüntülenir. |
primary_key_logical_name | Bu görünüm için sonuç tablosunun temel anahtar özniteliğinin Power Apps mantıksal adı. Örneğin, contactid. |
kayıt | Görünüm için tablo nesneleri olarak, sonuç kayıtlarının geçerli sayfası. |
sort_expression | Görünüm için varsayılan sıralama ifadesi. Örneğin, nameASC, createdon DESC. |
total_pages | Görünüm için sonuç sayfaları toplam sayısı. |
total_records | Görünüm için sonuçların toplam sayısı (tüm sayfalarda). |
etkinlikler
Olaylara erişim sağlama ve Olayları işleme olanağı sağlar. Olaylar nesnesi, belirli bir olayı veya tüm olayları seçmenize olanak verir.
olaylar Nesnesi
Olaylar nesnesi, portaldaki herhangi bir olaya veya portaldaki tüm olaylara erişmenizi sağlar (olaydan bağımsız olarak).
Olaylar nesnesi şu özniteliklere sahiptir:
Öznitelik | Açıklama |
---|---|
tekrar sayısı | Portaldaki tüm olay oluşumlarını içeren bir eventoccurancessobject öğesi döndürür |
[olay adı veya kimliği] | Herhangi bir olaya Adı veya Kimlik özellikleri ile erişebilirsiniz. {% olay ata = olaylar["Olay Adı"] %} {% olay ata = olaylar["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
olay Nesnesi
Olay nesnesi, bir olay için programlara ve oluşumlara erişim sağlamanıza izin veren, tek bir olayla çalışmanızı sağlar.
Olay nesnesi şu özniteliklere sahiptir:
Öznitelik | Açıklama |
---|---|
tekrar sayısı | Tüm olay oluşumlarını içeren bir eventoccurrencesobject öğesi döndürür. |
Ad | Olayın adı. |
URL | Olayın URL'si. |
eventoccurences Nesnesi
eventoccurrences nesnesi, olay oluşumları nesnelerinin bir koleksiyonuna erişmenize olanak verir. Liquid filtrelerini kullanarak olay oluşumlarını sıralayabilir ve almak için bir oluşum tarih aralığı belirleyebilir ve sayfa numaralarını arşivleyebilirsiniz
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
şunu unutmayın
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
da mümkündür.
Aşağıdaki öznitelikler eventoccurrences nesnesi ile ilişkilidir
Öznitelik | Açıklama |
---|---|
Tümü | Koleksiyondaki tüm eventoccurance nesnelerini döndürür. |
eventoccurence Nesnesi
Tek bir olay oluşumunu temsil eder. İlişkili öznitelikler aşağıda verilmiştir:
Öznitelik | Açıklama |
---|---|
URL | Oluşumun URL'si. |
is_all_day_event | Bu tüm gün süren bir olay mı? |
start_time | Olayın başlangıç zamanı. |
end_time | Olayın bitiş zamanı. |
forloop
için döngüsü engeli içinde faydalı özellikleri barındırır.
Not
forloop yalnızca için etiketi içinde kullanılabilir.
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 %}
Çıkış
This is the first child page!
This is child page number 2.
This is child page number 3.
Öznitelikler
Öznitelik | Açıklama |
---|---|
Birinci | İlk döngü tekrarı ise doğru değeri döndürür. İlk tekrar değilse yanlış değeri döndürür. |
dizin | Mevcut öğenin koleksiyon içindeki konumu, burada ilk öğe 1 konumuna sahip olacaktır. |
dizin0 | Mevcut öğenin koleksiyon içindeki konumu, burada ilk öğe 0 konumuna sahip olacaktır. |
Son | Son döngü tekrarı ise doğru değeri döndürür. Son tekrar değilse yanlış değeri döndürür. |
uzunluk | Döngü için tekrar sayısını ߝ koleksiyon içinde tekrarlanan öğe sayısını görüntüler. |
rindex | Döngüde kalan öğe sayısı (uzunluk - dizin) burada 1 son öğe dizinine karşılık gelir. |
rindex0 | Döngüde kalan öğe sayısı (uzunluk - dizin) burada 0 son öğe dizinine karşılık gelir. |
forumlar
Forumları ve forum ileti dizilerini işlemeye ve erişim sağlamaya olanak sağlar. Forum verilerini işlemek için Liquid kullanmak, gönderimleri de kapsar ancak yeni bir gönderi veya ileti dizisi oluşturmak için bir ASP.NET çok adımlı formu Sayfa Şablonunu, söz konusu işlevsellik yerleşik (örneğin varsayılan Forum İleti Dizisi ve Forum Gönderim Sayfası Şablonu) olarak kullanmanız gerektiğini unutmayın.
Forumlar nesnesi, bir Forum veya Forum ileti dizilerini seçmenize izin verir:
<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>
forumlar Nesnesi
Forumlar nesnesi, portaldaki belirli herhangi bir foruma veya portaldaki (hangi forum olduğundan bağımsız) tüm forum ileti dizisi gönderilerine erişmenize olanak sağlar.
Forum nesnesi, tüm ileti dizilerine erişim sağlayabileceğiniz tek bir forum ile çalışmanıza olanak sağlar.
forumthreads nesnesi forumthread nesnelerinin bir koleksiyonuna erişmenize olanak verir. Forum ileti dizilerini ve sayfa numaralandırmasını Liquid filtreler kullanarak da yapabilirsiniz.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
Tek bir Forum İleti Dizisi
forumposts nesnesi forumpost nesnelerinin bir koleksiyonuna erişmenize olanak verir.
Öznitelikler
Öznitelik | Açıklama |
---|---|
ileti dizileri | Portaldaki tüm forumthread nesnelerini içeren bir forumthreads nesnesi döndürür. |
Tümü | Portaldaki tüm forum nesnelerini döndürür. ebsite.forums değerinin de bir eşdeğer olduğunu unutmayın. |
thread_count | Web sitesinin tamamında kaç adet ileti dizisinin olduğunun sayısını, tamsayı olarak döndürür. |
post_count | Portalda toplam gönderini sayısının tamsayı değerini döndürür. |
[forum adı veya kimliği] | Herhangi bir foruma Adı veya Kimlik özellikleri ile erişebilirsiniz. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
forum Nesnesi
Özellikler
Not
Öznitelik | Veri Akışı Açıklaması |
---|---|
ileti dizileri | Forumdaki tüm forum ileti dizilerini içeren bir forumthreads nesnesi döndürür. |
Name | Forumun Adı. |
thread_count | Forumda kaç adet ileti dizisinin olduğunu sayısını, tamsayı olarak döndürür. |
post_count | Tüm forumda toplam kaç adet gönderi olduğunun sayısını, tamsayı olarak döndürür. |
forumthreads Nesnesi
Öznitelikler
Öznitelik | Açıklama |
---|---|
Tümü | Koleksiyondaki tüm forumthread nesnelerini döndürür. |
forumthread Nesnesi
Öznitelikler
Not
Öznitelik | Açıklama |
---|---|
gönderiler | İleti dizisi için tüm gönderimleri içeren bir forumposts nesnesi döndürür. |
yazar | İleti dizisi (yalnızca bir ilgili kişi tablosu nesnesi olan) için yazar döndürür. |
latest_post | İleti dizisindeki son gönderiyi döndürür. |
first_post | İleti dizisindeki ilk gönderiyi döndürür. |
post_count | İleti dizisinde kaç adet gönderim olduğunun sayısını, tamsayı olarak döndürür. |
is_answered | İleti dizisi yanıtlanmış mı yanıtlanmamış mı? |
is_sticky | İleti dizisi, yapışkan mı değil mi? |
forumposts Nesnesi
Öznitelikler
Öznitelik | Açıklama |
---|---|
Tümü | Koleksiyondaki tüm forumthread nesnelerini döndürür. |
Tek bir Forum Gönderimi
Öznitelikler
Not
Öznitelik | Açıklama |
---|---|
yazar | Gönderi (yalnızca bir ilgili kişi tablo nesnesi olan) için yazarı döndürür. |
içerik | Gönderinin içeriği. |
is_answer | Bu gönderi bir ileti dizisine yanıt mı? |
bilgi bankası
Portal içerisinde makaleler ve kategorileri işlemek için Power Apps bilgi bankası makalelerine ve kategori tablo kayıtlarına erişim sağlar.
Öznitelikler
Öznitelik | Açıklama |
---|---|
makaleler | Portal içindeki bilgi bankası tablo kayıtları için makale nesnesini içeren bir makaleler nesnesini döndürür. |
kategoriler | Portal içindeki bilgi bankası tablo kayıtları için kategori nesnesini içeren bir kategoriler nesnesini döndürür. |
makaleler nesnesi
Bu makaleler nesnesi, makale nesnelerinin bir koleksiyonuna erişmenize olanak sağlar. Makaleleri ve sayfa numaralandırmasını Liquid filtreleri kullanarak da yapabilirsiniz.
{% 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 %}
Özellikler
Öznitelik | Açıklama |
---|---|
popüler | En fazla görünüme sahip olan makale nesnelerinin koleksiyonunu döndürür. {% assign popular_articles = knowledge.articles.popular %} |
son | Son değiştirilme tarihine sahip olan makale nesnelerinin koleksiyonunu döndürür. {% assign recent_articles = knowledge.articles.recent %} |
üst | En yüksek puana sahip olan makale nesnelerinin koleksiyonunu döndürür. {% assign top_articles = knowledge.articles.top %} |
Filtreler
Aşağıdaki filtreler sayfa boyutu ve dile ilişkin isteğe bağlı parametreleri kabul edebilirler. İlk parametre, getirilecek kayıtların sayısıdır. Varsayılan sayfa boyutu 5'tir. İkinci parametre, belirli bir dilde makaleleri getirmek için dilin kodudur. Filtreler, diğer Liquid filtreler ile birleştirilebilir.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Öznitelik | Açıklama |
---|---|
popüler | En fazla görünüme sahip olan makale nesnelerinin koleksiyonunu döndürür. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
son | Son değiştirilme tarihine sahip olan makale nesnelerinin koleksiyonunu döndürür. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
üst | En yüksek puana sahip olan makale nesnelerinin koleksiyonunu döndürür. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
kategoriler nesnesi
Kategoriler nesnesi kategori nesnelerinin bir koleksiyonuna erişmenize olanak verir. Kategorileri ve sayfa numaralandırmasını liquid filtreler kullanarak da yapabilirsiniz.
{% 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 %}
Özellikler
Öznitelik | Açıklama |
---|---|
son | Son değiştirilme tarihine sahip olan kategori nesnelerinin koleksiyonunu döndürür. |
top_level | Bir üst kategoriye sahip olmayan kategori nesnelerinin bir koleksiyonunu döndürür. |
Filtreler
Aşağıdaki filtreler, sayfa boyutunu belirten isteğe bağlı bir parametre de kabul edebilir. Varsayılan sayfa boyutu 5'tir. Filtreler, diğer Liquid filtreler ile birleştirilebilir.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Öznitelik | Açıklama |
---|---|
son | Son değiştirilme tarihine sahip olan kategori nesnelerinin koleksiyonunu döndürür. Parametreler sağlayabilirsiniz {% assign recent_categories = knowledge.categories \| recent: 10 %} |
top_level | Bir üst kategoriye sahip olmayan kategori nesnelerinin bir koleksiyonunu döndürür. {% assign root_categories = knowledge.categories \| top_level %} |
makale Nesnesi
Makale nesnesi, söz konusu makalenin portal içindeki ayrıntılarını görüntülemeniz için tek bir bilgi bankası makalesi ile çalışmanıza olanak sağlar.
Özellikler
makale aşağıda listelenenlerin tümünün yanı sıra aynı özelliklere sahip bir varlık nesnesidir.
Öznitelik | Açıklama |
---|---|
article_public_number | Makalenin Makale Ortak Numarası. |
comment_count | Söz konusu makalenin kaç adet yorumunun olduğunu tamsayı değeri. |
içerik | Makalenin içeriği. |
current_user_can_comment | Geçerli kullanıcının makaleye yorumlar ekleyip ekleyemeyeceğini belirten bir Boole değeri döndürür. |
is_rating_enabled | Makale üzerinde derecelendirmenin etkin olup olmadığını belirten bir boole değeri döndürür. |
keywords | Makaledeki anahtar sözcükler. |
Ad | Makalenin başlığı için bir alternatif. |
derecelendirme | Makale üzerindeki ondalık derecelendirme değeri. |
title | Makalenin başlığı. |
view_count | Makalenin görüntülenmesinin tamsayı değeri. |
kategori Nesnesi
Kategori nesnesi, ayrıntılarını görüntülemeniz için tek bir kategori ile çalışmanıza olanak sağlar.
Özellikler
kategori aşağıda listelenenlerin tümünün yanı sıra aynı özelliklere sahip bir varlık nesnesidir.
Öznitelik | Açıklama |
---|---|
categorynumber | Kategorinin Kategori Numarası: |
Ad | Kategorinin başlığı için bir alternatif. |
unvan | Kategorinin başlığı. |
dil
Birden çok dil desteği etkinleştirilmişse, geçerli dil adını ve dil kodunu sağlar .
Öznitelikler
Öznitelik | Açıklama |
---|---|
URL | Geçerli dil kodu ön ekine sahip geçerli istek URL'si. |
url_substitution | Sayfa çıktısı ön belleğini atlayan geçerli dil kodu ön ekine sahip geçerli istek URL'si. |
Ad | Geçerli dilin başlığı. |
kod | Dilin dil kodu. |
Örneğin, birden fazla dil mevcut olduğunda Diller Açılan Menüsü web şablonu, kullanılabilir dilleri listelemek için bu Liquid nesnesini kullanır.
sayfa
Mevcut portal talep sayfasına bakın. Bu nesne site haritası öznitelikleri ile geçerli istek varlıkları ile (genelde bir web sayfası) birleştirir.
Sayfa nesnesi mevcut sayfa için içerik haritaları, mevcut sayfanın başlığı veya URL'si veya alttaki Power Apps kaydının diğer öznitelikleri veya ilgili varlıkları gibi öğelere erişim sağlar.
<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 }}. -->
Sayfa öznitelikleri
Not
Öznitelik | Açıklama |
---|---|
breadcrumbs | Site haritası kök düğümünden başlayarak ve ana konumunda sonlanarak, sayfanın içerik haritası için site haritası düğüm nesnelerini görüntüler. |
alt | Sayfanın alt site haritası düğüm nesnelerini görüntüler. |
ana | Sayfanın ana site haritası düğümü görüntüler. Sayfa Ana sayfaysa ana öğe null olur. |
title | Sayfanın başlığı. |
URL | Sayfanın URL'si. |
[öznitelik veya ilişki adı] | Mantıksal ada göre sayfanın temel Power Apps kaydına ait herhangi bir özniteliğe erişim sağlayabilirsiniz.{{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Doğrudan Liquid türleriyle eşitlenen birçok tablo özniteliğinin değerleri : Boole değerlerine İki Seçenek alanları eşlemesi, dizelere metin alanları, rakamlara sayısal/para birimi alanları, tarih nesnelerine tarih/saat alanları. Ancak bazı öznitelik türleri nesne olarak döndürülür:
{{ page.adx_webpage_entitylist.adx_name }} Yansıma ilişkisi (yani, kendine başvuran) olduğu durumda bir varlıklar nesnesi döndürülür. (Aksi takdirde, sonuç belirsiz olacaktır.) {{ page.adx_webpage_webpage.referencing.adx_name }} Not: Çok sayıda ilgili varlık yüklenmesi veya tek bir şablonda çok sayıda ilişkiye erişilmesi şablon işleme performansı üzerinde olumsuz bir etkiye sahip olabilir. Bir döngü içindeki bir dizideki her bir öğe için ilgili varlıklar yüklemekten kaçının. Mümkün olan yerlerde varlık koleksiyonlarını yüklemek için Power Apps Dataverse tablo etiketlerini kullanın. |
anketler
Bir ankete erişim sağlama ve oluşturma olanağı sağlar.
Anketler nesnesi, belirli bir anketi veya anket yerleşimini seçmenize olanak verir:
<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>
Anket Öznitelikleri
Öznitelik | Açıklama |
---|---|
yerleştirmeler | pollplacements nesnesini döndürür. |
[anket adı veya kimliği] | Herhangi bir ankete adı veya kimlik özniteliği ile erişebilirsiniz. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Anket Yerleşim Öznitelikleri
Öznitelik | Açıklama |
---|---|
[anket yerleşimi veya kimliği] | Herhangi bir anket yerleşimine Adı veya Kimlik özellikleri ile erişebilirsiniz.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Anket Yerleşim Öznitelikleri
Not
Öznitelik | Açıklama |
---|---|
Name | Anket yerleşiminin İsim alanını döndürür. |
placement_url | Tamamen şablon tarafından oluşturulan anket yerleşiminin alınmasında kullanılabilecek URL. |
anketler | Yerleşim ile ilişkilendirilmiş anket nesnelerinin koleksiyonunu döndürür. Yineleme etiketleri ve Dizi filtreleri bu koleksiyon ile kullanılabilir. |
random_url | Tamamen şablon tarafından oluşturulan yerleşimden rastgele bir anketin alınmasında kullanılabilecek URL. |
submit_url | Tamamlanan anketin gönderileceği URL. |
Anket Özellikleri
Not
Öznitelik | Açıklama |
---|---|
has_user_voted | Geçerli kullanıcı (oturum açmış veya anonim) bu ankette oy verdiyse doğru olarak döndürür. |
Ad | Anketin İsim alanını döndürür. |
seçenekler | Anket ile ilişkilendirilmiş anket seçeneği nesnelerinin koleksiyonunu döndürür. Yineleme etiketleri ve varlıklar bu koleksiyon ile kullanılabilir. |
poll_url | Tamamen şablon tarafından oluşturulan anketin alınmasında kullanılabilecek URL. |
sorusu | Anketin Soru alanını döndürür. |
submit_button_label | Gönder düğmesinin etiketini değiştirmek için kullanılabilecek bir dizeyi döndürür. |
submit_url | Tamamlanan anketin gönderileceği URL. |
user_selected_option | Kullanıcı tarafından seçilen polloption nesnesini döndürür (eğer oy verdilerse). |
oylar | Anket için tablo haline getirilmiş oyların sayısını döndürür. |
Anket Seçeneği Öznitelikleri
Not
Öznitelik | Açıklama |
---|---|
yanıt | Anketin Cevap alanını döndürür. |
yüzde | Anketteki seçeneğin oy sayısını oranını, 0'dan 100'e kadar bir ondalık sayı olarak döndürür. |
oylar | Seçenek için tablo haline getirilmiş oyların sayısını döndürür. |
istek
Geçerli HTTP talebi hakkında bilgiler içerir.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Not
- URL'leri URL filtrelerini kullanarak Liquid'de dinamik olarak oluşturabilirsiniz.
- request.url'de kullanılan URL istenen herhangi bir değer olabilir ve sonraki isteklerde önbelleğe alınabilir. Request.URL'de doğru değer olmasını sağlamak için, değiştirme etiketi, ~{Webfile Path} gibi kısmi URL kullanmayı veya site ayarları 'nda Portal URL 'sini depolamayı düşünün.
- Power Apps portalları sürüm 9.3.8.x veya üstü sürümler varsayılan olarak kullanıcı ve istek Liquid nesneleri için kaçış Liquid filtresini zorla uygular. Bu varsayılan yapılandırmayı devre dışı bırakmak ve kaçış Liquid filtresi olmadan bu Liquid nesnelere izin vermek için bkz. portal sitesi ayarları - Site/EnableDefaultHtmlEncoding.
Öznitelikler
Öznitelik | Açıklama |
---|---|
parametreler | Mevcut talep için adlandırılan parametre değerleri. params URL sorgu dizesi parametreleri, form ileti parametreleri ve tanımlama bilgilerinin bir birleşimidir. |
Yol | Mevcut talep URL'sinin yolu. /profil/ |
path_and_query | Mevcut talep URL'sinin yolu ve sorgusu. /profile/?foo=1&bar=something |
query | Mevcut talep URL'sinin sorgu bölümü. ?foo=1&bar=something |
URL | Mevcut talebin tam URL'si. https://www.example.com/profile/?foo=1&bar=something |
searchindex
Power Apps Dataverse tablo etiketlerinde kullanılan arama dizini nesnesi sorgu sonuçlarına erişim sağlar.
{% 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 %}
Öznitelikler
Öznitelik | Açıklama |
---|---|
approximate_total_hits | Dizin sorgusuyla eşleşen toplam isabet sayısını üretir. Arama dizininin güvenlik filtreleme ve diğer tasarım faktörlerine dayalı olarak çalışma şekli nedeniyle bu sayının sadece yaklaşık bir değerdir ve bazı durumlarda mevcut kullanıcı için geçerli toplam sonuç sayısıyla tam olarak uyuşmayabilir. |
Sayfa | Mevcut sorgunun sayfa numarasını gösterir. |
page_size | Mevcut sorgunun maksimum sayfa boyutunu gösterir. Mevcut sayfa için gerçek sonuç sayısının görüntülenmesini istiyorsanız (bu değer, belirtilen maksimum sayfa boyutundan küçük olabileceğinden) results.size öğesini kullanın. |
Sonuçlar | Sorgu sonucu sayfasını arama dizini sonuç nesneleri olarak görüntüler. |
Arama Dizini Sonuçları
Öznitelik | Açıklama |
---|---|
varlık | Sonuç için alttaki varlıklar. |
parça | <em> HTML etiketi kullanılarak vurgulanan, belirtilen sorguya eşleşen terimlerle birlikte sonuç için ilgili bir kısa metin parçası. Belirli sorgu türleri, kısmi sorgular (~) ve joker sorguları (*) gibi vurgulanan parçaları desteklemez. Bu özellik bu gibi durumlarda geçersiz olur. |
Kimlik | Sonuç için bir dize olarak, alttaki kaydın Power Apps tablo kimliği. Örneğin, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Sonuç için alttaki kaydın Power Apps tablosu mantıksal adı. Örneğin, adx_webpage |
Numara | 1'den başlayarak tüm sonuç sayfalarındaki sonuç sayısı. Örneğin, sonuçların ikinci sayfasındaki ilk sonuç için 10 sayfa boyutu ile birlikte bu değer 11 olarak görüntülenir. |
puan | Hareketli noktalı değer olarak sonucun Lucene puanı. Sonuçlar bu değere göre sıralı olarak üretilir. |
title | Sonucun başlığı. |
URL | Sonucun URL'si. Bu genellikle—ancak mutlaka değil—tam bir URL yerine geçerli uygulama için mutlak bir yol olmalıdır. Örneğin: /makaleler/makale1/ |
ayarlar
Herhangi bir site ayarını ada göre yüklemenizi sağlar. Belirtilen ada sahip bir ayar bulunamazsa, boş değeri döndürülür.
Not
Ayarlar dizeler olarak döndürülür fakat bunları başka türlere dönüştürmek için Tür filtreleri kullanılabilir.
{{ 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
Portal sitesi haritasına erişim sağlar.
<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 %}
Site Haritası Öznitelikleri
Öznitelik | Açıklama |
---|---|
Geçerli | Geçerli sayfa için site haritası düğümü nesnesini görüntüler. |
Kök | Web sitesinin kök (ana) sayfası için site haritası düğümü nesnesini görüntüler. |
Site Haritası Düğümü Öznitelikleri
Öznitelik | Açıklama |
---|---|
İçerik haritaları | Site haritası kök düğümünden başlayarak ve ana konumunda sonlanarak, düğümün içerik haritası için site haritası düğüm nesnelerini görüntüler. |
Alt Öğeler | Düğümün alt site haritası düğüm nesnelerini görüntüler. |
Açıklama | Düğümün açıklaması/özet içeriği. (Bu alan, HTML içerebilir.) |
Varlık | Düğümün alttaki varlıklar öğesini döndürür. Düğümde altta tablo yoksa bu değer null olacaktır. |
is_sitemap_ancestor | Site haritası düğümü mevcut düğümün bir üst öğesi ise doğru değeri döndürür, aksi takdirde yanlış değeri görüntülenir. |
is_sitemap_current | Site haritası düğümü mevcut düğüm ise doğru değerini döndürür, aksi takdirde yanlış değeri görüntülenir. |
Ana Öğe | Düğümün ana site haritası düğümü görüntüler. Düğüm kök düğüm ise ana öğe null olacaktır. |
Unvan | Düğümün başlığı. |
URL | Düğümün URL'si. |
sitemarkers
Herhangi bir site işaretçisini adıyla yüklemenizi sağlar. sitemarker varsa, bir sitemarker nesnesi döndürülür. Belirtilen ada sahip bir site işaretçisi bulunamazsa, boş değeri döndürülür.
{{ 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 %}
Sitemarker Öznitelikleri
Öznitelik | Açıklama |
---|---|
URL | sitemarker hedefinin URL'si. |
[öznitelik mantıksal adı] | Mantıksal ada göre sitemarker hedef Power Apps kaydına ait herhangi bir özniteliğe erişim sağlayabilirsiniz. Örneğin, {{ sitemarker.adx_name }} |
kod parçacıkları
Herhangi bir içerik parçacığını adıyla yüklemenizi sağlar. Belirtilen ada sahip bir kod parçacığı bulunamazsa, boş değeri döndürülür.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Yineleme etiketleri döngü engeli içinde faydalı özellikleri barındırır.
Not
tablerowloop yalnızca Yineleme etiketleri etiketi içinde kullanılabilir.
Öznitelikler
Öznitelik | Açıklama |
---|---|
Col | Geçerli satırın başlangıç dizinini 1'den başlayarak döndürür. |
col0 | Geçerli satırın başlangıç dizinini 0'dan başlayarak döndürür. |
col_first | Geçerli sütun satırdaki ilk sütun ise doğru, değilse yanlış değerini döndürür. |
col_last | Geçerli sütun satırdaki son sütun ise doğru, değilse yanlış değerini döndürür. |
İlk | İlk döngü tekrarı ise doğru değeri döndürür. İlk tekrar değilse yanlış değeri döndürür. |
Dizin | Mevcut öğenin koleksiyon içindeki konumu, burada ilk öğe 1 konumuna sahip olacaktır. |
dizin0 | Mevcut öğenin koleksiyon içindeki konumu, burada ilk öğe 0 konumuna sahip olacaktır. |
Son | Son döngü tekrarı ise doğru değeri döndürür. Son tekrar değilse yanlış değeri döndürür. |
Uzunluk | Döngü için tekrar sayısını ߝ koleksiyon içinde tekrarlanan öğe sayısını görüntüler. |
Rindex | Döngüde kalan öğe sayısı (uzunluk - dizin) burada 1 son öğe dizinine karşılık gelir. |
rindex0 | Döngüde kalan öğe sayısı (uzunluk - dizin) burada 0 son öğe dizinine karşılık gelir. |
kullanıcı
Geçerli portal kullanıcısın başvurur, böylece alttaki Power Apps ilgili kişi kaydının tüm özniteliklerine erişim sağlar. Hiçbir kullanıcı oturum açmamışsa bu değişken boş olur.
kullanıcı bir varlık nesnesidir.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Not
Power Apps portalları sürüm 9.3.8.x veya üstü sürümler varsayılan olarak kullanıcı ve istek Liquid nesneleri için kaçış Liquid filtresini zorla uygular. Bu varsayılan yapılandırmayı devre dışı bırakmak ve kaçış Liquid filtresi olmadan bu Liquid nesnelere izin vermek için bkz. portal sitesi ayarları - Site/EnableDefaultHtmlEncoding.
Öznitelikler
Bir varlık nesnesi özniteliklerinin tümüne sahip olmanın yanı sıra, kullanıcı aşağıdaki özniteliklere sahiptir.
Öznitelik | Açıklama |
---|---|
roller | Kullanıcının ait olduğu rolleri bir dizi olarak döndürür.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Not: Ayrıca bireysel rol üyeliklerini test etmek için has_role filtresini de kullanabilirsiniz. |
basic_badges_url | Bir kullanıcının rozetlerini almak üzere servis url'sini döndürür. Bir kullanıcı için rozetleri işlemek üzere "data-badge" ve "data-uri" özniteliklerini içeren bir etiket eklemeniz gerekir. Geçerli kullanıcın rozetlerini işlemek için: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Bir kullanıcının rozetlerini kimliğe göre işlemek için (değişken kullanıcı kimliği): `<div data-badge data-uri='{{user.basic_badges_url |
weblinks
Herhangi bir web bağlantısı öğesini adıyla veya kimliğiyle yüklemenizi sağlar.
Web bağlantı kümesi varsa, bir web bağlantısı kümesi nesnesi döndürülür. Belirli bir adda veya kimlikte bir web bağlantısı kümesi bulunmuyorsa boş değeri döndürülür.
<!-- 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 %}
Web Bağlantı Kümesi Öznitelikleri
Not
Web bağlantısı kümesi aşağıda listelenenlerin tümünün yanı sıra aynı özniteliklere sahip bir varlık nesnesidir.
Öznitelik | Açıklama |
---|---|
Kopya | Web bağlantı kümesinin HTML kopyası. |
Name | Web bağlantı kümesinin adı. |
Unvan | Web bağlantı kümesinin başlığı. |
Weblinks | Web bağlantı kümesiyle ilişkili web bağlantı nesnelerinin dizisi. |
[öznitelik mantıksal adı] | Mantıksal ada göre web bağlantı kümesi Power Apps kaydına ait herhangi bir özniteliğe erişim sağlayabilirsiniz. Örneğin {{ weblinkset.createdon }} |
Web Bağlantısı Öznitelikleri
Not
Web bağlantısı aşağıda listelenenlerin tümünün yanı sıra aynı özniteliklere sahip bir varlık nesnesidir.
Öznitelik | Açıklama |
---|---|
Açıklama | Web bağlantısının HTML açıklaması. |
display_image_only | Web bağlantısının bağlantı metni olmaksızın yalnızca görüntü olarak görüntülenip görüntülenmeyeceğini belirten boolean özniteliği. |
display_page_child_links | Web bağlantısını bağlantılı sayfanın sitemap alt sayfalarına alt bağlantılar olarak bağlantı gösterip göstermeyeceğini belirten boolean özniteliği. |
Resim | Bu bağlantının web bağlantısı görüntü nesnesi. Görüntü mevcut değilse bu öznitelik geçersiz olacaktır. |
is_external | Web bağlantısının hedef URL'sinin harici bir siteye (bir dahili portal sayfasına yerine) bağlanıp bağlanmayacağını gösteren boolean özniteliği. |
is_sitemap_ancestor | Web bağlantısının URL'si mevcut site haritası düğümünün bir üst öğesine başvuruyorsa doğru değerini, aksi takdirde yanlış değerini döndürür. |
is_sitemap_current | Web bağlantısının URL'si mevcut site haritası düğümüne başvuruyorsa doğru değerini, aksi takdirde yanlış değerini döndürür. |
Ad | Web bağlantısının adı/başlığı. |
Nofollow | Web bağlantısının rel=nofollow olarak işaretlenip işaretlenmeyeceğini gösteren boolean özniteliği. |
open_in_new_window | Web bağlantısının seçildiğinde yeni bir tarayıcı penceresinde/sekmesinde açılıp açılmayacağını gösteren Boolean özniteliği. |
Araç İpucu | Web bağlantısı için araç ipucu metni. |
URL | Web bağlantısının URL'si. |
Weblinks | Web bağlantısıyla ilişkili alt web bağlantı nesnelerinin dizisi. |
[öznitelik mantıksal adı] | Mantıksal ada göre web bağlantısı Power Apps kaydına ait herhangi bir özniteliğe erişim sağlayabilirsiniz. Örneğin {{ weblink.createdon }} |
Web Bağlantı Görüntüsü Öznitelikleri
alternate_text | Görüntü için alternatif metin. |
---|---|
Yükseklik | Belirtilen görüntü yüksekliğini içeren tamsayı. Hiçbir yükseklik değeri sağlanmamışsa bu öznitelik geçersiz olacaktır. |
URL | Görüntünün URL'si. |
Genişlik | Belirtilen görüntü genişliğini içeren tamsayı. Hiçbir genişlik değeri sağlanmamışsa bu öznitelik geçersiz olacaktır. |
web sitesi
Portal web sitesi kaydına başvurur, böylece portalın Power Apps Web sitesi (adx_website) kaydının tüm özniteliklerine erişim sağlar.
Not
Web sitesi tüm aynı özniteliklere sahip bir varlık nesnesidir.
Kod
{{ website.adx_name }} ({{ website.id }})
Çıktı
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Öznitelikler
Aşağıdaki tabloda, önbelleğe almayı önlemek için varsayılanları değiştirmek üzere kullanılabilecek bu etiketin öznitelikleri listelenmektedir.
Varsayılan | İkame (önbelleğe almayı engeller) | Örnek |
---|---|---|
sign_in_url | sign_in_url_substitution | Varsayılan: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F İkame (önbelleğe almayı engeller): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F (Bu örnekte "substitute-page", önbelleğe alınmış varsayılan URL'nin yerine geçer.) |
sign_out_url | sign_out_url_substitution | Varsayılan: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F İkame (önbelleğe almayı engeller): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F (Bu örnekte "substitute-page", önbelleğe alınmış varsayılan URL'nin yerine geçer.) |
Ayrıca bkz.
Liquid türleri
Liquid Etiketleri
Liquid Filtreleri
Not
Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)
Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).