Share via

範本標籤

  • 發行項

注意

自 2022 年 10 月 12 日起，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> 的 <attribute name="title"></attribute>。

結果屬性

所提供變數中的結果屬性（例如上例中的 'resultVariable'）保存 FetchXML 查詢結果和其他一些屬性。

  • 實體

    此屬性包含 fetchxml 查詢的結果。 您可以反覆查詢結果，並在 webtemplate 中使用它。

    <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 標籤支援以下屬性和子項目。

元素/子項目 屬性 子項目
擷取 對應
版本
計數
頁面
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 訂單
實體
訂單 屬性
別名
遞減
實體 名稱
all-attributes
no-attrs
屬性		 訂單
篩選器
link-entity
篩選器 類型
hint
isquickfindfields		 條件
篩選器
link-entity 名稱
寄件者
打給
別名
link-type
可見
交集
all-attributes
no-attrs
屬性		 訂單
篩選器
link-entity
條件 資料行
entityname
屬性
運算子
aggregate
別名
uiname
uitype
uihidden
數值		 數值

包括

將某個範本的內容包含在另一個範本中 (依名稱)。 在 Power Apps 入口網站中，另一個範本的來源通常會是網站範本。 這允許在多個地方重複使用常用的範本片段。

當範本包括在另一個範本中時，被包括的範本將能存取上層範本中定義的任何變數。

{% include 'My Template' %}

另外也可以傳遞任意數目的具名參數至 include 標籤。 這些參數會定義為所包括範本中的變數。

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

block

搭配 extends 用來提供範本繼承。 請參閱 extends 了解用法。

extends

搭配 block 標籤用來提供範本繼承。 這允許多個範本使用共用的配置，同時覆寫上層配置的特定區域。

在 Power Apps 入口網站中，提供給標籤的上層範本名稱通常是指網站範本的名稱。

使用 extends 時，它必須是範本中的第一項內容，而且後面只能接著一個或多個 block 標籤。

如果上層範本中定義的 block 未被覆寫，它在上層範本中的內容 (如果有) 將會呈現。

comment

可讓您在 Liquid 範本內留下未轉譯的程式碼。 block 內的任盒內容都不會轉譯，且內含的任何 Liquid 程式碼都不會執行。

代碼

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

輸出

Hello. My name is Charles.

raw

允許在頁面上輸出 Liquid 程式碼，而不將它剖析和執行。

輸出

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

替代

當您啟用頁首和頁尾快取，並想要避免快取某些區段輸出時，您可以使用此標籤。 此標記提供標籤或註腳中的內容塊，包裝的內容塊輸出無法快取。 這在使用者使用可經常更新的物件（如要求、頁面、語言和日期）時相當管用。 例如，當 啟用標題和註腳快取 時，請參考標題與註腳 Web 範本原始程式碼更新案例。

提示

request.url 中使用的 URL 可以是任何要求的值，並進入快取供後續要求使用。 為確保 request.url 的值正確，請考慮使用替代標記、部分 URL (例如 {~WebFile 路徑})，或在網站設定中儲存入口網站 URL。

codecomponent

請參閱瞭解元件 Dataverse 實體標記，使用代碼元件 Liquid 範本標籤。

請參閱

控制流程標籤
反覆項目標籤
變數標籤
Power Apps Dataverse 實體標籤
使用程式碼元件 Liquid 範本標籤

注意

是否能請您告知您偏好的慣用文件語言？ 請填寫問卷。 (請注意，本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。