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

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

  • Стаття

Примітка

З 12 жовтня 2022 року портали Power Apps перейменовано на Power Pages. Додаткова інформація: Microsoft Power Pages тепер у загальному доступі (блоґ)
Незабаром документацію порталів Power Apps буде перенесено та об’єднано з документацією Power Pages.

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

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 для розбиття на сторінці
utc-offset
об’єднати
distinct
min-active-row-version
формат виводу
returntotalrecordcount
без блокування		 порядок
сутність
порядок атрибут:
псевдонім
спаданням
сутність ім'я
усі атрибути
без націнок
атрибут:		 порядок
фільтр
посилання на сутність
фільтр тип
підказка
isquickfindfields		 умова
фільтр
посилання на сутність ім'я
з
to
псевдонім
тип посилання
видимий
перетинання
усі атрибути
без націнок
атрибут:		 порядок
фільтр
посилання на сутність
умова стовпець
entityname
атрибут:
оператор
об’єднати
псевдонім
ім'я користувача
uitype
uihidden
значення		 значення

включити

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

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

{% include 'My Template' %}

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

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

блок

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

розширює

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

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

Коли використовується 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.

Див. також

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

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).