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
コンテンツ作成者には、モデルの作成に使用された実際のデータタイプとプロパティは表示されません。つまり、場合によっては、特定のフィールドへの入力方法に関するヘルプと情報をコンテンツ作成者に提供する必要があります。基本的な情報については「フィールドラベル」と「デフォルト値」を使用できますが、より複雑なケースでは、プロジェクト固有のドキュメントを準備する必要があるかもしれません。
コンテンツフラグメントモデルの管理 managing-content-fragment-models
コンテンツフラグメントモデルの管理には、以下の操作が必要になります。
- モデルの有効化（または無効化） - コンテンツフラグメントの作成時に作成者がモデルを使用できるようになります（または使用できなくなります）。
- 削除 - 削除は常に必要ですが、コンテンツフラグメントに既に使用されているモデル、特に既に公開されているフラグメントを削除する場合には注意が必要です。
公開 publishing
コンテンツフラグメントモデルは、そのモデルに依存するコンテンツフラグメントの公開時または公開前に公開する必要があります。
モデルは、公開され次第、オーサー環境では読み取り専用モードに ロック されます。これは、変更によって、特にパブリッシュ環境で既存の GraphQL スキーマおよびクエリにエラーが発生するのを防ぐためです。コンソールには ロック済み と表示されます。
モデルがロック済み（読み取り専用モード）の場合、モデルの内容と構造は表示できますが、モデルを直接編集することはできません。ただし、コンソールまたはモデルエディターを使用すれば ロック済み モデルを管理できます。
次の手順 whats-next
これで基本を説明したので、次の手順は独自のコンテンツフラグメントモデルの作成を開始することです。
その他のリソース additional-resources
-
基本操作 - このページは主に Sites コンソールに基づいていますが、ほとんどの機能は 一般 コンソールでの コンテンツフラグメントモデル への移動やアクションの実行にも関連しています。
-
はじめる前に