コンテンツフラグメントのオーサリング authoring-content-fragments
コンテンツフラグメントのオーサリングは、ヘッドレス配信とページオーサリングの両方に焦点を当てています。
コンテンツフラグメントをオーサリングするためのエディターは 2 つあります。 この節で説明するエディターは、
- ヘッドレスコンテンツ配信用に開発されています（ただし、すべてのシナリオで使用できます）。
- コンテンツフラグメント コンソールから使用できます。
このエディターで提供する機能は次のとおりです。
- 自動保存：誤って編集内容が失われることを防ぎます。
- コンテンツ参照としてのアセットのインラインアップロードで、最初にアセット DAM にアップロードする必要はありません。
- バリエーションを生成：生成 AI を使用して、プロンプトに基づいたコンテンツ作成を高速化します。
- コンテンツフラグメントによって配信されるレンダリングされたエクスペリエンスのプレビュー。
- エディターから公開および非公開する機能。
- エディターで関連付けられた言語コピーを表示して開く機能。
- エディターでバージョンの詳細を表示する機能。 選択したバージョンに戻すこともできます。
- 親参照を表示して開く機能。
- 構造ツリーを使用したコンテンツフラグメントの階層表示とその参照。
コンテンツフラグメントエディター content-fragment-editor
コンテンツフラグメントエディターを初めて開くと、次の 4 つの主なエリアが表示されます。
-
上部のツールバー：主要な情報とアクション
-
コンテンツフラグメントコンソールへのリンク（ホームアイコン）
-
モデルとフォルダーに関する情報
-
すべての 親参照 を表示するオプション（リンクアイコン）
-
フラグメント ステータス、および最後に保存した情報
-
元の（アセットベースの）エディターへの切替えスイッチ
note warning WARNING 元のエディターが同じタブに開きます。 両方のエディターを同時に開くことはお勧めしません。
-
-
左側のパネル：コンテンツフラグメントの バリエーション およびその フィールド が表示されます。
- これらのリンクを使用して、コンテンツフラグメント構造に移動できます。
-
右側のパネル：プロパティ（メタデータ）とタグを表示するタブ、バージョン履歴および言語コピーに関する情報を表示します。
- 「プロパティ」タブでは、フラグメントの タイトル および 説明 または バリエーション を更新できます
- 「コメント」タブでは、他の作成者との共同作業に役立つコメントを追加および読み取ることができます。
-
中央パネル：選択したバリエーションの実際のフィールドとコンテンツを表示します
-
コンテンツの編集が可能
- モデルで（複数として）設定した際、様々なデータタイプを使用して、関連するフィールドのインスタンスを 追加 できます。
-
「タブプレースホルダー」フィールドがモデル内で定義されている場合は、ここに表示され、次のようになります。
- ナビゲーションに使用できます。
- 水平方向に表示されるか、ドロップダウンリストとして表示されます。
note note NOTE 基になるモデルの定義に応じて、フィールドは特定のタイプの検証の対象となる場合があります。 -
コンテンツフラグメント構造のナビゲート navigate-structure
単一のコンテンツフラグメント。
-
次の 2 つのレベルで構成されます。
- コンテンツフラグメントの バリエーション
- フィールド - コンテンツフラグメントモデルで定義され、すべてのバリエーションで使用されます。
-
様々な参照を含めることができます。
バリエーションおよびフィールド variations-and-fields
左側のパネルには、次の情報が表示されます。
-
このフラグメントに作成された バリエーション のリスト。
- メイン は、コンテンツフラグメントの最初の作成時に存在するバリエーションです。後で他のバリエーションを追加できます
- 「バリエーションを生成（#generate-variations）」を使用すると、アドビが特定のユースケース用に作成したプロンプトベースのテンプレートを使用できます。
- また、バリエーションを作成できます
-
フラグメント内の フィールド とそのバリエーションは、次のとおりです。
- アイコンは、データタイプを示します
- テキストはフィールド名です
- これらを組み合わせると、（現在のバリエーションの）中央パネルのフィールドコンテンツへの直接リンクが提供されます
リンクへの移動 follow-links
エディターの様々な部分で、リンクアイコンが表示されます。 このアイコンを使用して、コンテンツフラグメントモデル、親参照または参照されているフラグメントなど表示されている項目を開くことができます。
構造ツリー structure-tree
エディターのツールバーから「構造ツリー」タブを開いて、コンテンツフラグメントの階層構造とその参照を表示します。 リンクアイコンを使用して参照に移動します。
保存と自動保存 saving-autosaving
更新を行うたびに、コンテンツフラグメントが自動的に保存されます。 最後に保存した時間が上部のツールバーに表示されます。
バリエーション variations
バリエーションは、AEM のコンテンツフラグメントの重要な機能です。 これにより、特定のチャネルやシナリオで使用する メイン コンテンツのコピーを作成および編集でき、ヘッドレスコンテンツ配信やページオーサリングをより柔軟に行うことができます。
エディターから、次の操作を実行できます。
-
メイン コンテンツのバリエーションを作成
-
「バリエーションを生成」AI を使用：生成 AI を使用すると、アドビが特定のユースケース用に作成したプロンプトベースのテンプレートを使用できます。
-
コンテンツの編集に必要なバリエーションを選択
バリエーションを作成 create-variation
コンテンツフラグメントのバリエーションを作成するには、次の手順に従います。
-
左側のパネルで、バリエーション の右側にある プラス記号（バリエーションを作成）を選択します。
note note NOTE 最初のバリエーションを作成すると、既存のバリエーションが同じパネルに表示されます。 
-
ダイアログで、必要に応じて、バリエーションの タイトル および 説明 を入力します。
-
バリエーションを 作成 します。 作成したバリエーションがリストに表示されます。
バリエーションの名前の変更 rename-variation
バリエーション の名前を変更するには、次の手順に従います。
-
必要なバリエーションを選択します。
-
右側のパネルの「プロパティ」タブをを開きます。
-
バリエーション タイトル を更新します。
-
「戻る」を押すか、別のフィールドに移動して、変更を自動保存します。 左側の バリエーション パネルでタイトルが更新されます。
「バリエーションを生成」で生成 AI を使用したバリエーションの作成 generate-variations-ai
生成バリエーションを使用して生成 AI を活用し、コンテンツ作成を高速化します。
コンテンツフラグメントエディターを開き、バリエーションを生成するためのエントリポイントを見つけます。
詳しくは、 バリエーションの生成 – AEM エディターに統合を参照してください。
バリエーションを削除 delete-variation
コンテンツフラグメントのバリエーションを削除するには、次の手順に従います。
<div class="extension note">
<div>NOTE</div>
<div>
<p><strong>メイン</strong> は削除できません。</p>
</div>
</div>
-
「バリエーション」を選択します。
-
バリエーション パネルで、削除アイコン（ごみ箱）を選択します。
-
ダイアログが表示されます。 「作成」を選択して、アクションを確定します。
複数行テキストフィールドの編集 - プレーンテキストまたはマークダウン edit-multi-line-text-fields-plaintext-markdown
複数行テキスト フィールドは、次の 3 つの形式のいずれかを持つことができます。
「プレーンテキスト」または「マークダウン」として定義されたフィールドには、（画面上の）書式設定オプションのないシンプルなテキストボックスがあります。
複数行テキストフィールドの編集 - リッチテキスト edit-multi-line-text-fields-rich-text
リッチテキスト として定義された 複数行テキスト フィールドでは、様々な機能を使用できます。
-
コンテンツを編集します。
- 取り消し／やり直し
- ペースト／テキストとしてペースト
- コピー
- 段落書式を選択
- テーブルを作成／管理
- テキストの書式設定（太字、斜体、下線、色）
- 段落の整列を設定
- リスト（箇条書き、番号付き）を作成／管理
- テキストをインデント（減らす、増やす）
- 現在の書式設定をクリア
- リンクを挿入
- 画像アセットへの参照を選択して挿入
- 特殊文字を追加
-
全画面表示エディター - 全画面とインフローの切り替え
次に例を示します。
全画面表示エディター - リッチテキスト full-screen-editor-rich-text
全画面表示エディターでは、インフロー時と同じ編集オプションを提供しますが、テキスト用のスペースがより広くなります。
次に例を示します。
統計 - リッチテキスト statistics-rich-text
アクション 統計 は、「複数行」フィールドに、テキストに関する様々な情報を表示します。
次に例を示します。
比較と同期 - リッチテキスト compare-and-synchronize-rich-text
アクション 比較 は、バリエーション を開いた際に「複数行」フィールドで使用できます。
これにより、「複数行」フィールドが全画面表示で開き、次のように表示されます。
-
メイン と現在の バリエーション の両方のコンテンツを横に並べ、違いをハイライト表示する
-
違いは色で示されます。
- 緑は（バリエーションに）追加されたコンテンツを示します
- 赤は削除されたコンテンツを示します（バリエーションからの削除）
- 青は置換されたテキストを示します
-
メイン から現在のバリエーションにコンテンツを同期する 同期 アクションを提供する
- メイン が更新された場合、これらの変更はバリエーションに転送される
- バリエーションが更新された場合、これらの変更は メイン からコンテンツによって上書きされる
note caution CAUTION 同期を使用できるのは、メイン からバリエーションに 変更内容をコピーする場合のみです。 バリエーションから メイン への変更内容を転送することはオプションとして使用できません。
例えば、バリエーションコンテンツが完全に書き換えられたシナリオの場合、同期によってその新しいコンテンツが メイン からのコンテンツに置き換わります。
参照の管理 manage-references
フラグメント参照 fragment-references
フラグメント参照は、次の目的で使用できます。
既存のコンテンツフラグメントへの参照を作成する create-reference-existing-content-fragment
既存のコンテンツフラグメントへの参照を作成するには、次の手順に従います。
-
フィールドを選択します。
-
「既存のフラグメントを追加」を選択します。
-
フラグメントセレクターから必要なフラグメントを選択します。
note note NOTE 一度に 1 つのフラグメントのみを選択できます。
コンテンツフラグメントおよび参照の作成 create-reference-content-fragment
または、「新規フラグメントを作成」を選択して、作成 ダイアログを開くことができます。 作成後、このフラグメントは参照されます。
コンテンツ参照 content-references
コンテンツ参照は、画像、ページ、エクスペリエンスフラグメントなど、他の AEM コンテンツタイプを参照するのに使用されます。
参照画像 reference-images
コンテンツ参照 フィールドでは、次の操作を実行できます。
-
ローカルリポジトリーに既に存在する参照アセット
-
リモートリポジトリーにある参照アセット
-
アセットをフィールドに直接アップロードします。これにより、Assets コンソールを使用してアップロードする必要がなくなります
note note NOTE 画像を直接「コンテンツ参照」フィールドにアップロードする際 必須 事項は、次のとおりです。 - コンテンツフラグメントモデルに ルートパス が定義されていること 画像を保存する場所を指定します。
- 許可されたコンテンツタイプのリストに 画像 が含められていること
参照ローカルAssets reference-local-assets
ローカルアセットを参照するには、次のいずれかを実行します。
-
新しいアセットファイルを（例えば、ファイルシステムから）「コンテンツ参照」フィールドに直接ドラッグ＆ドロップします
-
アセットを追加 アクションを選択して、「アセットを参照」または「アップロード」を選択して、使用する適切なセレクターを開きます。
参照リモートAssets reference-remote-assets
リモートアセットを参照するには：
-
アセットを参照する際にリモートの リポジトリ を指定します。
-
選択後、アセット情報内に場所が表示されます。
リモートAssets – 制限 remote-assets-limitations
リモートアセットを参照する場合は、いくつかの制限があります。
-
リモートアセットリポジトリからの参照には、 承認済みアセットのみを使用できます。
-
参照されているアセットがリモートリポジトリーから削除されると、コンテンツ参照が破損します。
-
ユーザーがアクセス権を持つすべての配信アセットリポジトリーを選択できますが、使用可能リストは制限できません。
-
AEM インスタンスとリモートアセットリポジトリーインスタンスは、両方とも同じバージョンである必要があります。
-
管理 API または配信 API 経由で公開されるアセットメタデータがありません。 アセットメタデータの詳細を取得するには、Asset Metadata API を使用する必要があります。
-
個々のアセットメタデータ：https://adobe-aem-assets-delivery.redoc.ly/#operation/getAssetMetadata
-
検索 API を使用して一括メタデータ情報を取得（試行用）: https://adobe-aem-assets-delivery-experimental.redoc.ly/#operation/search
-
参照ページ reference-pages
AEM ページ、エクスペリエンスフラグメントまたはその他のコンテンツタイプへの参照を追加するには、次の手順を実行します。
-
「コンテンツのパスを追加」を選択します。
-
入力フィールドに必要なパスを追加します。
-
「追加」で確定します。
親参照の表示 view-parent-references
上部のツールバーでリンクアイコンを選択すると、すべての親参照のリストが開きます。
次に例を示します。
ウィンドウが開き、関連するすべての参照が表示されます。 参照を開くには、名前、タイトルまたはリンクアイコンを選択します。
次に例を示します。
プロパティおよびタグの表示 view-properties-tags
右側のパネルの「プロパティ」タブでは、プロパティ（メタデータ）とタグを表示できます。 プロパティは次のいずれかになります。
- コンテンツフラグメント - メイン が現在選択されている場合
- 特定の バリエーション
プロパティおよびタグの編集 edit-properties-tags
「プロパティ」タブ（右側のパネル）では、次の項目も編集できます。
-
タイトル
-
説明
-
タグ：ドロップダウンリストまたは選択ダイアログを使用
コンテンツフラグメントモデルを開く open-content-fragment-model
「メイン」を選択した場合、基になるコンテンツフラグメントモデルの名前が「プロパティ」セクションに表示されます。 リンクアイコンを選択すると、モデルが別のタブで開きます。
次に例を示します。
バージョン履歴の表示 view-version-history
右側のパネルの「バージョン履歴」タブに、現在のバージョンと以前のバージョンの詳細が表示されます。
バージョンの比較 compare-version
コンテンツフラグメントについては、以前のバージョンと現在のバージョンを比較できます。
以前のバージョンと現在のバージョンを比較するには、次の手順を実行します。
-
バージョンの横にある 3 点ドットアイコンを選択します。
-
「比較」を選択します。
これで、コンテンツの現在のバージョンとコンテンツフラグメントの選択した以前のバージョンとの違いを表示するビューが開きます。 変更のあるバリエーション ドロップダウンで、メインコンテンツやバリエーションのコンテンツとの違いを表示するように選択できます。
違いは色で示されます。
- 緑は（現在のバージョンに）追加されたコンテンツを示します
- 赤は（現在のバージョンから）削除されたコンテンツを示します
特定のバージョンに戻す revert-version
どのバージョンにも戻すことができます。
特定のバージョンに戻すには、次の手順に従います。
-
バージョンの横にある 3 点ドットアイコンを選択します。
-
「元に戻す」を選択します。
言語コピーの表示 view-language-copies
関連する言語コピーの「言語プロパティ」タブの詳細が表示されます。 リンクアイコンを選択すると、そのコピーが別のタブで開きます。
次に例を示します。
フラグメントへのコメント commenting-on-your-fragment
製品内およびコンテキスト内での共同作業を有効にするには、右側のパネルの「コメント」タブに次の機能があります。
- 新しいコメントを追加
- コメントで特定のユーザーをタグ付け
- フラグメントを直接開くリンクを含む通知が届きます
- 既存のコメントに「いいね！」を付ける
- コメントに返信
- コメントを書式設定。基本的な書式設定が使用できます。
- 既存のコメントを通じてテキスト検索を実行
- 既存のコメントを編集
- コメントを削除
フラグメントのプレビュー preview-content-fragment
コンテンツフラグメントエディターは、編集内容を外部フロントエンドアプリケーションでプレビューするオプションを作成者に提供します。
この機能を使用するには、まず次の操作が必要です。
- IT チームと協力して、JSON 出力を使用してコンテンツフラグメントをレンダリングする外部フロントエンドアプリケーションを設定します。
- 外部フロントエンドアプリケーションが設定されると、デフォルトのプレビュー URL パターン は、適切なコンテンツフラグメントモデルのプロパティとして定義される必要があります。
URL が定義されると、「プレビュー」ボタンがアクティブになります。 このボタンを選択すると、（別のタブで）外部アプリケーションを起動して、コンテンツフラグメントをレンダリングできます。
フラグメントの公開 publish-content-fragment
フラグメントを次のいずれかに 公開 できます。
- プレビューインスタンス
- パブリッシュインスタンス
フラグメントは、エディターまたはコンソールから公開できます。 詳しくは、フラグメントの公開とプレビューを参照してください。
フラグメントを非公開 unpublish-content-fragment
また、フラグメントを次のいずれかで 非公開 にすることができます。
- プレビューインスタンス
- パブリッシュインスタンス
フラグメントは、エディターまたはコンソールから非公開にすることができます。 詳しくは、フラグメントの非公開を参照してください。
フィールド、データタイプおよびアイコン fields-datatypes-icons
フィールド パネルには、コンテンツフラグメント内のすべてのフィールドが一覧表示されます。 アイコンは、データタイプ を示します。
タブプレースホルダー
実際のアイコンでは表されませんが、タブプレースホルダー は左側のパネルに表示されます。
中央のパネルでも、図のように水平方向に表示されるか、ドロップダウンリストで表示されます（水平方向に表示するには数が多すぎる場合）。
役に立つ知識 good-to-know
-
コンテンツフラグメントを編集するには、適切な権限が必要になります。 問題が発生している場合は、システム管理者にお問い合わせください。
例えば、
edit権限を持っていない場合、エディターは読み取り専用になります。 -
コンテンツフラグメントモデルでは、多くの場合、タイトル および 説明 の名前が付けられたデータフィールドを定義できます。 これらのフィールドが存在する場合、それらはユーザー定義のフィールドであり、フラグメントの編集中に 中央パネル で更新できます。
コンテンツフラグメントとそのバリエーションには、タイトル および 説明 とも呼ばれるメタデータフィールド（バリエーションのプロパティ）もあります。 これらのフィールドは、コンテンツフラグメントの不可欠な部分で、フラグメントの作成時に最初に定義されます。 これらは、フラグメントの編集中に 右パネル で更新できます。
-
元のコンテンツフラグメントエディターの完全な情報については、Assets ドキュメントを参照してください - Assets コンソールと コンテンツフラグメント コンソールのどちらからでも利用できます。
-
必要に応じて、プロジェクトチームはエディターをカスタマイズできます。 詳しくは、コンテンツフラグメントコンソールとエディターのカスタマイズを参照してください。