模板标记

项目
06/06/2024

模板标记通过各种方式控制模板的输出，并允许将多个模板合并到单个输出。

fetchxml

让用户可以从 Microsoft Dataverse 查询数据，并通过页面显示结果。

备注

您可以在使用 “fetchxml”查询数据时详细了解如何使用 fetchxml FetchXML 查询数据。

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

使用 fetchxml 查询数据时，确保您没有使用自关闭标记。例如，不要使用 <attribute name="title"/>，而是使用带有显式关闭标签 </attribute> 的 <attribute name="title"></attribute>。

结果属性

提供的变量（例如上面示例中的“resultVariable”）中的 results 属性包含 FetchXML 查询结果和一些其他属性。

实体

此属性中包含 fetchxml 查询的结果。可以循环访问结果，并将其用于 Web 模板中。

<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 属性

提供的变量（上面的示例中为“resultVariable”）中的 XML 属性中存储可用于从 Microsoft Dataverse 获取数据的结果查询。当您想了解如何在此 fetchxml 标记上应用表权限时，此属性可用于调试目的。

其他支持的元素和属性

fetchxml liquid 标记支持以下属性和子元素。

元素/子元素	属性	子元素
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
条件	column entityname attribute operator aggregate alias uiname uitype uihidden value	value

包括

按名称在另一个模板中包括某个模板的内容。在 Power Pages 中，此其他模板来源通常是 Web 模板。此运算符允许在多个位置重用常见模板片段。

在另一个模板中包括某个模板时，包括的模板可以访问父模板中定义的所有变量。

{% include 'My Template' %}

还可以将任何数量的已命名参数传递到包括标记。然后，这些参数将定义为包括模板中的变量。

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

block

与 extends 结合使用，以提供模板继承。有关使用情况，请参阅 extends。

扩展

与 block 标记结合使用，以提供模板继承。此运算符允许多个模板使用一个共享布局，同时替代父布局中特定区域。

在 Power Pages 中，提供给标记的父模板名称通常是指 Web 模板的名称。

使用 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.

替代

启用页眉和页脚缓存时，如果要避免缓存某个部分输出，可以使用此标记。此标记在其中不缓存包装的内容块的输出的页眉和页脚中提供内容块。如果用户使用可能经常更新的对象（如请求、页面、语言和日期），此运算符非常有用。例如，参考启用了页眉和页脚缓存时的页眉和页脚 Web 模板源代码更新方案。

提示

request.url 中使用的 URL 可以是任何请求的值，它为后续请求缓存。为了确保 request.url 中的值正确，请考虑使用替代标记，部分 URL（如 ~{WebFile path}）或将门户 URL 存储在站点设置中。

codecomponent

请参阅了解代码组件 Dataverse 实体标记、使用代码组件 Liquid 模板标记。

另请参见

控制流标记
 迭代标记
 变量标记
 Dataverse Liquid 标记
 使用代码组件 Liquid 模板标记

通过