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

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

Fetchxml

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

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

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

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

Атрибут results у наданій змінній (наприклад, ’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> 
  

• Ім’я таблиці

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

• Дані розширення

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

• MinActiveRowVersion

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

• ДокладнішеРекорди

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

• Paging Cookie

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

• TotalRecordCount

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

• TotalRecordCountLimitПеревищено

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

Атрибут XML

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

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

Тег Fetchxml liquid підтримує наступні атрибути та дочірні елементи.

включити

Включає вміст одного шаблону в інший, за іменем. У 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.

заміна

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

codecomponent

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

Див. також

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