コンテンツフラグメントのオーサリング authoring-content-fragments
この章では、新しく定義されたコンテンツフラグメントモデルに基づいて、新しいコンテンツフラグメントを作成し、編集します。また、コンテンツフラグメントのバリエーションを作成する方法についても説明します。
前提条件 prerequisites
これは複数の部で構成されるチュートリアルで、「コンテンツフラグメントモデルの定義」でまとめられている手順が完了していることを前提としています。
目的 objectives
- コンテンツフラグメントモデルに基づいたコンテンツフラグメントの作成
- コンテンツフラグメントのバリエーションの作成
アセットフォルダーの作成
コンテンツフラグメントは、AEM Assets のフォルダーに保存されます。前の章で作成したモデルからコンテンツフラグメントを作成するには、コンテンツフラグメントを保存するためのフォルダーを作成する必要があります。特定のモデルからフラグメントを作成できるようにするには、フォルダーで設定が必要です。
-
AEM スタート画面で、アセット/ファイル に移動します。
-
右上隅の「作成」をタップし、「フォルダー」をタップします。表示されたダイアログで、次のように入力します。
- タイトル*:My Project
- 名前:my-project
-
My Folder フォルダーを選択し、「プロパティ」をタップします。
-
「クラウドサービス」タブを選択します。「クラウド設定」タブで、パスファインダーを使用して My Project の設定を選択します。値は
/conf/my-project
にします。このプロパティを設定すると、前の章で作成したモデルを使用してコンテンツフラグメントを作成できます。
-
「ポリシー」タブをタップし、「許可されているコンテンツフラグメントモデル」フィールドの下にあるパスファインダーを使用して 、以前に作成した 人物 および チーム モデルを選択します。
これらのポリシーは、任意のサブフォルダーに自動的に継承され、上書きできます。また、タグ別にモデルを許可したり、他のプロジェクト設定からのモデルを有効にしたりすることもできます。このメカニズムにより、コンテンツ階層を強力に管理できます。
-
「保存して閉じる」をタップして、フォルダーのプロパティの変更を保存します。
-
My Project フォルダーの中に移動します。
-
別のフォルダーを次の値で作成します。
- タイトル*:English
- 名前:en
多言語サポート用のプロジェクトを設定することがベストプラクティスです。詳しくは、次の文書のページを参照してください。
コンテンツフラグメントの作成 create-content-fragment
次に、チーム および 人物 のモデルに基づいて、いくつかのコンテンツフラグメントが作成されます。
-
AEM スタート画面で「コンテンツフラグメント」をタップして、コンテンツフラグメント UI を開きます。
-
左側のパネルで「My Project」を展開し、「English」をタップします。
-
「作成」をタップして、新しいコンテンツフラグメント ダイアログを表示させ、次の値を入力します。
- 場所:
/content/dam/my-project/en
- コンテンツフラグメントモデル:人物
- タイトル:John Doe
- 名前:
john-doe
- 場所:
-
「作成」をタップします。
-
上記の手順を繰り返して、Alison Smith を表すフラグメントを作成します。
- 場所:
/content/dam/my-project/en
- コンテンツフラグメントモデル:人物
- タイトル:Alison Smith
- 名前:
alison-smith
「作成」をクリックして、ユーザーフラグメントを作成します。
- 場所:
-
次に、チームアルファ を表す チーム フラグメントを作成する手順を繰り返します。
- 場所:
/content/dam/my-project/en
- コンテンツフラグメントモデル:チーム
- タイトル:チームアルファ
- 名前:
team-alpha
「作成」をクリックして、チームフラグメントを作成します。
- 場所:
-
マイプロジェクト/英語 の下に 3 つのコンテンツフラグメントがあるはずです。
ユーザーコンテンツフラグメントの編集 edit-person-content-fragments
次に、新しく作成されたフラグメントにデータを入力します。
-
「John Doe」の横にあるチェックボックスをクリックし、「開く」をクリックします。
-
コンテンツフラグメントエディターには、コンテンツフラグメントモデルに基づくフォームが含まれています。様々なフィールドに入力して、コンテンツを John Doe フラグメントに追加します。プロファイル写真については、自分の写真を AEM Assets にアップロードします。
-
「保存して閉じる」をクリックして、John Doe フラグメントへの変更を保存します。
-
コンテンツフラグメント UI に戻り、Alison Smith ファイルを開いて編集します。
-
上記の手順を繰り返して、Alison Smith フラグメントにコンテンツを入力します。
チームコンテンツフラグメントの編集 edit-team-content-fragment
-
コンテンツフラグメント UI を使用して、チームアルファ コンテンツフラグメントを開きます。
-
「タイトル」、「短縮名」、「説明」フィールドにそれぞれ入力します。
-
John Doe コンテンツフラグメントと Alison Smith コンテンツフラグメントを選択して、「チームメンバー」フィールドに入力します。
note note NOTE 「新しいコンテンツフラグメント」ボタンを使用して、インラインでコンテンツフラグメントを作成することもできます。 -
「保存して閉じる」をクリックして、チームアルファフラグメントへの変更を保存します。
コンテンツフラグメントの公開
レビューと検証が完了したら、作成した Content Fragments
を公開します
-
AEM スタート画面で「コンテンツフラグメント」をクリックしてコンテンツフラグメント UI を開きます。
-
左側のパネルで「My Project」を展開し、「English」をタップします。
-
コンテンツフラグメントの横にあるチェックボックスをクリックして、「公開」をクリックします。
おめでとうございます。 congratulations
これで完了です。複数のコンテンツフラグメントを作成し、バリエーションを作成しました。
次の手順 next-steps
次の章、GraphQL API の探索では、組み込みの GrapQL ツールを使用して AEM の GraphQL API を探索します。AEM がコンテンツフラグメントモデルに基づいて GraphQL スキーマを自動生成する方法について説明します。GraphQL 構文を使用して、基本的なクエリを作成してみます。