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

Теги шаблонів

  • Стаття

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

fetchxml

Дає змогу користувачу запитувати дані із Microsoft Dataverse і відтворювати результати на сторінці.

Нотатка

Ви можете дізнатися більше про запитування даних за допомогою fetchxml у статті Використання FetchXML для запитування даних.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Під час використання fetchxml для запиту даних переконайтеся, що не використовуються теги, що закриваються автоматично. Наприклад, замість <attribute name="title"/> використовуйте <attribute name="title"></attribute> із явним закриваючим тегом </attribute>.

Атрибут результатів

Атрибут результатів у вказаній змінній (наприклад, "resultVariable" у наведеному вище зразку) містить результати запиту FetchXML і кілька інших атрибутів.

  • Сутності

    Цей атрибут містить результат запиту fetchxml. Ви можете ітерувати результат і використати його у веб-шаблоні.

    <table> 
{% for entityVariable in resultVariable.results.entities %} 
<tr> 
<td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
<td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
</tr> 
{% endfor %} 
</table>

  • TableName

    Отримує логічне ім’я сутності.

  • ExtensionData

    Отримує структуру, яка містить додаткові дані.

  • MinActiveRowVersion

    Отримує значення найнижчої активної версії рядка.

  • MoreRecords

    Отримує відомості про наявність інших записів.

  • PagingCookie

    Отримує поточну інформацію про довантаження.

  • TotalRecordCount

    Отримує загальну кількість записів у колекції.
    Під час виконання запиту сутність ReturnTotalRecordCount мала значення true.

  • TotalRecordCountLimitExceeded

    Отримує відомості про те, чи результати запиту перевищують кількість записів.

Атрибут XML

Атрибут XML у вказаній змінній (наприклад, «resultVariable» у наведеному вище зразку) містить результуючий запит, який можна використати для отримання даних із Microsoft Dataverse. Цей атрибут зручно використовувати для налагодження, щоб зрозуміти принцип застосування дозволу таблиці до позначки fetchxml.

Інші підтримувані елементи та атрибути

Позначка fetchxml liquid підтримує такі атрибути і дочірні елементи.

Елемент/дочірній елемент Атрибути Дочірній елемент
fetch зіставлення
версія
кількість
сторінка
cookie-файли для розбивання на сторінки
часовий пояс
об'єднати
розділити
мінімальна версія активного рядка
формат виведення
returntotalrecordcount
без блокування		 порядок
сутність
порядок атрибут
псевдонім
спаданням
сутність ім’я
усі атрибути
без націнок
атрибут:		 порядок
фільтрувати
посилання на сутність
фільтр тип
підказка
isquickfindfields		 умова
фільтр
посилання на сутність ім’я
з
до
псевдонім
тип посилання
видимий
перетинання
усі атрибути
без націнок
атрибут:		 порядок
фільтрувати
посилання на сутність
умова стовпець
ім'я сутності
атрибут
оператор
об'єднати
псевдонім
uiname
uitype
uihidden
значення		 значення

включити

Включає вміст одного шаблону в інший, за іменем. У Power Pages джерелом цього іншого шаблону зазвичай буде веб-шаблон. Цей оператор дозволяє повторне використання фрагментів поширених шаблонів в декількох місцях.

Якщо включити один шаблон в інший, включений шаблон буде мати доступ до будь-яких змінних визначених в первинному шаблоні.

{% include 'My Template' %}

Можна також передати будь-яку кількість названих параметрів для включення тегу. Тоді ці параметри будуть визначені як змінні у включеному шаблоні.

{% include 'My Template' a:x, b:y %}

блок

Використовується з розширенням, щоб забезпечити успадкування шаблону. Див. розширення для використання.

розширює

Використовується в поєднанні з тегом block, щоб забезпечити успадкування шаблону. Цей оператор дозволяє кільком шаблонам використовувати спільні макети, заміняючи певні області батьківського макета.

У Power Pages ім'я батьківського шаблону, надане тегу, буде зазвичай посилатися на ім’я веб-шаблону.

Коли використовується extends, він повинен бути першим вмістом у шаблоні і може супроводжуватися одним або кількома тегами block.

Якщо блок, визначений у батьківському шаблоні, не замінюється, то буде відтворюватися вміст у первинному шаблоні (за його наявності).

коментар

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

Код

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Результат

Hello. My name is Charles.

сировина

Дозволяє виведення коду Liquid на сторінці без аналізу і виконання.

Результат

Hello, {{ user.fullname }}. My name is Charles.

заміна

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

Порада

URL-адреса, що використовується в request.url може бути будь-яким запитаним значенням та кешується для подальших запитів. Щоб забезпечити правильне значення в request.url, рекомендуємо використовувати тег заміни, часткову URL-адресу, наприклад, ~{шлях WebFile} або зберігання URL-адреси порталу в настройках сайту.

codecomponent

Див. розділи Ознайомлення з тегом сутності «Компонент коду Dataverse», Використання тегу компонентів коду Liquid.

Див. також

Теги керування потоком
Теги ітерації
Змінні теги
Теги Liquid Dataverse
Використання компонентів коду: позначка шаблону Liquid