コンテンツフラグメントでの参照の使用について

最終更新日: 2023-11-07
  • 作成対象:
  • Developer

これまでの説明内容

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

ヘッドレス CMS オーサリングの基本と、AEMaaCS でのオーサリング、特にコンテンツフラグメントのオーサリングの基本を学びました。

この記事では、これらに基づいて、AEM ヘッドレスプロジェクトで独自のコンテンツをオーサリングするための参照の使用方法を説明します。

目的

  • オーディエンス:経験者

  • 目的:ヘッドレス CMS オーサリングでの参照の使用方法を紹介します。使用可能な参照の種類と用途は次のとおりです。

    • コンテンツ参照
    • アセット/メディア参照
    • フラグメント参照
    • テキストブロック内からのアドホック参照

参照とは

参照は、他のコンテンツ、アセット(画像など)、他のフラグメントなどのリソースを接続するためのメカニズムです。それぞれよく似ていますが、いくつかの違いがあります。

参照には、専用のデータタイプを持つもの(コンテンツ参照やフラグメント参照など)もあれば、テキストブロック内の参照として追加されるもの(アセット参照やアドホック参照など)もあります。

コンテンツフラグメント - 参照

コンテンツ参照

コンテンツ参照はそのような役割を果たします。コンテンツ参照を使用すると、他のコンテンツを参照できます。 コンテンツ項目を選択できるブラウザーが開きます。

アセット/メディア参照

アセット(画像やメディアなど)は、「アセットを挿入」オプションを使用して、テキストブロック内で参照することができます。アセットを選択できるブラウザーが開きます。

コンテンツフラグメント - アセットを挿入

フラグメント参照

再びフラグメント参照でも同様の操作が可能です。この場合、別のフラグメントを参照できます。 これが重要な理由については、もう少し説明が必要です。

例えば、次のコンテンツフラグメントモデルが定義されているとします。

  • City(市区町村)
  • Company(会社)
  • Person(ユーザー)
  • 授賞歴

非常に簡単に見えますが、会社には CEO と従業員の両方がいます…これらはすべて人物で、それぞれが Person として定義されます。

また、Person は Award(1 つまたは複数)を持っている可能性があります。

  • 私の会社 - Company
    • CEO - Person
    • 従業員 - Person
      • 個人賞 - Award

しかし、これはほんの一例です。複雑さに応じて、Award が Company 固有のものであったり、Company が特定の City に本社を置いていたりすることがあります。

こうした相互関係は、作成者とヘッドレスアプリケーションの双方が理解できるように、フラグメント参照を使用して表すことができます。

作成者は、これらの関係を定義するわけではありません(コンテンツフラグメントモデルの作成時にコンテンツアーキテクトが行います)が、参照を把握して編集する方法を理解しておく必要があります。

ネストされたフラグメントのオーサリング方法

フラグメント参照のオーサリングはどても簡単です(ただし、通常、フィールドには​フラグメント参照​というラベルは付きません)。参照を直接入力するか、(可能性が高い)フォルダーアイコンを選択してブラウザーを開き、必要なフラグメントに移動して選択できます。

コンテンツフラグメント - 参照

コンテンツフラグメントモデルの定義で以下が決まります。

  • 複数の参照を選択して追加できるかどうか
  • 選択できるコンテンツフラグメントモデルのタイプ。参照に使用できるフラグメントモデルはコンテンツフラグメントモデルで定義されるので、AEM は、そのモデルに基づくフラグメントのみを表示します。

コンテンツフラグメントエディターの「構造ツリー」タブを使用すると、フラグメントで参照されているフラグメント間を移動し、さらに、それらのフラグメントに含まれている参照間を移動できます。参照を選択すると、そのフラグメントが編集用に開きます。

メモ

メインパネルのパンくずリストを使用して、開始点に戻ることができます。

コンテンツフラグメント構造ツリー

アドホック参照

アドホック参照は、テキストブロック内に単純なリンクとして追加できます。

コンテンツフラグメント - アドホック参照

次の手順

これで、コンテンツフラグメントにおける参照と構造について説明したので、次のステップは、コンテンツフラグメントのメタデータとタグの定義についてです。このステップでは、コンテンツフラグメントのメタデータとタグを定義する方法を説明します。

その他のリソース

このページ