範本標籤
範本標籤負責控制各種方式的範本輸出,並允許結合多個範本進行單次輸出。
fetchxml
允許使用找從 Microsoft Dataverse 查詢資料,並在頁面中呈現結果。
注意
您可以在使用 FetchXML 查詢資料中深入了解如何使用 fetchxml 查詢資料。
{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}
使用 fetchxml 查詢資料時,請確保不要使用自訂關閉標籤。 例如,不要使用 <attribute name="title"/>
而是使用帶有顯式封閉標籤 </attribute>
的 <attribute name="title"></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 標籤支援以下屬性和子項目。
元素/子項目 | 屬性 | 子項目 |
---|---|---|
擷取 | 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 數值 |
數值 |
包括
將某個範本的內容包含在另一個範本中 (依名稱)。 在 Power Pages 中,其他範本的來源通常會是網站範本。 這運算子允許在多個地方重複使用常用的範本片段。
當範本包括在另一個範本中時,被包括的範本將能存取上層範本中定義的任何變數。
{% include 'My Template' %}
另外也可以傳遞任意數目的具名參數至 include 標籤。 這些參數接著定義為所包括範本中的變數。
{% include 'My Template' a:x, b:y %}
block
與 extends 搭配用來提供範本繼承。 請參閱 extends 了解用法。
extends
與 block 標籤搭配用來提供範本繼承。 此運算子允許多個範本使用共用配置,同時覆寫上層配置的特定區域。
在 Power Pages 中,提供給標籤的上層範本名稱通常是指網站範本的名稱。
使用 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 範本標籤。