AEM でのコンテンツフラグメントモデルの作成について architect-headless-content-fragment-models

これまでの説明内容 story-so-far

AEM ヘッドレスコンテンツ作成者ジャーニーの冒頭の AEM でのヘッドレスのコンテンツモデリングの基本についてで、ヘッドレス向けのオーサリングに関連する基本概念と用語について説明しました。

この記事では、これらに基づいて、AEM ヘッドレスプロジェクト用に独自のコンテンツフラグメントモデルを作成する方法を説明します。

目的 objective

  • 対象読者:初心者
  • 目的:コンテンツフラグメントモデルを使用したヘッドレス CMS のコンテンツモデリングの概念と仕組みについて説明します。

コンテンツフラグメントモデルの作成 creating-content-fragment-models

コンテンツフラグメントモデルを作成し、構造を定義します。これは、ツール一般コンテンツフラグメントモデル ​で実行できます。

ツールのコンテンツフラグメントモデル

これを選択した後、モデルの場所に移動し、「作成」を選択します。ここでは、様々な主要情報を入力できます。

モデルを有効化」オプションはデフォルトで有効になっています。つまり、モデルは、保存するとすぐに(コンテンツフラグメントの作成で)使用できます。必要に応じて、この機能を無効にすることができます。後で既存のモデルを有効(または無効)にすることができます。

コンテンツフラグメントモデルの作成

作成」で確定すると、モデルを​ 開いて ​構造の定義を開始できます。

コンテンツフラグメントモデルの定義 defining-content-fragment-models

初めて新しいモデルを開くと、左側に大きな空白スペースがあり、右側に長い​ データタイプ ​のリストが表示されます。

空のモデル

では、何をすればよいのでしょうか。

データタイプ」のインスタンスを左側のスペースにドラッグします。これでもうモデルを定義しているのです。

フィールドの定義

データタイプを追加したら、そのフィールドの「プロパティ」を定義する必要があります。プロパティは、使用するタイプによって異なります。次に例を示します。

データプロパティ

フィールドは必要なだけ追加できます。次に例を示します。

コンテンツフラグメントモデル

コンテンツ作成者 your-content-authors

コンテンツ作成者には、モデルの作成に使用された実際のデータタイプとプロパティは表示されません。つまり、場合によっては、特定のフィールドへの入力方法に関するヘルプと情報をコンテンツ作成者に提供する必要があります。基本的な情報については「フィールドラベル」と「デフォルト値」を使用できますが、より複雑なケースでは、プロジェクト固有のドキュメントを準備する必要があるかもしれません。

NOTE
詳しくは、「その他のリソース」の「コンテンツフラグメントモデル」を参照してください。

コンテンツフラグメントモデルの管理 managing-content-fragment-models

コンテンツフラグメントモデルの管理には、以下の操作が必要になります。

  • モデルの有効化(または無効化) - コンテンツフラグメントの作成時に作成者がモデルを使用できるようになります(または使用できなくなります)。
  • モデルの削除 - 削除は必ず必要ですが、コンテンツフラグメント、特に公開済みのフラグメントに既に使用されているモデルの削除には注意する必要があります。

公開 publishing

コンテンツフラグメントモデルは、そのモデルに依存するコンテンツフラグメントの公開時または公開前に公開する必要があります。

NOTE
まだ公開されていないモデルに基づくコンテンツフラグメントを作成者が公開しようとすると、選択リストにそのことが示され、モデルがフラグメントと共に公開されます。

モデルは、公開され次第、オーサー環境では読み取り専用モードに​ ロック ​されます。これは、変更によって、特にパブリッシュ環境で既存の GraphQL スキーマおよびクエリにエラーが発生するのを防ぐためです。コンソールには​ ロック済み ​と表示されます。

モデルが​ ロック済み(読み取り専用モード)の場合、モデルの内容と構造は表示できますが、モデルを直接編集することはできません。ただし、コンソールまたはモデルエディターを使用すれば​ ロック済み ​モデルを管理できます。

次の手順 whats-next

これで基本を説明したので、次の手順は独自のコンテンツフラグメントモデルの作成を開始することです。

その他のリソース additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab