コンテンツをモデル化する方法 model-your-content

AEM ヘッドレスデベロッパージャーニーのこの部分では、コンテンツ構造をモデル化する方法について説明します。次に、チャネル間での再利用のために、コンテンツフラグメントモデルとコンテンツフラグメントを使用した Adobe Experience Manager（AEM）の構造を実現します。

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

最初の CMS ヘッドレス開発の詳細では、ヘッドレスコンテンツ配信についてや、ヘッドレスコンテンツ配信を使用する理由を説明しました。次に、「AEM Headless as a Cloud Service の概要」では、独自のプロジェクトのコンテキストで AEM ヘッドレスを説明しました。

以前の AEM ヘッドレスジャーニードキュメント（AEM ヘッドレスを使用した初めてのエクスペリエンスへのパス）では、初めてのプロジェクトの実装に必要な手順について説明しました。読み終えると、次のことを理解できるようになります。

この記事は、これらの基本事項に基づいて構築されており、独自の AEM ヘッドレスプロジェクトを準備する方法を理解できます。

目的 objective

コンテンツモデリング content-modeling

外の世界は大きくて邪悪だ（It's a big, bad world out there)。

この歌詞が本当かどうかはわかりませんが、それは確かに​ 複雑な ​世界です。データモデリングは、ある目的に必要な特定の情報を使用して、その非常に小さな部分を、単純化された表現で定義するために使用されます。

次に例を示します。

学校は多数ありますが、いろいろな共通点があります。

このような小さな例でも、リストは無限に見えるかもしれません。ただし、アプリケーションで単純なタスクを実行するだけの場合は、情報を必要不可欠なものに限定する必要があります。

例えば、地域内のすべての学校向けに特別なイベントを広告します。

概念 concepts

記述する内容は​ エンティティ（基本的には、保存する情報の対象となる「もの」）と呼ばれます。

その事がらについて保存する情報は、氏名、教員資格などの​ 属性（プロパティ）です。

次に、エンティティ間に様々な​ 関係 ​があります。例えば、通常、学校には教頭が 1 人しかいませんが、多くの教師（教頭も教師）がいます。

この情報を分析し定義するプロセスは、コンテンツモデリング ​と呼ばれます。

基本 basics

多くの場合、エンティティとそれらの関係を説明する​ 概念スキーマ ​の作成から始める必要があります。通常、これは概要レベル（概念的）のものです。

これが安定したら、エンティティを記述する​ 論理スキーマ ​に、属性と関係と共にモデルを変換できます。このレベルでは、定義を詳細に調べて、重複を排除し、デザインを最適化します。

例えば、Head Teacher と Teacher に別々のエンティティが必要ですか。それとも、Teacher モデルの追加属性だけが必要ですか。

データの整合性の確保 data-integrity

ライフサイクル全体にわたってコンテンツの正確性と一貫性を保証するには、データの整合性が必要です。これには、コンテンツ作成者が何を保存するかを容易に理解できるようにすることが含まれます。そのため、次のことが重要です。

データの冗長性を排除 data-redundancy

データの冗長性は、同じ情報がコンテンツ構造内に 2 回格納される場合に発生します。コンテンツの作成時に混乱が生じ、クエリ時にエラーが生じる可能性があるので、この方法は避けてください。記憶領域の誤用は言うまでもありません。

最適化とパフォーマンス optimization-and-performance

構造を最適化することで、コンテンツの作成とクエリの両方でパフォーマンスを向上できます。

何事もバランスが重要です。作成する構造が複雑すぎたり、レベルが多すぎると、コンテンツを作成する作成者が混乱する可能性があります。また、必要なコンテンツを取得するために、クエリが複数のネストされた（参照された）コンテンツフラグメントにアクセスする必要がある場合、パフォーマンスに重大な影響を与える可能性があります。

AEM ヘッドレスのコンテンツモデリング content-modeling-for-aem-headless

データモデリングは確立された一連のテクニックで、関係データベースを開発する際によく使用されます。そのため、コンテンツモデリングは AEM ヘッドレスに対して何を意味するのでしょうか。

使用する理由 why

アプリケーションが AEM から必要なコンテンツを一貫して効率的に要求し、受け取れるようにするには、このコンテンツが構造化されている必要があります。

つまり、アプリケーションは、事前に応答の形式を把握し、その処理方法を把握しています。これは、自由形式のコンテンツを受け取るよりも簡単です。自由形式の場合は、そのコンテンツの内容と用途を判断するための解析が必要です。

仕組みの概要 how

AEM は、コンテンツフラグメントを使用して、コンテンツをアプリケーションにヘッドレスに配信するために必要な構造を提供します。

コンテンツモデルの構造には次が当てはまります。

コンテンツのリクエストは、標準の GraphQL API のカスタマイズされた実装である AEM GraphQL API を使用して行われます。AEM GraphQL API を使用すると、コンテンツフラグメントで（複雑な）クエリを実行できます。各クエリは、特定のモデルタイプに従っています。

返されたコンテンツは、アプリケーションで使用できます。

コンテンツフラグメントモデルを使用した構造の作成 create-structure-content-fragment-models

コンテンツフラグメントモデルは、コンテンツの構造を定義するための様々なメカニズムを提供します。

コンテンツフラグメントモデルは、エンティティを記述します。

モデル内：

例：

データタイプ data-types

AEM では、コンテンツをモデル化するために次のデータタイプが用意されています。

参照とネストされたコンテンツ references-nested-content

2 つのデータタイプは、特定のフラグメント外のコンテンツへの参照を提供します。

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

始めに、サイトに対してコンテンツフラグメントモデルを有効にする必要があります。これは、設定ブラウザーの​ ツール／一般／設定ブラウザー ​で行います。グローバルエントリを設定するか、新しい設定を作成することができます。次に例を示します。

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

モデルを使用したコンテンツフラグメントでのコンテンツのオーサリング use-content-to-author-content

コンテンツフラグメントは、常にコンテンツフラグメントモデルに基づいています。モデルが構造を提供し、フラグメントがコンテンツを保持します。

適切なモデルの選択 select-model

コンテンツを実際に作成する最初の手順は、コンテンツフラグメントを作成することです。これは、アセット／ファイルの下の必要なフォルダーに作成／コンテンツフラグメントを使用して行います。ウィザードの指示に従って手順を進めます。

コンテンツフラグメントは、作成プロセスの最初の手順として選択した、特定のコンテンツフラグメントモデルに基づいています。

構造化コンテンツの作成と編集 create-edit-structured-content

フラグメントを作成したら、コンテンツフラグメントエディターで開くことができます。次の操作を実行できます。

コンテンツフラグメントの作成 creating-content-fragments

適切なモデルを選択すると、コンテンツフラグメントが開いてコンテンツフラグメントエディターで編集できます。

いくつかの例を使用する前に getting-started-examples

基本的な構造のサンプルについては、「サンプルコンテンツフラグメント構造」を参照してください。

次の手順 whats-next

これで、構造をモデル化する方法とそれに応じてコンテンツを作成する方法を確認しました。次の手順は、GraphQL クエリを使用してコンテンツフラグメントにアクセスしてコンテンツを取得する方法を確認することです。ここでは GraphQL について紹介して説明し、その後、クエリの例を見て実際の動作を確認します。

その他のリソース additional-resources