Поділитися через

Доступні об’єкти Liquid

  • Стаття

Об'єкти Liquid містять атрибути для виводу динамічного вмісту на сторінці. Наприклад, об'єкт сторінки має атрибут, який називається "заголовок", що може бути використаний для виводу заголовку поточної сторінки.

Для доступу до атрибута об'єкта за іменем, користуйтеся точкою (.). Для відтворення атрибута об’єкта в шаблоні, візьміть його в {{ and }}.

Важливо

Щоб уникнути можливих проблем із міжсайтовими сценаріями (XSS), завжди використовуйте фільтр екранування для кодування даних за допомогою HTML під час використання об'єктів Liquid для читання ненадійних даних, наданих користувачем.

{{ page.title }}

Атрибути об'єкта можна також отримати за допомогою імені рядка та []. Цей формат корисний в тих випадках, коли потрібний атрибут визначається динамічно або ім'я атрибута містить символи, пробіли, спеціальні символи і т. д., які будуть неправильними при використанні (.).

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Вказані нижче об'єкти можуть бути використані і доступні будь-якому місці, в будь-якому шаблоні.

Об'єкт Опис
сутності Дозволяє завантажувати будь-яку таблицю Microsoft Dataverse за ідентифікатором. Додаткові відомості: сутності
зараз Об’єкт дати/часу, який посилається на поточний час UTC, коли відтворюється шаблон.
Примітка: це значення кешується веб-програмою порталу і не оновлюється кожного разу. Додаткові відомості: Фільтри даних
сторінка Відтворює на поточній сторінці порталу сторінку запиту. Об'єкт сторінки надає доступ до речей, таких як деталізація для поточної сторінки, заголовок або URL-адреса поточної сторінки, та будь-які інші атрибути або пов'язані сутності базового запису Dataverse. Докладні відомості: сторінка
params Зручний ярлик для request.params. Додаткові відомості: запит
запит Містить відомості про поточний запит HTTP. Додаткові відомості: запит
настройки Дозволяє завантажувати будь-які параметри сайту за іменем. Більше інформації: настройки
мапа сайту Дозволяє отримати доступ до мапи сайту порталу. Додаткові відомості: мапа сайту
маркери місця Дозволяє завантажувати будь-які маркери місця за іменем. Додаткові відомості: маркери сайту
фрагменти Дозволяє завантажувати будь-які фрагменти вмісту за іменем. Більше інформації: фрагменти
користувач Посилається на поточного користувача порталу , що дозволяє доступ до всіх атрибутів базових записів контактів Dataverse. Якщо жоден користувач не увійшов, ця змінна буде мати нульове значення. Додаткові відомості: користувач
веб-посилання Дозволяє завантажувати будь-який набір веб-посилань за іменем або ідентифікатором. Додаткову інформацію див. в розділі Веб-посилання
веб-сайт Посилається на запис «Веб-сайт», що дає доступ до всіх атрибутів записів сайту Dataverse (adx_website) для порталу. Додаткову інформацію див. в розділі веб-сайти

оголошення

Надає можливість отримати доступ і відтворити оголошення.

Об'єкт оголошень дозволяє вибрати конкретне оголошення або місце розташування оголошення.

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

Атрибути оголошення

Атрибут Опис
розміщення Відтворює об'єкт adplacements.
[ім'я або ідентифікатор оголошення] Ви можете отримати доступ до будь-якого оголошення за його ім'ям або ідентифікатором.
{% 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 Відтворює «істина», якщо URL-адреса, вказана redirect_url має відкриватися в новому вікні.
redirect_url URL-адреса, на яку буде переспрямовано користувача під час вибору оголошення.

Атрибути зображення оголошення

Атрибут Опис
alternate_text Відтворює текст, який має з'являтися в атрибуті alt тегу .
висота Відтворює висоту в пікселях для зображення
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>

Об’єкти блогів

Об’єкт блогу дозволяє отримати доступ до будь-якого конкретного блогу на порталі або отримати доступ до всіх записів блогу на порталі.

Наведена нижче таблиця пояснює атрибути, пов'язані з об’єктом блогів.

Атрибут Опис
записи Відтворення запису блогу , що містить всі повідомлення блогу на порталі.
[ім'я або ідентифікатор блогу] Ви можете отримати доступ до будь-якого блогу за його властивостями імені або ідентифікатора. 
{% assign blog = blogs["Blog Name"] %}                             

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

Об’єкт блогу

Об’єкт блогу дозволяє працювати з одним блогом, що дає змогу отримати доступ до записів цього блогу.

Наведена нижче таблиця пояснює різні атрибути, пов'язані з об’єктом блогу.

Атрибут Опис
записи Відтворює записи блогів , що містять всі записи для блогу.
Ім’я Назва блогу.
title Заголовок блогу.
URL-адреса URL-адреса блогу.

Об'єкт записів у блозі

Об'єкт записів блогу дозволяє отримати доступ до колекції об’єктів записів блогу. Ви можете замовити записи блогу і досягти нумерації сторінок, а також використання гнучких фільтрів:

{% 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 сутності тепер називаються таблицями . Зміни імені не застосовуються до об’єктів «Об’єкти об’єктів равлики». Об’єкт об’єкта "Схвалений" продовжуватиме називатися об’єктами.

Дозволяє завантажувати будь-яку таблицю 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.

Атрибут Опис
Ідентифікатор Ідентифікатор GUID таблиці у вигляді рядка. Наприклад, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
логічне ім’я Логічне ім’я Dataverse таблиці.
Примітки Завантажує усі примітки (анотації), пов'язані з таблицею, в порядку від найстаріших до найновіших (createdon). Примітки знаходяться як об'єкти приміток.
дозволи Завантажує результати підтвердження дозволу таблиці для даної таблиці. Результати відтворюються як об'єкт дозволу.
URL-адреса Повертає URL-шлях системи керування вмістом Power Pages для таблиці. Якщо таблиця не має дійсної URL-адреси у поточному веб-сайті, повертає null-значення. Як правило, якщо ви не настроїли URL-провайдера в програмі, функція повертатиме значення лише для певних типів таблиць, інтегрованих до порталу CMS.
[ім’я атрибуту або зв’язку] Можна отримати доступ до будь-якого атрибуту таблиці 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 для завантаження колекцій сутностей.

Пов’язане посилання на таблицю

Значення атрибуту підстановки повертаються у вигляді об'єктів пов’язаних посилань на таблицю, з вказаними нижче атрибутами.

Атрибут Опис
Ідентифікатор Ідентифікатор GUID вказаної в посиланні таблиці, у вигляді рядка.
Наприклад, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
логічне ім’я Логічне ім’я Dataverse вказаної в посиланні таблиці.
Ім'я Первинний атрибут імені вказаної в посиланні таблиці.

Примітка

Примітка є об'єктом таблиці, що надає доступ до атрибутів і зв'язків запису анотації. Окрім всіх атрибутів об'єкта таблиці, примітка містить вказані нижче додаткові атрибути.

Атрибут Опис
documentbody Завантажує атрибут documentbody запису анотації примітки як рядок з кодуванням Base64. Через те, що зміст цього атрибута може бути великим, він не завантажується з рештою атрибутів примітки, він може бути завантажений тільки на вимогу.
Примітка. Використання атрибута documentbody може мати негативний вплив на ефективність візуалізації шаблону і повинно робитися з обережністю.
Використовуйте атрибут url, щоб надавати натомість посилання на вкладення примітки, якщо це можливо.
URL-адреса Відтворює шлях URL-адреси для вбудованоого обробника вкладення анотації на порталі. Якщо користувач має дозвіл, а примітка має вкладений файл, запит на цю URL-адресу буде завантажувати вкладений файл примітки.

Нотатка

Додаткові фільтри

Значення набору параметрів

Значення атрибуту набору параметрів/розкривного списку повертаються у вигляді об'єктів пов’язаних посилань на таблицю, з вказаними нижче атрибутами.

Атрибут Опис
Підпис Локалізовані підписи значення атрибута набору параметрів/розкривного списку. Наприклад, Активовано
Значення Ціле значення атрибута набору параметрів/розкривного списку. Наприклад: 0

Дозволи для таблиці

Об'єкт дозволів таблиці надає доступ до зведеного результату підтвердження дозволу для таблиці.

Атрибут Опис
can_append Відтворює "істинність", якщо поточний користувач має дозвіл додавати записи до зв’язків цього запису. В іншому разі повертає значення "хибність".
can_append_to Повертає значення "істина", якщо поточний користувач має дозвіл додавати цей запис до зв'язків іншої таблиці. В іншому разі повертає значення "хибність".
can_create Повертає значення "істина", якщо поточний користувач має дозвіл створювати нові записи цього типу таблиці. В іншому разі повертає значення "хибність".
can_delete Відтворює "істинність", якщо поточний користувач має дозвіл на видалення цього запису. В іншому разі повертає значення "хибність".
can_read Відтворює "істинність", якщо поточний користувач має дозвіл на читання цього запису. В іншому разі повертає значення "хибність".
can_write Відтворює "істинність", якщо поточний користувач має дозвіл на оновлення цього запису. В іншому разі повертає значення "хибність".
rules_exist Відтворює "істинність", якщо результати дозволу, представлені цим об'єктом, є результатом чітко визначених дозвільних правил. Відтворює "хибність", якщо результати визначені за промовчанням за відсутності чітко визначених дозволів.

Рефлексивний зв'язок

Спроби завантажити рефлексивні (тобто такі, що посилаються самі на себе) зв’язки на сутності, відтворюються як об'єкти із вказаними нижче атрибутами.

Атрибут Опис
is_reflexive Відтворює "істинність" Використовується для перевірки, чи об'єкт, відтворений зв’язком, є рефлексивним об'єктом зв'язку.
за посиланням Відтворює масив посилань на сутності для ціього зв’язку.
посилання Повертає таблицю посилань для вказаного зв’язку. Повертає null-значення, якщо немає таблиці посилань. Якщо зв’язок має значення "багато до багатьох" (N:N), відтворюється масив сутностей із посиланнями.

список сутностей

Об'єкт entitylist використовується в межах тегів таблиць Dataverse. Надає доступ до всіх атрибутів даного списку.

Нотатка

Відображення списку, пов'язаного з поточною сторінкою

Атрибути

Нотатка

сутності

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

Атрибути подання списку

Атрибут Опис
стовпці Повертає стовпці подання у вигляді об'єктів стовпців подання списку.
entity_logical_name Повертає логічне ім'я таблиці Dataverse для записів, включених в подання. Наприклад, contact
Ідентифікатор Відтворює ідентифікатор GUID перегляду.
language_code Відтворює код мови цілого числа Dataverse, яке буде використовуватися для вибору всіх локалізованих підписів (заголовки стовпців тощо) для цього перегляду.
Ім'я Відтворює коротке ім’я Dataverse перегляду.
primary_key_logical_name Повертає первинне ключове логічне ім'я таблиці Dataverse для записів,і включених в подання. Наприклад, contactid
sort_expression Відтворює вираз сортування за промовчанням для перегляду. Наприклад, name ASC, createdon DESC

Атрибути стовпця подання списку

Атрибут Опис
attribute_type Відтворює ім'я типу атрибута Dataverse для стовпця як рядка. Наприклад, Lookup, Picklist, String, Boolean, DateTime
логічне ім’я Відтворює логічне ім'я типу атрибута Dataverse для стовпця. Наприклад, дата створення
Ім’я Відтворює локалізоване коротке ім'я Dataverse для стовпця. Наприклад, Дата створення
sort_ascending Відтворює рядок виразу сортування для сортування стовпців у порядку зростання. Наприклад, createdon ASC
sort_descending Відтворює рядок виразу сортування для сортування стовпців у порядку спадання. Наприклад, createdon DESC
sort_disabled Відтворює "істинність", якщо сортування вимкнуто для стовпця. В іншому разі повертає значення "хибність".
sort_enabled Відтворює "істинність", якщо сортування увімкнуто для стовпця. В іншому разі повертає значення "хибність".
ширина Відтворює настроєну ширину для стовпця у пікселях.

entityview

Об'єкт entityview використовується всередині тегу entityview і забезпечує доступ до метаданих для перегляду, а також до перегляду записів результатів.

Атрибути

Атрибут Опис
стовпці Повертає стовпці у подання у вигляді об'єктів стовпців подання таблиці.
entity_permission_denied Повертає значення "істина", якщо доступ до подання результатів був відхилений через брак відповідних дозволів таблиці для поточного користувача. Відтворює "хибність", якщо було надано доступ "читання" для перегляду результатів.
entity_logical_name Логічне ім'я таблиці Dataverse перегляду записів результатів. Наприклад, contact
first_page Номер сторінки на першій сторінці перегляду результатів. Це буде 1, якщо не було відтворено ніяких результатів, у випадку чого буде значення нуль.
Ідентифікатор Ідентифікатор GUID перегляду Dynamics 365, який визначає цей entityview Dataverse.
language_code Мовний код цілого числа Dataverse використовується для завантаження локалізованих підписів для поточного перегляду.
last_page Номер сторінки на останній сторінці перегляду результатів. Якщо не було ніяких результатів, це буде нуль.
ім'я Ім'я перегляду Dataverse, який визначає цю entityview, наприклад, "Активні контакти".
next_page Номер сторінки на наступній сторінці перегляду результатів. Якщо немає наступної сторінки результатів, це буде нуль.
Стор. Номер сторінки на поточній сторінці перегляду результатів.
сторінки Відтворює масив номерів сторінок, які містять усі сторінки результатів для поточного перегляду.
page_size Кількість результатів, відтворених на сторінку, для поточного перегляду.
previous_page Номер сторінки на наступній сторінці перегляду результатів. Якщо немає попередньої сторінки результатів, це буде нуль.
primary_key_logical_name Логічне ім’я атрибута основного ключа Dataverse таблиці результатів для цього подання. Наприклад, contactid
записи Поточна сторінка записів результатів для подання, у виглядів об'єктів таблиці.
sort_expression Вираз сортування за промовчанням для перегляду. Наприклад, nameASC, createdon DESC.
total_pages Загальна кількість сторінок результатів для перегляду.
total_records Загальна кількість результатів для перегляду (на всіх сторінках).

події

Надає можливість отримати доступ і відтворити події. Об'єкт подій дозволяє вибрати конкретну подію або всі події.

Об'єкт подій

Об’єкт подій дозволяє отримати доступ до будь-якої конкретної події на порталі або отримати доступ до всіх подій на порталі (незалежно від події).

Об'єкт подій має такі атрибути:

Атрибут Опис
випадки Відтворює eventoccurancessobject, що містить всі випадки подій на порталі
[ім'я або ідентифікатор події] Ви можете отримати доступ до будь-якої події за її властивостями імені або ідентифікатора.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Об'єкт події

Об’єкт події дає змогу працювати з однією подією, що дає змогу отримати доступ до графіків та випадків цієї події.

Об'єкт події має такі атрибути:

Атрибут Опис
повтор. Відтворює 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 Час закінчення події.

for-петля

Містить властивості, корисні в межах петлі блоку для.

Нотатка

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.

Атрибути

Атрибут Опис
Перший Відтворює "істинність", якщо це перший цикл петлі. Відтворює "хибність", якщо це не перший цикл петлі.
покажчик Положення поточного елемента в колекції, де перший елемент має позицію 1.
index0 Положення поточного елемента в колекції, де перший елемент має позицію 0.
Остання Відтворює "істинність", якщо це останній цикл петлі. Відтворює "хибність", якщо це не останній цикл петлі.
довжина Відтворює кількість циклів для петлі ߝ кількість елементів у колекції, що повторюються.
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>

об'єкт форумів

Об'єкт форумів дозволяє отримати доступ до будь-якого конкретного форуму на порталі або отримати доступ до всіх гілок форуму на порталі (незалежно від форуму).

Об'єкт форумів дозволяє працювати з одним форумом, що дає змогу отримати доступ до гілок для цього форуму.

Об'єкт Forumthreads дозволяє отримати доступ до колекції об'єктів forumthread. Ви можете встановити порядок гілок форуму і застосувати нумерацію також за допомогою рідких фільтрів.

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

Об'єкт форуму

Атрибути

Нотатка

сутності

Атрибут Опис
гілки Відтворює об'єкт forumthreads, що містить усі гілки форуму для цього форуму.
Ім'я Назва форуму.
thread_count Відтворює значення цілого числа підрахунку кількості гілок, які є у всьому форумі.
post_count Відтворює значення цілого числа підрахунку загальної кількості записів, які є у всьому форумі.

Об'єкт forumthreads

Атрибути

Атрибут Опис
Усі Відтворює всі об'єкти forumthread в колекції.

Об'єкт forumthread

Атрибути

Нотатка

сутності

Атрибут Опис
записи Відтворює об'єкт forumposts, що містить усі записи форуму для цієї гілки форуму.
автор Повертає автора ланцюжка (що являє собою просто об'єкт таблиці контактних осіб).
latest_post Відтворює останній запис у гілці.
first_post Відтворює перший запис у гілці.
post_count Відтворює значення цілого числа підрахунку кількості записів, які є у всій гілці.
is_answered Чи містить гілка відповіді чи ні?
is_sticky Чи є гілка клейкою?

Об'єкт forumposts

Атрибути

Атрибут Опис
Усі Відтворює всі об'єкти forumthread в колекції.

Єдиний запис форуму

Атрибути

Нотатка

сутності

Атрибут Опис
автор Повертає автора запису (що являє собою просто об'єкт таблиці контактних осіб).
вміст Вміст запису.
is_answer Чи є цей запис відповіддю на гілку?

база знань

Надає доступ до записів таблиць knowledgearticle та категорій Dataverse для відтворення статей та категорії в порталі.

Атрибути

Атрибут Опис
статті Повертає об'єкт статей, що містить об'єкти статті записів таблиці knowledgearticle, доступних у порталі.
переможців Повертає об'єкт категорій, що містить об'єкти категорії для доступних на порталі записів таблиці категорій.

об'єкта статей

Об'єкт статей дозволяє отримати доступ до колекції об’єктів статей. Ви можете замовити статті і досягти нумерації сторінок, також за допомогою гнучких фільтрів.

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

об'єкт категорій

Об'єкт категорій дозволяє отримати доступ до колекції об’єктів категорії. Ви можете встановити категорії і застосувати нумерацію, також і за допомогою рідких фільтрів.

{% 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 для перелічення доступних мов, якщо доступно кілька мов.

сторінка

Відтворює на поточній сторінці порталу сторінку запиту. Цей об'єкт поєднує в собі атрибути з карти сайту і поточного запиту сутності (зазвичай за веб-сторінкою).

Об'єкт сторінки надає доступ до речей, таких як деталізація для поточної сторінки, заголовок або 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 }}. -->

Атрибути сторінки

Нотатка

сутності

Атрибут Опис
навігація Відтворює деталізовані об’єкти вузла мапи сайту для сторінки, починаючи від кореневого вузла карти сайту і закінчуючи батьківським.
дочірні об’єкти Відтворює дочірні об'єкти вузла карти сайту сторінки.
батьківський Відтворює первинні об'єкти вузла карти сайту для сторінки. Якщо сторінки є головною сторінкою, батьківська буде нулем.
заголовок Заголовок сторінки.
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] %}

Атрибути місця розташування опитувань

Нотатка

сутності

Атрибут Опис
Ім'я Відтворює поле "Іім'я" для розміщення опитування.
placement_url URL-адреса може бути використаний для відтворення опитування, що повністю відображається шаблоном.
опитування Відтворює колекцію об'єктів опитування, пов'язаних з розміщенням. Мітки ітерації та Фільтри масиву можуть використовуватися з цією колекцією.
random_url URL-адреса може бути використана для довільного відтворення опитування з місця розташування, що повністю відображається шаблоном.
submit_url URL-адреса, до якої подається завершене опитування.

Атрибути опитування

Нотатка

сутності

Атрибут Опис
has_user_voted Повертає значення "істина", якщо поточний користувач (який виконав вхід або анонімний) вже голосував у цьому опитуванні.
Ім’я Відтворює поле "Ім'я" для опитування.
параметри Відтворює колекцію об'єктів параметрів опитування, пов'язаних з опитуванням. Мітки ітерації та сутності можуть використовуватися з цією колекцією.
poll_url URL-адреса може бути використана для відтворення опитування, що повністю відображається шаблоном.
запитання Відтворює поле "Питання" для опитування.
submit_button_label Відтворює рядок, який можна використовувати для заміщення підпису кнопка надсилання для опитування.
submit_url URL-адреса, до якої подається завершене опитування.
user_selected_option Відтворює об'єкт polloption, обраний користувачем (якщо він вже проголосував).
голоси Відтворює кількість голосів, які були зведені для опитування.

Атрибути параметра опитування

Нотатка

сутності

Атрибут Опис
відповідь Відтворює поле "Відповідь" для опитування.
відсоток Відтворює відсоток голосів в опитуванні для параметру як десяткове число від 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 або пізнішої за замовчуванням матимуть фільтр Liquid escape за замовчуванням застосований до об’єктів Liquid user і request. Щоб вимкнути цю конфігурацію за замовчуванням і дозволити використання цих об’єктів Liquid без фільтра Liquid, див. розділ Параметри сайту порталу — Site/EnableDefaultHtmlEncoding.

Атрибути

Атрибут Опис
params Значення названого параметра для поточного запиту. params – це поєднання параметрів рядка запиту URL-адреси, параметрів запису форми та файлів cookie.
Шлях Шлях поточного запиту URL-адреси.
/profile/
path_and_query Шлях і запит поточного запиту URL-адреси.
/profile/?foo=1&bar=something
query Частина із запитом поточного запиту URL-адреси.
?foo=1&bar=something
URL-адреса Повна URL-адреса поточного запиту.
https://www.example.com/profile/?foo=1&bar=something

searchindex

Об'єкт 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.
Результати Відтворює сторінку результатів запиту, як об'єкт результату індексу пошуку.

Результати індексу пошуку

Атрибут Опис
сутність Основні сутності для результату.
фрагмент Відповідний фрагмент короткого тексту для результату з термінами, які відповідають вказаному запиту, виділеними за допомогою HTML-тегу <em>. Певні типи запитів не підтримують виділені фрагменти, наприклад нечіткі запити (~) та узагальнення запитів (*). Ця властивість дорівнюватиме нулю в цих випадках.
Ідентифікатор Ідентифікатор таблиці Dataverse базового запису для результату, у вигляді рядка. Наприклад, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
логічне ім’я Логічне ім’я таблиці Dataverse базового запису для результату. Наприклад, adx_webpage
Номер Кількість результатів, на всіх сторінках результатів, починаючи з 1. Наприклад, для першого результату другої сторінки результатів, сторінки розміром 10, це значення буде 11.
оцінка Оцінка Lucene результату, як значення з плаваючою комою. Результати буде відображено в порядку за цим значенням.
title Заголовок результату.
URL-адреса URL-адреса для результату. Це зазвичай, але необов'язково, буде абсолютним шляхом для поточної програми, а не повною URL-адресою. Наприклад: / статті/стаття1 /

настройки

Дозволяє завантажувати будь-які параметри сайту за іменем. Якщо параметр із цим заданим іменем не знайдено, відобразиться Нуль.

Нотатка

Параметри відтворюються як рядки, але ви можете використовувати Тип фільтрів, щоб конвертувати їх в інші типи.

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

Нотатка

Відтворити заголовок веб-сайту і первинної навігаційної панелі

мапа сайту

Дозволяє отримати доступ до мапи сайту порталу.

<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).
Об'єкт Відтворює базові об’єкти сутностей вузла. Якщо вузол не має базової таблиці, це значення буде null.
is_sitemap_ancestor Відтворює "істинність", якщо вузол мапи сайту був первинним для поточного вузла, в іншому випадку відтворюється "хибність".
is_sitemap_current Відтворює "істинність", якщо вузол мапи сайту є поточним вузлом, в іншому випадку відтворюється "хибність".
Батьківський об’єкт Відтворює первинні об'єкти вузла карти сайту для вузла. Якщо вузол є кореневим вузлом, первинний буде нуль.
Назва Заголовок вузла.
URL-адреса URL-адреса вузла.

маркери місця

Дозволяє завантажувати будь-які маркери місця за іменем. Якщо маркер місця існує, об'єкт маркера місця буде знайдено. Якщо маркер місця із цим заданим іменем не знайдено, відобразиться нуль.

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

фрагменти

Дозволяє завантажувати будь-які фрагменти вмісту за іменем. Якщо фрагмент із цим заданим іменем не знайдено, відобразиться нуль.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Містить властивості, корисні в межах петлі блоку Теги ітерації.

Нотатка

tablerowloop може використовуватися лише в межах тегу Теги ітерації.

Атрибути

Атрибут Опис
Стовп. Відтворює індекс поточного рядка, починаючи з 1.
col0 Відтворює індекс поточного рядка, починаючи з 0.
col_first Відтворює «істинність», якщо поточний стовпець є першим стовпцем в рядку, відтворює «хибність», якщо ні.
col_last Відтворює «істинність», якщо поточний стовпець є останнім стовпцем в рядку, відтворює «хибність», якщо ні.
Ім’я Відтворює "істинність", якщо це перший цикл петлі. Відтворює "хибність", якщо це не перший цикл петлі.
Індекс Положення поточного елемента в колекції, де перший елемент має позицію 1.
index0 Положення поточного елемента в колекції, де перший елемент має позицію 0.
Остання Відтворює "істинність", якщо це останній цикл петлі. Відтворює "хибність", якщо це не останній цикл петлі.
Довжина Відтворює кількість циклів для петлі ߝ кількість елементів у колекції, що повторюються.
Rindex Кількість елементів, що залишилися в петлі (довжина - покажчик), де 1 є покажчиком останнього елемента.
rindex0 Кількість елементів, що залишилися в петлі (довжина - покажчик), де 0 є покажчиком останнього елемента.

користувач

Посилається на поточного користувача порталу , що дозволяє доступ до всіх атрибутів базових записів контактів Dataverse. Якщо жоден користувач не увійшов, ця змінна буде мати нульове значення.

користувача є об'єктом сутності.

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

Нотатка

Випуск Power Pages версії 9.3.8.x або пізнішої за замовчуванням матимуть фільтр Liquid escape за замовчуванням застосований до об’єктів Liquid user і request. Щоб вимкнути цю конфігурацію за замовчуванням і дозволити використання цих об’єктів Liquid без фільтра Liquid, див. розділ Параметри сайту порталу — Site/EnableDefaultHtmlEncoding.

Атрибути

Крім того наявності всіх атрибутів об’єкту сутності, користувач має вказані нижче атрибути.

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

Дозволяє завантажувати будь-які веб-посилання за іменем або ідентифікатором.

Якщо існує набір веб-посилань, об'єкт набору веб-посилань буде знайдено. Якщо набір веб-посилань з указаним іменем або ідентифікатором не знайдено, буде відображено нуль.

<!-- 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 Логічний атрибут, що вказує, чи веб-посилання повинно відображати посилання на похідні сторінки карти сайту пов'язаної сторінки, як субпосилання.
Зображення Об'єкт зображення веб-посилання для цього посилання. Цей атрибут дорівнюватиме нулю, якщо немає зображення.
is_external Логічний атрибут, що вказує, чи цільова URL-адреса веб-посилання йде на зовнішній сайт (а не на внутрішню сторінку порталу).
is_sitemap_ancestor Відтворює "істинність", якщо URL-адреса веб-посилання переходить на предка поточного вузла карти сайту, в іншому випадку відтворюється "хибність".
is_sitemap_current Відтворює "істинність", якщо URL-адреса веб-посилання переходить на поточний вузол карти сайту, в іншому випадку відтворюється "хибність".
Ім’я Ім’я/заголовок веб-посилання.
Nofollow Логічний атрибут вказує, чи веб-посилання повинно позначатися як rel="nofollow".
open_in_new_window Логічний атрибут, що вказує, чи веб-посилання має відкриватися в новому вікні/вкладці браузера, коли його вибрали.
Підказка Текст підказки для веб-посилання.
URL-адреса URL-адреса веб-посилання.
Веб-посилання Масив дочірніх об'єктів веб-посилань, пов'язаних з веб-посиланням.
[Логічне ім’я атрибута] Можна відкрити будь-який атрибут запису Dataverse веб-посилання за логічним ім'ям. Наприклад: {{ weblink.createdon }}
alternate_text Змініть текст для зображення.
За висотою Ціле число, що містить вказану висоту зображення. Якщо не вказано значення висоти, цей атрибут дорівнюватиме нулю.
URL-адреса URL-адреса зображення.
Ширина Ціле число, що містить вказану ширину зображення. Якщо не вказано значення ширини, цей атрибут дорівнюватиме нулю.

веб-сайт

Посилається на веб-сайт порталу, що дозволяє доступ до всіх атрибутів записів веб-сайту 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