AEM を使用したヘッドレスのオーサリングの基本 author-headless-basics

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

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

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

目的 objective

基本操作 basic-handling

コンテンツフラグメントについて理解する前に、AEM の使用方法を簡単に説明します。実際には、ログインしてシステムを実際に使用してみるのが一番です。

オーサーとパブリッシュ author-preview-publish

AEM インストールは、通常、少なくとも次の 2 つの環境で構成されます。

ログインし、オーサー環境を使用してコンテンツを生成します。準備が整ったら、コンテンツを公開して、一般に利用できるようにします。ヘッドレスの場合は、他のアプリケーションに対して行われ、web ページの場合は、web 上の読者に対して行われます。

詳しくは、「オーサリングに関する概念」を参照してください。

ログイン signing-in

ほとんどのシステムと同様に、ログインする必要があります。作成者には、次の情報が提供されます。

アカウントには、必要な権限が前もって設定されています。問題がある場合は、社内のプロジェクトサポートチームに問い合わせることをお勧めします。

ナビゲーション navigation

初めてログインすると、簡単なオンラインチュートリアルでユーザーインターフェイスの主な機能がいくつか紹介されます。

その後、ナビゲーションパネルを使用して、AEMの主要な領域にアクセスできます。コンテンツフラグメントの場合は、Assets コンソール ​を使用します。

ナビゲーションパネルを開くには、左上の Adobe アイコンを選択し、次に小さいコンパスアイコンを選択します。

コンソール内では、フォルダーを選択してコンテンツフラグメントに移動したり、（ヘッダー内の）パンくずリストを選択してツリーの上に戻ることができます。

アクション、選択、表示 actions-selecting-viewing

Assets コンソールには、リソース（フォルダーやコンテンツフラグメントなど）を選択した後で使用できる専用の​ アクションツールバー ​および​ クイックアクション ​があります。

クイックアクションは、1 つのリソースに対して使用できます。下の Basel を参照してください。

アクションツールバーでは、現在のシナリオに適用できるすべてのアクションにアクセスできます。使用可能なアクションは、場所や選択したリソース数（１ つまたは複数）によって変わることがあります。

リソースの表示形式を表示セレクターで選択できます。

項目に関する追加情報をパネルセレクター表示できます。追加のアクションにもアクセスできます。

コンテンツフラグメントのオーサリング authoring-content-fragments

以上、AEM ユーザーインターフェイス（UI）について簡単に説明しました。実際に UI を試してみる機会があれば幸いです。ここからは、実際の関心事である、ヘッドレスのコンテンツフラグメンについて説明します。

最初から最後まで説明する必要がありますが、お使いのインスタンスにはフォルダーやフラグメントが既に作成されていて、それらが様々な場所に存在している可能性があります。原則はすべて同じです。

整理とナビゲーション organizing-and-navigating

コンテンツフラグメントがほとんどない場合を除き、コンテンツフラグメントを整理して、作成者（および他のユーザー）が見つけやすくします。

フォルダーの作成 creating-folder

そのためには、Assets コンソールの「ファイル」セクション内に一連のフォルダーを作成します。「作成」オプション（右上）を選択したあと、「フォルダー」を選択します。

詳細を入力できるダイアログが開くので、入力後、「作成」で確定します。

フォルダーで使用可能なコンテンツフラグメントモデルをパスとタグで制限する方法 tags-paths-for-models-in-folder

この節の内容は少し上級者向けです。開始したばかりで試している段階ならそれほど必要ではありませんが、多数のフラグメントがある場合に最も便利です。まだ使わなくても、知っておいて損はありません。

コンテンツアーキテクトは、現在のプロジェクトや他のプロジェクトに必要なすべてのコンテンツフラグメントモデルを作成しています。自分自身や他の作成者が作業を簡単に行えるように、特定のフォルダーで使用できるモデルのリストを制限できます。

フォルダーを作成したら、そのフォルダーの​ プロパティ ​を開きます。ここには、フォルダーに関する情報と設定詳細の様々なタブがあります。特に、コンテンツフラグメントの場合は、「ポリシー」タブを使用して、このフォルダーに特定のパスやタグを定義できます。これにより、フォルダーで使用できるコンテンツフラグメントモデルが制限されます。つまり、コンテンツフラグメントモデルを使用してこのフォルダーでフラグメントを生成するには、これらの要件を満たす必要があるということです。

次に、これらのフォルダーを移動して、コンテンツフラグメントの作成と編集を行います。

フォルダークラウドサービスの設定（参考まで） cloud-services-folder

以下は参考までに説明しておきます。

フォルダーを作成できる初期フォルダーがあらかじめ用意されているはずです。これは、一部の設定詳細を（通常は開発者またはシステム管理者が）ルートフォルダーに適用する必要があるからです。おそらく重要ではありませんが、必要に応じて、フォルダーの​ プロパティ ​の​ クラウドサービス ​で​ 設定 ​を確認できます。

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

コンテンツフラグメントの作成はフォルダーの作成と非常に似ています。代わりに、「コンテンツフラグメント」オプションを使用するだけです。

今度は、ウィザードが開きます。最初の手順では、フラグメントの基になるコンテンツフラグメントモデルを選択します。

「次へ」で続行した後、フラグメントの詳細（「基本」および「詳細」）を指定できます。

「作成」で確定すると、フラグメントをエディターで​ 開く ​ことができます。

フラグメントの編集 editing-fragment

フラグメントは、作成後すぐに開くことも、Assets コンソールから選択して開くこともできます。

エディターが初めて開くと、以下のものが表示されます。

例：

「保存」または「保存して閉じる」を使用して、更新を確定します。

（おそらく）気にする必要がないもの what-you-probably-do-not-need-to-worry-about

やや奇妙なタイトルの節ですが、コンテンツフラグメントエディターを開いて詳細な作業に入ると、コンテンツ作成者のヘッドレスジャーニーに（おそらく）当てはまらない様々なオプションが表示されることになります。そこで、ここでは、ヘッドレスコンテキストで無視できるものについて簡単に説明しておきます。

公開 publishing

フラグメントが完成したら​ 公開 ​して、ヘッドレスアプリケーションで利用できるようにします。

公開アクションは、エディターで（または Assets コンソールのツールバーから）実行できます。

次の手順 whats-next

これで基本を説明したので、次のステップはコンテンツフラグメントでの参照の使用についてです。ここでは、使用可能な様々な参照を紹介し、ヘッドレス向けオーサリングの重要な部分であるフラグメント参照を使用した構造レベルの作成方法について説明します。

その他のリソース additional-resources