Aracılığıyla paylaş


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>

&ndash;

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

&ndash;

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

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

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

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:
  • Arama (İlişkili Tablo Başvurusu) alanları ilişkili tablo başvuru nesneleri olarak döndürülür.
  • Seçenek Kümesi/Seçim Listesi alanları seçenek kümesi değer nesneleri olarak üretilir.
  • Ayrıca, ilgili varlıkları ilişki şeması adına göre yükleyebilirsiniz.
  • {{ 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.

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

Ö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

Ö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

Ö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

Ö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

Ö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:
  • Arama (İlişkili Tablo Başvurusu) alanları ilişkili tablo başvuru nesneleri olarak döndürülür.
  • Seçenek Kümesi/Seçim Listesi alanları seçenek kümesi değer nesneleri olarak döndürülür.
  • Ayrıca, ilgili varlıkları ilişki şeması adına göre yükleyebilirsiniz.
    {{ 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

Ö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

Ö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

Ö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

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).