Доступні об’єкти Liquid
Примітка
З 12 жовтня 2022 року портали Power Apps перейменовано на Power Pages. Додаткова інформація: Microsoft Power Pages тепер у загальному доступі (блоґ)
Незабаром документацію порталів Power Apps буде перенесено та об’єднано з документацією Power Pages.
Об'єкти Liquid містять атрибути для виводу динамічного вмісту на сторінці. Наприклад, об'єкт сторінки має атрибут, який називається "заголовок", що може бути використаний для виводу заголовку поточної сторінки.
Для доступу до атрибута об'єкта за іменем, користуйтеся точкою (.). Для відтворення атрибута об’єкта в шаблоні, візьміть його в {{ and }}.
Важливо
Щоб уникнути можливих проблем із міжсайтовими сценаріями (XSS), завжди використовуйте фільтр екранування для кодування даних за допомогою HTML під час використання об'єктів Liquid для читання ненадійних даних, наданих користувачем.
{{ page.title }}
Атрибути об'єкта можна також отримати за допомогою імені рядка та []. Цей формат корисний в тих випадках, коли потрібний атрибут визначається динамічно або ім'я атрибута містить символи, пробіли, спеціальні символи і т. д., які будуть неправильними при використанні (.).
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Вказані нижче об'єкти можуть бути використані і доступні будь-якому місці, в будь-якому шаблоні.
| Об'єкт | Опис |
|---|---|
| сутності | Дозволяє завантажувати будь-яку таблицю Power Apps за ідентифікатором. Додаткові відомості: сутності |
| зараз | Об’єкт дати/часу, який посилається на поточний час UTC, коли відтворюється шаблон. Примітка: це значення кешується веб-програмою порталу і не оновлюється кожного разу. Додаткові відомості: Фільтри даних |
| сторінка | Відтворює на поточній сторінці порталу сторінку запиту. Об'єкт сторінки надає доступ до речей, таких як деталізація для поточної сторінки, заголовок або URL-адреса поточної сторінки, та будь-які інші атрибути або пов'язані сутності базового запису Power Apps. Додаткові відомості: сторінка |
| params | Зручний ярлик для request.params. Додаткові відомості: запит |
| запит | Містить відомості про поточний запит HTTP. Додаткові відомості: запит |
| настройки | Дозволяє завантажувати будь-які параметри сайту за іменем. Додаткові відомості: Настройки |
| мапа сайту | Дозволяє отримати доступ до мапи сайту порталу. Додаткові відомості: карта сайту |
| маркери місця | Дозволяє завантажувати будь-які маркери місця за іменем. Додаткові відомості: маркери місця |
| фрагменти | Дозволяє завантажувати будь-які фрагменти вмісту за іменем. Додаткові відомості: фрагменти |
| користувач | Посилається на поточного користувача порталу , що дозволяє доступ до всіх атрибутів базових записів контактів Power Apps. Якщо жоден користувач не увійшов, ця змінна буде мати нульове значення. Додаткові відомості: користувач |
| веб-посилання | Дозволяє завантажувати будь-який набір веб-посилань за іменем або ідентифікатором. Додаткові відомості: веб-посилання |
| веб-сайт | Посилається на запис порталу "Веб-сайт", що дає доступ до всіх атрибутів записів сайту Power Apps(adx_) для порталу. Додаткові відомості: веб-сайт |
оголошення
Надає можливість отримати доступ і відтворити оголошення.
Об'єкт оголошень дозволяє вибрати конкретне оголошення або місце розташування оголошення.
<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] %} |
Атрибути місця розташування оголошень
Розташування рекламного оголошення — це об'єкт таблиці з тими ж загальними атрибутами, та атрибутами, зазначеними нижче.
| Атрибут | Опис |
|---|---|
| Рекламні оголошення | Відтворює колекцію оголошень об'єктів, пов'язаних з місцем розташування. Мітки ітерації та Фільтри масиву можуть використовуватися з цією колекцією. |
| Ім’я | Відтворює поле "Ім'я" для місця розташування оголошень. |
| розміщення_url-адреси | URL-адреса може бути використана для відтворення місця розташування оголошення, що повністю відображається шаблоном. |
| випадкові_url-адреси | URL-адреса може бути використана для довільного відтворення оголошення з місця розташування, що повністю відображається шаблоном. |
Атрибути оголошення
Примітка
Рекламне оголошення — це об'єкт таблиці з тими самим атрибутами, а також з атрибутами, зазначеними нижче.
| Атрибут | Опис |
|---|---|
| оголошення_url-адреса | URL-адреса може бути використана для відтворення оголошення, що повністю відображається шаблоном. |
| Копія | Відтворює поле "Копіювати" для оголошення. |
| зображення | Відтворює об'єкт зображення (за наявності) для оголошення. |
| Ім’я | Відтворює поле "Ім’я" для оголошення. |
| відкрити_в_новому_вікні | Відтворює "істина", якщо URL-адреса, вказана переадресацією_url-адреса має відкриватися в новому вікні. |
| перенаправлення_url-адреси | URL-адреса, на яку буде переспрямовано користувача під час вибору оголошення. |
Атрибути зображення оголошення
| Атрибут | Опис |
|---|---|
| альтернативний_текст | Відтворює текст, який має з'являтися в атрибуті 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 | Відтворює ціле значення кількості коментарів для цього запису. |
| опублікування_дата | Дата, коли запис був опублікований. |
сутності
Застереження
Щоб уникнути можливих проблем із міжсайтовими сценаріями (XSS), завжди використовуйте фільтр екранування для кодування даних за допомогою HTML під час використання об'єкту Liquid сутності для читання наданих користувачем даним, що не є надійними.
Примітка
Деякі з цих умов іменування Dataverse змінилися, наприклад, Dataverse сутності тепер називаються таблицями . Зміни імені не застосовуються до об’єктів «Об’єкти об’єктів равлики». Об’єкт об’єкта "Схвалений" продовжуватиме називатися об’єктами.
Дозволяє завантажувати будь-яку таблицю Power Apps за ідентифікатором. Якщо таблиця існує, повертає об'єкт таблиці. Якщо таблицю з вказаним Ідентифікатором не знайдено, відобразиться 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
Об'єкт сутності надає доступ до атрибутів запису таблиці Power Apps.
| Атрибут | Опис |
|---|---|
| Ідентифікатор | Ідентифікатор GUID таблиці у вигляді рядка. Наприклад, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| логічне_ім’я | Логічне ім’я Power Apps таблиці. |
| Примітки | Завантажує усі примітки (анотації), пов'язані з таблицею, в порядку від найстаріших до найновіших (createdon). Примітки знаходяться як об'єкти приміток. |
| дозволи | Завантажує результати підтвердження дозволу таблиці для даної таблиці. Результати відтворюються як об'єкт дозволу. |
| URL-адреса | Повертає URL-шлях системи керування вмістом порталів Power Apps для таблиці. Якщо таблиця не має дійсної URL-адреси у поточному веб-сайті, повертає null-значення. Як правило, якщо ви не настроїли URL-провайдера в програмі, функція повертатиме значення лише для певних типів таблиць, інтегрованих до порталу CMS. |
| [ім’я атрибуту або зв’язку] | Можна отримати доступ до будь-якого атрибуту таблиці Power Apps за логічним ім'ям. {{ 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 |
| логічне_ім’я | Логічне ім’я Power Apps вказаної в посиланні таблиці. |
| Унікальне ім'я | Первинний атрибут імені вказаної в посиланні таблиці. |
Примітка
Примітка є об'єктом таблиці, що надає доступ до атрибутів і зв'язків запису анотації. Окрім всіх атрибутів об'єкта таблиці, примітка містить вказані нижче додаткові атрибути.
| Атрибут | Опис |
|---|---|
| documentbody | Завантажує атрибут documentbody запису анотації примітки як рядок з кодуванням Base64. Через те, що зміст цього атрибута може бути великим, він не завантажується з рештою атрибутів примітки, він може бути завантажений тільки на вимогу. Примітка. Використання атрибута documentbody може мати негативний вплив на ефективність візуалізації шаблону і повинно робитися з обережністю. Використовуйте атрибут url, щоб надавати натомість посилання на вкладення примітки, якщо це можливо. |
| URL-адреса | Відтворює шлях URL-адреси для вбудованоого обробника вкладення анотації на порталі. Якщо користувач має дозвіл, а примітка має вкладений файл, запит на цю URL-адресу буде завантажувати вкладений файл примітки. |
Примітка
Значення набору параметрів
Значення атрибуту набору параметрів/розкривного списку повертаються у вигляді об'єктів пов’язаних посилань на таблицю, з вказаними нижче атрибутами.
| Атрибут | Опис |
|---|---|
| Підпис | Локалізовані підписи значення атрибута набору параметрів/розкривного списку. Наприклад, Активовано |
| Значення | Ціле значення атрибута набору параметрів/розкривного списку. Наприклад: 0 |
Дозволи для таблиці
Об'єкт дозволів таблиці надає доступ до зведеного результату підтвердження дозволу для таблиці.
| Атрибут | Опис |
|---|---|
| можна_додати | Відтворює "істинність", якщо поточний користувач має дозвіл додавати записи до зв’язків цього запису. В іншому разі повертає значення "хибність". |
| можна_додати_до | Повертає значення "істина", якщо поточний користувач має дозвіл додавати цей запис до зв'язків іншої таблиці. В іншому разі повертає значення "хибність". |
| можна_створити | Повертає значення "істина", якщо поточний користувач має дозвіл створювати нові записи цього типу таблиці. В іншому разі повертає значення "хибність". |
| можна_видалити | Відтворює "істинність", якщо поточний користувач має дозвіл на видалення цього запису. В іншому разі повертає значення "хибність". |
| можна_читати | Відтворює "істинність", якщо поточний користувач має дозвіл на читання цього запису. В іншому разі повертає значення "хибність". |
| можна_писати | Відтворює "істинність", якщо поточний користувач має дозвіл на оновлення цього запису. В іншому разі повертає значення "хибність". |
| правила_існують | Відтворює "істинність", якщо результати дозволу, представлені цим об'єктом, є результатом чітко визначених дозвільних правил. Відтворює "хибність", якщо результати визначені за промовчанням за відсутності чітко визначених дозволів. |
Рефлексивний зв'язок
Спроби завантажити рефлексивні (тобто такі, що посилаються самі на себе) зв’язки на сутності, відтворюються як об'єкти із вказаними нижче атрибутами.
| Атрибут | Опис |
|---|---|
| є_зворотні | Відтворює "істинність" Використовується для перевірки, чи об'єкт, відтворений зв’язком, є рефлексивним об'єктом зв'язку. |
| за посиланням | Відтворює масив посилань на сутності для ціього зв’язку. |
| посилання | Повертає таблицю посилань для вказаного зв’язку. Повертає null-значення, якщо немає таблиці посилань. Якщо зв’язок має значення "багато до багатьох" (N:N), відтворюється масив сутностей із посиланнями. |
список сутностей
Об'єкт entitylist використовується в межах тегів таблиць Power Apps Dataverse. Надає доступ до всіх атрибутів даного списку.
Атрибути
Примітка
| Атрибут | Опис |
|---|---|
| створення_включено | Повертає значення "істина", якщо створення нових записів налаштовано для списку. В іншому разі повертає значення "хибність". |
| створення_url | Повертає налаштований URL-шлях для створення посилання/кнопки для списку. |
| інформація_включена | Повертає значення "істина", якщо докладне подання для окремих записів налаштоване для списку. В іншому разі повертає значення "хибність". |
| інформація_ідентифікатора_параметра | Відтворює ім’я параметра рядка запиту, що потрібно використовувати для ідентифікатора запису при формуванні URL-адреси перегляду інформації запису. Див. Фільтри URL-адрес для докладної інформації про використання фільтрів Liquid для побудови URL-адрес. Наприклад, ідентифікатор |
| інформація_етикетки | Повертає налаштований локалізований підпис для посилань/кнопок докладного подання для списку. |
| інформація_url-адреси | Повертає налаштований URL-шлях для посилань/кнопок докладного подання для списку. |
| порожній_список_тексту | Повертає настроєний локалізований текст, який з'являтиметься, якщо подання списку не поверне жодних результатів. |
| включити_дозволи_сутності | Повертає значення "істина", якщо для списку увімкнено фільтрування дозволів таблиці. В іншому разі повертає значення "хибність". |
| логічне_ім’я_сутності | Повертає логічне ім'я таблиці Power Apps для записів, щоб відображатимуться цим списком. Наприклад, contact |
| атрибут_фільтру_бізнес_партнерів | Відтворює логічне ім'я атрибута для підстановки в обліковий запис, який буде використовуватись для фільтрування записів результатів первинним партнером поточного користувача порталу. Наприклад, accountid |
| етикетка_застосовування_фільтра | Повертає налаштований локалізований підпис, який буде використовуватися для посилання/кнопки, що застосовує розширений фільтр атрибутів до результатів списку. |
| filter_definition | Повертає визначення фільтра атрибуту JSON для списку. Див. розділ Фільтри списків для докладної інформації про те, як використовувати метафільтри фільтру Liquid для обробки цього визначення. |
| filter_enabled | Повертає значення "істина", якщо розширена фільтрація атрибутів увімкнена для списку. В іншому разі повертає значення "хибність". |
| filter_portal_user_attribute_name | Відтворює логічне ім'я атрибута для підстановки в контакт, який буде використовуватись для фільтрування записів результатів контактною особою поточного користувача порталу. Наприклад, contactid |
| ім’я_атрибута_фільтра_веб-сайтів | Відтворює логічне ім'я атрибута для підстановки в adx_веб-сайт, який буде використовуватись для фільтрування записів результатів поточним веб-сайтом порталу. Наприклад, adx_websiteid |
| код_мови | Повертає мовний код цілого числа Power Apps, що буде використовуватися для вибору всіх локалізованих підписів для цього списку. |
| розмір_сторінки | Повертає настроєний розмір сторінки результатів для списку. |
| ім'я_основного_ключа | Повертає логічне ім’я первинного ключового атрибуту для записів, що відображатимуться цим списком. |
| пошук_включено | Повертає значення "істина", якщо для цього списку увімкнено пошук. В іншому разі повертає значення "хибність". |
| покажчик місця заповнення_пошуку | Повертає налаштований локалізований текст для заповнювача поля пошуку списку. |
| підказка_пошуку | Повертає налаштований локалізований текст для підказки пошуку у списку. |
| подання | Повертає доступні для списку подання у вигляді об'єктів подання списку. |
| [логічне ім’я атрибута] | Ви можете отримати доступ до будь-якого атрибуту запису (adx_entitylist) Power Apps списку за логічним ім'ям, так само, як у таблиці. Наприклад, {{ entitylist.adx_name }} |
Атрибути подання списку
| Атрибут | Опис |
|---|---|
| стовпці | Повертає стовпці подання у вигляді об'єктів стовпців подання списку. |
| логічне_ім’я_сутності | Повертає логічне ім'я таблиці Power Apps для записів, включених в подання. Наприклад, contact |
| Ідентифікатор | Відтворює ідентифікатор GUID перегляду. |
| код_мови | Відтворює код мови цілого числа Power Apps, яке буде використовуватися для вибору всіх локалізованих підписів (заголовки стовпців тощо) для цього перегляду. |
| Ім’я | Відтворює коротке ім’я Power Apps перегляду. |
| логічне_ім’я_основного_ключа | Повертає первинне ключове логічне ім'я таблиці Power Apps для записів,і включених в подання. Наприклад, contactid |
| вираз_сортування | Відтворює вираз сортування за промовчанням для перегляду. Наприклад, name ASC, createdon DESC |
Атрибути стовпця подання списку
| Атрибут | Опис |
|---|---|
| тип_атрибута | Відтворює ім'я типу атрибута Power Apps для стовпця як рядка. Наприклад, Lookup, Picklist, String, Boolean, DateTime |
| логічне_ім’я | Відтворює логічне ім'я типу атрибута Power Apps для стовпця. Наприклад, дата створення |
| Ім’я | Відтворює локалізоване коротке ім'я Power Apps для стовпця. Наприклад, Дата створення |
| сортувати_за зростанням | Відтворює рядок виразу сортування для сортування стовпців у порядку зростання. Наприклад, createdon ASC |
| сортування_за спаданням | Відтворює рядок виразу сортування для сортування стовпців у порядку спадання. Наприклад, createdon DESC |
| сортування_вимкнуто | Відтворює "істинність", якщо сортування вимкнуто для стовпця. В іншому разі повертає значення "хибність". |
| сортування_включено | Відтворює "істинність", якщо сортування увімкнуто для стовпця. В іншому разі повертає значення "хибність". |
| ширина | Відтворює настроєну ширину для стовпця у пікселях. |
entityview
Об'єкт entityview використовується всередині тегу entityview і забезпечує доступ до метаданих для перегляду, а також до перегляду записів результатів.
Атрибути
| Атрибут | Опис |
|---|---|
| стовпці | Повертає стовпці у подання у вигляді об'єктів стовпців подання таблиці. |
| відмовлено_в дозволі_сутності | Повертає значення "істина", якщо доступ до подання результатів був відхилений через брак відповідних дозволів таблиці для поточного користувача. Відтворює "хибність", якщо було надано доступ "читання" для перегляду результатів. |
| логічне_ім’я_сутності | Логічне ім'я таблиці Power Apps перегляду записів результатів. Наприклад, contact |
| перша_сторінка | Номер сторінки на першій сторінці перегляду результатів. Це буде 1, якщо не було відтворено ніяких результатів, у випадку чого буде значення нуль. |
| Ідентифікатор | Ідентифікатор GUID перегляду Dynamics 365, який визначає цей entityview Power Apps. |
| код_мови | Мовний код цілого числа Power Apps використовується для завантаження локалізованих підписів для поточного перегляду. |
| остання_сторінка | Номер сторінки на останній сторінці перегляду результатів. Якщо не було ніяких результатів, це буде нуль. |
| ім'я | Ім'я перегляду Power Apps, який визначає цю entityview, наприклад, "Активні контакти". |
| наступна_сторінка | Номер сторінки на наступній сторінці перегляду результатів. Якщо немає наступної сторінки результатів, це буде нуль. |
| Стор. | Номер сторінки на поточній сторінці перегляду результатів. |
| сторінки | Відтворює масив номерів сторінок, які містять усі сторінки результатів для поточного перегляду. |
| розмір_сторінки | Кількість результатів, відтворених на сторінку, для поточного перегляду. |
| попередня_сторінка | Номер сторінки на наступній сторінці перегляду результатів. Якщо немає попередньої сторінки результатів, це буде нуль. |
| логічне_ім’я_основного_ключа | Логічне ім’я атрибута основного ключа Power Apps таблиці результатів для цього подання. Наприклад, contactid |
| записи | Поточна сторінка записів результатів для подання, у виглядів об'єктів таблиці. |
| вираз_сортування | Вираз сортування за промовчанням для перегляду. Наприклад, nameASC, createdon DESC. |
| усього_сторінок | Загальна кількість сторінок результатів для перегляду. |
| усього_записів | Загальна кількість результатів для перегляду (на всіх сторінках). |
події
Надає можливість отримати доступ і відтворити події. Об'єкт подій дозволяє вибрати конкретну подію або всі події.
Об'єкт подій
Об’єкт подій дозволяє отримати доступ до будь-якої конкретної події на порталі або отримати доступ до всіх подій на порталі (незалежно від події).
Об'єкт подій має такі атрибути:
| Атрибут | Опис |
|---|---|
| випадки | Відтворює 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-адреса випадку. |
| це_подія_на весь_день | Це подія на весь день? |
| час_початку | Час початку події. |
| час_завершення | Час закінчення події. |
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 також є еквівалентним. |
| підрахунок_гілок | Відтворює значення цілого числа підрахунку кількості гілок, які є у всьому сайті. |
| підрахунок_записів | Повертає ціле значення загальної кількості записів на порталі. |
| [ім'я або ідентифікатор форуму] | Ви можете отримати доступ до будь-якого форуму за його властивостями імені або ідентифікатора. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Об'єкт форуму
Атрибути
Примітка
| Атрибут | Опис |
|---|---|
| гілки | Відтворює об'єкт forumthreads, що містить усі гілки форуму для цього форуму. |
| Ім’я | Назва форуму. |
| підрахунок_гілок | Відтворює значення цілого числа підрахунку кількості гілок, які є у всьому форумі. |
| підрахунок_записів | Відтворює значення цілого числа підрахунку загальної кількості записів, які є у всьому форумі. |
Об'єкт forumthreads
Атрибути
| Атрибут | Опис |
|---|---|
| Усі | Відтворює всі об'єкти forumthread в колекції. |
Об'єкт forumthread
Атрибути
Примітка
| Атрибут | Опис |
|---|---|
| записи | Відтворює об'єкт forumposts, що містить усі записи форуму для цієї гілки форуму. |
| автор | Повертає автора ланцюжка (що являє собою просто об'єкт таблиці контактних осіб). |
| останній_пост | Відтворює останній запис у гілці. |
| перший_запис | Відтворює перший запис у гілці. |
| підрахунок_записів | Відтворює значення цілого числа підрахунку кількості записів, які є у всій гілці. |
| отримано_відповідь | Чи містить гілка відповіді чи ні? |
| є_прикріпленою | Чи є гілка клейкою? |
Об'єкт forumposts
Атрибути
| Атрибут | Опис |
|---|---|
| Усі | Відтворює всі об'єкти forumthread в колекції. |
Єдиний запис форуму
Атрибути
Примітка
| Атрибут | Опис |
|---|---|
| автор | Повертає автора запису (що являє собою просто об'єкт таблиці контактних осіб). |
| вміст | Вміст запису. |
| є_відповіддю | Чи є цей запис відповіддю на гілку? |
база знань
Надає доступ до записів таблиць knowledgearticle та категорій Power Apps для відтворення статей та категорії в порталі.
Атрибути
| Атрибут | Опис |
|---|---|
| статті | Повертає об'єкт статей, що містить об'єкти статті записів таблиці 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-адреса поточної сторінки, та будь-які інші атрибути або пов'язані сутності базового запису Power Apps.
<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 }}. -->
Атрибути сторінки
Примітка
| Атрибут | Опис |
|---|---|
| навігація | Відтворює деталізовані об’єкти вузла мапи сайту для сторінки, починаючи від кореневого вузла карти сайту і закінчуючи батьківським. |
| дочірні об’єкти | Відтворює дочірні об'єкти вузла карти сайту сторінки. |
| батьківський | Відтворює первинні об'єкти вузла карти сайту для сторінки. Якщо сторінки є головною сторінкою, батьківська буде нулем. |
| title | Заголовок сторінки. |
| URL-адреса | URL-адреса сторінки. |
| [ім’я атрибуту або зв’язку] | Можна відкрити будь-який атрибут на сторінці, що є основою запису Power Apps за логічним ім'ям.{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}Значення більшості атрибутів таблиці зіставляються безпосередньо з Типами Liquid: поля з двома варіантами зіставляються з логічними, текстові поля з рядками, числові та грошові поля з числами, поля дати та часу з об'єктами дат. Але кілька типів атрибутів відтворюються як об'єкти:
{{ page.adx_webpage_entitylist.adx_name }}У випадку, якщо зв’язки будуть рефлексивними (тобто посилатимуться самі на себе), буде відображатися об’єкт сутності. (Інакше результат був б неоднозначний.) {{ page.adx_webpage_webpage.referencing.adx_name }} Примітка. Завантаження великої кількості пов'язаних сутностей або доступ до великої кількості зв’язків в одному шаблоні може мати негативний вплив на ефективність відтворення шаблону. Уникайте завантаження пов'язаних сутностей для кожного елемента масиву в межах цтклу. При можливості, використовуйте в першу чергу теги таблиць Power Apps 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] %} |
Атрибути місця розташування опитувань
Примітка
| Атрибут | Опис |
|---|---|
| Ім’я | Відтворює поле "Іім'я" для розміщення опитування. |
| розміщення_url-адреси | URL-адреса може бути використаний для відтворення опитування, що повністю відображається шаблоном. |
| опитування | Відтворює колекцію об'єктів опитування, пов'язаних з розміщенням. Мітки ітерації та Фільтри масиву можуть використовуватися з цією колекцією. |
| випадкові_url-адреси | URL-адреса може бути використана для довільного відтворення опитування з місця розташування, що повністю відображається шаблоном. |
| подати_url-адресу | URL-адреса, до якої подається завершене опитування. |
Атрибути опитування
Примітка
| Атрибут | Опис |
|---|---|
| має_користувача_, який проголосував | Повертає значення "істина", якщо поточний користувач (який виконав вхід або анонімний) вже голосував у цьому опитуванні. |
| Ім’я | Відтворює поле "Ім'я" для опитування. |
| параметри | Відтворює колекцію об'єктів параметрів опитування, пов'язаних з опитуванням. Мітки ітерації та сутності можуть використовуватися з цією колекцією. |
| url-адреса_опитування | URL-адреса може бути використана для відтворення опитування, що повністю відображається шаблоном. |
| Запитання | Відтворює поле "Питання" для опитування. |
| підпис_кнопки_"Надіслати" | Відтворює рядок, який можна використовувати для заміщення підпису кнопка надсилання для опитування. |
| подати_url-адресу | URL-адреса, до якої подається завершене опитування. |
| виділений_користувачем_варіант | Відтворює об'єкт 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 Apps версії 9.3.8.x або пізнішої за замовчуванням матимуть фільтр Liquid escape за замовчуванням застосований до об’єктів Liquid user і request. Щоб вимкнути цю конфігурацію за замовчуванням і дозволити використання цих об’єктів Liquid без фільтра Liquid, див. розділ Параметри сайту порталу — Site/EnableDefaultHtmlEncoding.
Атрибути
| Атрибут | Опис |
|---|---|
| params | Значення названого параметра для поточного запиту. params – це поєднання параметрів рядка запиту URL-адреси, параметрів запису форми та файлів cookie. |
| Шлях | Шлях поточного запиту URL-адреси. /профіль/ |
| шлях_і_запит | Шлях і запит поточного запиту 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 використовується в межах тегів таблиці Power Apps 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 %}
Атрибути
| Атрибут | Опис |
|---|---|
| приблизна_загальна кількість_переглядів | Відтворює приблизний підрахунок усіх показів, які збігаються із запитом покажчика. У зв’язку зі способом який працює індекс пошуку в плані безпеки фільтрації та інших факторів розробки, це число є лише орієнтовним і не може точно збігатися із загальною кількістю результатів для поточного користувача в деяких ситуаціях. |
| Стор. | Відтворює номер сторінки поточного запиту. |
| розмір_сторінки | Відтворює максимальний розмір сторінки поточного запиту. Якщо ви хочете відображати фактичну кількість результатів для поточної сторінки (оскільки це може бути менше за розмір вказаного максимального розміру сторінки), слід використовувати results.size. |
| Результати | Відтворює сторінку результатів запиту, як об'єкт результату індексу пошуку. |
Результати індексу пошуку
| Атрибут | Опис |
|---|---|
| сутність | Основні сутності для результату. |
| фрагмент | Відповідний фрагмент короткого тексту для результату з термінами, які відповідають вказаному запиту, виділеними за допомогою HTML-тегу <em>. Певні типи запитів не підтримують виділені фрагменти, наприклад нечіткі запити (~) та узагальнення запитів (*). Ця властивість дорівнюватиме нулю в цих випадках. |
| Ідентифікатор | Ідентифікатор таблиці Power Apps базового запису для результату, у вигляді рядка. Наприклад, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| логічне_ім’я | Логічне ім’я таблиці Power Apps базового запису для результату. Наприклад, 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. |
| є_карта сайту_вихідною | Відтворює "істинність", якщо вузол мапи сайту був первинним для поточного вузла, в іншому випадку відтворюється "хибність". |
| є_карта сайту_поточною | Відтворює "істинність", якщо вузол мапи сайту є поточним вузлом, в іншому випадку відтворюється "хибність". |
| Батьківський об’єкт | Відтворює первинні об'єкти вузла карти сайту для вузла. Якщо вузол є кореневим вузлом, первинний буде нуль. |
| Назва | Заголовок вузла. |
| 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-адреса цілі маркера місця. |
| [логічне ім’я атрибута] | Можна відкрити будь-який атрибут цілі маркера місця запису Power Apps за логічним ім'ям. Наприклад, {{ sitemarker.adx_ім’я }} |
фрагменти
Дозволяє завантажувати будь-які фрагменти вмісту за іменем. Якщо фрагмент із цим заданим іменем не знайдено, відобразиться нуль.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Містить властивості, корисні в межах петлі блоку Теги ітерації.
Примітка
tablerowloop може використовуватися лише в межах тегу Теги ітерації.
Атрибути
| Атрибут | Опис |
|---|---|
| Стовп. | Відтворює індекс поточного рядка, починаючи з 1. |
| col0 | Відтворює індекс поточного рядка, починаючи з 0. |
| стовп._перший | Відтворює «істинність», якщо поточний стовпець є першим стовпцем в рядку, відтворює «хибність», якщо ні. |
| стовп._останній | Відтворює «істинність», якщо поточний стовпець є останнім стовпцем в рядку, відтворює «хибність», якщо ні. |
| Ім’я | Відтворює "істинність", якщо це перший цикл петлі. Відтворює "хибність", якщо це не перший цикл петлі. |
| Індекс | Положення поточного елемента в колекції, де перший елемент має позицію 1. |
| index0 | Положення поточного елемента в колекції, де перший елемент має позицію 0. |
| Остання | Відтворює "істинність", якщо це останній цикл петлі. Відтворює "хибність", якщо це не останній цикл петлі. |
| Довжина | Відтворює кількість циклів для петлі ߝ кількість елементів у колекції, що повторюються. |
| Rindex | Кількість елементів, що залишилися в петлі (довжина - покажчик), де 1 є покажчиком останнього елемента. |
| rindex0 | Кількість елементів, що залишилися в петлі (довжина - покажчик), де 0 є покажчиком останнього елемента. |
користувач
Посилається на поточного користувача порталу , що дозволяє доступ до всіх атрибутів базових записів контактів Power Apps. Якщо жоден користувач не увійшов, ця змінна буде мати нульове значення.
користувача є об'єктом сутності.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Примітка
Випуск порталів Power Apps версії 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-копія набору веб-посилань. |
| Ім’я | Ім’я набору веб-посилань. |
| Назва | Заголовок набору веб-посилань. |
| Веб-посилання | Масив об'єктів веб-посилань, пов'язаних з набором веб-посилань. |
| [логічне ім’я атрибута] | Можна відкрити будь-який атрибут запису Power Apps набору веб-посилань за логічним ім'ям. Наприклад: {{ weblinkset.createdon }} |
Атрибути веб-посилання
Примітка
Веб-посилання є об'єктом сутності з усіма з однаковими атрибутами, зокрема тими, що наведені нижче.
| Атрибут | Опис |
|---|---|
| Опис | HTML-копія опису веб-посилання. |
| відображати_лише_зображення | Логічний атрибут, що вказує, чи веб-посилання має відображатися тільки як зображення без зв'язку з текстом. |
| відобразити_дочірні_посилання_сторінки | Логічний атрибут, що вказує, чи веб-посилання повинно відображати посилання на похідні сторінки карти сайту пов'язаної сторінки, як субпосилання. |
| Зображення | Об'єкт зображення веб-посилання для цього посилання. Цей атрибут дорівнюватиме нулю, якщо немає зображення. |
| є_зовнішній | Логічний атрибут, що вказує, чи цільова URL-адреса веб-посилання йде на зовнішній сайт (а не на внутрішню сторінку порталу). |
| є_карта сайту_вихідною | Відтворює "істинність", якщо URL-адреса веб-посилання переходить на предка поточного вузла карти сайту, в іншому випадку відтворюється "хибність". |
| є_карта сайту_поточною | Відтворює "істинність", якщо URL-адреса веб-посилання переходить на поточний вузол карти сайту, в іншому випадку відтворюється "хибність". |
| Ім’я | Ім’я/заголовок веб-посилання. |
| Nofollow | Логічний атрибут вказує, чи веб-посилання повинно позначатися як rel="nofollow". |
| відкрити_в_новому_вікні | Логічний атрибут, що вказує, чи веб-посилання має відкриватися в новому вікні/вкладці браузера, коли його вибрали. |
| Підказка | Текст підказки для веб-посилання. |
| URL-адреса | URL-адреса веб-посилання. |
| Веб-посилання | Масив дочірніх об'єктів веб-посилань, пов'язаних з веб-посиланням. |
| [логічне ім’я атрибута] | Можна відкрити будь-який атрибут запису Power Apps веб-посилання за логічним ім'ям. Наприклад: {{ weblink.createdon }} |
Атрибути зображень веб-посилання
| альтернативний_текст | Змініть текст для зображення. |
|---|---|
| Висота | Ціле число, що містить вказану висоту зображення. Якщо не вказано значення висоти, цей атрибут дорівнюватиме нулю. |
| URL-адреса | URL-адреса зображення. |
| Ширина | Ціле число, що містить вказану ширину зображення. Якщо не вказано значення ширини, цей атрибут дорівнюватиме нулю. |
веб-сайт
Посилається на запис порталу веб-сайт, що дозволяє доступ до всіх атрибутів записів Power Apps веб-сайту (adx_веб-сайт) для порталу.
Примітка
Веб-сайт є об’єктом сутності з тими самим атрибутами.
Код
{{ 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
Примітка
Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)
Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).