使用可能な Liquid のオブジェクト
注意
2022 年 10 月 12 日より、Power Apps ポータルは Power Pages となります。 詳細: Microsoft Power Pages の一般提供が開始されました (ブログ)
Power Apps ポータルのドキュメントは、近日中に Power Pages ドキュメントに移行、統合されます。
流動オブジェクトは、ページに動的コンテンツを出力するための属性が含まれます。 たとえば、ページ オブジェクトには title という現在のページのタイトルを出力するのに使用できる属性があります。
オブジェクト属性に名前でアクセスするには、ピリオド (.) を使用します。 テンプレートにあるオブジェクトの属性を表示するには、{{ and }} で囲みます。
重要
潜在的なクロスサイト スクリプティング (XSS) の問題を回避するには、常に エスケープ フィルター を用いて、ユーザーから提供された信頼できないデータを読み取る場合は常に Liquid オブジェクトを使用してデータを HTML エンコードします。
{{ page.title }}
オブジェクトの属性には、文字列名を使用して [] でアクセスすることもできます。 このフォーマットは、目的の属性が動的に決定される場合や、構文中にピリオド (.) を使用する際に無効になってしまう特定の文字、スペースや特殊文字などが属性の名前に含まれる場合に便利です。
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
次のオブジェクトは、どこでも、どのテンプレートからでも使用およびアクセスできます。
| オブジェクト | 内容 |
|---|---|
| entities | ID により Power Apps テーブルを読み込むことができます。 詳細情報: エンティティ |
| 今すぐ | 現在の UTC 時間を示す日時のオブジェクト。テンプレートの表示時点です。 メモ: この値は、ポータル Web アプリでキャッシュされており、毎回更新されるわけではありません。 詳細情報: 日付フィルター |
| ページ | 現在のポータルの要求ページを示します。 ページ オブジェクトは、現在のページの階層リンク、現在のページのタイトルや URL、および基になる Power Apps レコードのそのほかの属性や関連エンティティにアクセスする方法を提供します。 詳細情報: ページ |
| パラメーター | 要求パラメーターの便利なショートカット。 詳細情報: 要求 |
| 要求 | 現在の HTTP 要求に関する情報が含まれます。 詳細情報: 要求 |
| 設定 | 名前別にすべてのサイト設定を読み取ることができます。 詳細情報: 設定 |
| サイト マップ | ポータル サイト マップへのアクセスを許可します。 詳細情報: サイトマップ |
| サイト マーカー | 名前別にすべてのサイト マーカーを読み取ることができます。 詳細情報: サイトマーカー |
| スニペット | 名前によってコンテンツ スニペットを読み取ることができます。 詳細情報: スニペット |
| ユーザー | ポータルの現在のユーザーを参照するもので、基になる Power Apps 担当者レコードのすべての属性にアクセスすることができます。 サインインしているユーザーがいない場合、この変数は null になります。 詳細情報: ユーザー |
| Web リンク | 名前または ID を指定して、任意の Web リンクのセットを読み取ることができます。 詳細情報: Web リンク |
| Web サイト | ポータルの Web サイト レコードを参照するもので、ポータルの Power Apps Web サイト (adx_website) レコードのすべての属性にアクセスすることができます。 詳細情報: Web サイト |
広告
広告へのアクセスおよび表示の機能を提供します。
広告オブジェクトにより、特定の広告の選択や、広告の配置の選択ができます。
<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>
広告の属性
| 属性 | 内容 |
|---|---|
| 配置 | adplacements (広告の配置) オブジェクトを返します。 |
| [広告の名前または ID] | 名前または ID プロパティで、任意の広告にアクセスできます。 {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
広告の配置属性
| 属性 | 内容 |
|---|---|
| [広告の配置の名前または ID] | 名前または ID プロパティで、任意の adplacement (広告の配置) にアクセスできます。{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
広告の配置属性
広告の配置は、同じ全般的な属性と以下にリストされている属性を持つテーブル オブジェクトです。
| 属性 | 内容 |
|---|---|
| 広告 | 配置に関連付けられる広告オブジェクトのコレクションが返されます。 反復タグおよび配列フィルターがこのコレクションに使用される場合があります。 |
| 件名 | 広告の配置の名前フィールドを返します。 |
| placement_url | 広告の配置を取得するのに使用できる URL は、テンプレートによって完全に表示されます。 |
| random_url | テンプレートによって完全に表示された配置からランダムな広告を取得するのに使用できる URL。 |
広告の属性
注意
広告はテーブル オブジェクトで、共通の属性の他に、次に示す属性があります。
| 属性 | 内容 |
|---|---|
| ad_url | テンプレートによって完全に表示された広告を取得するのに使用できる URL。 |
| コピー | 広告の [コピー] フィールドを返します。 |
| 画像 | 広告の画像オブジェクト (ある場合) が返されます。 |
| 件名 | 広告の [名前] フィールドを返します。 |
| open_in_new_window | redirect_url で指定された URL が新しいウィンドウを開く場合は true を返します。 |
| redirect_url | 広告を選択することによりユーザーが誘導される URL。 |
広告のイメージ属性
| 属性 | 内容 |
|---|---|
| alternate_text | タグの alt 属性に表示されるように意図されたテキストを返します。 |
| 高さ | 画像の高さをピクセルで返します。 |
| URL | 画像の URL ソースを返します。 |
| 幅 | 画像の幅をピクセルで返します。 |
ブログ
ブログおよびブログ記事へアクセスして表示する機能を提供します。
ブログ オブジェクトにより、特定のブログやブログ投稿を選択できます。
{% 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
ブログ オブジェクト
ブログのオブジェクトにより、ポータルの任意のブログ、またはポータルのすべてのブログ記事 (ブログに関係なく) にアクセスできます。
次の表は、ブログ オブジェクトに関連付けられる属性を説明したものです。
| 属性 | 内容 |
|---|---|
| 投稿 | ポータルのすべてのブログ投稿を格納する blogposts オブジェクトを返します。 |
| [ブログの名前または ID] | 名前または ID プロパティで、任意のブログにアクセスできます。 |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
ブログ オブジェクト
ブログ オブジェクトにより、単一のブログを使用できるようになり、そのブログの投稿へアクセスできるようになります。
次の表は、ブログ オブジェクトに関連付けられるさまざまな属性を説明したものです。
| 属性 | 内容 |
|---|---|
| 投稿 | ブログのすべてのブログ投稿を格納する blogposts オブジェクトを返します。 |
| 件名 | ブログの名前です。 |
| タイトル | ブログのタイトルです。 |
| URL | ブログの URL です。 |
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 オブジェクト
単一のブログ記事を参照します。
次の表は、blogpost オブジェクトに関連付けられるさまざまな属性を説明したものです。
| 属性 | 内容 |
|---|---|
| url | 投稿の URL です。 |
| コンテンツ | 投稿のコンテンツ フィールドを返します。 |
| author | 投稿 (単純に取引先担当者テーブル オブジェクト) の作成者を返します。 |
| タイトル | 投稿のタイトルです。 |
| comment_count | 特定の投稿のコメント数の整数値を返します。 |
| publish_date | 投稿が公開された日付。 |
entities
注意事項
潜在的なクロスサイト スクリプティング (XSS) の問題を回避するには、エンティティ の液体オブジェクトを使用するたびに信頼できないユーザーから提供されたデータを読み取るために、常に エスケープ フィルター を使用して文字列データを HTML エンコードします。
注意
Dataverse の名前付け規則の一部が変更されています。たとえば、 Dataverse エンティティは tables と呼ばれています。 名前の変更は、Liquid オブジェクトには適用されません。 Liquid エンティティのオブジェクトは、引き続きエンティティとして参照されます。
ID により Power Apps テーブルを読み込むことができます。 テーブルがある場合は、テーブル オブジェクトが返されます。 指定された 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 %}
Entity
エンティティ オブジェクトは、Power Apps のテーブル レコードの属性へのアクセスを提供します。
| 属性 | 内容 |
|---|---|
| ID | テーブルの GUID ID、文字列。 たとえば、936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | テーブルの Power Apps 論理名です。 |
| メモ | テーブルに関連付けられている任意のメモ (コメント) を読み込み、最も古いほうから新しいほうに順に並び替えられます (createdon)。 メモは、メモ オブジェクトとして返されます。 |
| アクセス許可 | テーブルについてのテーブルのアクセス権のアサーション結果を読み込みます。 結果は、アクセス許可オブジェクトとして返されます。 |
| URL | テーブルの Power Apps ポータルのコンテンツ管理システム URL のパスを返します。 テーブルに現在の Web サイトで有効な URL がない場合、null が返されます。 通常これは、アプリケーションで URL プロバイダーをカスタマイズしていない限り、ポータル CMS に統合されている特定のテーブルの種類についての値のみを返します。 |
| [属性または関連付けの名前] | 論理名で Power Apps テーブルの任意の属性にアクセスできます。 {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} ほとんどのテーブル属性の値は、直接Liquid の種類 にマッピングされます。2 値のオプション フィールドがブール値、テキスト フィールドが文字列、数値/通貨フィールドが数字、日付/時刻フィールドが日付オブジェクトにマッピングされます。 ただし、一部の属性の種類はオブジェクトとして返されます。
{{ page.adx_webpage_entitylist.adx_name }}関連付けが再帰 (すなわち自己参照) の場合、再帰関係オブジェクトが返されます。 (それ以外の場合、結果は曖昧になります){{ page.adx_webpage_webpage.referencing.adx_name }} メモ: 大量の関連エンティティを読み込む場合や、単一のテンプレートで大量の関連付けにアクセスする場合、テンプレートの表示パフォーマンスに悪い影響を与える可能性があります。 ループ内で、配列の各要素について関連するエンティティの読み込みを避けます。 可能な場合、エンティティのコレクションを読み込むために、Dataverse テーブル タグ を使用します。 |
関連付けられたテーブル参照
検索属性の値は、次の属性を持つ関連付けられたテーブル参照オブジェクトとして返されます。
| 属性 | 内容 |
|---|---|
| ID | 文字列としての、参照されたテーブルの GUID ID。 たとえば、936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | 参照テーブルの Power Apps 論理名。 |
| 件名 | 参照先テーブルのプライマリ名属性。 |
メモ
メモは、コメント レコードの属性および関連付けへのアクセスを提供するテーブル オブジェクトです。 テーブル オブジェクトのすべての属性に加えて、メモには次の追加の属性があります。
| 属性 | 内容 |
|---|---|
| documentbody | メモ コメント レコードの documentbody 属性を、Base64 エンコードされた文字列として読み込みます。 この属性のコンテンツは長い可能性があるため、メモのほかの属性と同様には読み込まれず、オンデマンドでのみ読み込まれます。 メモ: documentbody 属性を使用すると、テンプレートの表示パフォーマンスに悪い影響がある場合があるため、注意して使用する必要があります。 url 属性を使用すると、可能な場合、かわりにメモの添付ファイルへのリンクを提供します。 |
| url | 組み込みのポータル用コメント添付ファイル ハンドラーの URL パスを返します。 ユーザーにアクセス許可があり、メモに添付ファイルがある場合は、この URL へのリクエストはメモの添付ファイルのダウンロードになります。 |
注意
オプション セット値
オプション セット/候補リスト属性の値は、次の属性を持つ関連付けられたテーブル参照オブジェクトとして返されます。
| 属性 | 内容 |
|---|---|
| ラベル | オプション セット/候補リスト属性の値のローカライズされたラベル。 たとえば、アクティブです。 |
| Value | オプション セット/候補リスト属性の値の整数値。 たとえば、0 です。 |
テーブルのアクセス許可
テーブルへのアクセス許可を持つオブジェクトは、テーブルについての集合的なアクセス許可のアサーション結果へのアクセスを提供します。
| 属性 | 内容 |
|---|---|
| can_append | 現在のユーザーがこのレコードの関連付けにレコードを追加するアクセス許可を持つ場合、true が返されます。 それ以外の場合は、false を返します。 |
| can_append_to | 現在のユーザーがほかのテーブルの関連付けにこのレコードを追加するアクセス許可を持つ場合、true が返されます。 それ以外の場合は、false を返します。 |
| can_create | 現在のユーザーがこのテーブルの種類の新しいレコードを作成するアクセス許可を持つ場合、true が返されます。 それ以外の場合は、false を返します。 |
| can_delete | 現在のユーザーがこのレコードを削除するアクセス許可を持つ場合、true が返されます。 それ以外の場合は、false を返します。 |
| can_read | 現在のユーザーがこのレコードを読み取るアクセス許可を持つ場合、true が返されます。 それ以外の場合は、false を返します。 |
| can_write | 現在のユーザーがこのレコードを更新するアクセス許可を持つ場合、true が返されます。 それ以外の場合は、false を返します。 |
| rules_exist | このオブジェクトが表すアクセス許可の結果が、明示的に定義されたアクセス許可のルールである場合、true が返されます。 これらが明示的に定義されたアクセス許可がないときの既定の結果の場合、false が返されます。 |
再帰関係
次の属性を持つオブジェクトとして返されるエンティティについて、再帰関係 (自己参照など) を読み込みしようとします。
| 属性 | 内容 |
|---|---|
| is_reflexive | true を返します。 関係から返されたオブジェクトが再帰関係オブジェクトかどうかをテストする場合に使用できます。 |
| 参照先 | 指定の関係について、参照先エンティティの配列として返します。 |
| 参照元 | 指定の関係について、参照元テーブルの配列を返します。 参照元テーブルが存在しない場合、null を返します。 関連付けが多対多 (N:N) の場合、参照元エンティティの配列を返します。 |
entitylist
entitylist オブジェクトは、Power Apps Dataverse テーブル タグ 内で使用されます。 また、特定のリストのすべての属性へのアクセスを提供します。
属性
注意
| 属性 | 内容 |
|---|---|
| create_enabled | リストの新規レコードが作成できるよう構成されている場合は、true を返します。 それ以外の場合は、false を返します。 |
| create_url | リストのリンク/ボタン作成用に構成された URL パスを返します。 |
| detail_enabled | リストの個々のレコードを詳細表示できるよう構成されている場合は、true を返します。 それ以外の場合は、false を返します。 |
| detail_id_parameter | レコードの詳細表示の URL 構築の際に、レコード ID に使用するクエリ文字列のパラメーター名を返します。 URL の構築に Liquid フィルターを使用する場合の詳細については、URL フィルターを参照してください。 例えば、id です。 |
| detail_label | リスト用に構成されたローカライズ済みの詳細表示のリンク/ボタンのラベルを返します。 |
| detail_url | リスト用に構成された詳細表示のリンク/ボタンの URL パスを返します。 |
| empty_list_text | リストのビューが何も結果を返さない場合に表示される構成されたローカライズ済のテキストを返します。 |
| enable_entity_permissions | テーブルのアクセス許可フィルターがリストに対して有効化されている場合、true を返します。 それ以外の場合は、false を返します。 |
| entity_logical_name | このリストによって表示されるレコードの Power Apps テーブル論理名を返します。 たとえば、取引先担当者 |
| filter_account_attribute_name | 現在のポータル ユーザーの取引先企業の親会社により結果のレコードをフィルター処理するために使用されるアカウントを検索するための属性論理名を返します。 たとえば、accountid です。 |
| filter_apply_label | リストの結果に高度な属性フィルター処理を適用するリンク/ボタンに対して使用される構成済されたローカライズ済みのラベルを返します。 |
| filter_definition | リストに対する JSON 属性フィルターの定義を返します。 この定義を処理するための metafilters Liquid フィルターの使用方法についての詳細は、リスト フィルター を参照してください。 |
| filter_enabled | リストに対して高度な属性フィルター処理が有効化されている場合は、true を返します。 それ以外の場合は、false を返します。 |
| filter_portal_user_attribute_name | 現在のポータル ユーザーの取引先担当者によって結果のレコードをフィルター処理するために使用される取引先担当者を検索するための属性論理名を返します。 たとえば、contactid です。 |
| filter_website_attribute_name | 現在のポータル Web サイトによって結果のレコードをフィルター処理するために使用される adx_website を検索するための属性論理名を返します。 例: adx_websiteid |
| language_code | このリスト用にローカライズされたすべてのラベルを選択するために使用される Power Apps 整数言語コードを返します。 |
| page_size | このリストに対して構成された結果のページ サイズを返します。 |
| primary_key_name | このリストによって表示されるレコードの主キーの属性論理名を返します。 |
| search_enabled | このリストの検索が有効化されている場合、true を返します。 それ以外の場合は、false を返します。 |
| search_placeholder | リストの検索フィールドのプレースホルダー用に構成されたローカライズ済みのテキストを返します。 |
| search_tooltip | リストの検索ツールヒント用に構成されたローカライズ済みのテキストを返します。 |
| ビュー | リストが使用できるビューを、リストのビュー オブジェクトとして返します。 |
| [属性論理名] | テーブル オブジェクトと同じように、論理名によってリスト (adx_entitylist) Power Apps レコードのすべての属性にアクセスすることができます。 たとえば、 {{ entitylist.adx_name }} |
リスト ビューの属性
| 属性 | 内容 |
|---|---|
| 列 | リスト ビューの列オブジェクトとしてビューの列を返します。 |
| entity_logical_name | ビューに含まれるレコードの Power Apps テーブル論理名を返します。 たとえば、取引先担当者 |
| ID | ビューの GUID ID を返します。 |
| language_code | ビュー用のローカライズされたすべてのラベル (列のヘッダーなど) を選択するために使用される Power Apps 整数言語コードを返します。 |
| 件名 | ビューの Power Apps 表示名を返します。 |
| primary_key_logical_name | ビューに含まれるレコードの Power Apps テーブルの主キーの論理名を返します。 たとえば、contactid です。 |
| sort_expression | ビューの既定の並べ替え式を返します。 例: name ASC、createdon DESC |
リスト ビューの列属性
| 属性 | 内容 |
|---|---|
| attribute_type | 列の Power Apps 属性種類名を文字列として返します。 例: 検索、候補リスト、文字列、ブール値、日時 |
| logical_name | 列の Power Apps 属性論理名を返します。 例: createdon |
| Name | 列のローカライズ済みの Power Apps 表示名を返します。 例: Created On |
| sort_ascending | 列を昇順に並べ替えるための並べ替え式の文字列を返します。 例: createdon ASC |
| sort_descending | 列を降順に並べ替えるための並べ替え式の文字列を返します。 例: createdon DESC |
| sort_disabled | 列の並べ替えが無効化されている場合は、true を返します。 それ以外の場合は、false を返します。 |
| sort_enabled | 列の並べ替えが有効化されている場合は、true を返します。 それ以外の場合は、false を返します。 |
| 幅 | 列の構成済みの幅をピクセル単位で返します。 |
エンティティビュー
entityview オブジェクトは、entityview タグの内で使用され、ビューのメタデータへのアクセスおよびビューの結果レコードへのアクセスを提供します。
属性
| 属性 | 内容 |
|---|---|
| 列 | テーブル ビューの列オブジェクト として、ビューの列を返します。 |
| entity_permission_denied | 現在のユーザーについてテーブルのアクセス許可が不足しているためにビューの結果へのアクセスが拒否された場合、true を返します。 ビューの結果に対する読み取りアクセス権が許可された場合、false を返します。 |
| entity_logical_name | ビューの結果レコードの Power Apps テーブルの論理名。 たとえば、取引先担当者 |
| first_page | ビューの結果の最初のページのページ番号。 結果が返されなかった場合は null になり、それ以外の場合は 1 になります。 |
| ID | この entityview を定義する Power Apps ビューの GUID ID。 |
| language_code | 現在のビューにローカライズされたラベルを読み込むのに使用されている Power Apps の整数の言語コード。 |
| last_page | ビューの結果の最後のページのページ番号。 結果が返されなかった場合、これは null になります。 |
| 名前 | この entityview を定義する Power Apps ビューの名前。たとえば、アクティブな取引先担当者。 |
| next_page | ビューの結果の次のページのページ番号。 結果の次のページがない場合、これは null になります。 |
| ページ | ビューの結果の現在のページのページ番号。 |
| ページ | 現在のビューのすべての結果ページを含むページ番号の配列を返します。 |
| page_size | 現在のビューのページあたりの返される結果数。 |
| previous_page | ビューの結果の次のページのページ番号。 結果の前のページがない場合、これは null になります。 |
| primary_key_logical_name | このビューの結果テーブルの主キー属性の Power Apps 論理名。 たとえば、contactid。 |
| レコード | テーブル オブジェクトとして、ビューの結果レコードの現在のページ。 |
| sort_expression | ビューの既定の並べ替え用の式。 たとえば、nameASC、createdon DESC。 |
| total_pages | ビューの結果ページの総数。 |
| total_records | ビューの結果の総数 (すべてのページ中)。 |
イベント
イベントにアクセスおよび表示する機能があります。 イベント オブジェクトにより、特定のイベントやすべてのイベントを選択できます。
イベント オブジェクト
イベント オブジェクトにより、ポータルの任意のイベント、およびポータルのすべてのイベント (イベントに関係なく) にアクセスできます。
イベント オブジェクトには、次の属性があります。
| 属性 | 内容 |
|---|---|
| オカレンス | ポータルのすべてのイベントのオカレンスを格納する eventoccurancessobject を返します。 |
| [イベントの名前または ID] | 名前または ID プロパティで、任意のイベントにアクセスできます。 {% assign event = events["イベント名"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
イベント オブジェクト
イベント オブジェクトにより、単一のイベントを使用できるようになり、このイベントのスケジュールやオカレンスにアクセスできるようになります。
イベント オブジェクトには、次の属性があります。
| 属性 | 内容 |
|---|---|
| 発生回数 | イベントのすべてのオカレンスを格納する eventoccurancessobject を返します。 |
| 名前 | イベントの名前です。 |
| url | イベントの URL。 |
eventoccurences オブジェクト
eventoccurrences オブジェクトにより、イベント オカレンス オブジェクトのコレクションにアクセスできます。 イベントのオカレンスを並べ替え、取得するオカレンスの日付の範囲を指定して改ページを実行し、Liquid フィルターも使用できます。
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
次の点に注意
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
も実行可能です。
次の属性は、eventoccurrences オブジェクトに関連付けられます。
| 属性 | 内容 |
|---|---|
| すべて | コレクションのすべての eventoccurance オブジェクトを返します。 |
eventoccurence オブジェクト
単一のイベントのオカレンスを表します。 以下に、関連付けられた属性を表示します。
| 属性 | 内容 |
|---|---|
| url | オカレンスの URL。 |
| is_all_day_event | これは終日のイベントですか。 |
| start_time | イベントの開始時刻です。 |
| end_time | イベントの終了時刻です。 |
forloop
for ループ ブロック内で役立つプロパティを含みます。
注意
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.
属性
| 属性 | 説明 |
|---|---|
| 第 1 | ループの最初の繰り返しの場合、true を返します。 ループの最初の繰り返しでない場合、false を返します。 |
| インデックス | 最初のアイテムの場所を 1 としたときの、コレクション内で現在の項目がある位置。 |
| index0 | 最初のアイテムの場所を 0 としたときの、コレクション内で現在の項目がある位置。 |
| 最終 | ループの最後の繰り返しの場合、true を返します。 ループの最後の繰り返しでない場合、false を返します。 |
| 長さ | ループに対して同じ操作を繰り返す数 ߝ コレクション内の繰り返す項目の数を返します。 |
| rindex | 最後の項目のインデックスを 1 としたときの、ループ内の残りの項目の数 (長さ - インデックス)。 |
| rindex0 | 最後の項目のインデックスを 0 としたときの、ループ内の残りの項目の数 (長さ - インデックス)。 |
フォーラム
フォーラムおよびフォーラム スレッドへアクセスして表示する機能を提供します。 なお、フォーラム データの表示に流動を使用する機能は投稿を拡張しますが、新しい投稿またはスレッドを作成するには、前述の組み込み機能 (既定のフォーラム スレッドおよびフォーラム投稿ページ テンプレートなど) のある 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 オブジェクトのコレクションにアクセスできます。
属性
| 属性 | 内容 |
|---|---|
| スレッド | ポータルのすべての forumthread オブジェクトを格納する forumthreads オブジェクトを返します。 |
| すべて | ポータルのすべてのフォーラム オブジェクトを返します。 なお、Web サイト フォーラムも同等です。 |
| thread_count | Web サイト全体にあるスレッド数の整数値を返します。 |
| post_count | ポータルの投稿の合計数の整数値を返します。 |
| [フォーラムの名前または ID] | 名前または ID プロパティで、任意のフォーラムにアクセスできます。 `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
フォーラム オブジェクト
属性
注意
| Attribute | Description |
|---|---|
| スレッド | フォーラムのすべてのフォーラム スレッドを含む forumthreads オブジェクトを返します。 |
| 件名 | フォーラムの名前。 |
| thread_count | フォーラムにあるスレッド数の整数値を返します。 |
| post_count | フォーラム全体にある投稿数の整数値を返します。 |
forumthreads オブジェクト
属性
| 属性 | 内容 |
|---|---|
| すべて | コレクションのすべての forumthread オブジェクトを返します。 |
forumthread オブジェクト
属性
注意
| 属性 | 内容 |
|---|---|
| 投稿 | スレッドへのすべてのフォーラム投稿を含む forumposts オブジェクトを返します。 |
| 作成者 | スレッド (単純に取引先担当者テーブル オブジェクト) の作成者を返します。 |
| latest_post | スレッドの最後の投稿を返します。 |
| first_post | スレッドの最初の投稿を返します。 |
| post_count | スレッドにある投稿数の整数値を返します。 |
| is_answered | このスレッドに、回答できますか、できませんか。 |
| is_sticky | このスレッドは難しいスレッドですか。 |
forumposts オブジェクト
属性
| 属性 | 内容 |
|---|---|
| すべて | コレクションのすべての forumthread オブジェクトを返します。 |
シングル フォーラム投稿
属性
注意
| 属性 | 内容 |
|---|---|
| 作成者 | 投稿 (単純に取引先担当者テーブル オブジェクト) の作成者を返します。 |
| content | 投稿の内容。 |
| is_answer | この投稿はスレッドへの回答ですか。 |
サポート情報
Power Apps knowledgearticle およびカテゴリ テーブル レコードへのアクセスを提供し、記事およびポータルのカテゴリを表示します。
属性
| 属性 | 内容 |
|---|---|
| 記事 | ポータルで使用可能な 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 %}
属性
| 属性 | 内容 |
|---|---|
| 人気 | 一番多いビューを含む記事オブジェクトのコレクションを返します。 {% assign popular_articles = knowledge.articles.popular %} |
| 最新 | 最新の変更日を含む記事オブジェクトのコレクションを返します。 {% assign recent_articles = knowledge.articles.recent %} |
| 上位 | 最高評価を含む記事オブジェクトのコレクションを返します。 {% assign top_articles = knowledge.articles.top %} |
フィルター
以下のフィルターは、ページ サイズと言語のオプション パラメーターを受け取ることができます。 最初のパラメーターは、取得する数またはレコードです。 既定のページ サイズは 5 です。 2 番目のパラメーターは、特定の言語用の記事を取得する言語のコードです。 フィルターは、他の Liquid フィルター と組み合わせることができます。
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| 属性 | 内容 |
|---|---|
| 人気 | 一番多いビューを含む記事オブジェクトのコレクションを返します。 {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
| 最新 | 最新の変更日を含む記事オブジェクトのコレクションを返します。 {% assign recent_articles = knowledge.articles \| recent: 5 %} |
| 上位 | 最高評価を含む記事オブジェクトのコレクションを返します。 {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
カテゴリ オブジェクト
カテゴリ オブジェクトにより、カテゴリ オブジェクトのコレクションにアクセスできます。 カテゴリを指定して改ページを実行し、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 %}
属性
| 属性 | 内容 |
|---|---|
| 最新 | 最新の変更日を含むカテゴリ オブジェクトのコレクションを返します。 |
| top_level | 親カテゴリを持たないカテゴリ オブジェクトのコレクションを返します。 |
フィルター
以下のフィルターは、ページ サイズを示すオプション パラメーターを受け取ることができます。 既定のページ サイズは 5 です。 フィルターは、他の Liquid フィルター と組み合わせることができます。
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| 属性 | 内容 |
|---|---|
| 最新 | 最新の変更日を含むカテゴリ オブジェクトのコレクションを返します。 パラメーター{% assign recent_categories = knowledge.categories \| recent: 10 %}を指定できます |
| top_level | 親カテゴリを持たないカテゴリ オブジェクトのコレクションを返します。 {% assign root_categories = knowledge.categories \| top_level %} |
記事オブジェクト
記事オブジェクトにより、単一の knowledgearticle を使用してそのポータルの記事の詳細を表示することができます。
属性
記事 エンティティ はエンティティ オブジェクトで、共通の属性の他に、次に示す属性があります。
| 属性 | 内容 |
|---|---|
| article_public_number | 記事の記事のパブリック番号。 |
| comment_count | 特定の記事のコメント数の整数値。 |
| 内容 | 記事の内容。 |
| current_user_can_comment | 現在のユーザーが記事にコメントを追加できるかどうかを示すブール値を返します。 |
| is_rating_enabled | 記事の評価が有効かどうかを示すブール値を返します。 |
| キーワード | 記事のキーワード。 |
| 名前 | 記事のタイトルの代替エイリアス。 |
| 評価 | 記事の 10 進数評価値。 |
| タイトル | 記事のタイトル。 |
| view_count | 記事が表示された回数の整数値。 |
カテゴリ オブジェクト
カテゴリ オブジェクトにより、単一のカテゴリを使用してそのポータルでの詳細を表示することができます。
属性
カテゴリは エンティティ エンティティ オブジェクトで、共通の属性の他に、次に示す属性があります。
| 属性 | 内容 |
|---|---|
| categorynumber | カテゴリのカテゴリ ナンバー。 |
| 名前 | カテゴリのタイトルの代替エイリアス。 |
| タイトル | カテゴリのタイトル。 |
言語
多言語サポート が有効になっている場合、現在の言語名と、次の場合は言語コードを提供します。
属性
| 属性 | 内容 |
|---|---|
| URL | 現在の言語コードのプレフィックスが付いた現在のリクエスト URL。 |
| url_substitution | ページ出力キャッシュをバイパスする現在の言語コードが先頭についた現在のリクエスト URL。 |
| 名前 | 現在の言語のタイトル。 |
| コード | 言語の言語コードです。 |
たとえば、言語ドロップダウン Web テンプレートは、規定でこの流動オブジェクトを使用して、複数の言語が使用可能な場合に使用可能な言語を一覧表示します。
ページ
現在のポータルの要求ページを示します。 このオブジェクトは、サイト マップ の属性と現在の要求 エンティティ (通常は Web ページ) を連結します。
ページ オブジェクトは、現在のページの階層リンク、現在のページのタイトルや URL、および基になる Power Apps レコードのそのほかの属性や関連エンティティにアクセスする方法を提供します。
<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 }}. -->
ページ属性
注意
| 属性 | 内容 |
|---|---|
| 階層リンク | サイト マップ ルート ノードから始まり親で終わる、ページの階層リンク サイト マップ ノード オブジェクトが返されます。 |
| 子 | ページの子サイト マップ ノード オブジェクトを返します。 |
| 上位 | ページの親サイト マップ ノードを返します。 ページがホーム ページの場合、親は null になります。 |
| タイトル | ページのタイトル。 |
| url | ページの URL。 |
| [属性または関連付けの名前] | 論理名で、ページの基になる Power Apps レコードの属性にアクセスできます。{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}ほとんどのテーブル属性の値は、直接Liquid の種類 にマッピングされます。2 値のオプション フィールドがブール値、テキスト フィールドが文字列、数値/通貨フィールドが数字、日付/時刻フィールドが日付オブジェクトにマッピングされます。 ただし、一部の属性の種類はオブジェクトとして返されます。
{{ page.adx_webpage_entitylist.adx_name }}関連付けが再帰 (すなわち自己参照) の場合、エンティティ オブジェクトが返されます。 (それ以外の場合、結果は曖昧になります) {{ page.adx_webpage_webpage.referencing.adx_name }} メモ: 大量の関連エンティティを読み込む場合や、単一のテンプレートで大量の関連付けにアクセスする場合、テンプレートの表示パフォーマンスに悪い影響を与える可能性があります。 ループ内で、配列の各要素について関連するエンティティの読み込みを避けます。 可能な場合、Power Apps Dataverse テーブル タグ を使用してエンティティのコレクションを読み込むことをお勧めします。 |
ポーリング
ポーリングにアクセスおよび表示する機能があります。
ポーリング オブジェクトにより、特定のポーリングやポーリングの配置を選択できます。
<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>
ポーリング属性
| 属性 | 内容 |
|---|---|
| 配置 | ポーリングの配置オブジェクトを返します。 |
| [ポーリングの名前または ID] | 名前または ID プロパティで、任意のポーリングにアクセスできます。 {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
ポーリングの配置属性
| 属性 | 内容 |
|---|---|
| [ポーリングの配置の名前または ID] | 名前または ID プロパティで、任意のポーリングの配置にアクセスできます。{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
ポーリングの配置属性
注意
| 属性 | 内容 |
|---|---|
| 件名 | ポーリングの配置の名前フィールドを返します。 |
| placement_url | ポーリングの配置を取得するのに使用できる URL は、テンプレートによって完全に表示されます。 |
| ポーリング | 配置に関連付けられるポーリング オブジェクトのコレクションが返されます。 反復タグおよび配列フィルターがこのコレクションに使用される場合があります。 |
| random_url | 配置からランダムなポーリングを取得するのに使用できる URL は、テンプレートによって完全に表示されます。 |
| submit_url | 完了したポーリングへの URL が送信されます。 |
ポーリング属性
注意
| 属性 | 内容 |
|---|---|
| has_user_voted | 現在のユーザー (サインインしているか、または匿名) がすでにこのポーリングで投票している場合は、true を返します。 |
| Name | ポーリングの名前フィールドを返します。 |
| オプション | ポーリングに関連付けられるポーリング オプション オブジェクトのコレクションを返します。 反復タグ と エンティティ がこのコレクションに使用される場合があります。 |
| poll_url | ポーリングを取得するのに使用できる URL は、テンプレートによって完全に表示されます。 |
| 質問 | ポーリングの質問フィールドを返します。 |
| submit_button_label | ポーリングの送信ボタンのラベルのオーバーライドに使用できる文字列を返します。 |
| submit_url | 完了したポーリングへの URL が送信されます。 |
| user_selected_option | (これらがすでに投票している場合は) ユーザーが選択した polloption オブジェクトを返します。 |
| 投票 | ポーリングのために集計された投票数を返します。 |
ポーリング オプション属性
注意
| 属性 | 内容 |
|---|---|
| 回答 | ポーリングの回答フィールドを返します。 |
| 割合 | オプションのポーリングの投票率を 0 ～ 100 の間の 10 進数で返します。 |
| 投票 | オプションのために集計された投票数を返します。 |
要求
現在の HTTP 要求に関する情報が含まれます。
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
注意
- URL フィルターを使用して Liquid で URL を動的に作成できます。
- request.url で使用される URL は、された任意の値にすることができ、後続の要求のために キャッシュ されます。 request.url の値を正しくするには、置換タグ を使用するか、~{WebFile パス} などの部分的な URL を使用するか、または サイト設定 にポータル URL を保存することを検討してください。
- Power Apps ポータルのリリース バージョン 9.3.8.x またはそれ以降では、ユーザー に強制された Liquid フィルターを既定で エスケープ し、Liquid オブジェクトを 要求 します。 この既定の構成を無効にして Liquid フィルターをエスケープせずにこれらの Liquid オブジェクトを許可するには、ポータル サイト設定 - Site/EnableDefaultHtmlEncoding を参照してください。
属性
| 属性 | 内容 |
|---|---|
| params | 現在の要求の、名前の付いたパラメーター値です。 パラメーターは URL クエリ文字列パラメーター、フォーム投稿パラメーターおよびクッキーの組み合わせです。 |
| パス | 現在の要求 URL のパスです。 /プロファイル/ |
| path_and_query | 現在の要求 URL のパスおよびクエリです。 /profile/?foo=1&bar=something |
| クエリ | 現在の要求 URL のクエリ パーツです。 ?foo=1&bar=something |
| url | 現在の要求の完全な URL です。 https://www.example.com/profile/?foo=1&bar=something |
検索インデックス
検索インデックス オブジェクトはPower Apps 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 %}
属性
| 属性 | 内容 |
|---|---|
| approximate_total_hits | インデックスのクエリと一致する合計ヒット数のおよその数を返します。 セキュリティのフィルター処理や他の設計要素に関わる検索インデックス機能の仕組みのために、この数は近似値にすぎず、現在のユーザーが使用できる結果の合計数と正確に一致しない場合があります。 |
| ページ | 現在のページ数を返します。 |
| page_size | 現在のクエリの最大ページ サイズを返します。 現在のページによって返される結果の実績数を取得する場合は (指定された最大ページ サイズより小さい可能性があるため)、results.size を使用します。 |
| 結果 | クエリ結果のページを、検索インデックスの結果オブジェクトとして返します。 |
検索インデックスの結果
| 属性 | 内容 |
|---|---|
| エンティティ | 結果に対する基盤となるエンティティです。 |
| フラグメント | 結果に関する短いテキストのフラグメントであり、<em> HTML タグを使用してハイライトされた特定のクエリと一致する用語が含まれます。 曖昧なクエリ (~) やワイルドカード クエリ (*) など、特定タイプのクエリはハイライトされたフラグメントをサポートしません。 このプロパティはこれらの場合は null となります。 |
| ID | 結果に対する基盤となるレコードの Power Apps テーブル ID で、文字列で構成されます。 たとえば、936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | 結果に対する基盤となるレコードの Power Apps テーブル論理名です。 例: adx_webpage |
| 番号 | 1 から始まるすべての結果ページにおける結果の数です。 たとえば、10 件のページ サイズの、結果の 2 ページ目の最初の結果において、この値は 11 となります。 |
| スコア | 浮動小数点値としての結果における Lucene スコアです。 この値で並べ替えられた結果が返されます。 |
| タイトル | 結果のタイトルです。 |
| url | 結果に対する URL です。 これは通常 — ですが、— ではない場合もあり、完全な URL というより、むしろ現在のアプリケーションの絶対パスです。 例: /articles/article1/ |
設定
名前別にすべてのサイト設定を読み取ることができます。 指定された名前の設定が見つからない場合は、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 %}
サイト マップ属性
| 属性 | 内容 |
|---|---|
| 現在 | 現在のページのサイト マップ ノード オブジェクトを返します。 |
| ルート | Web サイトのルート (ホーム) ページのサイト マップ ノード オブジェクトを返します。 |
サイト マップ ノード属性
| 属性 | 内容 |
|---|---|
| 階層リンク | サイト マップ ルート ノードから始まり親で終わる、ノードの階層リンク サイト マップ ノード オブジェクトを返します。 |
| 子 | ノードの子サイト マップ ノード オブジェクトを返します。 |
| 内容 | ノードの説明および概要コンテンツです。 (このフィールドは HTML を含む場合があります)。 |
| エンティティ | 基になるノードのエンティティを返します。 ノードに基になるテーブルがない場合、その値は null です。 |
| is_sitemap_ancestor | サイト マップ ノードが現在のノードの上位の場合 true を返し、それ以外の場合は false を返します。 |
| is_sitemap_current | サイト マップ ノードが現在のノードの場合 true を返し、それ以外の場合は false を返します。 |
| 親 | ノードの親サイト マップ ノードを返します。 ノードがルート ノードの場合、親が null となります。 |
| 敬称 | ノードのタイトルです。 |
| url | ノードの URL です。 |
サイトマーカー
名前別にすべてのサイト マーカーを読み取ることができます。 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 %}
サイト マーカー属性
| 属性 | 内容 |
|---|---|
| url | sitemarker ターゲットの URL。 |
| [属性論理名] | 論理名でサイト マーカー ターゲットの Power Apps レコードの属性にアクセスできます。 例: {{ sitemarker.adx_name }} |
スニペット
名前によってコンテンツ スニペットを読み取ることができます。 指定された名前のスニペットが見つからない場合は、null が返されます。
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
反復タグ ループ ブロック内で役立つプロパティを含みます。
注意
tablerowloop は 反復タグ タグ内のみで使用可能です。
属性
| 属性 | 内容 |
|---|---|
| カラム | 1 で始まる、現在の行のインデックスを返します。 |
| col0 | 0 で始まる、現在の行のインデックスを返します。 |
| col_first | 現在の列が行の最初の列の場合、true を返し、そうでない場合は、false を返します。 |
| col_last | 現在の列が行の最後の列の場合、true を返し、そうでない場合は、false を返します。 |
| 最初 | ループの最初の繰り返しの場合、true を返します。 ループの最初の繰り返しでない場合、false を返します。 |
| インデックス | 最初のアイテムの場所を 1 としたときの、コレクション内で現在の項目がある位置。 |
| index0 | 最初のアイテムの場所を 0 としたときの、コレクション内で現在の項目がある位置。 |
| 最終 | ループの最後の繰り返しの場合、true を返します。 ループの最後の繰り返しでない場合、false を返します。 |
| 長さ | ループに対して同じ操作を繰り返す数 ߝ コレクション内の繰り返す項目の数を返します。 |
| Rindex | 最後の項目のインデックスを 1 としたときの、ループ内の残りの項目の数 (長さ - インデックス)。 |
| rindex0 | 最後の項目のインデックスを 0 としたときの、ループ内の残りの項目の数 (長さ - インデックス)。 |
ユーザー
ポータルの現在のユーザーを参照するもので、基になる Power Apps 担当者レコードのすべての属性にアクセスすることができます。 サインインしているユーザーがいない場合、この変数は null になります。
ユーザーはエンティティ オブジェクトです。
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
注意
Power Apps ポータルのリリース バージョン 9.3.8.x またはそれ以降では、ユーザーに強制された Liquid フィルターを既定でエスケープし、Liquid オブジェクトを要求します。 この既定の構成を無効にして Liquid フィルターをエスケープせずにこれらの Liquid オブジェクトを許可するには、ポータル サイト設定 - Site/EnableDefaultHtmlEncoding を参照してください。
属性
エンティティ オブジェクトのすべての属性に加えて、ユーザーには次の属性もあります。
| 属性 | 説明 |
|---|---|
| ロール | ユーザーが属するロールを、配列として戻します。{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}メモ: また、個々のロールのメンバーシップをテストするために has_role フィルターを使用することができます。 |
| basic_badges_url | ユーザーのバッジを取得するサービス URL を戻します。 ユーザーのバッジを表示するには、"data-badge" および "data-uri" 属性を持つタグを含める必要があります。 現在のユーザーのバッジを表示する方法: <div data-badge data-uri='{{user.basic_badges_url }}'></div>ユーザーのバッジを ID (可変ユーザー ID) で表示する方法: `<div data-badge data-uri='{{user.basic_badges_url |
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 リンク セットの HTML コピー。 |
| 件名 | Web リンク セットの名前。 |
| 敬称 | Web リンク セットのタイトル。 |
| Web リンク | Web リンク セットに関連付けられている Web リンク オブジェクトの配列。 |
| [属性論理名] | 論理名で Web リンク セットの Power Apps レコードの属性にアクセスできます。 例:{{ weblinkset.createdon }} |
Web リンクの属性
注意
Web リンクは エンティティ オブジェクトで、以下に示す属性に加え、すべての同じ属性があります。
| 属性 | 説明 |
|---|---|
| 説明 | Web リンクの HTML の説明。 |
| display_image_only | Web リンクが、リンク テキストなしで、画像としてのみ表示される必要があるかどうかを示すブール値。 |
| display_page_child_links | Web リンクが、リンクされたページの サイト マップ 子ページへのリンクをサブ リンクとして表示するかどうかを示すブール値属性。 |
| 画像 | このリンクの Web リンクの画像オブジェクト。 画像がない場合、属性は null になります。 |
| is_external | Web リンクのターゲット URL が (内部のポータル ページではなく) 外部サイトに向いているかどうかを示すブール属性。 |
| is_sitemap_ancestor | Web リンクの URL 参照が現在のサイト マップ ノードの上位の場合 true を返し、それ以外の場合は false を返します。 |
| is_sitemap_current | Web リンクの URL 参照が現在のサイト マップ ノードの場合 true を返し、それ以外の場合は false を返します。 |
| Name | Web リンクの名前/タイトル。 |
| Nofollow | Web リンクを rel=nofollow としてマークするかどうかを示すブール値属性。 |
| open_in_new_window | リンクを選択したときに新しいブラウザー ウィンドウまたはタブで開くかどうかを示すブール属性。 |
| ツールヒント | Web リンクのツールヒントのテキスト。 |
| url | Web リンクの URL。 |
| Web リンク | Web リンクに関連付けられている子の Web リンク オブジェクトの配列。 |
| [属性論理名] | 論理名で Web リンク Power Apps レコードの属性にアクセスできます。 例:{{ weblink.createdon }} |
Web リンク画像の属性
| alternate_text | 画像の代替テキスト。 |
|---|---|
| 高さ | 画像に指定された高さを示す整数。 高さの値が指定されていない場合、この属性は null になります。 |
| url | 画像の URL。 |
| 幅 | 画像に指定された幅を示す整数。 幅の値が指定されていない場合、この属性は null になります。 |
Web サイト
ポータルの Web サイトを参照するもので、ポータルの Power Apps Web サイト (adx_website) レコードのすべての属性にアクセスすることができます。
注意
Web サイトはエンティティ オブジェクトで、すべての同じ属性があります。
コード
{{ website.adx_name }} ({{ website.id }})
出力
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
属性
次の表に、キャッシュを回避するために規定の代わりに使用できるこのタグの属性を示します。
| 既定 | 置換 (キャッシュを回避) | 例 |
|---|---|---|
| sign_in_url | sign_in_url_substitution | 規定: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F 置換 (キャッシュを回避): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F (この例の "substitute-page" は、規定のキャッシュされた URL を置き換えます。) |
| sign_out_url | sign_out_url_substitution | 規定: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F 置換 (キャッシュを回避): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F (この例の "substitute-page" は、規定のキャッシュされた URL を置き換えます。) |
関連項目
Liquid の種類
Liquid タグ
Liquid フィルター
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。