Доступні об’єкти 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. Якщо жоден користувач не увійшов до системи, ця змінна дорівнює null. Додаткові відомості: користувач |
веб-посилання | Дозволяє завантажувати будь-який набір веб-посилань за іменем або ідентифікатором. Додаткову інформацію див. в розділі Веб-посилання |
веб-сайт | Посилається на запис «Веб-сайт», що дає доступ до всіх атрибутів записів сайту 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
Об’єкти блогів
Об’єкт блогу дозволяє отримати доступ до будь-якого конкретного блогу на порталі або отримати доступ до всіх записів блогу на порталі.
Наведена нижче таблиця пояснює атрибути, пов'язані з об’єктом блогів.
Атрибут | Опис |
---|---|
записи | Відтворення запису блогу , що містить всі повідомлення блогу на порталі. |
[ім'я або ідентифікатор блогу] | Ви можете отримати доступ до будь-якого блогу за його властивостями імені або ідентифікатора. |
{% 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 за ідентифікатором. Якщо таблиця існує, повертається об’єкт таблиці. Якщо таблицю з вказаним ID не знайдено, повертається 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 %}
Об'єкт
Об’єкт сутності надає доступ до атрибутів Dataverse запису таблиці.
Атрибут | Опис |
---|---|
Ідентифікатор | Ідентифікатор GUID таблиці у вигляді рядка. Наприклад, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
логічне ім’я | Логічне ім’я 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 для завантаження колекцій сутностей. |
Пов’язане посилання на таблицю
Значення атрибуту підстановки повертаються у вигляді об'єктів пов’язаних посилань на таблицю, з вказаними нижче атрибутами.
Атрибут | Опис |
---|---|
Ідентифікатор | Ідентифікатор 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 | Відтворює "істинність", якщо результати дозволу, представлені цим об'єктом, є результатом чітко визначених дозвільних правил. Повертає false, якщо вони встановлені за замовчуванням, призводить до відсутності явно визначених дозволів. |
Рефлексивний зв'язок
Спроби завантажити рефлексивні (тобто такі, що посилаються самі на себе) зв’язки на сутності, відтворюються як об'єкти із вказаними нижче атрибутами.
Атрибут | Опис |
---|---|
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 | Номер сторінки на останній сторінці перегляду результатів. Якщо результати не були повернуті, це значення дорівнює null. |
назва | Ім'я перегляду Dataverse, який визначає цю entityview, наприклад, "Активні контакти". |
next_page | Номер сторінки на наступній сторінці перегляду результатів. Якщо на наступній сторінці результатів немає, це значення дорівнює null. |
Стор. | Номер сторінки на поточній сторінці перегляду результатів. |
сторінки | Відтворює масив номерів сторінок, які містять усі сторінки результатів для поточного перегляду. |
page_size | Кількість результатів, відтворених на сторінку, для поточного перегляду. |
previous_page | Номер сторінки на наступній сторінці перегляду результатів. Якщо на попередній сторінці результатів немає, це null. |
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 – це об’єкт сутності , з усіма тими ж атрибутами, крім наступних атрибутів:
Атрибут | Опис |
---|---|
article_public_number | Загальнодоступний номер статті. |
comment_count | Ціле значення підрахунку кількості коментарів до даної статті. |
вміст | Вміст статті. |
current_user_can_comment | Відтворює логічне значення, що вказує, чи поточний користувач може додавати коментарі до статті. |
is_rating_enabled | Відтворює логічне значення, що вказує, чи ввімкнуто оцінювання статті. |
ключові слова | Ключові слова у статті. |
ім'я | Змінний псевдонім для назви статті. |
оцінка | Десяткове значення оцінки до статті. |
title | Заголовок сутності. |
view_count | Ціле значення кількості переглядів статті. |
об'єкт категорії
Об'єкт категорії дозволяє працювати з однією категорією для відображення відомостей цієї статті на порталі.
Атрибути
Category – це об’єкт сутності з усіма тими самими атрибутами, на додаток до наступних атрибутів:
Атрибут | Опис |
---|---|
categorynumber | Номер категорії. |
ім'я | Змінний псевдонім для назви категорії. |
назва | Заголовок категорії. |
мова
Надає поточну назву мови і код мови, якщо ввімкнено підтримку кількох мов.
Атрибути
Атрибут | Опис |
---|---|
URL-адреса | URL-адреса поточного запиту з префіксом поточного мовного коду. |
url_substitution | URL-адреса поточного запиту з префіксом поточного мовного коду в обхід кешу виведення сторінки. |
назва | Назва поточної мови. |
код | Мовний код мови. |
Наприклад, веб-шаблон Спадне меню мов за замовчуванням використовує цей об'єкт liquid для перелічення доступних мов, якщо доступно кілька мов.
журнал
Виробники мають можливість включати лог-інструкції у свій код Liquid. Коли сайт Power pages працює, журнали, додані виробником у коді Liquid, відображаються в розширенні 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 }}. -->
Атрибути сторінки
Нотатка
Атрибут | Опис |
---|---|
навігація | Відтворює деталізовані об’єкти вузла мапи сайту для сторінки, починаючи від кореневого вузла карти сайту і закінчуючи батьківським. |
дочірні об’єкти | Відтворює дочірні об'єкти вузла карти сайту сторінки. |
батьківський | Відтворює первинні об'єкти вузла карти сайту для сторінки. Якщо сторінка є домашньою, батьківський елемент дорівнює null. |
заголовок | Заголовок сторінки. |
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 результату, як значення з плаваючою комою. Результати повертаються впорядкованими за цим значенням. |
заголовок | Заголовок результату. |
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 | Відтворює "істинність", якщо вузол мапи сайту є поточним вузлом, в іншому випадку відтворюється "хибність". |
Батьківський об’єкт | Відтворює первинні об'єкти вузла карти сайту для вузла. Якщо вузол є кореневим вузлом, батьківський елемент дорівнює null. |
Звання | Заголовок вузла. |
URL-адреса | URL-адреса вузла. |
маркери місця
Дозволяє завантажувати будь-які маркери місця за іменем. Якщо маркер сайту існує, повертається об’єкт маркера сайту. Якщо маркер із зазначеним ім’ям не знайдено, повертається 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 | Відтворює «істинність», якщо поточний стовпець є першим стовпцем в рядку, відтворює «хибність», якщо ні. |
col_last | Відтворює «істинність», якщо поточний стовпець є останнім стовпцем в рядку, відтворює «хибність», якщо ні. |
Ім’я | Відтворює "істинність", якщо це перший цикл петлі. Відтворює "хибність", якщо це не перший цикл петлі. |
Індекс | Положення поточного елемента в колекції, де перший елемент має позицію 1. |
index0 | Положення поточного елемента в колекції, де перший елемент має позицію 0. |
Остання | Відтворює "істинність", якщо це останній цикл петлі. Відтворює "хибність", якщо це не останній цикл петлі. |
Довжина | Відтворює кількість циклів для петлі ߝ кількість елементів у колекції, що повторюються. |
Rindex | Кількість елементів, що залишилися в петлі (довжина - покажчик), де 1 є покажчиком останнього елемента. |
rindex0 | Кількість елементів, що залишилися в петлі (довжина - покажчик), де 0 є покажчиком останнього елемента. |
User
Посилається на поточного користувача порталу , що дозволяє доступ до всіх атрибутів базових записів контактів Dataverse. Якщо жоден користувач не увійшов до системи, ця змінна дорівнює null.
Користувач є об’єктом сутності .
{% 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-адресу служби для отримання значків користувача. Щоб відобразити значки для користувача, потрібно включити тег із атрибутами "data-badge" та "data-uri". Для отримання значків поточного користувача: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Для відтворення значків користувача за id (змінний ідентифікатор користувача): `<div data-badge data-uri='{{user.basic_badges_url |
веб-посилання
Дозволяє завантажувати будь-які веб-посилання за іменем або ідентифікатором.
Якщо набір веб-посилань існує, повертається об’єкт набору веб-посилань. Якщо набір веб-посилань з заданим іменем або ID не знайдено, повертається 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 %}
Атрибути набору веб-посилань
Нотатка
Tнабір веб-посилань — це об’єкт сутності з усіма тими самими атрибутами, крім наступних атрибутів:
Атрибут | Опис |
---|---|
Копія | HTML-копія набору веб-посилань. |
Ім’я | Ім’я набору веб-посилань. |
Назва | Заголовок набору веб-посилань. |
Веб-посилання | Масив об'єктів веб-посилань, пов'язаних з набором веб-посилань. |
[Логічне ім’я атрибута] | Можна відкрити будь-який атрибут запису Dataverse набору веб-посилань за логічним ім'ям. Наприклад: {{ weblinkset.createdon }} |
Атрибути веб-посилання
Нотатка
Веб-пов’язане — це об’єкт сутності з усіма тими ж атрибутами, на додаток до наступних атрибутів:
Атрибут | Опис |
---|---|
Опис | HTML-копія опису веб-посилання. |
display_image_only | Логічний атрибут, що вказує, чи веб-посилання має відображатися тільки як зображення без зв'язку з текстом. |
display_page_child_links | Логічний атрибут, що вказує, чи веб-посилання повинно відображати посилання на похідні сторінки карти сайту пов'язаної сторінки, як субпосилання. |
Image | Об'єкт зображення веб-посилання для цього посилання. Цей атрибут є null, якщо зображення не відсутнє. |
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 | Змініть текст для зображення. |
---|---|
За висотою | Ціле число, що містить вказану висоту зображення. Якщо значення висоти не було надано, цей атрибут дорівнює 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-адресу) |