可用的 Liquid 物件

Liquid 物件包含輸出動態內容至頁面的屬性。 例如，頁面物件擁有名為 title 的屬性，可用來輸出目前頁面的標題。

若要依名稱存取物件屬性，請使用句號 (.)。 若要轉譯範本中物件的屬性，請將它裝合在 {{ and }} 中。

{{ page.title }}

物件的屬性也可以使用字串名稱和 [] 來存取。 這在某些情況下此格式會很實用，例如所需的屬性為動態決定，或在語法中使用句號 (.) 時，屬性名稱包含字元、空格和特殊字元等將無效。

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

以下物件可以在任何範本中的任何地方使用和存取。

ads

啟用廣告的檢索和顯示。

ads 物件可讓您選取特定廣告或廣告位置：

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

廣告屬性

廣告位置屬性

廣告位置屬性

廣告展示位置是一個具有相同通用屬性的資料表物件，具有以下屬性：

廣告屬性

廣告影像屬性

blogs

啟用博客和博客文章的檢索和顯示。

blogs 物件可讓您選取特定部落格或部落格文章。

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

blogs 物件

blogs 物件可讓您存取入口網站上的任何特定部落格，或存取入口網站上的所有部落格文章。

下表說明與 blogs 物件相關的屬性。

{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

blog 物件

blog 物件可讓您使用單一部落格，如此就能存取該部落格的文章。

下表說明與 blog 物件相關的各種屬性。

blogposts 物件

blogposts 物件可讓您存取部落格文章物件的集合。 除了使用 Liquid 篩選進行分頁之外，您還可以排列部落格文章的順序：

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

其他可能選項：

• blogs.posts.all （獲取所有博客文章）
• blogs.posts | from\_index: 0 | take: 2

下表說明與 blogposts 物件相關的各種屬性。

blogpost 物件

指出單一部落格文章。

下表說明與 blogpost 物件相關的各種屬性。

實體

允許您透過識別碼載入任何 Dataverse 資料表。 如果資料表存在，會傳回資料表物件。 如果找不到具有特定識別碼的資料表，會傳回 null。

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Entity

實體物件可讓您存取 Dataverse 表格記錄的屬性。

相關的表格參照

查詢屬性值會做為相關聯表格參考物件傳回，包含下列屬性。

注意

附註是資料表物件，可讓您存取 annotation 記錄的屬性和關聯。 除了資料表物件的所有屬性之外，附註還有下列額外的屬性。

選項組值

選項組/挑選清單屬性值會做為相關聯資料表參考物件傳回，包含下列屬性。

表格權限

資料表權限物件可讓您存取針對資料表彙總的權限判斷提示結果。

自反關聯性

嘗試在實體上載入自反 (亦即自我參考) 關聯性，會做為物件傳回，且包含下列屬性。

entitylist

entitylist 物件用於 Dataverse 資料表標籤中。 它可讓您存取特定清單的所有屬性。

屬性

清單檢視屬性

清單檢視表欄屬性

entityview

entityview 物件是在 entityview 標籤中使用，並且提供存取檢視表中繼資料的方式，以及檢視結果記錄。

屬性

事件

啟用事件的檢索和顯示。 events 物件可讓您選取特定事件或所有事件。

events 物件

events 物件可讓您存取入口網站上的任何特定事件，或存取入口網站上的所有事件 (任何事件)。

events 物件有下列屬性：

event 物件

event 物件可讓您使用單一事件，如此就能存取該事件的排程和出現位置。

event 物件有下列屬性：

eventoccurences 物件

eventoccurrences 物件可讓您存取 event occurrences 物件的集合。 您可以排列物件的出現位置，並指定要擷取該事件的日期範圍，以及使用 Liquid 篩選進行分頁：

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

也可以使用以下選項：

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

下列屬性與 eventoccurrences 物件相關

eventoccurence 物件

代表事件出現單次。 以下是相關屬性：

forloop

包含 for 迴圈區塊內實用的屬性。

法典

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

輸出

This is the first child page!

This is child page number 2.

This is child page number 3.

屬性

forums

啟用論壇和論壇話題的檢索和顯示。 使用 Liquid 呈現論壇資料的功能會延伸至貼文，但為了建立對話的新貼文，您必須使用內建所述功能的 ASP.NET 多步驟表單頁面範本 (例如，預設的「論壇對話」和「論壇貼文」頁面範本)。

forums 物件可讓您選取論壇或論壇執行緒：

<div class=content-panel panel panel-default>

<div class=panel-heading>

<h4>

<span class=fa fa-comments aria-hidden=true></span>

{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}

</h4>

</div>

{% for forum in website.forums %}

<ul class=list-group>

<li class=list-group-item>

<div class=row>

<div class=col-sm-6>

<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>

<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>

</div>

<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>

<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>

</div>

</li>

</ul>

{% endfor %}

</div>

forums 物件

forums 物件可讓您存取入口網站上的任何特定論壇，或存取入口網站上的所有論壇對話 (任何論壇)。

forum 物件可讓您使用單一論壇，如此就能存取該論壇的對話。

forumthreads 物件可讓您存取 forumthread 物件的集合。 您可以排列論壇對話的順序，並使用 Liquid 篩選進行分頁。

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

單一論壇對話

forumthreads 物件可讓您存取 forumthread 物件的集合。

屬性

forum 物件

屬性

forumthreads 物件

屬性

forumthread 物件

屬性

forumposts 物件

屬性

單一論壇貼文

屬性

知識

提供 Dataverse knowledgearticle 和 category 資料表記錄的存取權，以在入口網站中轉譯文章和類別。

屬性

articles 物件

articles 物件可讓您存取 article 物件的集合。 您可以排列文章的順序，並使用 Liquid 篩選進行分頁。

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

屬性

篩選

下列篩選可以接受頁面大小及語言的選用參數。 第一個參數是要擷取的數字或記錄。 預設頁面大小為 5。 第二個參數是擷取特定語言文章的語言代碼。 篩選可結合其他 Liquid 篩選 使用。

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

categories 物件

categories 物件可讓您存取 category 物件的集合。 您可以排列類別的順序，並使用 Liquid 篩選進行分頁。

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

屬性

篩選

下列篩選可以接受指出頁面大小的選用參數。 預設頁面大小為 5。 篩選可結合其他 Liquid 篩選 使用。

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

article 物件

article 物件可讓您使用單一 knowledgearticle 在入口網站顯示該 article 的詳細資料。

屬性

article 是 實體 物件，包含所有相同屬性，除了下列屬性：

category 物件

category 物件可讓您使用單一 category 在入口網站顯示其詳細資料。

屬性

類別是 實體 物件，包含所有相同屬性，除了下列屬性：

語言

提供目前的語言名稱，如果已啟用多語言支援，則提供語言代碼。

屬性

例如，當可使用多個語言時，語言下拉式表單網站範本會預設使用此 Liquid 物件來列出可用語言。

紀錄

製作者能夠將記錄陳述式合併到他們的 Liquid 程式碼中。 當 Power Pages 網站執行時，製作者在 Liquid 程式碼中新增的記錄將顯示在 Power Pages 開發人員工具延伸模組中。 啟用診斷設定時，這些由製作者嵌入的記錄將顯示在開發人員工具延伸模組中。

可以在 Liquid 程式碼中使用以下語法來記錄自訂訊息：

{% log message:'Custom message' level:'Warning' %}

紀錄屬性

範例:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

頁面

是指目前入口網站要求頁面。 此物件結合網站地圖與目前要求的實體 (通常是網頁)。

page 物件提供存取某些項目的方式，像是目前頁面的導覽路徑標示、目前頁面的標題或 URL，以及基礎 Dataverse 記錄的任何其他屬性或相關實體。

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

頁面屬性

polls

啟用民意調查的擷取和顯示。

polls 物件可讓您選取特定輪詢或輪詢位置：

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

輪詢屬性

輪詢位置屬性

輪詢位置屬性

輪詢屬性

輪詢選項屬性

要求

包含有關目前 HTTP 要求的資訊。

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

屬性

searchindex

searchindex 物件是在 Dataverse 資料表標籤中使用，可讓您存取查詢的結果。

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

屬性

搜尋索引結果

設定

可讓您依名稱載入任何網站設定。 如果找不到具有特定名稱的設定，則會傳回 null。

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

網站地圖

允許存取入口網站的網站地圖。

<h1>{{ sitemap.root.title }}</h1>

<ul class=breadcrumb>

{% for crumb in sitemap.current.breadcrumbs %}

<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>

{% endfor %}

<li class=active>{{ sitemap.current.title }}</li>

</ul>

{% for child in sitemap.current.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

It's also possible to load a site map node by URL path:

{% assign node = sitemap[/content/page1/] %}

{% if node %}

{% for child in node.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

{% endif %}

網站地圖屬性

網站地圖節點屬性

sitemarkers

可讓您依名稱載入任何網站標記。 如果網站標記存在，將會傳回 sitemarker 物件。 如果找不到具有特定名稱的網站標記，則會傳回 null。

{{ sitemarkers[Login].url }}

{% assign my_sitemarker = sitemarkers["My Site Marker"] %}

{% if my_sitemarker %}

<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

網站標記屬性

snippets

可讓您依名稱載入任何內容程式碼片段。 如果找不到具有特定名稱的程式碼片段，則會傳回 null。

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

包含反覆項目標籤迴圈區塊內實用的屬性。

屬性

User

是指目前入口網站使用者，允許存取基礎 Dataverse 連絡人記錄的任何屬性。 如果沒有使用者登入，此變數會是 null。

使用者是實體物件。

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

屬性

除了擁有實體物件的所有屬性之外，使用者還有下列屬性。

weblinks

可讓您依名稱或識別碼載入任何網頁連結。

如果網頁連結組存在，網頁連結組物件將會傳回。 若未發現所指名稱或識別碼的網頁連結組，將會傳回 null。

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

網頁連結組屬性

網頁連結屬性

網頁連結影像屬性

網站

是指入口網站的網站，允許存取入口網站的 Dataverse 網站 (adx_website) 記錄的所有屬性。

法典

{{ website.adx_name }} ({{ website.id }})

輸出

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

屬性

下表列出此標記的屬性，此標記可以用來取代預設值，以避免快取。

請參閱

液體類型
Liquid 標籤
液體篩檢程式