Kullanılabilir Liquid nesneleri

Liquid nesneleri, sayfaya dinamik içerik gönderilmesini sağlayan öznitelikler içerir. Örneğin, nesnenin page geçerli sayfanın başlığını çıkarmak için kullanabileceğiniz adlı title bir özniteliği vardır.

Nesne özniteliğine ada göre erişmek için nokta (.) kullanın. Bir nesnenin özniteliğini şablonda işlemek için ve içinde {{}}sarmalayın.

Important

Olası siteler arası betik (XSS) sorunlarını önlemek için, bir kullanıcının sağladığı güvenilmeyen verileri okumak için Liquid nesneleri kullandığınızda her zaman HTML kodlama verilerini 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 nesneleri istediğiniz yerde, herhangi bir şablonda kullanabilir ve bu nesnelere erişebilirsiniz.

Nesne	Description
entities	Herhangi bir Microsoft Dataverse tablosunu kimlikle yüklemenize olanak tanır. 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: Portal web uygulaması bu değeri önbelleğe alır ve her seferinde yenilenmez. Daha fazla bilgi: Tarih filtreleri
page	Mevcut portal talep sayfasına bakın. page nesnesi geçerli sayfanın içerik haritaları, geçerli sayfanın başlığı veya URL'si ve temel alınan Dataverse kaydının diğer özniteliklerine veya ilgili varlıklarına erişim sağlar. Daha fazla bilgi: sayfa
parametreler	için request.paramskullanışlı bir kısayol. Daha fazla bilgi: istek
request	Geçerli HTTP talebi hakkında bilgiler içerir. Daha fazla bilgi: istek
settings	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: site işaretçileri
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ı
user	Geçerli portal kullanıcısın başvurur, böylece alttaki Dataverse 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: web bağlantıları
web sitesi	Portal web sitesi kaydına başvurur, böylece portalın Dataverse web sitesi (adx_website) kaydının tüm özniteliklerine erişim sağlar. Daha fazla bilgi: web sitesi

Reklam

Reklamın alımını ve gösterimini etkinleştirir.

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

Özellik	Description
yerleştirmeler	Yerleştirmeler nesnesini döndürür.
[reklam adı veya kimliği]	Herhangi bir reklama Ad veya Kimlik özelliklerine göre erişebilirsiniz. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Reklam Yerleştirmeleri öznitelikleri

Özellik	Description
[reklam yerleşimi veya kimliği]	Her türlü yerleştirmeye 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ğıdaki özniteliklere sahip bir tablo nesnesidir.

Özellik	Description
Reklamlar	Yerleşim ile ilişkilendirilmiş reklam nesnelerinin koleksiyonunu döndürür. Bu koleksiyonla Yineleme etiketlerini ve Dizi filtrelerini kullanın.
İsim	Reklam yerleşiminin İsim alanını döndürür.
placement_url	Bir şablon tarafından tamamen işlenen reklam yerleşimini almak için kullanabileceğiniz URL.
random_url	Bir şablon tarafından tamamen işlenen yerleşimden rastgele bir reklam almak için kullanabileceğiniz URL.

Reklam öznitelikleri

Note

Reklam, aşağıdaki özniteliklere ek olarak tüm özniteliklere sahip bir tablo nesnesidir:

Özellik	Description
ad_url	Bir şablon tarafından tamamen işlenen reklamı almak için kullanabileceğiniz URL.
Kopyala	Reklam yerleşiminin Metin alanını döndürür.
görüntü	Reklamın resim nesnesini (mevcutsa) döndürür.
İsim	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 görüntüsü öznitelikleri

Özellik	Description
alternate_text	Etiketin alt özniteliğinde görüntülenen metni döndürür.
height	Resmin yüksekliğini piksel cinsinden döndürür.
url	Resmin URL kaynağını döndürür.
width	Görüntünün genişliğini piksel cinsinden döndürür.

bloglar

Blogların ve blog gönderilerinin alınmasını ve görüntülenmesini sağlar.

Bloglar nesnesi, belirli bir blogu veya blog gönderilerini seçmenizi sağlar.

{% 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 bir bloga veya portaldaki tüm blog gönderilerine erişmenize olanak tanır.

Aşağıdaki tabloda bloglar nesnesi ile ilişkili öznitelikler açıklanmıştır.

Özellik	Description
gönderiler	Portaldaki tüm blog gönderilerini içeren bir blog gönderileri nesnesi döndürür.
[blog adı veya kimliği]	Herhangi bir bloga Ad veya Kimlik özelliklerine göre erişebilirsiniz.

{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

blog Nesnesi

Blog nesnesi tek bir blogla çalışır, böylece bu blog için gönderilere erişebilirsiniz.

Aşağıdaki tabloda blog nesnesiyle ilişkili çeşitli öznitelikler açıklanmaktadır.

Özellik	Description
gönderiler	Blog için tüm blog gönderilerini içeren bir blog gönderisi nesnesi döndürür.
İsim	Blogun adı.
başlık	Blogun başlığı.
url	Blogun URL'si.

blogposts Nesnesi

Blog gönderileri nesnesi, blog gönderisi nesneleri koleksiyonuna erişmenizi sağlar. Blog gönderilerini sipariş edebilir ve sıvı filtreleri kullanarak sayfalandırmaya ulaşabilirsiniz.

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Diğer olası seçenekler şunlardır:

• blogs.posts.all (tüm blog gönderilerini almak için)
• blogs.posts | from\_index: 0 | take: 2

Aşağıdaki tabloda blogposts nesnesiyle ilişkili çeşitli öznitelikler açıklanmaktadır.

Özellik	Description
Tümü	Koleksiyondaki tüm blog gönderisi nesnelerini döndürür.

blogpost Nesnesi

Tek bir blog gönderisine başvurur.

Aşağıdaki tabloda blogpost nesnesiyle ilişkili çeşitli öznitelikler açıklanmaktadır.

Özellik	Description
url	Gönderinin URL'si.
içerik	Gönderinin İçerik alanını getirir.
yazar	Bir kişi tablosu nesnesi olan gönderinin yazarları.
başlık	Gönderinin başlığı
comment_count	Belirli bir gönderi için kaç açıklama olduğunu gösteren tamsayı değeri.
publish_date	Gönderinin yayımlandığı tarih.

entities

Caution

Olası siteler arası betik (XSS) sorunlarından kaçınmak için, kullanıcı tarafından sağlanan ve güvenilmeyen verileri okumak için Liquid nesnesini her kullandığınızda her zaman HTML kodlama dizesi verilerinin kaçış filtresini kullanın.

Note

Dataverse'in adlandırma kurallarından bazıları değişti. Örneğin, Dataverse varlıkları artık tablo olarak adlandırılır. Ad değişiklikleri Liquid nesneleri için geçerli değildir. Liquid varlıkları nesnesi entities olarak anılmaya devam eder.

Herhangi bir Dataverse tablosunu kimlikle yüklemek için bu nesneyi kullanın. Tablo varsa, bir tablo nesnesi döndürür. Verilen kimlikli bir tablo bulunamazsa null döndürü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 %}

Varlık

Bir varlık nesnesi bir Dataverse tablo kaydının özniteliklerine erişim sağlar.

Özellik	Description
Kimlik	Bir dize olarak, tablonun GUID kimliği. Örneğin, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Tablonun Dataverse mantıksal adı.
Notlar	Tabloyla ilişkili mevcut notları (ek açıklama) en eskiden en yeniye sıralı olarak yükler (createdon). Notlar, not nesneleri olarak üretilir.
permissions	Tablo için Tablo İzni onaylama sonuçlarını yükler. Sonuçlar bir izinler nesnesi olarak üretilir.
url	Tablonun Power Pages içerik yönetim sistemi URL yolunu döndürür. Tablo mevcut web sitesinde geçerli bir URL içermiyorsa null döndürülür. Genel olarak bu, uygulamanızda URL Sağlayıcıyı özelleştirmediğiniz sürece portal CMS'siyle tümleştirilen belirli tablo türleri için yalnızca bir değer döndürür.
[öznitelik veya ilişki adı]	Dataverse 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.

Özellik	Description
Kimlik	Bir dize olarak, başvurulan tablonun GUID kimliği. Örneğin, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Başvurulan tablonun Dataverse mantıksal adı.
İsim	Başvurulan tablonun temel ad özniteliği.

Note

Not, bir not kaydının özniteliklerine ve ilişkilerine erişim sağlayan tablo nesneleridir. Tablo nesnesinin özniteliklerine ek olarak, not aşağıdaki ek özniteliklere sahiptir.

Özellik	Description
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 eklenen dosya bulunuyorsa bu URL'ye yapılan talepte not dosyası eklentisi indirilir.

Note

Ek filtreler

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.

Özellik	Description
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 izinleri

Tablo İzinleri nesnesi, bir tablo için toplanan izin onay sonuçlarına erişim sağlar.

Özellik	Description
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çlar varsa yanlış değeri döndürür.

Esnek ilişki

Varlıklara esnek (kendi kendine başvuran) ilişkileri yüklemeye çalışır, aşağıdaki özniteliklere sahip nesneler olarak döner.

Özellik	Description
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.
referencing	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

Belirli bir listenin entitylist tüm özniteliklerine erişmek için Dataverse tablo etiketleri içindeki nesnesini kullanın.

Note

Mevcut sayfayla ilişkili listeyi işleme

Özellikler

Note

entities

Özellik	Description
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	Liste için oluşturma bağlantısı veya 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	Ayrıntılı görünüm bağlantıları veya liste düğmeleri için yapılandırılmış yerelleştirilmiş etiketi döndürür.
detail_url	Listenin ayrıntılı görünüm bağlantıları veya düğmeleri 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 Dataverse 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ılan 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ş öznitelik filtresi uygulayan bağlantı veya düğme için kullanılacak yapılandırılmış yerelleştirilmiş etiketi 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ılan 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ılan adx_website araması için öznitelik mantıksal adını döndürür. Örneğin, adx_websiteid
language_code	Bu liste için tüm yerelleştirilmiş etiketleri seçmek için kullanılan Dataverse tamsayı dil kodunu döndürür.
sayfa boyutu	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.
views	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) Dataverse 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

Özellik	Description
columns	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 Dataverse tablosu 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ütun başlıkları ve diğer etiketler) seçmek için kullanılan Dataverse tamsayı dil kodunu döndürür.
İsim	Görünümün Dataverse görünen adını döndürür.
primary_key_logical_name	Görünümde bulunan kayıtların Dataverse tablosu birincil anahtar 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

Özellik	Description
attribute_type	Sütun için Dataverse ö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 Dataverse öznitelik mantıksal adını döndürür. Örneğin, createdon
İsim	Sütun için yerelleştirilmiş Dataverse 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.
width	Sütun için yapılandırılmış genişliği, piksel cinsinden döndürür.

entityview

entityview etiketindeki entityview nesnesini kullanın. Sonuç kayıtlarını görüntülemeye ek olarak görünümün meta verilerine erişim sağlar.

Özellikler

Özellik	Description
columns	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 Dataverse 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 Dataverse 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 Dataverse 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ülenmediyse bu değer null olur.
isim	Bu entityview öğesini tanımlayan Dataverse 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ı yoksa bu değer null olur.
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.
sayfa boyutu	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ı yoksa bu değer null olur.
primary_key_logical_name	Bu görünüm için sonuç tablosunun birincil anahtar özniteliğinin Dataverse 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).

events

Olayların alımını ve gösterimini etkinleştirir. Olaylar nesnesi, belirli bir olayı veya tüm olayları seçmenize olanak verir.

events nesnesi

portalda events belirli bir olaya erişmek veya portaldaki tüm olaylara erişmek için nesnesini kullanın.

events nesnesi aşağıdaki özniteliklere sahiptir:

Özellik	Description
occurrences	Portaldaki tüm olay oluşumlarını içeren bir eventoccurrences nesne döndürür.
[olay adı veya kimliği]	Herhangi bir olaya Ad veya Kimlik özelliklerine göre erişin. {% assign event = events["Olay Adı"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

olay nesnesi

event Tek bir olayla çalışmak için nesnesini kullanın. Bu olayın zamanlamalarına ve oluşumlarına erişebilirsiniz.

event nesnesi aşağıdaki özniteliklere sahiptir:

Özellik	Description
occurrences	Tüm olay oluşumlarını içeren bir eventoccurrencesobject öğesi döndürür.
isim	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, almak için bir oluşum tarih aralığı belirleyebilir ve sayfalandırmayı arşivleyebilirsiniz:

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

Aşağıdaki öznitelikler eventoccurrences nesnesi ile ilişkilidir

Özellik	Description
Tümü	Koleksiyondaki tüm eventoccurance nesnelerini döndürür.

eventoccurence Nesnesi

Tek bir olay oluşumunu temsil eder. İlişkili öznitelikler şunlardır:

Özellik	Description
url	Oluşumun URL'si.
is_all_day_event	Bu tüm gün süren bir olay mı?
başlangıç zamanı	Olayın başlangıç zamanı.
bitiş_zamanı	Olayın bitiş zamanı.

forloop

için döngüsü engeli içinde faydalı özellikleri barındırır.

Note

forloop yalnızca için etiketi içinde kullanılabilir.

Code

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Output

This is the first child page!

This is child page number 2.

This is child page number 3.

Özellikler

Özellik	Description
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.
indeks	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.
length	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ın ve Forum İleti Dizilerinin alımını ve gösterimini etkinleştirir. Forum verilerini işlemek için sıvı kullanma özelliği gönderilere kadar uzanır, ancak yeni bir gönderi veya yazışma oluşturmak için, yerleşik olarak söz konusu işlevlere sahip ASP.NET çok adımlı formlar Sayfa Şablonu kullanmanız gerekir (varsayılan Forum Yazışması ve Forum Gönderi Sayfası Şablonları gibi).

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>

forums 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 tek bir forumla çalışmanıza olanak tanır, böylece bu forumun yazışmalarına erişebilirsiniz.

forumthreads nesnesi forumthread nesnelerinin bir koleksiyonuna erişmenize olanak verir. Forumu sipariş edebilir ve Liquid filtrelerini kullanarak sayfalandırmaya ulaşabilirsiniz.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Tek bir forum yazışması

forumposts nesnesi forumpost nesnelerinin bir koleksiyonuna erişmenize olanak verir.

Özellikler

Özellik	Description
threads	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 özelliklerine göre erişebilirsiniz. {% assign forum = forums[Forum Adı] %} {% ata forumu = forumlar[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

forum Nesnesi

Özellikler

Note

entities

Özellik	Description
threads	Forumdaki tüm forum ileti dizilerini içeren bir forumthreads nesnesi döndürür.
İsim	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

Özellikler

Özellik	Description
Tümü	Koleksiyondaki tüm forumthread nesnelerini döndürür.

forumthread Nesnesi

Özellikler

Note

entities

Özellik	Description
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

Özellikler

Özellik	Description
Tümü	Koleksiyondaki tüm forumthread nesnelerini döndürür.

Tek bir Forum Gönderimi

Özellikler

Note

entities

Özellik	Description
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

Portal içerisinde makaleler ve kategorileri işlemek için Dataverse bilgi bankası makalelerine ve kategori tablo kayıtlarına erişim sağlar.

Özellikler

Özellik	Description
makaleler	Portal içindeki bilgi bankası tablo kayıtları için makale nesnesini içeren bir makaleler nesnesini döndürür.
categories	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

Özellik	Description
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 %}
top	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 filtreleri ile birleştirilebilir.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Özellik	Description
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 %}
top	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

Özellik	Description
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 filtreleri ile birleştirilebilir.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Özellik	Description
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ğıdaki özniteliklerin yanı sıra aynı özniteliklerin tümüne sahip bir varlık nesnesidir.

Özellik	Description
article_public_number	Makalenin Makale Ortak Numarası.
comment_count	Söz konusu makalede bulunan yorum sayısının 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.
Anahtar kelime -ler	Makaledeki anahtar sözcükler.
isim	Makalenin başlığı için bir alternatif.
derecelendirme	Makale üzerindeki ondalık derecelendirme değeri.
başlık	Makalenin başlığı.
view_count	Makalenin görüntülenme sayısının 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ğıdaki özniteliklerin yanı sıra aynı özniteliklerin tümüne sahip bir varlık nesnesidir.

Özellik	Description
categorynumber	Kategorinin Kategori Numarası:
isim	Kategorinin başlığı için bir alternatif.
başlık	Kategorinin başlığı.

language

Birden çok dil desteği etkinleştirilmişse geçerli dil adını ve dil kodunu sağlar.

Özellikler

Özellik	Description
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.
isim	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.

günlük

Oluşturucular Liquid kodlarına gün ifadeleri ekleme olanağına sahiptir. Power Pages sitesi çalışırken, Liquid kodunda geliştirici tarafından eklenen günlükler Power Pages geliştirici aracı uzantısında gösterilir. Oluşturucu tarafından eklenen günlükler, tanılama ayarı etkinleştirildiğinde geliştirici aracı uzantısında görüntülenir.

Özel iletileri günlüğe kaydetmek için Liquid kodda aşağıdaki sözdizimi kullanılabilir:

{% log message:'Custom message' level:'Warning' %}

Günlük öznitelikleri

Özellik	Description
günlük	Liquid nesne adı
message	Günlüğe kaydedilecek özel iletileri gösteren bir dize
Düzey	İletiyi Bilgi, Uyarı veya Hata olarak günlüğe kaydet

Örnek:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

page

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 Dataverse 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

Note

entities

Özellik	Description
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.
parent	Sayfanın ana site haritası düğümü görüntüler. Sayfa Ana sayfaysa ana öğe null olur.
başlık	Sayfanın başlığı.
url	Sayfanın URL'si.
[öznitelik veya ilişki adı]	Mantıksal ada göre sayfanın temel Dataverse 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 Dataverse tablo etiketlerini kullanın.

anketler

Anketin alımını ve gösterimini etkinleştirir.

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

Özellik	Description
yerleştirmeler	pollplacements nesnesini döndürür.
[anket adı veya kimliği]	Herhangi bir ankete Ad veya Kimlik özelliklerine göre erişebilirsiniz. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Anket Yerleşim Öznitelikleri

Özellik	Description
[anket yerleşimi veya kimliği]	Herhangi bir yoklama yerleşimine Ad veya Kimlik özelliklerine göre erişebilirsiniz.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Anket Yerleşim Öznitelikleri

Note

entities

Özellik	Description
İsim	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. Bu koleksiyonla yineleme etiketleri ve dizi filtreleri 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

Note

entities

Özellik	Description
has_user_voted	Geçerli kullanıcı (oturum açmış veya anonim) bu ankette oy verdiyse doğru olarak döndürür.
İsim	Anketin İsim alanını döndürür.
options	Anket ile ilişkilendirilmiş anket seçeneği nesnelerinin koleksiyonunu döndürür. Bu koleksiyonla yineleme etiketleri ve varlıklar kullanılabilir.
poll_url	Tamamen şablon tarafından oluşturulan anketin alınmasında kullanılabilecek URL.
soru	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 (oy verdiyse).
oylar	Anket için tablo haline getirilmiş oyların sayısını döndürür.

Anket Seçeneği Öznitelikleri

Note

entities

Özellik	Description
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.

request

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>

Note

• 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 Pages sürümü 9.3.8.x veya üzeri, varsayılan olarak escape Liquid filtresi user ve request Liquid nesneleri için uygulanacaktır. 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.

Özellikler

Özellik	Description
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. /profile/
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

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 %}

Özellikler

Özellik	Description
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ı yalnızca yaklaşık bir değerdir ve bazı durumlarda geçerli kullanıcı için mevcut toplam sonuç sayısıyla tam olarak uyuşmayabilir.
Sayfa	Mevcut sorgunun sayfa numarasını gösterir.
sayfa boyutu	Mevcut sorgunun maksimum sayfa boyutunu gösterir. Geçerli sayfa için döndürülen gerçek sonuç sayısını isterseniz (bu değer, belirtilen maksimum sayfa boyutundan küçük olabileceğinden) results.size öğesini kullanın.
results	Sorgu sonucu sayfasını arama dizini sonuç nesneleri olarak görüntüler.

Arama Dizini Sonuçları

Özellik	Description
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, belirsiz sorgular (~) ve joker karakter sorguları (*) gibi vurgulanan parçaları desteklemez. Bu özellik bu gibi durumlarda null olur.
Kimlik	Sonuç için bir dize olarak, alttaki kaydın Dataverse tablo kimliği. Örneğin, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Sonuç için alttaki kaydın Dataverse tablosu mantıksal adı. Örneğin, adx_webpage
number	1'den başlayarak tüm sonuç sayfalarındaki sonuç sayısı. Örneğin, sonuçların ikinci sayfasındaki ilk sonuç için sayfa boyutu 10 ile birlikte bu değer 11 olur.
puan	Hareketli noktalı değer olarak sonucun Lucene puanı. Sonuçlar bu değere göre sıralı olarak döndürülür.
başlık	Sonucun başlığı.
url	Sonucun URL'si. Bu URL genellikle tam URL yerine geçerli uygulama için mutlak bir yoldur. Örneğin: /makaleler/makale1/

sunucusal

Liquid şablonu işleme sırasında serverlogic etiket bir sunucu mantığı işlemi çağırır. output etiketinin serverlogic parametresi nesnesini oluşturur. Nesnesi genel liquid nesnesi olarak kullanılamaz.

Sözdizimi

{% serverlogic name: 'server-logic-name', operation: 'operation-name', input: inputData, output: result %}

Parameters

Parametre	Gerekli	Description
name	Evet	Çağrılacak sunucu mantıksal kaydının adı.
operation	Evet	Sunucu mantıksal kaydında çağrılacak JavaScript işlevinin adı.
input	Hayır	Etiketin sunucu mantığı işlemine geçirdiği bir dize. Yapılandırılmış verileri geçirmek için JSON dizesi kullanın. İşlem, aracılığıyla değere Server.Context.Inputerişebilir.
output	Evet	Sunucu mantığı sonuç nesnesini alan Liquid değişkeninin adı.

Aşağıdaki örnek, JSON girişini bir sunucu mantığı işlemine geçirir:

{% assign inputData = '{"category":"active","maximumResults":5}' %}

{% serverlogic name: 'customer-summary', operation: 'getSummary', input: inputData, output: result %}

{% if result.success %}
  <p>{{ result.data.message | escape }}</p>
{% else %}
  <p>The customer summary couldn't be retrieved.</p>
{% endif %}

Sunucu mantığı işleminde girişi okumak için kullanın Server.Context.Input :

function getSummary() {
    var input = JSON.parse(Server.Context.Input || "{}");

    return JSON.stringify({
        message: "Summary retrieved",
        category: input.category,
        maximumResults: input.maximumResults
    });
}

Liquid'den sunucu mantığını çağırma bölümünde daha fazla bilgi edinin.

Özellikler

Özellik	Description
success	Sunucu mantığı işlemi başarıyla tamamlandığında döndürür true ; aksi takdirde döndürür false.
status_code	Sunucu mantığı işleminin durum kodunu döndürür. Yürütme hatası durum kodunu 500döndürür.
data	Sunucu mantığı işleminin ürettiği ayrıştırılmış JSON değerini döndürür. Standart Liquid söz dizimini kullanarak iç içe nesnelere ve dizilere erişebilirsiniz.
raw_result	Sunucu mantığı işlemi tarafından oluşturulan ayrıştırılmamış yanıtı döndürür. Yanıt geçerli JSON olmadığında veya özgün yanıtı incelemeniz gerektiğinde bu özniteliği kullanın.

Important

Sunucu mantığı tarafından döndürülen giriş ve değerleri güvenilmeyen veriler olarak değerlendirin. Sunucu mantığı işlemindeki girişi doğrulayın ve döndürülen dizeleri HTML'de işlemeden önce filtreyi escape uygulayın.

settings

Herhangi bir site ayarını ada göre yüklemek için bu nesneyi kullanın. Portal belirtilen ada sahip bir ayarı bulamazsa null döndürür.

Note

Portal, ayarları dize olarak döndürür, ancak tür filtrelerini kullanarak bunları diğer türlere dönüştürebilirsiniz.

{{ 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 %}

Note

Web sitesi başlığını ve birincil gezinti çubuğunu oluşturma

sitemap

Portal site haritasına erişmek için bu nesneyi kullanın.

<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

Özellik	Description
Mevcut	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 eşleme düğümü öznitelikleri

Özellik	Description
İç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.
Çocuklar	Düğümün alt site haritası düğüm nesnelerini görüntüler.
Description	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 temel alınan tablo yoksa bu değer null olur.
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.
Ebeveyn	Düğümün ana site haritası düğümü görüntüler. Düğüm kök düğüm ise ana öğe null olur.
Başlık	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 sitemarker nesnesi döndürülür. Belirtilen ada sahip bir sitemarker bulunmazsa null 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 %}

Note

Web sitesi başlığını ve birincil gezinti çubuğunu oluşturma

Sitemarker öznitelikleri

Özellik	Description
url	sitemarker hedefinin URL'si.
[öznitelik mantıksal adı]	Mantıksal ada göre sitemarker hedef Dataverse 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ığı bulunmazsa null 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.

Note

tablerowloop yalnızca Yineleme etiketleri etiketi içinde kullanılabilir.

Özellikler

Özellik	Description
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.

User

Geçerli portal kullanıcısın başvurur, böylece alttaki Dataverse 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 %}

Note

Power Pages sürüm 9.3.8.x veya üzeri, kullanıcı ve istek Liquid nesneleri için kaçış Liquid filtresini varsayılan olarak zorunlu bırakır. Bu varsayılan yapılandırmayı devre dışı bırakmak ve kaçış Liquid filtresi olmadan bu Liquid nesnelerine izin vermek için bkz. portal sitesi ayarları - Site/EnableDefaultHtmlEncoding.

Özellikler

Bir varlık nesnesi özniteliklerinin tümüne sahip olmanın yanı sıra, kullanıcı aşağıdaki özniteliklere sahiptir.

Özellik	Description
roles	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. 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 web bağlantı kümesi nesnesi döndürülür. Belirli bir ada veya kimliğe sahip web bağlantısı kümesi bulunmuyorsa null 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 %}

Note

Web sitesi başlığını ve birincil gezinti çubuğunu oluşturma |

Web Bağlantı Kümesi Öznitelikleri

Note

Web bağlantı kümesi aşağıdaki özniteliklerin yanı sıra aynı özniteliklere sahip bir varlık nesnesidir.

Özellik	Description
Kopyala	Web bağlantı kümesinin HTML kopyası.
İsim	Web bağlantı kümesinin adı.
Başlık	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 Dataverse kaydına ait herhangi bir özniteliğe erişim sağlayabilirsiniz. Örneğin, {{ weblinkset.createdon }}

Web bağlantısı öznitelikleri

Note

Web bağlantısı aşağıdaki özniteliklerin yanı sıra aynı özniteliklere sahip bir varlık nesnesidir.

Özellik	Description
Description	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 null olur.
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.
İsim	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.
Tooltip	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ı Dataverse 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ı. Yükseklik değeri sağlanmamışsa bu öznitelik null olur.
url	Görüntünün URL'si.
Genişlik	Belirtilen görüntü genişliğini içeren tamsayı. Genişlik değeri sağlanmamışsa bu öznitelik null olur.

web sitesi

Portal web sitesine başvurur, böylece portalın Dataverse web sitesi (adx_website) kaydının tüm özniteliklerine erişim sağlar.

Note

Web sitesi tüm aynı özniteliklere sahip bir varlık nesnesidir.

Code

{{ website.adx_name }} ({{ website.id }})

Output

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Özellikler

Aşağıdaki tabloda, önbelleğe almayı önlemek için varsayılanları değiştirmek üzere kullanılabilecek bu etiketin öznitelikleri listelenmektedir.

Default	İkame (önbelleğe almayı engeller)	Example
sign_in_url	sign_in_url_substitution	Varsayılan: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Değiştirme (ö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 Değiştirme (ö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 bakınız

Liquid türleri
Liquid Etiketleri
Liquid Filtreleri