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

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

  • Статья

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

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 компонентов кода