使用可能な Liquid のオブジェクト

流動オブジェクトは、ページに動的コンテンツを出力するための属性が含まれます。 たとえば、ページ オブジェクトには title という現在のページのタイトルを出力するのに使用できる属性があります。

オブジェクト属性に名前でアクセスするには、ピリオド (.) を使用します。 テンプレートにあるオブジェクトの属性を表示するには、{{ and }} で囲みます。

{{ page.title }}

オブジェクトの属性には、文字列名と [] を使用してアクセスすることもできます。 このフォーマットは、目的の属性が動的に決定される場合や、構文中にピリオド (.) を使用する際に無効になってしまう特定の文字、スペースや特殊文字などが属性の名前に含まれる場合に便利です。

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

次のオブジェクトは、どこでも、どのテンプレートからでも使用およびアクセスできます。

広告

広告の取得と表示を有効にします。

広告オブジェクトにより、特定の広告の選択や、広告の配置の選択ができます。

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

広告の属性

広告の配置属性

広告の配置属性

広告の配置は、同じ全般的な属性と次の属性を持つテーブル オブジェクトです。

広告の属性

広告のイメージ属性

ブログ

ブログとブログ投稿の取得と表示を有効にします。

ブログ オブジェクトにより、特定のブログやブログ投稿を選択できます。

{% 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>

ブログオブジェクト

ブログオブジェクトにより、ポータル内の特定のブログや、ポータル内のすべてのブログ投稿にアクセスできます。

次の表は、ブログ オブジェクトに関連付けられる属性を説明したものです。

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

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

ブログ オブジェクト

ブログ オブジェクトにより、単一のブログを使用できるようになり、そのブログの投稿へアクセスできるようになります。

次の表は、ブログ オブジェクトに関連付けられるさまざまな属性を説明したものです。

ブログ記事オブジェクト

blogposts オブジェクトにより、ブログ記事オブジェクトのコレクションにアクセスできます。 ブログ記事を並べ替えてページ分割を行い、Liquid フィルターを使用することもできます。

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

その他の可能なオプション:

• (すべてのブログ投稿を取得するため)
• blogs.posts | from\_index: 0 | take: 2

次の表は、blogposts オブジェクトに関連付けられるさまざまな属性を説明したものです。

blogpost オブジェクト

単一のブログ記事を参照します。

次の表は、blogpost オブジェクトに関連付けられるさまざまな属性を説明したものです。

エンティティ

ID により Dataverse テーブルを読み込むことができます。 テーブルがある場合は、テーブル オブジェクトが返されます。 指定された ID のテーブルが見つからない場合は、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 %}

エンティティ

エンティティ オブジェクトは、Dataverse のテーブル レコードの属性へのアクセスを提供します。

関連テーブルの参照

検索属性の値は、次の属性を持つ関連付けられたテーブル参照オブジェクトとして返されます。

注意

メモは、コメント レコードの属性および関連付けへのアクセスを提供するテーブル オブジェクトです。 テーブル オブジェクトのすべての属性に加えて、メモには次の他の属性があります。

選択項目セットの値

オプション セット/候補リスト属性の値は、次の属性を持つ関連付けられたテーブル参照オブジェクトとして返されます。

テーブルのアクセス許可

テーブルへのアクセス許可を持つオブジェクトは、テーブルについての集合的なアクセス許可のアサーション結果へのアクセスを提供します。

再帰関係

エンティティ上の再帰的 (自己参照的) 関係を読み込もうとすると、次の属性を持つオブジェクトとして返されます。

エンティティリスト

entitylist オブジェクトは、Dataverse テーブル タグ 内で使用されます。 また、特定のリストのすべての属性へのアクセスを提供します。

属性

リスト ビューの属性

リストビュー列の属性

エンティティビュー

entityview オブジェクトは、entityview タグの内で使用され、ビューのメタデータへのアクセスおよびビューの結果レコードへのアクセスを提供します。

属性

イベント

イベントの取得と表示を有効にします。 イベント オブジェクトにより、特定のイベントやすべてのイベントを選択できます。

イベント オブジェクト

イベント オブジェクトにより、ポータルの任意のイベント、およびポータルのすべてのイベント (イベントに関係なく) にアクセスできます。

イベント オブジェクトには、次の属性があります。

イベント オブジェクト

イベント オブジェクトにより、単一のイベントを使用できるようになり、このイベントのスケジュールやオカレンスにアクセスできるようになります。

イベント オブジェクトには、次の属性があります。

eventoccurences オブジェクト

eventoccurrences オブジェクトにより、イベント オカレンス オブジェクトのコレクションにアクセスできます。 イベントのオカレンスを並べ替え、取得するオカレンスの日付の範囲を指定して改ページを実行し、Liquid フィルターも使用できます。

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

次のオプションも可能です。

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

次の属性は、eventoccurrences オブジェクトに関連付けられます。

eventoccurence オブジェクト

単一のイベントの発生を表します。 関連付けられた属性は次のとおりです:

フォーループ

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.

属性

フォーラム

フォーラムとフォーラム スレッドの取得と表示を有効にします。 リキッドを使用してフォーラムデータをレンダリングする機能は投稿にまで及びますが、新しい投稿やスレッドを作成するには、上記の機能が組み込まれた ASP.NET マルチステップフォームページテンプレート(既定のフォーラムスレッドやフォーラム投稿ページテンプレートなど)を使用する必要があります。

フォーラム オブジェクトでは、次のフォーラムやフォーラム スレッドを選択することができます。

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

フォーラム オブジェクト

フォーラム オブジェクトにより、ポータルの任意のフォーラム、およびポータルのすべてのフォーラム スレッド (フォーラムにかかわらず) にアクセスできます。

フォーラム オブジェクトにより、単一のフォーラムを使用できるようになり、このフォーラムのスレッドへアクセスできるようになります。

forumthreads オブジェクトにより、forumthreads オブジェクトのコレクションにアクセスできます。 Liquid フィルターを使用することでフォーラム スレッドを指定して改ページを実行することもできます。

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

単一のフォーラムスレッド

forumposts オブジェクトにより、forumpost オブジェクトのコレクションにアクセスできます。

属性

掲示板オブジェクト

属性

フォーラムスレッドオブジェクト

属性

フォーラムスレッドオブジェクト

属性

フォーラム投稿オブジェクト

属性

1件のフォーラム投稿

属性

ナレッジ

Dataverse knowledgearticle およびカテゴリ テーブル レコードへのアクセスを提供し、記事およびポータルのカテゴリを表示します。

属性

記事オブジェクト

記事オブジェクトにより、記事オブジェクトのコレクションにアクセスできます。 記事を指定して改ページを実行し、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 です。 2 番目のパラメーターは、特定の言語用の記事を取得する言語のコードです。 フィルターは、他の Liquid フィルター と組み合わせることができます。

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

カテゴリ オブジェクト

カテゴリ オブジェクトにより、カテゴリ オブジェクトのコレクションにアクセスできます。 カテゴリを指定して改ページを実行し、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 %}

記事オブジェクト

記事オブジェクトを使用すると、単一のナレッジ記事を扱い、その記事の詳細をポータルに表示することができます。

属性

記事 エンティティ はエンティティ オブジェクトで、共通の属性の他に、次の属性があります。

カテゴリ オブジェクト

カテゴリ オブジェクトにより、単一のカテゴリを使用してそのポータルでの詳細を表示することができます。

属性

カテゴリはエンティティオブジェクトであり、共通の属性に加えて、次の属性があります。

言語

複数言語のサポート が有効な場合は、現在の言語名と言語コードが表示されます。

属性

たとえば、言語ドロップダウン Web テンプレートは、規定でこの流動オブジェクトを使用して、複数の言語が使用可能な場合に使用可能な言語を一覧表示します。

ログ

作成者は、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 %}

ページ

現在のポータルの要求ページを示します。 このオブジェクトは、サイト マップ の属性と現在の要求 エンティティ (通常は Web ページ) を連結します。

ページ オブジェクトは、現在のページの階層リンク、現在のページのタイトルや 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 }}. -->

ページ属性

ポーリング

アンケートの取得と表示を可能にします。

ポールオブジェクトを使用すると、特定の投票または投票の配置を選択できます。

<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 オブジェクトは 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 %}

サイト マップ属性

サイト マップ ノード属性

サイトマーカー

名前で任意のサイトマーカーを読み込むことができます。 sitemarker がある場合は、sitemarker オブジェクトが返されます。 指定された名前の 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 %}

サイトマーカー属性

スニペット

名前によってコンテンツ スニペットを読み込むことができます。 指定された名前のスニペットが見つからない場合は、null が返されます。

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

反復タグ ループ ブロック内で役立つプロパティを含みます。

属性

ユーザー

ポータルの現在のユーザーを参照するもので、基になる Dataverse 担当者レコードのすべての属性にアクセスすることができます。 サインインしているユーザーがいない場合、この変数は null です。

ユーザーはエンティティ オブジェクトです。

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

属性

エンティティ オブジェクトのすべての属性に加えて、ユーザーには次の属性もあります。

Web リンク

名前または ID で任意の Web リンク を読み取ることができます。

Web リンク セットが存在する場合、Web リンク セット オブジェクトが返されます。 指定された名前や ID の Web リンク セットが見つからない場合、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 %}

ウェブリンクセット属性

Web リンクの属性

Web リンク画像の属性

Web サイト

ポータルの Web サイトを参照するもので、ポータルの Dataverse Web サイト (adx_website) レコードのすべての属性にアクセスすることができます。

コード

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

出力

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

属性

次の表に、キャッシュを回避するために規定の代わりに使用できるこのタグの属性を示します。

関連項目

Liquid の種類
Liquid タグ
液体フィルター