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

Статья
03/16/2023

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

fetchxml

Позволяет пользователю запрашивать данные из Microsoft Dataverse и отображать результаты на странице.

Заметка

Дополнительную информацию о запросе данных с помощью fetchxml можно узнать на странице use 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.

Другие поддерживаемые элементы и атрибуты

Liquid-тег fetchxml поддерживает следующие атрибуты и дочерние элементы.

Элемент/дочерний элемент	Атрибуты	Дочерний элемент
fetch	mapping version count page paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock	order Сущность
заказ	attribute alias по убыванию
Сущность	name all-attributes no-attrs атрибут	order filter link-entity
Фильтр	type hint isquickfindfields	condition Фильтр
link-entity	name from to alias link-type visible intersect all-attributes no-attrs атрибут	order filter link-entity
condition	column entityname attribute operator aggregate alias uiname uitype uihidden value	value

include

Включает содержимое одного шаблона в другой, по имени. На порталах Power Pages источником другого шаблона обычно будет веб-шаблон. Этот оператор позволяет повторно использовать часто встречающиеся фрагменты шаблона в нескольких местах.

Когда шаблон включен в другой шаблон, включенный шаблон будет иметь доступ ко всем переменным, определенным в родительском шаблоне.

{% include 'My Template' %}

Также возможно передавать любое число именованных параметров в тег include. Эти параметры будут определены как переменные во включенном шаблоне.

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

block

Используется с extends для обеспечения наследования шаблонов. Использование см. в extends.

extends

Используется с тегом block для обеспечения наследования шаблонов. Этот оператор позволяет нескольким шаблонам использовать общий макет, переопределяя конкретные области родительского макета.

На порталах Power Pages имя родительского шаблона, указанное для тега, обычно ссылается на имя веб-шаблона.

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

Если блок, определенный в родительском шаблоне, не будут переопределен, отображается его содержимое в родительском шаблоне (если имеется).

Комментарий

Позволяет оставить необрабатываемый код внутри шаблона Liquid. Любое содержимое в блоке не будет отображаться, и любой содержащийся внутри код Liquid не будет выполняться.

Код

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

Выходные данные

Hello. My name is Charles.

raw

Позволяет выводить код Liquid на странице без его синтаксического анализа и выполнения.

Выходные данные

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

замена

Если вы включаете кэширование верхнего и нижнего колонтитула и хотите избежать кэширования выходных данных определенного раздела, вы можете использовать этот тег. Этот тег обеспечивает блок контента в верхнем или нижнем колонтитуле, где вывод используемого блока контента не кэшируется. Этот оператор полезно в тех случаях, когда пользователь использует объект, который может часто обновляться, например, запрос, страница, язык и дата. Например, обратитесь к сценариям обновления исходного кода веб-шаблона верхнего и нижнего колонтитула, когда кэширование верхнего и нижнего колонтитула включено.

Совет

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

codecomponent

См. Понимание тега сущности codecomponent Dataverse, Использование тега шаблона Liquid компонентов кода.

См. также

Теги потока управления
Теги итераций
Теги переменных
Теги Dataverse Liquid
Использование тега шаблона Liquid компонентов кода

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