テンプレート タグ

  • [アーティクル]

テンプレート タグは、さまざまな方法でテンプレートの出力を制御し、複数のテンプレートを 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 マッピング
バージョン
カウント
ページ
paging-cookie
utc-offset
集計
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 受注
エンティティ
注文 属性
エイリアス
降順
エンティティ 名前
all-attributes
no-attrs
属性		 受注
フィルター
link-entity
フィルター タイプ
ヒント
isquickfindfields		 条件
フィルター
link-entity 名前
送信元
to
エイリアス
link-type
表示
交差
all-attributes
no-attrs
属性		 受注
フィルター
link-entity
条件 列
entityname
属性
演算子
集計
エイリアス
uiname
uitype
非表示を解除
価値		 価値

含む

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

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

{% include 'My Template' %}

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

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

ブロック

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

extends

ブロック タグと使用することで、テンプレート敬称が提供されます。 このオペレーターは、親のレイアウトのオーバーライド指定領域でも、複数のテンプレートに共有レイアウトを使用できるようにできます。

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

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

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

コメント

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

コード

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Output

Hello. My name is Charles.

生

ページ上の Liquid コードの解析や実行を行わずに出力できるようにします。

出力

Hello, {{ user.fullname }}. My name is Charles.

代替

ヘッダーとフッターのキャッシュを有効にし、特定のセクション出力のキャッシュを回避したい場合は、このタグを使用できます。 このタグは、ラップされたコンテンツ ブロックの出力がキャッシュされないヘッダーまたはフッターにコンテンツブロックを提供します。 このオペレーターは、リクエスト、ページ、言語、日付など、頻繁に更新される可能性のあるオブジェクトをユーザーが使用しているシナリオで役立ちます。 たとえば、ヘッダーとフッターのキャッシュが有効になっている場合にヘッダーとフッターの Web テンプレート ソース コード更新シナリオを参照してください。

チップ

request.url で使用される URL は、任意の要求値にでき、後続の要求に対して キャッシュ を取得します。 request.url の値を正しくするには、置換タグ を使用するか、 ~{WebFile path} などの部分的な URL を使用するか、または サイト設定 にポータル URL を保存することを検討してください。

codecomponent

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

参照

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