テンプレート タグ

  • [アーティクル]

注意

2022 年 10 月 12 日より、Power Apps ポータルは Power Pages となります。 詳細: Microsoft Power Pages の一般提供が開始されました (ブログ)
Power Apps ポータルのドキュメントは、近日中に Power Pages ドキュメントに移行、統合されます。

テンプレート タグは、さまざまな方法でテンプレートの出力を制御し、複数のテンプレートを 1 つの出力にまとめることができます。

fetchxml

ユーザーが Microsoft Dataverse からデータを照会し、結果をページに表示できるようにします。

注意

FetchXML を使用したデータのクエリの詳細については、FetchXML を使用してデータをクエリするをご覧ください。

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

fetchxml を使用してデータをクエリするときは、自己終了タグを使用しないようにしてください。 たとえば、<attribute name="title"/> ではなく、明示的な終了タグ</attribute>付きの<attribute name="title"></attribute>を使用します。

結果属性

提供された変数の結果属性 (上記のサンプルの "resultVariable"など) は、FetchXML クエリ結果と他のいくつかの属性を保持します。

  • エンティティ

    この属性には、FetchXML クエリの結果が含まれます。 結果を繰り返して、Web テンプレートで使用できます。

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

提供された変数 (上記のサンプルの "resultVariable" など) の XML 属性は、Microsoft Dataverse からデータを取得するために使用できる結果のクエリを保持します。 この属性は、テーブルのアクセス許可がこの fetchxml タグに適用される方法を理解したい場合、デバッグするのに便利です。

その他のサポートされている要素と属性

fetchxml 液体タグは、次の属性と子要素をサポートします。

要素/子要素 属性 子要素
fetch mapping
version
件数
page
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 注文
エンティティ
注文 属性
エイリアス
降順
エンティティ name
all-attributes
no-attrs
属性		 注文
フィルター
link-entity
フィルター type
ヒント
isquickfindfields		 条件
フィルター
link-entity name
送信元
to
エイリアス
link-type
表示する
交差
all-attributes
no-attrs
属性		 注文
フィルター
link-entity
条件 列
エンティティ名
属性
operator
aggregate
エイリアス
uiname
uitype
uihidden
価値		 価値

含む

1 つのテンプレートの内容を名前を指定して別のテンプレートに含めます。 Power Apps ポータルでは、これ以外のテンプレートのソースは、通常 Web テンプレートです。 これにより、複数の場所で共通のテンプレートのフラグメントを再利用できます。

テンプレートが別のテンプレートに含まれている場合、含まれたテンプレートは親のテンプレートで定義された変数にアクセスできます。

{% include 'My Template' %}

include タグに、名前の付けられた任意の数のパラメーターを渡すこともできます。 これらは、含まれたテンプレートで変数として定義されます。

{% include 'My Template' a:x, b:y %}

block

テンプレートを継承するために、拡張と組み合わせて使用されます。 使用方法については、拡張を参照してください。

extends

テンプレートを継承するために、ブロック タグと組み合わせて使用されます。 これにより、親のレイアウトのオーバーライド指定領域でも、複数のテンプレートで共有レイアウトを使用できす。

Power Apps ポータルでは、タグに提供された親のテンプレート名は、通常 Web テンプレートの名前を参照します。

拡張を使用する場合は、テンプレートの最初の内容である必要があり、1 つ以上のブロック タグのみ続けることができます。

親のテンプレートで定義された block がオーバーライドされなかった場合、親のテンプレートの内容 (ある場合) が表示されます。

comment

流動テンプレート内の非表示コードをそのままの状態にすることができます。 ブロック内のコンテンツが表示されない場合、内部の流動コードは実行されません。

コード

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 の値を正しくするには、置換タグ を使用するか、 ~{WebFile path} などの部分的な URL を使用するか、または サイト設定 にポータル URL を保存することを検討してください。

codecomponent

コード コンポーネントの Dataverse エンティティ タグを理解する を参照し、コード コンポーネントの Liquid テンプレート タグを使用します。

関連情報

制御フロー タグ
イテレーション タグ
変数タグ
Power Apps Dataverse エンティティ タグ
コード コンポーネントの Liquid テンプレート タグを使用する

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。