分享方式:


範本標籤

範本標籤負責控制各種方式的範本輸出,並允許結合多個範本進行單次輸出。

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 範本標籤

另請參閱

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