ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Webコンテンツテンプレートの作成

ウェブコンテンツテンプレートは、FreeMarkerテンプレート言語（FTL）を使用して、ページ上でコンテンツフィールドがどのようにレンダリングされるかを決定します。各テンプレートは、 Webコンテンツ構造に関連付けられるか、他のテンプレートに埋め込まれたにも関連付けることができます。

重要

FreeMarkerでテンプレートを作成または編集する権限は信頼できるユーザーにのみ付与してください。 Webコンテンツテンプレートのセキュリティに関する情報については、 Webコンテンツ構造とテンプレートへの権限の割り当てを参照してください。

Webコンテンツテンプレートを作成する方法

サイトメニュー () を開き、 コンテンツ & データ → ウェブコンテンツ に移動します。
テンプレート タブを選択し、新規をクリックして、新しい Web コンテンツテンプレートを作成します。
新しいテンプレートのタイトルを入力してください。
オプションで、これらの設定可能なテンプレートプロパティを指定できます。
スクリプトウィンドウを使用して、または ファイルを選択 をクリックして既存の .ftl スクリプトファイルを選択してインポートすることにより、FreeMarker コードをテンプレートに追加します。

スクリプトウィンドウにコードを手動で入力する場合、テンプレートパネルから標準変数にすばやくアクセスできます。テンプレートの構造を選択した場合、その特定のフィールドの変数だけでなく、 フレンドリー URL 変数にもアクセスできます。

その後、テンプレートのスクリプトにHTMLまたは追加のFreeMarkerコードを追加できます。

警告

メタタグの説明文にシングルクォーテーション（'）が含まれている場合、カスタムテンプレートコードを介して追加するとHTMLが壊れる可能性があります。メタタグに記述変数を挿入する際は、 htmlUtil.escape() で囲みます。
完了したら保存をクリックするか、 保存して続行 をクリックして編集の進行状況を保存し、編集を続行します。

重要

テンプレートが構造体とリンクされて保存されると、そのテンプレートのプロパティは変更できなくなります。

保存すると、DXPはテンプレートのDDMテンプレートキー、URL、およびWebDAV URLを自動的に生成します。これらはプロパティパネルで確認できます。

テンプレートを作成したら、そのリンク構造で作成されたウェブコンテンツ記事に使用したり、他のテンプレートに埋め込んだりすることができます。テンプレートはいつでも編集できます。

注

構造の変更は、関連するテンプレートの変更を必要とする場合があります。例えば、テンプレート内で参照されている構造体フィールド名が変更または削除された場合、テンプレートの参照箇所を手動で更新する必要があります。

設定可能なテンプレートのプロパティ

テンプレートを作成する際に、プロパティパネルで以下のテンプレート設定を任意で指定できます。

構造: 構造フィールドを使用して、テンプレートを既存の Web コンテンツ構造にリンクするか、このフィールドを空白のままにして、他の Web コンテンツテンプレートに埋め込むことができる汎用テンプレートを作成します。
説明: 説明フィールドを使用して、テンプレートのローカライズされた説明を提供します。
キャッシュ可能: デフォルトでは、新しいテンプレートはキャッシュ可能です。動的な動作が必要な場合（例：タグライブラリ、リクエスト処理、CMS クエリ API）、このプロパティのチェックを外してください。
注目の画像: URL またはデバイスからテンプレートの注目の画像を選択します。

テンプレートの選択

Webコンテンツテンプレートと情報テンプレートはどちらもFreeMarkerをテンプレート言語として使用し、コンテンツを構造化して表示します。しかし、それぞれ異なる用途があり、適用されるコンテンツの種類も異なります。

コンテンツの種類と機能に最適なテンプレートを選択するために、以下の重要な違いを考慮してください。

情報テンプレート

情報テンプレートは汎用性が高く、Webコンテンツ、コレクション、ドキュメント、カスタムアセットなど、複数のアセットタイプに対応しています。ただし、各情報テンプレートは単一のタイプまたはサブタイプに限定されているため、あるタイプ／サブタイプ用に設計されたテンプレートを別のタイプ／サブタイプに適用することはできません。

例えば、Webコンテンツ構造用に作成された情報テンプレートは、文書タイプでは使用できません。ただし、資産用に作成された一般的な情報テンプレートは、Webコンテンツ構造とドキュメントの両方に適用できます。どちらも資産とみなされるためです。

この場合、両方の資産に共通するフィールドにのみアクセスでき、各タイプ固有のフィールドにはアクセスできません。さらに、情報テンプレートは、情報フレームワークでサポートされている共通フィールド（例： チェックボックス （単一および複数）、 日付、 レイアウトへのリンク、 数値、 テキスト、および リッチテキスト）に限定されます。)

情報テンプレートはコレクションアイテムに使用できますが、各アイテムに個別に適用されるため、単一のテンプレートでコレクション全体をスタイル設定することはできません。