Споделяне чрез

Налични обекти на Liquid

  • Статия

Обектите на Liquid съдържат атрибути за извеждане на динамично съдържание на страницата. Например обектът „Страница” има атрибут, наречен „заглавие”, който може да се използва за извеждане на заглавието на текущата страница.

За достъп до атрибут на обект по име използвайте точка (.). За да рендирате атрибут на обект в шаблон, го оградете в {{ and }}.

Важно

За да избегнете потенциални проблеми със скриптове между сайтове (XSS), винаги използвайте филтър за превключване в шифроването на HTML данни, когато използвате обекти на Liquid за четене на ненадеждни данни, предоставени от потребителя.

{{ page.title }}

Можете да получите достъп до атрибути на обект и като използвате име на низ и []. Този формат полезен в случаите, когато необходимият атрибут се определя динамично или името на атрибута съдържа знаци, интервали, специални знаци, т.н., които биха били невалидни при използване на точка (.) в синтаксиса.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Следните обекти могат да бъдат използвани и да се получи достъп до тях навсякъде и във всеки шаблон.

Обект Описание
обекти Позволява ви да заредите всяка таблица на Microsoft Dataverse по ИД. Повече информация: entities
сега Обект за дата/час, който препраща към текущия UTC час в момента на рендиране на шаблона.
Забележка: Уеб приложението на портала кешира тази стойност и не се обновява всеки път. Повече информация: Филтри за дата
страница Отнася се за текущата страница за заявка в портала. Обектът „Страница” предоставя достъп до неща, като йерархични връзки за текущата страница, заглавието или URL адреса на текущата страница, както и всякакви други атрибути или свързани обекти на подлежащия запис на Dataverse. Повече информация: страница
параметри Удобен пряк път за request.params. Повече информация: заявка
заявка Съдържа информация относно текущата HTTP заявка. Повече информация: заявка
настройки Позволява ви да заредите всяка настройка на сайта по име. Повече информация: настройки
sitemap Позволява достъп до картата на сайта на портала. Повече информация: карта на сайта
маркери на сайт Позволява ви да заредите всякакви маркери на сайт по име. Повече информация: маркери на сайта
фрагменти Позволява ви да заредите всеки фрагмент от съдържание по име. Повече информация: фрагменти
потребител Отнася се за текущия потребител на портала, което позволява достъп до всички атрибути на подлежащия запис на контакт в Dataverse. Ако няма влязъл потребител, тази променлива е null. Повече информация: потребител
уеб връзки Позволява ви да заредите всякакъв набор от уеб връзки по име или ИД. Повече информация: уеб връзки
уеб сайт Отнася се за записа на уеб сайта на портала, което позволява достъп до всички атрибути на записа уеб сайт на Dataverse (adx_website) за портала. Повече информация: уеб сайт

ads

Позволява извличането и показването на реклама.

Обектът „Реклами” ви позволява да изберете конкретна реклама или разполагане на реклама:

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

Атрибути за реклама

Атрибут Описание
разполагания Връща обекта за разполагане на реклама.
[име или ИД на реклама] Можете да получите достъп до всяка реклама чрез свойствата за нейното име или ИД.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Атрибути на разполаганията на реклама

Атрибут Описание
[име или ИД на разполагане на реклама] Можете да получите достъп до всяко разполагане на реклама чрез свойствата за неговото име или ИД.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Атрибути на разполагането на реклама

Рекламното разположение е табличен обект със същите общи атрибути и следните атрибути:

Атрибут Описание
Реклами Връща колекцията от обекти на реклама, свързани с разполагането. Тагове за итерация и филтри за масиви могат да се използват с тази колекция.
Име Връща полето „Име“ за разполагането на рекламата.
placement_url URL адресът, който може да се използва за извличане на разполагането на рекламата, изцяло рендирано от шаблон.
random_url URL адресът, който може да се използва за извличане на произволна рекламата от разполагане, изцяло рендирано от шаблон.

Атрибути на реклама

Бележка

Рекламата е табличен обект с едни и същи атрибути в допълнение към следното:

Атрибут Описание
ad_url URL адресът, който може да се използва за извличане на рекламата, изцяло рендирана от шаблон.
Копиране Връща полето „Копиране“ за рекламата.
изображение Връща обекта на изображението (ако има такива) за рекламата.
Име Връща полето „Име“ за рекламата.
open_in_new_window Връща „true“, ако URL адресът от redirect_url трябва да се отвори в нов прозорец.
redirect_url URL адресът, към който е насочен потребителят, избирайки рекламата.

Атрибути за изображение на рекламата

Атрибут Описание
alternate_text Връща текста, който е предназначен да се появи в алтернативния атрибут на етикета.
height Връща височината на изображението в пиксели
URL адрес Връща източника на URL адрес за изображението.
ширина Връща ширината на изображението в пиксели

блогове

Разрешава извличането и показването на блогове и публикации в блогове.

Обектът „Блогове” ви позволява да изберете конкретни блог или публикации в блог.

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

обект на блогове

Обектът на блогове ви дава достъп до всеки конкретен блог в портала или до всички публикации в блог в портала.

Таблицата по-долу описва атрибутите, свързани с обекта на блогове.

Атрибут Описание
публикации Връща обект blogposts, съдържащ всички публикации в блог в портала.
[име или ИД на блог] Можете да получите достъп до всеки блог чрез свойствата за неговото име или ИД. 
{% assign blog = blogs["Blog Name"] %}                             

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

обект на блог

Обектът на блог ви позволява да работите с един блог, като ви дава достъп до публикациите в този блог.

Таблицата по-долу описва различни атрибути, свързани с обекта на блог.

Атрибут Описание
публикации Връща обект на блог, съдържащ всички публикации в блог за блога.
Име Името на блога.
title Заглавието на блога.
URL адрес URL адресът на блога.

обект на публикации в блог

Обектът за публикации в блог ви позволява достъп до колекция от обекти за публикации в блог. Можете да подредите публикациите в блог и да постигне страниране, както и да използвате филтри на Liquid:

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

Други възможни опции:

  • blogs.posts.all (за да получите всички публикации в блога)
  • blogs.posts | from\_index: 0 | take: 2

Таблицата по-долу описва различни атрибути, свързани с обекта на публикации в блог.

Атрибут Описание
Всички Връща всички обекти на публикации в блог в колекцията

обект на публикация в блог

Отнася се за единична публикация в блог.

Таблицата по-долу описва различни атрибути, свързани с обекта на публикация в блог.

Атрибут Описание
URL адрес URL адресът на публикацията.
съдържание Връща полето със съдържание за публикацията.
автор Връща авторите за публикацията (които са просто обект за таблица на контакт).
заглавие Заглавието на публикацията.
comment_count Връща целочислената стойност на броя, който показва колко коментара има за дадена публикация.
publish_date Датата, на която е публикувана публикацията.

обекти

Внимание

За да избегнете потенциални проблеми със скриптове между сайтове (XSS), винаги използвайте филтър за превключване в шифроването на HTML данни на низ, когато използвате обекти на Liquid за четене на данни, предоставени от потребител, който не е доверен.

Бележка

Някои от конвенциите за именуване на Dataverse са се променили, напр. Dataverse обекти сега се наричат таблици. Промените в името не се отнасят за обекти Liquid. Обектът Liquid entities ще продължи да се нарича обекти.

Позволява ви да заредите всяка таблица на Dataverse по ИД. Ако таблицата съществува, се връща обект на таблица. Ако не бъде намерена таблица с дадения ИД, връща се null .

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

Обектът на обект предоставя достъп до атрибутите на Dataverse табличен запис.

Атрибут Описание
ID ИД на GUID на таблицата като низ. Например 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Логическото име на Dataverse на таблицата.
Бележки Зарежда всички бележки (анотация), свързани с таблицата, подредени от най-старите към най-новите (createdon). Бележките се връщат като обекти на бележки.
разрешения Зарежда резултати от потвърждение на разрешение за таблица за таблицата. Резултатите се извеждат като обект на разрешения.
URL адрес Връща път на URL адрес за системата за управление на съдържанието на Power Pages за таблицата. Ако таблицата няма валиден URL адрес в текущия уеб сайт, връща null. Обикновено това връща стойност само за определени типове таблици, които са интегрирани в CMS на портала, освен ако не сте персонализирали доставчика на URL адреси във вашето приложение.
[име на атрибут или релация] Можете да отворите всеки атрибут на таблица на Dataverse чрез логическо име. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Стойностите на повечето атрибути на таблица се нанасят директно върху Типове на Liquid: Полетата с две опции се нанасят до булев израз, текстовите полета до низове, числовите/валутни полетата до числа, полетата за дата/час до обекти на дата. Някои типове атрибути обаче се връщат като обекти:
  • Полетата за справка (препратка към свързана таблица) се връщат като обекти за препратка към свързана таблица.
  • Полетата за набор от опции/списък по избор се връщат като обекти със стойност за задаване на опция.
  • Можете също да заредите всички свързани обекти по име на схема на отношение.
    • {{ page.adx_webpage_entitylist.adx_name }}В случай, че дадена връзка е рефлексивна (т.е. самореференциална), се връща обект на рефлексивна връзка. (В противен случай, желаният резултат ще бъде неясен.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Забележка: Зареждането на голям брой свързани обекти или достъпът до голям брой релации в един единствен шаблон може да има отрицателно въздействие върху характеристиките на рендиране на шаблона. Избягвайте зареждане на свързаните обекти за всеки елемент в масив в рамките на един цикъл. Когато е възможно, използвайте етикети на таблица на Dataverse, за да заредите колекции от обекти.

Препратка към асоциирана таблица

Стойностите на атрибутите за търсене се връщат като обекти за препратка към свързана таблица със следните атрибути.

Атрибут Описание
ID ИД на GUID на таблицата с препратка като низ.
Например 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Логическото име на таблицата с препратка в Dataverse.
Име Основното име на атрибута на таблицата с препратка.

Забележка

Бележката представлява обект на таблица, който предоставя достъп до атрибути и отношения на запис на анотация. В допълнение към всички атрибути на табличен обект, бележката има следните допълнителни атрибути.

Атрибут Описание
documentbody Зарежда атрибута documentbody на записа на анотацията на бележката във формата на кодиран чрез Base64 низ. Тъй като съдържанието на този атрибут може да е голямо, то не се зарежда с останалите атрибути на бележката, а се зарежда само при поискване.
Забележка: Използването на атрибута documentbody може да има отрицателен ефект върху производителността на рендирането на шаблона и трябва да се извършва с повишено внимание.
Използвайте атрибута URL адрес, за да предоставите връзка към прикачения файл на бележката, ако е възможно.
URL адрес Връща път на URL адрес за манипулатора за прикачен файл на анотация на вградения портал. Ако потребителят има разрешение и бележката има прикачен файл, искане към този URL адрес изтегля прикачения файл с бележка.

Бележка

Допълнителни филтри

Стойност на набора от опции

Стойностите на атрибута за набор от опции/списък по избор се връщат като обекти за препратка към свързана таблица с атрибутите по-долу.

Атрибут Описание
Етикет Локализираният етикет на стойността на атрибута на набор от опции/списък по избор. Например „активен”
Стойност Целочислената стойност на стойността на атрибута на набор от опции/списък по избор. Например 0

Разрешения за таблица

Обектът на разрешения за таблица предоставя достъп до резултат за потвърждение на обобщено разрешение за дадена таблица.

Атрибут Описание
can_append Връща „true”, ако текущият потребител има разрешение за добавяне на записи към отношения на този запис. В противен случай връща „false”.
can_append_to Връща „вярно”, ако текущият потребител има разрешение за добавяне на този запис към отношения на друга таблица. В противен случай връща „false”.
can_create Връща „вярно”, ако текущият потребител има разрешение за създаване на нов запис за този тип таблица. В противен случай връща „false”.
can_delete Връща „true”, ако текущият потребител има разрешение да изтрие този запис. В противен случай връща „false”.
can_read Връща „true”, ако текущият потребител има разрешение да прочете този запис. В противен случай връща „false”.
can_write Връща „true”, ако текущият потребител има разрешение да актуализира този запис. В противен случай връща „false”.
rules_exist Връща „true”, ако резултатите от разрешение, представени от този обект са резултат от изрично определени правила за разрешение. Връща false, ако те са резултатите по подразбиране при липса на изрично дефинирани разрешения.

Рефлексивно отношение

Опитите да се заредят рефлексивни (т.е. самоотносими) взаимоотношения на обекти се връщат като обекти с атрибутите по-долу.

Атрибут Описание
is_reflexive Връща „true”. Може да се използва, за да проверите дали даден обект, върнат от отношение, е обект на рефлексивно отношение.
посочени Връща масив от обекти с препратка за даденото отношение.
препращащи Връща таблица с препратка за дадената релация. Връща null, ако не съществува таблица с препратка. Ако релацията е много-към-много (N:N), връща масив от препращащи обекти.

entitylist

Обектът на списък с обекти се използва в рамките на етикетите на таблица на Dataverse. Той осигурява достъп до всички атрибути от даден списък.

Бележка

Рендиране на списъка, свързан с текущата страница

Атрибути

Бележка

entities

Атрибут Описание
create_enabled Връща „вярно”, ако е конфигурирано създаването на нови записи за списъка. В противен случай връща „false”.
create_url Извежда конфигурирания път до URL адреса за връзка/бутон за създаване за списъка.
detail_enabled Връща „вярно”, ако е конфигуриран подробен изглед за отделни записи за списъка. В противен случай връща „false”.
detail_id_parameter Извежда името на параметър на низа за заявката, който да се използва за ИД на записа при конструиране на URL адрес за подробен изглед на запис. Вижте Филтри за URL адреси за подробности за използването на филтри на Liquid за изграждане на URL адреси. Например ИД
detail_label Извежда конфигурирания локализиран етикет за връзки/бутони за подробен изглед за списъка.
detail_url Извежда конфигурирания път до URL адреса за връзки/бутони за подробен изглед за списъка.
empty_list_text Извежда конфигуриран локализиран текст, който да се показва, когато изгледът на списъка не извежда никакви резултати.
enable_entity_permissions Връща „вярно”, ако е активирано филтрирането по разрешение за таблица за този списък. В противен случай връща „false”.
entity_logical_name Връща логическото име на таблицата на Dataverse за записи, което да се показва от този списък. Пример, контакт
filter_account_attribute_name Връща логическото име на атрибута за справка в акаунта, което се използва за филтриране на записи на резултати по родителски акаунт на текущия потребител на портала. Например accountid
filter_apply_label Извежда конфигуриран локализиран етикет, който да се използва за връзката/бутона, които прилагат разширен филтър за атрибути към резултатите в списъка.
filter_definition Извежда дефиницията за филтъра за JSON атрибута за списъка. Вижте Филтри за списък за подробности за това как да използвате филтър от метафилтри на Liquid за обработване на тази дефиниция.
filter_enabled Връща „вярно”, ако е активирано разширено филтриране по атрибути за списъка. В противен случай връща „false”.
filter_portal_user_attribute_name Връща логическото име на атрибута за справка за контакт, който се използва за филтриране на записи на резултати по контакта на текущия потребител на портала. Например contactid
filter_website_attribute_name Връща логическото име на атрибута за справката adx_website, която се използва за филтриране на записи на резултати по текущия портален уеб сайт. Например adx_websiteid
language_code Връща целочисления код за език на Dataverse, който ще се използва за избиране на всички локализирани етикети за списъка.
page_size Извежда конфигурирания размер на страницата с резултати за списъка.
primary_key_name Извежда логическото име на атрибута за първичен ключ, което да се показва от този списък.
search_enabled Връща „вярно”, ако е активирано търсене за този списък. В противен случай връща „false”.
search_placeholder Извежда конфигурирания локализиран текст за контейнера на полето за търсене в списъка.
search_tooltip Извежда конфигурирания локализиран текст за пояснението за търсене в списъка.
изгледи Извежда наличните изгледи за списъка като обекти на изгледи на списъка.
[логическо име на атрибут] Можете да отворите всеки атрибут на списъка на запис на Dataverse (adx_entitylist) по логическо име по същия начин като обект таблица. Например, {{ entitylist.adx_name }}

Атрибути на изгледи на списъци

Атрибут Описание
колони Извежда колоните на изгледа като обектите на колона в изглед на списък.
entity_logical_name Връща логическото име на таблицата на Dataverse за записите, включени в изгледа. Пример, контакт
ИД Извежда GUID ID на изгледа.
language_code Връща кода на Dataverse целочисления език, който се използва за избиране на всички локализирани етикети (заглавки на колони и т.н.) за изгледа.
Име Връща показваното име в Dataverse на изгледа.
primary_key_logical_name Връща логическото име на първичния ключ на таблицата на Dataverse за записите, включени в изгледа. Например contactid
sort_expression Извежда израза за сортиране по подразбиране за изгледа. Например name ASC, createdon DESC.

Атрибути на колони в изглед на списък

Атрибут Описание
attribute_type Връща името на типа на Dataverse атрибута за колоната като низ. Например справка, списък по избор, низ, булева стойност, DateTime
logical_name Връща логическото име на Dataverse атрибута за колоната. Например createdon
Име Връща локализираното показвано име в Dataverse за колоната. Например „Създаден на”
sort_ascending Извежда низ за израз за сортиране за сортиране на колоната във възходящ ред. Например createdon ASC
sort_descending Извежда низ за израз за сортиране за сортиране на колоната в низходящ ред. Например createdon DESC
sort_disabled Връща „true”, ако сортирането е забранено за колоната. В противен случай връща „false”.
sort_enabled Връща „true”, ако сортирането е разрешено за колоната. В противен случай връща „false”.
width Извежда конфигурираната ширина за колоната в пиксели.

entityview

Обектът „entityview” се използва в рамките на етикет „entityview” и предоставя достъп до метаданните за изгледа, както и записите на резултат за преглед.

Атрибути

Атрибут Описание
колони Извежда колоните в изгледа като обекти на колона в изглед на таблица.
entity_permission_denied Връща „вярно”, ако е отказан достъп до преглед на резултатите поради недостатъчни разрешения за таблицата за текущия потребител. Връща „false”, ако е бил предоставен достъп за преглед на резултатите.
entity_logical_name Логическото име на таблица на Dataverse за записите на резултат за преглед. Пример, контакт
first_page Номера на страницата на първата страница на прегледа на резултатите. Това е 1, освен ако няма върнати резултати, в който случай е нула.
ИД ИД на GUID на изгледа на Dataverse, който дефинира този „entityview”.
language_code Кодът за език на цяло число за Dataverse, който се използва за зареждане на локализирани етикети за текущия изглед.
last_page Номера на страницата на последната страница в прегледа на резултатите. Ако няма върнати резултати, тази стойност е Null.
Име Името на изгледа на Dataverse, който дефинира този „entityview”, като например „Активни контакти”.
next_page Номера на страницата на следващата страница в прегледа на резултатите. Ако няма следваща страница с резултати, тази стойност е null.
Страница Номера на страницата на текущата страница в прегледа на резултатите.
pages Връща масив с номера на страници, съдържащи всички страници с резултати за текущия изглед.
page_size Броят резултати, върнат за страница, за текущия изглед.
previous_page Номера на страницата на следващата страница в прегледа на резултатите. Ако няма предишна страница с резултати, това е нула.
primary_key_logical_name Логическото име за Dataverse на атрибута за първичен ключ на получената таблица за този изглед. Пример, contactid.
записи Текущата страница със записи на резултати за изгледа като обекти на таблица.
sort_expression Изразът за сортиране по подразбиране за изгледа. Например nameASC, createdon DESC.
total_pages Общият брой на страниците с резултати за изгледа.
total_records Общият брой на резултатите за изгледа (във всички страници).

събития

Позволява извличането и показването на събития. Обектът „събития” ви позволява да изберете определено събитие или всички събития.

Обект „events“

Обектът „събития” ви позволява да получите достъп до определено събитие в портал или да получите достъп до всички събития в даден портал (независимо от събитието).

Обектът „събития” има следните атрибути:

Атрибут Описание
повторения Връща обект „eventoccurancessobject”, съдържащ всички повторения на събития в портала
[име на събитие или ИД] Можете да получите достъп до всяко събитие чрез свойствата за неговото име или ИД.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Обект „event“

Обектът „събитие” ви позволява да работите с единично събитие, което ви позволява да имате достъп до графиците и повторенията за това събитие.

Обектът „събитие” има следните атрибути:

Атрибут Описание
повторения Връща обект „eventoccurrencesobject”, съдържащ всички повторения за събитието.
Име Името на събитието.
URL адрес URL адресът на събитието.

Обект „eventoccurences“

Обектът „eventoccurrences” ви позволява достъп до колекция от обекти на повторения на събития. Можете да поръчате събитията и да зададете диапазон от дати за извличане на събитията, както и да постигнете страниране, като използвате течни филтри:

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

Възможна е и следната опция:

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

Следните атрибути са свързани с обект „eventoccurrences”

Атрибут Описание
Всички Връща всички обекти „eventoccurrences” в колекцията.

Обект „eventoccurence“

Представлява еднократно повторение на събитие. Следните са свързаните атрибути:

Атрибут Описание
URL адрес URL адресът на повторението.
is_all_day_event Целодневно събитие ли е това?
start_time Начален час за събитието.
end_time Краен час за събитието.

forloop

Съдържа свойства, които са полезни в рамките на блок на цикъл за.

Бележка

forloop може да се използва само в рамките на етикет за.

Код

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Резултат

This is the first child page!

This is child page number 2.

This is child page number 3.

Атрибути

Атрибут Описание
първо Връща „вярно”, ако това е първата итерация на цикъла. Връща „false”, ако това не е първата итерация.
показалец Позицията на текущия елемент в колекцията, когато първият елемент има позиция 1.
index0 Позицията на текущия елемент в колекцията, когато първият елемент има позиция 0.
Последно Връща „true”, ако това е последната итерация на цикъла. Връща „false”, ако това не е последната итерация.
дължина Връща броя на итерациите за цикъла ߝ броя на елементите в колекцията, върху които се извършва итерацията.
rindex Брой на елементите, оставащи в цикъла (дължина – индекс), където 1 е индексът на последния елемент.
rindex0 Брой на елементите, оставащи в цикъла (дължина – индекс), където 0 е индексът на последния елемент.

форуми

Позволява извличането и показването на форуми и теми във форума. Възможността да се използва Liquid за рендиране на данни се простира до публикации, но за да създадете нова публикация или нишка, трябва да използвате шаблон на страница за многостъпкови формуляри на ASP.NET с вградена указаната функционалност (например шаблоните по подразбиране за нишка от форум и страница на публикация във форум).

Обектът на форуми ви позволява да изберете форум или нишки от форум:

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

Обектът „forums“ ви позволява да получите достъп до всеки конкретен форум в портала или до всички нишки от форум в портала (независимо от форума).

Обектът на форуми ви позволява да работите с единичен форум, което ви позволява да имате достъп до нишките за този форум.

Обектът „forumthreads“ ви позволява да имате достъп до набор от обекти „forumthread“. Можете да подредите нишките от форум и да постигнете страниране и като използвате филтри на Liquid.

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

Единична нишка от форум

Обектът „forumposts“ ви позволява да имате достъп до набор от обекти „forumpost“.

Атрибути

Атрибут Описание
нишки Връща обект forumthreads, съдържащ всички обекти forumthreads в портала.
Всички Връща всички обекти на форуми в портала. Обърнете внимание, че website.forums също е еквивалент.
thread_count Връща целочислената стойност на броя на нишките в целия уеб сайт.
post_count Връща целочислената стойност на общия брой на публикациите в портала.
[име или ИД на форум] Можете да получите достъп до всеки форум чрез свойствата за неговото име или ИД.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

обект „форум“

Атрибути

Бележка

entities

Атрибут Описание
нишки Връща обект „forumthread”, съдържащ всички нишки от форум за форума.
Име Името на форума.
thread_count Връща целочислената стойност на броя на нишките във форума.
post_count Връща целочислената стойност на броя на нишките в целия форум.

Обект „forumthreads“

Атрибути

Атрибут Описание
Всички Връща всички обекти „forumthread” в колекцията.

обект „forumthread“

Атрибути

Бележка

entities

Атрибут Описание
публикации Връща обект „forumposts”, съдържащ всички публикации във форум за нишката.
автор Връща автора за нишката (който е просто обект за таблица на контакт).
latest_post Връща последната публикация в нишката.
first_post Връща първата публикация в нишката.
post_count Връща целочислената стойност на броя на публикациите в нишката.
is_answered Нишката получила ли е отговор, или не?
is_sticky Нишката лепкава нишка ли е?

Обект „Forumposts“

Атрибути

Атрибут Описание
Всички Връща всички обекти „forumthread” в колекцията.

Единична публикация във форум

Атрибути

Бележка

entities

Атрибут Описание
автор Връща автора за публикацията (който е просто обект за таблица на контакт).
съдържание Съдържание на публикацията.
is_answer Тази публикация представлява ли отговор на нишката?

знания

Осигурява достъп до knowledgearticle на Dataverse и записи на таблица с категории за рендиране на статии и категории в портал.

Атрибути

Атрибут Описание
статии Връща обект на статии, който съдържа обекти на статии за записите на таблицата knowledgearticle, налични в портала.
награди Връща обект на категории, който съдържа обекти на категория за записите на таблицата „Категория”, налични в портала.

обект на статии

Обектът на статии ви позволява достъп до набор от обекти на статии. Можете да подредите статиите и да постигнете страниране и чрез филтри на Liquid.

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

Атрибути

Атрибут Описание
популярни Връща набор от обекти на статии, които съдържат най-много прегледи. {% assign popular_articles = knowledge.articles.popular %}
скорошни Връща набор от обекти на статии, които съдържат най-скорошна дата на промяна. {% assign recent_articles = knowledge.articles.recent %}
горе Връща набор от обекти на статии, които съдържат най-висока оценка. {% assign top_articles = knowledge.articles.top %}

Филтри

Следните филтри може да приемат параметри по избор за размер и език на страница. Първият параметър е броят записи за извличане. Размерът на страницата по подразбиране е 5. Вторият параметър е кодът на език за извличане на статии за даден език. Филтрите могат да се комбинират с други филтри за течности.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Атрибут Описание
популярни Връща набор от обекти на статии, които съдържат най-много прегледи. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
скорошни Връща набор от обекти на статии, които съдържат най-скорошна дата на промяна. {% assign recent_articles = knowledge.articles \| recent: 5 %}
горе Връща набор от обекти на статии, които съдържат най-висока оценка. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

обект на категории

Обектът на категориите ви позволява достъп до колекция от обекти на категории. Можете да подредите категориите и да постигнете страниране и чрез филтри на Liquid.

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

Атрибути

Атрибут Описание
скорошни Връща набор от обекти на категория, които съдържат най-скорошна дата на промяна.
top_level Връща набор от обекти на категория, които нямат родителска категория.

Филтри

Следните филтри може да приемат параметър по избор, който показва размера на страницата. Размерът на страницата по подразбиране е 5. Филтрите могат да се комбинират с други филтри за течности.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Атрибут Описание
скорошни Връща набор от обекти на категория, които съдържат най-скорошна дата на промяна. Можете да предоставите параметри {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Връща набор от обекти на категория, които нямат родителска категория. {% assign root_categories = knowledge.categories \| top_level %}

обект на статия

Обектът на статия ви позволява да работите с една knowledgearticle, за да се покажат подробности за статията в портала.

Атрибути

Статията е обект на обект , с всички същите атрибути, в допълнение към следните атрибути:

Атрибут Описание
article_public_number Публичният номер на статия за статията.
comment_count Целочислената стойност на броя на коментарите за дадена статия.
съдържание Съдържанието на статията.
current_user_can_comment Връща булева стойност, която показва дали текущият потребител може да добавя коментари в статията.
is_rating_enabled Връща булева стойност, която показва дали е разрешена оценка на статия.
ключови думи Ключовите думи на статията.
Име Алтернативен псевдоним за заглавието на статията.
оценка Десетична стойност за оценка на статията.
title Заглавието на статията.
view_count Целочислената стойност на броя пъти, в които е преглеждана статията.

обект на категория

Обектът на категория ви позволява да работите с една категория, за да се покажат подробностите за нея в портала.

Атрибути

категория е обект обект, с всички от същите атрибути, в допълнение към следните атрибути:

Атрибут Описание
categorynumber Номерът на категория на категорията.
Име Алтернативен псевдоним за заглавието на категорията.
длъжност Заглавието на категорията.

език

Предоставя текущото име на езика и езиков код, ако е активирана многоезична поддръжка.

Атрибути

Атрибут Описание
URL адрес URL адресът на текущата заявка с префикс с текущия код на езика.
url_substitution URL адресът на текущата заявка с префикс с текущия езиков код, заобикаляйки кеша на изхода на страницата.
Име Заглавие на текущия език.
код Езиковият код.

Например уеб шаблонът с Падащо меню за езици по подразбиране използва този обект на Liquid, за да изброи наличните езици, когато са налични множество езици.

Влезете

Производителите имат способността да включват регистрационни отчети в своя Liquid код. Когато сайтът Power pages се изпълнява, регистрационните файлове, добавени от производителя в Liquid code, се показват в разширението Power Pages на инструмента заразработчици. Тези регистрационни файлове, вградени от производителя, се показват в разширението на инструмента за разработчици, когато диагностичната настройка е разрешена.

Следният синтаксис може да се използва в Liquid код за регистриране на персонализирани съобщения:

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

Регистрационни атрибути

Атрибут Описание
Влезете Име на течен обект
съобщение Низ, представящ всички персонализирани съобщения за регистриране
ниво Регистриране на съобщението като информация, предупреждение или грешка

Пример:

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

страница

Отнася се за текущата страница за заявка в портала. Този обект съчетава атрибутите на картата на сайта и текущата заявка обекти (обикновено уеб страница).

Обектът „Страница” предоставя достъп до неща, като йерархични връзки за текущата страница, заглавието или URL адреса на текущата страница, както и всякакви други атрибути или свързани обекти на подлежащия запис на Dataverse.

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

Атрибути на страницата

Бележка

entities

Атрибут Описание
йерархични връзки Връща обектите на възли на картата на сайта за йерархични връзки за страницата, като започва от коренния възел на картата на сайта и завършва с родителския.
дъщерни Връща обектите на възел на картата на дъщерен сайт на страницата.
родител Връща възела на картата на родителския сайт на страницата. Ако страницата е началната страница, родителят е празен.
заглавие Заглавието на страницата.
URL адрес URL адресът на страницата.
[име на атрибут или релация] Можете да получите достъп до всеки атрибут на подлежащия запис на Dataverse за страницата чрез логическо име.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Стойностите на повечето атрибути на таблица се нанасят директно върху Типове на Liquid: Полетата с две опции се нанасят до булев израз, текстовите полета до низове, числовите/валутни полетата до числа, полетата за дата/час до обекти на дата. Някои типове атрибути обаче се връщат като обекти:
  • Полетата за справка (препратка към свързана таблица) се връщат като обекти за препратка към свързана таблица.
  • Полетата за набор от опции/списък по избор се връщат като обект на стойност на набор от опции.
    • Можете също да заредите всички свързани обекти по име на схема на отношение.
    {{ page.adx_webpage_entitylist.adx_name }}
    В случай, че една релация е рефлексивна (т.е. самореференциална), обект на обекти се връща. (В противен случай, желаният резултат ще бъде неясен.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Забележка: Зареждането на голям брой свързани обекти или достъпът до голям брой релации в един единствен шаблон може да има отрицателно въздействие върху характеристиките на рендиране на шаблона. Избягвайте зареждане на свързаните обекти за всеки елемент в масив в рамките на един цикъл. Когато е възможно, избирайте използването на етикетите на таблица на Dataverse, за да заредите колекции от обекти.

анкети

Разрешава извличането и показването на анкета.

Обектът „анкети” ви позволява да изберете конкретна анкета или разполагане на анкета:

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

Атрибути на анкети

Атрибут Описание
разполагания Връща обекта „pollplacements“.
[име или ИД на анкета] Можете да получите достъп до всяка анкета чрез свойствата за нейното име или ИД. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Атрибути на разполаганията на анкета

Атрибут Описание
[име или ИД на разполагане на анкета] Можете да получите достъп до всяко разполагане на анкета чрез свойствата за неговото име или ИД.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Атрибути на разполагане на анкета

Бележка

entities

Атрибут Описание
Име Връща полето „Име“ за разполагането на анкета.
placement_url URL адресът, който може да се използва за извличане на разполагането на анкета, изцяло рендирано от шаблон.
анкети Връща колекцията от обекти на анкета, свързани с разполагането. Тагове за итерация и филтри за масиви могат да се използват с тази колекция.
random_url URL адресът, който може да се използва за извличане на произволна анкета от разполагане, изцяло рендирано от шаблон.
submit_url URL адресът, към който е подадена приключената анкета.

Атрибути на анкета

Бележка

entities

Атрибут Описание
has_user_voted Връща „true“, ако текущият потребител (влязъл или анонимен) вече е гласувал в тази анкета.
Име Връща полето „Име“ за анкетата.
опции Връща колекцията от обекти „опция за анкета“, свързани с анкетата. Итерационни тагове и обекти могат да се използват с тази колекция.
poll_url URL адресът, който може да се използва за извличане на анкета, изцяло рендирана от шаблон.
въпрос Връща полето „Въпрос“ за анкетата.
submit_button_label Връща низ, който може да се използва да игнориране на етикета на бутона за подаване на анкета.
submit_url URL адресът, към който е подадена приключената анкета.
user_selected_option Връща обекта polloption, избран от потребителя (ако вече е гласувал).
гласове Връща броя на гласовете, които са таблични за анкетата.

Атрибути на опция за анкета

Бележка

entities

Атрибут Описание
отговор Връща полето „Отговор“ за анкетата.
процент Връща процента от гласовете в анкетата за опцията като десетично число от 0 до 100.
гласове Връща броя на гласовете, които са таблични за опцията.

заявка

Съдържа информация относно текущата HTTP заявка.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Бележка

  • Можете да изградите URL адреси динамично в Liquid с помощта на филтри за URL адреси.
  • URL адресът, използван в request.url, може да бъде всяка поискана стойност и се кешира за последващи искания. За да осигурите правилната стойност в request.url, помислете за използването на заместващ маркер, частичен URL адрес като ~{Път към WebFile} или съхраняване на URL адреса на портала в Настройки на сайта.
  • Версия на издание на Power Pages 9.3.8.x или по-нова ще има по подразбиране escape филтър на Liquid наложен за потребител и обекти на Liquid заявка. За да деактивирате тази конфигурация по подразбиране и да разрешите тези обекти на Liquid без изходен филтър Liquid, вижте настройки на сайт - Site/EnableDefaultHtmlEncoding.

Атрибути

Атрибут Описание
параметри Именуваните стойности на параметър за текущата заявка. params е комбинация от параметри на низ на заявка на URL адрес, следващи параметри на формуляр и бисквитки.
Път Пътят на URL адреса на текущата заявка.
/profile/
path_and_query Пътят и заявката на URL адреса на текущата заявка.
/profile/?foo=1&bar=something
заявка Частта на заявка на URL адреса на текущата заявка.
?foo=1&bar=something
URL адрес Пълният URL адрес на текущата заявка.
https://www.example.com/profile/?foo=1&bar=something

индекс за търсене

Обектът searchindex се използва в рамките на етикети на таблица на Dataverse и предоставя достъп до резултатите от заявка.

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

Атрибути

Атрибут Описание
approximate_total_hits Връща приблизителен от общ брой попадения, съответстващи на заявката на индекса. Поради начина, по който работи индексът за търсене по отношение на филтрирането на защитата и други фактори за проектиране, този брой е само приблизителна и може да не съответства точно на общия брой резултати, достъпни за текущия потребител в някои ситуации.
Страница Връща номера на страница на текущата заявка.
page_size Връща максималния размер на страница за текущата заявка. Ако искате действителният брой резултати, върнати за текущата страница (защото той може да е по-малък от указания максимален размер на страницата), използвайте results.size.
Резултати Връща страницата с резултати от заявката във формата на обекти на резултат от индекса за търсене.

Резултати от индекса за търсене

Атрибут Описание
обект Подлежащите обекти за резултата.
фрагмент Свързан кратък текстов фрагмент за резултата с термини, съответстващи на указаната заявка, подчертани с помощта на <em> HTML етикет. Някои типове заявки не поддържат осветени фрагменти, като например размити заявки (~) и заместващи заявки (*). Това свойство е нулево в тези случаи.
ИД ИД на таблица на Dataverse на подлежащия запис за резултата във формата на низ. Например 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Логическото име на таблица на Dataverse на подлежащия запис за резултата. Например adx_webpage
номер Номерът на резултата в рамките на всички страници с резултати, започващи от 1. Например, за първия резултат от втората страница с резултати, с размер на страницата 10, тази стойност е 11.
резултат Резултата на Lucene за резултата под формата на стойност с плаваща запетая. Резултатите се връщат, подредени по тази стойност.
заглавие Заглавието на резултата.
URL адрес URL адрес за резултата. Това обикновено, но не задължително, ще е абсолютен път за текущото приложение, а не пълен URL адрес. Например: /articles/article1/

настройки

Позволява ви да заредите всяка настройка на сайта по име. Ако настройка с даденото име не бъде намерена, ще се върне нула.

Бележка

Настройки се връщат като низове, но можете да използвате Филтри за тип, за да ги преобразувате в други типове.

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

Позволява достъп до картата на сайта на портала.

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

Атрибути на картата на сайта

Атрибут Описание
Текущи Връща обект за възел на карта на сайта за текущата страница.
Корен Връща обект на възел на карта на сайта за коренната (началната) страница на уеб сайта.

Атрибути на възела на картата на сайта

Атрибут Описание
Йерархични връзки Връща обектите на възли на картата на сайта за йерархични връзки за възела, като започва от коренния възел на картата на сайта и завършва с родителския.
Деца Връща обектите на възел на картата на дъщерен сайт на възела.
Описание Съдържанието на описанието/обобщението на възела. (Това поле може да съдържа HTML.)
Entity Връща подлежащите обекти на възела. Ако възелът няма базова таблица, тази стойност е null.
is_sitemap_ancestor Връща „true”, ако възела на картата на сайта е наследник на текущия възел, в противен случай „false”.
is_sitemap_current Връща „true”, ако възела на картата на сайта е текущия възел, в противен случай „false”.
Родител Връща възела на картата на родителския сайт на възела. Ако възелът е коренният възел, родителят е нулев.
Обръщение Заглавието на възела.
URL адрес URL адресът на възела.

маркери на сайт

Позволява ви да заредите всякакви маркери на сайт по име. Ако маркерът на сайта съществува, се връща обект sitemarker. Ако маркер на сайт с даденото име не бъде намерен, връща се null .

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

Бележка

Рендиране на горен колонтитул и основна навигационна лента на уеб сайт

Атрибути на маркер на сайт

Атрибут Описание
URL адрес URL адрес на целта на маркера на сайт.
[логическо име на атрибут] Можете да получите достъп до всеки атрибут на целевия запис на маркер на сайт на Dataverse чрез логическо име. Например, {{ sitemarker.adx_name }}

фрагменти

Позволява ви да заредите всякакъв фрагмент от съдържанието по име. Ако не бъде намерен фрагмент със собствено име, връща се null .

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Съдържа свойства, които са полезни в рамките на блок на цикъл Етикети за итерация.

Бележка

tablerowloop може да се използва само в рамките на етикет етикети за итерация.

Атрибути

Атрибут Описание
Кол Връща индекса на текущия ред, като започва от 1.
col0 Връща индекса на текущия ред, като започва от 0.
col_first Връща „true”, ако текущата колона е първата колона в ред, връща „false”, ако не е.
col_last Връща „true”, ако текущата колона е последната колона в ред, връща „false”, ако не е.
Собствено Връща „вярно”, ако това е първата итерация на цикъла. Връща „false”, ако това не е първата итерация.
Index Позицията на текущия елемент в колекцията, когато първият елемент има позиция 1.
index0 Позицията на текущия елемент в колекцията, когато първият елемент има позиция 0.
Последно Връща „true”, ако това е последната итерация на цикъла. Връща „false”, ако това не е последната итерация.
Дължина Връща броя на итерациите за цикъла ߝ броя на елементите в колекцията, върху които се извършва итерацията.
Rindex Брой на елементите, оставащи в цикъла (дължина – индекс), където 1 е индексът на последния елемент.
rindex0 Брой на елементите, оставащи в цикъла (дължина – индекс), където 0 е индексът на последния елемент.

Потребители

Отнася се за текущия потребител на портала, което позволява достъп до всички атрибути на подлежащия запис на контакт в Dataverse. Ако няма влязъл потребител, тази променлива е null.

Потребителят е обект на обект .

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Бележка

Версия на издание на Power Pages 9.3.8.x или по-нова ще има по подразбиране escape филтър на Liquid наложен за потребител и обекти на Liquid заявка. За да деактивирате тази конфигурация по подразбиране и да разрешите тези обекти на Liquid без изходен филтър Liquid, вижте настройки на сайт - Site/EnableDefaultHtmlEncoding.

Атрибути

В допълнение към разполагането с всички атрибути на обект обекти потребителят има атрибутите, посочени по-долу.

Атрибут Описание
роли Връща ролите, към която принадлежи потребителят, като масив.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Забележка: Можете също да използвате филтър has_role, за да проверите за членства с индивидуалната роля.
basic_badges_url Връща URL адреса на услугата за извличане на потребителски значки.
За да рендирате значки за потребител, трябва да включите таг с атрибутите "data-badge" и "data-uri". За рендиране на значките на текущия потребител:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
За рендиране на потребителски значки по ИД (променлив userid):
`<div data-badge data-uri='{{user.basic_badges_url

Позволява ви да заредите всякакви уеб връзки по име или ИД.

Ако набор от уеб връзки съществува, се връща обект a набор от уеб връзки . Ако не бъде намерен набор от уеб връзки с даденото име или ИД, връща се null .

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

Бележка

Рендиране на горен колонтитул и основна навигационна лента на уеб сайт |

Бележка

набор от уеб връзки е обект обект с едни и същи атрибути, в допълнение към следните атрибути:

Атрибут Описание
Копирай HTML копието на набора от уеб връзки.
Име Името на набора от уеб връзки.
Длъжност Заглавието на набора от уеб връзки.
Уеб връзки Масивът от обекти на уеб връзки, свързан с набора от уеб връзки.
[логическо име на атрибут] Можете да достигнете до всеки атрибут от записа в Dataverse за набора от уеб връзки по логическо име. Например, {{ weblinkset.createdon }}

Бележка

Уеб връзката е обект обект с всички същите атрибути, в допълнение към следните атрибути:

Атрибут Описание
Описание HTML описанието на уеб връзката.
display_image_only Булев атрибут, указващ дали уеб връзката трябва да бъде показана само като изображение без текст за връзка.
display_page_child_links Булев атрибут, указващ дали уеб връзката трябва да показва връзки към дъщерните страници карта на сайта на свързаната страница като подвръзки.
Image Обектът на изображение на уеб връзката за тази връзка. Този атрибут е нулев, ако няма изображение.
is_external Булев атрибут, указващ дали целевият URL адрес на уеб връзката е към външен сайт (вместо към вътрешна страница на портал).
is_sitemap_ancestor Връща „true”, ако URL адреса на уеб връзката насочва към наследник на текущия възел на карта на сайта, в противен случай „false”.
is_sitemap_current Връща „true”, ако URL адреса на уеб връзката насочва към текущия възел на карта на сайта, в противен случай „false”.
Име Името/заглавието на уеб връзката.
Nofollow Булев атрибут, указващ дали уеб връзката трябва да бъде обозначена като rel=nofollow.
open_in_new_window Булев атрибут, указващ дали уеб връзката трябва да бъде отворена в нов прозорец/раздел на браузъра, когато бъде избрана.
Пояснение Текст на пояснение за уеб връзката.
URL адрес URL адресът на уеб връзката.
Уеб връзки Масивът от дъщерни обекти на уеб връзката, свързана с уеб връзката.
[логическо име на атрибут] Можете да достигнете до всеки атрибут от записа в Dataverse за уеб връзки по логическо име. Например, {{ weblink.createdon }}
alternate_text Алтернативен текст за изображението.+
Височина Цяло число, съдържащо указаната височина на изображението. Ако не е предоставена стойност за височина, този атрибут е null.
URL адрес URL адресът на изображението.
Широчина Цяло число, съдържащо указаната ширина на изображението. Ако не е предоставена стойност за ширина, този атрибут е Null.

уеб сайт

Отнася се за уеб сайт на портала, което позволява достъп до всички атрибути на записа на уеб сайта Dataverse (adx_website) за портала.

Бележка

Уеб сайтът е обект на обект с всички еднакви атрибути.

Код

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

Резултат

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

Атрибути

Следващата таблица изброява атрибутите за този маркер, които могат да се използват за замяна на настройките по подразбиране, за да се избегне кеширането.

По подразбиране Заместител (избягва кеширането) Пример
sign_in_url sign_in_url_substitution По подразбиране: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Замяна (избягва кеширането): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(„substitute-page“ в този пример заменя кеширания URL адрес по подразбиране.)
sign_out_url sign_out_url_substitution По подразбиране: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Замяна (избягва кеширането): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(„substitute-page“ в този пример заменя кеширания URL адрес по подразбиране.)

Вижте също

Типове на Liquid
Етикети на Liquid
Филтри на Liquid