コンテンツフラグメントモデル content-fragment-models
Adobe Experience Manager(AEM)as a Cloud Service のコンテンツフラグメントモデルでは、コンテンツフラグメントのコンテンツの構造を定義します。これらのフラグメントは、ページオーサリングまたはヘッドレスコンテンツの基盤として使用できます。
コンテンツフラグメントモデルを使用するには、以下を行います。
- インスタンスに対するコンテンツフラグメントモデル機能の有効化
- コンテンツフラグメントモデルの作成と設定
- コンテンツフラグメントの作成時に使用するために、コンテンツフラグメントモデルを有効にする
- ポリシー の設定による必要なアセットフォルダーに対するコンテンツフラグメントモデルの許可
コンテンツフラグメントモデルの作成 creating-a-content-fragment-model
-
ツール/一般 に移動し、コンテンツフラグメントモデル を開きます。
-
目的の設定またはサブ設定に適したフォルダーに移動します。
-
「作成」を使用してウィザードを開きます。
note caution CAUTION コンテンツフラグメントモデルの使用が有効になっていない場合、「作成」オプションは使用できません。 -
モデルタイトル を指定します。
また、例えば「タグ」、「説明」を追加し、必要に応じて「モデルを有効化」を選択してモデルを有効にすることで、様々なプロパティを定義できます。
デフォルトのプレビュー URL パターン.note note NOTE 詳しくは、コンテンツフラグメントモデル - プロパティを参照してください。 -
「作成」を使用して、空のモデルを保存します。アクションの成功を示すメッセージが表示され、「開く」を選択して、モデルを直ちに編集するか、「完了」でコンソールに戻ります。
コンテンツフラグメントモデル - プロパティ content-fragment-model-properties
これらのプロパティは、モデルの作成時に定義され、後にコンテンツフラグメントモデルの「プロパティ」オプションで編集できます。
-
基本
-
モデルタイトル
-
タグ
-
説明
-
モデルを有効化
-
デフォルトのプレビュー URL パターン
コンテンツフラグメントエディターを使用すると、作成者は外部フロントエンドアプリケーションのコンテンツを プレビュー できます。プレビューサービス を設定したら、フロントエンドアプリケーションの URL を追加します。プレビュー URL は次のパターンに従う必要があります。
https://<preview_url>?param=${expression}
使用できる式は次のとおりです。
${contentFragment.path}
${contentFragment.model.path}
${contentFragment.model.name}
${contentFragment.variation}
${contentFragment.id}
-
画像をアップロード
-
コンテンツフラグメントモデルの定義 defining-your-content-fragment-model
コンテンツフラグメントモデルは、データタイプ の選択を使用して、結果として得られるコンテンツフラグメントの構造を効果的に定義します。モデルエディターを使用して、データタイプのインスタンスを追加し、それらを設定して必須フィールドを作成できます。
-
ツール/一般 に移動し、コンテンツフラグメントモデル を開きます。
-
コンテンツフラグメントモデルが含まれているフォルダーに移動します。
-
必要なモデルを 編集 用に開きます。クイック操作を使用するか、モデルを選択してツールバーから操作を選択します。
モデルを開くと、モデルエディターに以下の情報が表示されます。
- 左:フィールドが既に定義されています
- 右:フィールドの作成に使用できる データタイプ(およびフィールドの作成後に使用する プロパティ)
note note NOTE あるフィールドを「必須」と指定した場合、左側のウィンドウに表示される ラベル にアスタリスク(*)が付きます。
-
フィールドを追加するには
-
必要なデータタイプをフィールドの必要な場所にドラッグします。
-
フィールドがモデルに追加されると、その特定のデータタイプに対して定義できる プロパティ が右側のパネルに表示されます。ここで、そのフィールドに必要な項目を定義することができます。
-
多くのプロパティは自明です。詳しくは「プロパティ」を参照してください。
-
「フィールドラベル」を入力すると、「プロパティ名」が空欄の場合は自動入力され、後で手動で更新できます。
note caution CAUTION データタイプのプロパティの「プロパティ名」を手動で更新する場合、名前には、A~Z、a~z、0~9 および特殊文字のアンダースコア「_」のみ を使用することができます。 以前のバージョンの AEM で作成されたモデルに不正な文字が含まれている場合は、それらの文字を削除または更新します。
次に例を示します。
-
-
-
フィールドを削除するには
必須フィールドを選択し、ごみ箱アイコンを選択します。アクションの確認が求められます。
-
すべての必須フィールドを追加し、必要に応じて関連するプロパティを定義します。次に例を示します。
-
「保存」を選択して、定義を保持します。
データタイプ data-types
モデルの定義には、次のデータタイプを選択できます。
-
1 行のテキスト
- 1 行のテキストのフィールドを追加します。最大長を定義できます
- フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
-
複数行テキスト
- リッチテキスト、プレーンテキストまたはマークダウンのテキストエリア
- フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
note note NOTE テキストエリアがリッチテキスト、プレーンテキストまたはマークダウンのどれであるかは、モデル内で、プロパティの デフォルトのタイプ によって定義されます。 この形式は、コンテンツフラグメントエディターから変更はできませんが、モデルからのみ変更できます。 -
数値
- 数値フィールドの追加
- フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
-
ブール型
- ブール型チェックボックスを追加
-
日時
- 日付や時刻のフィールドを追加する
-
列挙
- チェックボックス、ラジオボタン、ドロップダウンフィールドのセットを追加
- フラグメント作成者が使用できるオプションを指定できます
- チェックボックス、ラジオボタン、ドロップダウンフィールドのセットを追加
-
タグ
- フラグメント作成者がタグの領域にアクセスして選択できるようにする
-
フラグメント参照
-
他のコンテンツフラグメントの参照をネストされたコンテンツの作成に使用可能
-
このデータタイプは、フラグメント作成者が次の操作を行えるように設定可能です。
- 参照先フラグメントの直接編集
- 適切なモデルに基づいた新しいコンテンツフラグメントの作成
- フィールドの新しいインスタンスを作成
-
参照は、参照されるリソースへのパスを指定します。例:
/content/dam/path/to/resource
-
-
フラグメント参照(UUID)
-
他のコンテンツフラグメントの参照をネストされたコンテンツの作成に使用可能
-
このデータタイプは、フラグメント作成者が次の操作を行えるように設定可能です。
- 参照先フラグメントの直接編集
- 適切なモデルに基づいた新しいコンテンツフラグメントの作成
- フィールドの新しいインスタンスを作成
-
エディターでは、参照は参照されるリソースへのパスを指定します。内部的には、参照は、リソースを参照するユニバーサル固有識別子(UUID)として保持されます
- UUID を知っている必要はありません。フラグメントエディターで、必要なフラグメントを参照できます
-
-
コンテンツ参照
- 任意の種類の他のコンテンツを参照し、ネストされたコンテンツの作成に使用可能
- 画像が参照されている場合は、サムネールを表示するように選択可能
- フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
- 参照は、参照されるリソースへのパスを指定します。例:
/content/dam/path/to/resource
-
コンテンツ参照(UUID)
- 任意の種類の他のコンテンツを参照し、ネストされたコンテンツの作成に使用可能
- 画像が参照されている場合は、サムネールを表示するように選択可能
- フィールドは、フラグメント作成者がフィールドの新しいインスタンスを作成できるように設定できます
- エディターでは、参照は参照されるリソースへのパスを指定します。内部的には、参照は、リソースを参照するユニバーサル固有識別子(UUID)として保持されます
- UUID を知っている必要はありません。フラグメントエディターで、必要なアセットリソースを参照できます
-
JSON オブジェクト
-
コンテンツフラグメントの作成者がフラグメントの対応する要素に JSON 構文を入力できます。
- 別のサービスからコピー&ペーストした JSON を AEM に直接保存できるようにします。
- JSON が渡され GraphQL で JSON として出力されます。
- コンテンツフラグメントエディターに JSON 構文のハイライト表示機能、オートコンプリートおよびエラーのハイライト表示機能が含まれています。
-
-
タブプレースホルダー
-
コンテンツフラグメントコンテンツの編集時に使用するタブを導入を許可します。
- モデルエディターで区切りとして表示され、コンテンツデータタイプのリストをセクションに分割します。各インスタンスは、新しいタブの開始を表します。
- フラグメントエディターでは、各インスタンスがタブとして表示されます。
note note NOTE このデータタイプは書式設定にのみ使用され、AEM GraphQL スキーマでは無視されます。
-
プロパティ properties
多くのプロパティは自明です。プロパティによっては次に示す追加の詳細情報があります。
-
プロパティ名
データタイプのこのプロパティを手動で更新する場合、名前には、A~Z、a~z、0~9 および特殊文字としてアンダースコア「_」のみ を使用する 必要があります。
note caution CAUTION 以前のバージョンの AEM で作成されたモデルに不正な文字が含まれている場合は、それらの文字を削除または更新します。 -
レンダリング形式
フラグメント内のフィールドを実現/レンダリングするための様々なオプション。多くの場合、これにより、オーサーにフィールドの 1 つのインスタンスが表示されるか、オーサーが複数のインスタンスを作成できるかを定義できます。複数フィールド を使用する場合、項目の最小数と最大数を定義できます。詳しくは、検証を参照してください。
-
フィールドラベル
フィールドラベル を入力すると、プロパティ名 を自動生成し、必要に応じて手動で更新できます。 -
検証 基本検証は、
必須 プロパティなどのメカニズムで使用できます。一部のデータ型には、追加の検証フィールドがあります。詳しくは、「検証」を参照してください。 -
データタイプが 複数行テキスト の場合、「デフォルトの種類」を次のいずれかとして定義できます。
- リッチテキスト
- Markdown
- プレーンテキスト
指定しなかった場合は、デフォルト値の リッチテキスト がこのフィールドで使用されます。
コンテンツフラグメントモデルで デフォルトのタイプ を変更した場合、その影響が既存の関連コンテンツフラグメントに及ぶのは、そのフラグメントがエディターで開かれて保存された後です。
-
一意:
(特定のフィールドの)コンテンツは、現在のモデルから作成されたすべてのコンテンツフラグメントで一意である必要があります。これにより、同じモデルの別のフラグメントに既に追加されているコンテンツをコンテンツ作成者が繰り返し作成できないようになります。
例えば、コンテンツフラグメントモデルの 1 行のテキスト フィールド
Country
は、2 つの依存するコンテンツフラグメントで同じJapan
値を持つことはできません。2 つ目のインスタンスが試行された場合、警告が表示されます。note note NOTE 言語ルートごとに一意性が確保されます。 note note NOTE バリエーションは、同じフラグメントのバリエーションと同じ 一意の 値を持つことができますが、他のフラグメントのバリエーションで使用されている値とは異なります。 -
特定のデータタイプとそのプロパティについて詳しくは、コンテンツ参照 を参照してください。
-
特定のデータタイプとそのプロパティについて詳しくは、フラグメント参照(ネストされたフラグメント) を参照してください。
-
変換可能
コンテンツフラグメントモデルエディターのフィールドの「翻訳可能」チェックボックスをオンにした場合:
- フィールドのプロパティ名がまだ存在しない場合は、翻訳設定のコンテキスト
/content/dam/<sites-configuration>
に確実に追加されます。 - GraphQL の場合:「コンテンツフラグメント」フィールドの
<translatable>
プロパティをyes
に設定して、変換可能なコンテンツのみを含む JSON を出力するための GraphQL クエリフィルターを許可します。
- フィールドのプロパティ名がまだ存在しない場合は、翻訳設定のコンテキスト
検証 validation
様々なデータ型に、結果のフラグメントにコンテンツが入力される際の検証要件を定義できるようになりました。
-
1 行のテキスト
- 事前定義された正規表現と比較します。
-
数値
- 特定の値を確認します。
-
コンテンツ参照
- 特定のタイプのコンテンツをテストします。
- 指定したファイルサイズ以下のアセットのみを参照できます。
- 定義済みの幅または高さ(ピクセル単位)の範囲に収まる画像のみを参照できます。
-
フラグメント参照
- 特定のコンテンツフラグメントモデルをテストします。
-
最小項目数/最大項目数
複数フィールド として定義されているフィールド(レンダリング形式 で設定)には、次のオプションがあります。
- 最小項目数
- 最大項目数
これらは、コンテンツフラグメントエディターで検証されます。
参照の使用によるネストされたコンテンツの作成 using-references-to-form-nested-content
コンテンツフラグメントは、次のいずれかのデータタイプを使用して、ネストされたコンテンツを作成できます。
-
-
他のコンテンツへの単純な参照(任意のタイプ)を提供します。
-
データタイプによって提供されます。
- コンテンツ参照 - パスベース
- コンテンツ参照(UUID) - UUID ベース
-
(結果のフラグメント内で)1 つまたは複数の参照に対して設定できます。
-
-
フラグメント参照(ネストされたフラグメント)
-
指定した特定のモデルに応じて、他のフラグメントを参照します。
-
データタイプによって提供されます。
- フラグメント参照 - パスベース
- フラグメント参照(UUID) - UUID ベース
-
構造化データを包含/取得できます。
note note NOTE このメソッドは、GraphQL でコンテンツフラグメントを使用したヘッドレスコンテンツ配信を使用する場合、特に重要になります。 * (結果のフラグメント内で)1 つまたは複数の参照に対して設定できます。
-
-
コンテンツ参照
これにより、ユーザーは現在のフラグメントに参照を追加できなくなり、フラグメント参照ピッカーダイアログが空になる場合があります。 -
GraphQL のフラグメント参照
相互に参照される複数のコンテンツフラグメントを返すディープクエリを作成する場合、最初に null が返されます。
コンテンツ参照 content-reference
コンテンツ参照 および コンテンツ参照(UUID) データタイプを使用すると、画像、ページ、エクスペリエンスフラグメントなどの別のソースからコンテンツをレンダリングできます。
標準プロパティに加えて、以下を指定できます。
フラグメント参照(ネストされたフラグメント) fragment-reference-nested-fragments
フラグメント参照 および フラグメント参照(UUID) データタイプは、1 つ以上のコンテンツフラグメントを参照できます。 複数のレイヤーを持つ構造化データを取得できるようになるので、アプリで使用するコンテンツを取得する場合、この機能は特に重要になります。
次に例を示します。
- 次が含まれる従業員の詳細を定義するモデルです。
- 事業主(会社)を定義するモデルへの参照
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
標準プロパティに加えて、次のものを定義できます。
-
レンダリング時の名前:
-
multifield - フラグメント作成者は個別の参照を複数作成できます。
-
fragmentreference - フラグメント作成者はフラグメントへの 1 つの参照を選択できます。
-
-
モデルタイプ:
複数のモデルを選択できます。コンテンツフラグメントに参照を追加する場合、これらのモデルを使用して参照先のフラグメントが既に作成されている必要があります。 -
ルートパス
参照されるフラグメントのルートパスを指定または表します。 -
フラグメントの作成を許可
これにより、フラグメント作成者は、適切なモデルに基づいてフラグメントを作成できるようになります。
- fragmentreferencecomposite - フラグメント作成者が複数のフラグメントを選択して複合フラグメントを作成できるようになります。
コンテンツフラグメントモデルの有効化または無効化 enabling-disabling-a-content-fragment-model
コンテンツフラグメントモデルを 有効化 または 無効化 して、その使用を完全に制御できます。
コンテンツフラグメントモデルの有効化 enabling-a-content-fragment-model
モデルを作成したら、次のようにモデルを有効にする必要があります。
- コンテンツフラグメントの作成時に選択できます。
- コンテンツフラグメントモデル内から参照する
- GraphQL で使用する(スキーマが生成される)
次のいずれかとしてフラグ付けされたモデルを有効にするには
- ドラフト:新規(有効化されていない)
- 無効:明示的に無効化されている
「 有効化」オプションは、次のいずれかから使用します。
- 上部のツールバー(必要なモデルが選択されている場合)
- 対応するクイックアクション(必要なモデルにマウスを移動)
コンテンツフラグメントモデルの無効化 disabling-a-content-fragment-model
モデルを無効にすると、以下のようになります。
-
このモデルは、新しい コンテンツフラグメントを作成する際の基盤としては使用できなくなります。
-
ただし、
- GraphQL スキーマは生成され続け、スキーマのクエリも引き続き可能です(JSON API への影響を回避するため)。
- モデルに基づくコンテンツフラグメントは、引き続き GraphQL エンドポイントからクエリして返すことができます。
-
モデルは参照できなくなりますが、既存の参照は変更されず、引き続き GraphQL エンドポイントからクエリして返すことができます。
「有効」としてフラグ付けされたモデルを無効にするには、次のいずれかの「無効にする」オプションを使用します。
- 上部のツールバー(必要なモデルが選択されている場合)
- 対応するクイックアクション(必要なモデルにマウスを移動)
アセットフォルダーでのコンテンツフラグメントモデルの許可 allowing-content-fragment-models-assets-folder
コンテンツのガバナンスを実装するには、アセットフォルダーに ポリシー を設定して、そのフォルダーでのフラグメント作成に使用可能なコンテンツフラグメントモデルを管理します。
許可されているコンテンツフラグメントモデル に ポリシー を設定するには:
-
必要なアセットフォルダーの プロパティ を開きます。
-
「ポリシー」タブを開き、以下を設定します。
-
継承元
<folder>
ポリシーは、新しい子フォルダーの作成時に自動的に継承されます。サブフォルダーで親フォルダーとは異なるモデルを許可する必要がある場合は、ポリシーを再設定(継承を解除)できます。
-
許可されているコンテンツフラグメントモデルパス (パス別)
複数のモデルを許可できます。
-
許可されているコンテンツフラグメントモデルタグ (タグ別)
複数のモデルを許可できます。
-
-
変更内容を 保存 します。
フォルダーに対して許可されるコンテンツフラグメントモデルは、次の順序で解決されます。
- 許可されているコンテンツフラグメントモデル の ポリシー。
- 空の場合は、継承ルールを使用してポリシーの決定を試みます。
- 継承チェーンを使用しても結果が得られない場合は、そのフォルダーの Cloud Services 設定を調べます(最初は直接、次に継承を使用して調べます)。
- 上記のいずれでも結果が得られない場合、そのフォルダーに許可されるモデルはありません。
コンテンツフラグメントモデルの削除 deleting-a-content-fragment-model
コンテンツフラグメントモデルを削除するには、次の操作を実行します。
-
ツール/一般 に移動し、コンテンツフラグメントモデル を開きます。
-
コンテンツフラグメントモデルが含まれているフォルダーに移動します。
-
モデルを選択し、次にツールバーの「削除」を選択します。
note note NOTE モデルが参照されている場合は、適切なアクションを実行できるように警告が表示されます。
コンテンツフラグメントモデルの公開 publishing-a-content-fragment-model
コンテンツフラグメントモデルは、そのモデルに依存するコンテンツフラグメントの公開時または公開前に公開する必要があります。
コンテンツフラグメントモデルを公開するには、次の操作を実行します。
-
ツール/一般 に移動し、コンテンツフラグメントモデル を開きます。
-
コンテンツフラグメントモデルが含まれているフォルダーに移動します。
-
モデルを選択し、次にツールバーの「公開」を選択します。
公開ステータスがコンソールに示されます。note note NOTE まだ公開されていないモデルのコンテンツフラグメントを公開すると、選択リストにそのことが示され、モデルがフラグメントと共に公開されます。
コンテンツフラグメントモデルを非公開にする unpublishing-a-content-fragment-model
コンテンツフラグメントモデルがフラグメントによって参照されていない場合は、そのモデルを非公開にできます。
コンテンツフラグメントモデルを非公開するには、次の操作を実行します。
-
ツール/一般 に移動し、コンテンツフラグメントモデル を開きます。
-
コンテンツフラグメントモデルが含まれているフォルダーに移動します。
-
モデルを選択し、次にツールバーの「非公開」を選択します。
公開ステータスがコンソールに表示されます。
1 つ以上のフラグメントで現在使用されているモデルを非公開にしようとすると、エラーメッセージが表示されます。次に例を示します。
このメッセージでは、参照パネルを確認して詳細を調べるよう提案されます。
ロック済み(公開済み)コンテンツフラグメントモデル locked-published-content-fragment-models
この機能は、公開済みのコンテンツフラグメントモデルに対するガバナンスを提供します。
課題 the-challenge
-
コンテンツフラグメントモデルは、AEM における GraphQL クエリのスキーマを決定します。
-
AEM GraphQL スキーマは、コンテンツフラグメントモデルが作成されると同時に作成され、オーサー環境とパブリッシュ環境の両方に存在できます。
-
公開上のスキーマは、JSON 形式のコンテンツフラグメントコンテンツをライブ配信する場合の基盤となるので、非常に重要です。
-
-
コンテンツフラグメントモデルが変更つまり編集された場合には、問題が発生する可能性があります。つまり、スキーマの変更が既存の GraphQL クエリに影響を与える可能性があります。
-
コンテンツフラグメントモデルに新しいフィールドを追加する場合は、(通常は)悪影響はありません。ただし、既存のデータフィールド(名前など)を変更したり、フィールド定義を削除したりすると、既存の GraphQL クエリでこれらのフィールドをリクエストする際に、クエリが機能しなくなります。
要件 the-requirements
-
ライブコンテンツ配信に既に使用されているモデル(つまり、公開済みのモデル)を編集する際のリスクをユーザーに認識させる。
-
意図しない変更を避ける。
いずれにせよ、変更されたモデルが再公開されると、クエリが機能しなくなる可能性があります。
解決策 the-solution
これらの問題に対処するために、コンテンツフラグメントモデルは、公開され次第、オーサー環境では読み取り専用モードに ロック されます。このステータスは、ロック済み と表示されます。
モデルが ロック済み(読み取り専用モード)の場合、モデルの内容と構造は表示できますが、モデルを編集することはできません。
ロック済み モデルは、コンソールまたはモデルエディターで管理できます。
-
コンソール
コンソールで、ツールバーの「ロック解除」および「ロック」アクションを使用して、読み取り専用モードを管理できます。
-
モデルを ロック解除 して編集を有効にすることができます。
「ロック解除」を選択した場合、警告が表示されるので、「ロック解除」アクションを確定する必要があります。
その後、モデルを編集用に開くことができます。
-
編集後にまたモデルを ロック することもできます。
-
モデルを再公開すると、すぐに ロック済み(読み取り専用)モードに戻ります。
-
-
モデルエディター
-
ロックされているモデルを開くと、警告が表示され、「キャンセル」、「読み取り専用で表示」、「編集」の 3 つのアクションが提示されます。
-
「読み取り専用で表示」を選択した場合、モデルの内容と構造が表示されます。
-
「編集」を選択すると、更新内容を編集して保存できます。
note note NOTE まだ上部に警告が表示される場合がありますが、その場合は、モデルが既存のコンテンツフラグメントで既に使用されています。 -
「キャンセル」を選択すると、コンソールに戻ります。
-