マップコンソールでのAEM Sites プリセット
マップコンソールからAEM Sites プリセットを作成し、AEM Sites出力を生成するように設定できます。 AEM Sites出力を作成するには、次の2つの方法があります。
複合コンポーネントマッピングの使用
複合コンポーネントマッピングでは、従来のコンポーネントマッピングと比較して、AEM Sitesへの公開をより迅速かつスケーラブルに行うことができます。 AEMのテンプレートエディターを使用して、必要に応じてカスタマイズできる、すぐに使用できる編集可能なテンプレートが付属しています。 テンプレートでは、WCM コアコンポーネントと専用のguides-componentsを組み合わせて使用することで、エンドユーザーがAEM Sites ページで最高のエクスペリエンスを得られるようにします。 また、複合コンポーネントマッピング方式を使用して、既存のテンプレートをカスタマイズすることもできます。
Experience Manager Guidesには、AEM Sitesを作成するための定義済みテンプレートが用意されています。 これらのテンプレートは、コンテンツのレイアウトと構造の一貫性を確保するのに役立ちます。
- これらの定義済みテンプレートに基づいて ホームページ を作成します。
- トピックテンプレート を編集し、要件に応じてスタイルを適用できます。
- また、既存のAEM Sites テンプレートを カスタマイズすることもできます。
AEM Sites プリセットの作成
複合コンポーネントマッピングを使用してAEM Sites プリセットを作成するには、次の手順を実行します。
-
出力プリセット パネルで、「+」アイコンを選択して出力プリセットを作成します。
-
新しい出力プリセット ダイアログボックスのType ドロップダウンから AEM Sites を選択します。
-
「レガシーコンポーネントマッピングを使用」オプションの選択を解除します。
-
「現在のフォルダープロファイルに追加」オプションを選択して、現在のフォルダープロファイル内に出力プリセットを作成します。
グローバルおよびフォルダープロファイル出力プリセットの管理の詳細をご覧ください。
-
「追加」を選択します。
AEM Sitesのプリセットが作成されます。
複合コンポーネントマッピング用のAEM Sites プリセット設定
- オンプレミスソフトウェア: オンプレミスソフトウェア用のAEM Sites テンプレート を ダウンロードしてインストールする方法について詳しく説明します。
- Cloud Service: Cloud Service用AEM Sites テンプレート をダウンロードしてインストールする方法について詳しく説明します。
マップコンソールでは、複合コンポーネントマッピングのプリセット設定オプションが次のタブに整理されています。
- 一般
- コンテンツ
- トピックリスト
- クロスマップ参照
一般
「一般」タブには、次の設定オプションが含まれています。
サイトパスの設定時に変数を使用することもできます。 詳細については、宛先パス、サイト名、またはファイル名のオプションを設定するための変数の使用を参照してください
「更新
AEMG-Docsに、公開パスをaemg-docs-en/docs/product-abc.に指定した場合、AEM Sites出力はaemg-docs-en/docs/product-abc/のcrx/de ノードの下に生成されます。トピックタイトル: DITA トピックのタイトルを使用して、Experience Manager サイト名を作成します。
トピック a.dita、b.dita、およびc.ditaを含むDITA マップを公開したとします。 マップを再度公開する前に、マップからb.dita トピックを削除しました。 これで、このオプションを選択した場合、b.ditaに関連するすべてのコンテンツがAEM Sites出力から削除され、a.ditaとc.ditaのみが公開されます。
メモ：削除されたページに関する情報も、出力生成ログに取り込まれます。 ログファイルへのアクセスについて詳しくは、 ログファイルを表示して確認してください。
注意：トピックを削除すると、公開されたサイトからページを使用できなくなります。 トピックが削除される前に、警告が表示されます。 削除することを確認してください。
- このパスで他のソースによって作成されたすべてのページを削除：このオプションを選択すると、他のマップ、個々のトピック、またはその他のソースからこのパスに公開されているすべてのページが削除されます。 ページは、公開されたサイトからも利用できなくなります。 トピックが削除される前に、警告が表示されます。 削除することを確認してください。
コンテンツ
「コンテンツ」タブには、次の設定オプションが含まれています。
なし：公開された出力に条件を適用しない場合は、このオプションを選択します。
DITAVALの使用：条件付きコンテンツを生成するには、DITAVAL ファイルを選択します。 参照ダイアログまたはファイルパスを入力して、複数のDITAVal ファイルを選択できます。 ファイル名の近くにある十字アイコンを使用して削除します。 DITAVal ファイルは指定された順序で評価されるので、最初のファイルで指定された条件は、後のファイルで指定された一致する条件よりも優先されます。 ファイルを追加または削除することで、ファイルの順序を維持できます。 DITAVal ファイルが別の場所に移動されたり、削除されたりした場合、マップダッシュボードから自動的に削除されることはありません。 ファイルが移動または削除された場合は、場所を更新する必要があります。 ファイル名にカーソルを合わせると、ファイルが保存されているAEM リポジトリ内のパスを表示できます。 DITAVal ファイルのみを選択でき、他のファイルタイプを選択した場合はエラーが表示されます。
条件プリセット：出力の公開中に条件を適用するには、ドロップダウンから条件プリセットを選択します。 このオプションは、DITA マップファイルの条件を追加した場合に表示されます。 条件設定は、DITA マップコンソールの「条件プリセット」タブで使用できます。 条件プリセットについて詳しくは、条件プリセットの使用を参照してください。
ファイル（Assets）のプロパティ
注: メタデータのプロパティでは、大文字と小文字が区別されます。
ベースラインを選択した場合、プロパティの値は、選択したベースラインのバージョンに基づきます。ベースラインを選択していない場合、プロパティの値は最新バージョンに基づいています。
DITA-OT パブリッシングを使用して、メタデータを出力に渡すこともできます。 詳細については、DITA-OTを使用してメタデータを出力に渡します。
注意: 「プロパティ」オプションで
cq:tagsを定義していない場合、公開用のベースラインを選択した場合でも、cq:tagsの値が現在の作業コピーから選択されます。マッププロパティをフォールバックとして使用
文字列、日付、または長い（1つの値と複数値の）プロパティのみをAEM サイトページに渡すことができます。String タイプ プロパティのメタデータ値は、特殊文字（
@, #, " "など）をサポートしていません。*このオプションは、
Properties オプションと共に使用する必要があります。トピックリスト
「トピックリスト」タブには、DITA マップの現在の作業コピーに存在するトピックのリストが表示されます。 デフォルトでは、すべてのトピックが含まれています。 特定のトピックを選択し、そのトピックに対してのみAEM Sites出力を生成できます。 例えば、一部のトピックを更新して、DITA マップ全体を公開するのではなく、それらのトピックのみを公開できるようにします。
クロスマップ参照
このリストには、scope ="peer"とのクロスマップ参照を含むトピックが含まれています。 他のDITA マップで使用可能なトピックにscope="peer"を含むクロスマップ参照のリストに対して、公開コンテキストを指定できます。 このタブは、Experience Manager Guides（UUID）バージョンを使用している場合に表示されます。
詳細については、以下の「 リンクされたトピックの操作」セクションを参照してください。
設定が完了したら、変更をプリセットに保存し、生成を選択して、対応するマップのAEM Sitesを生成します。
従来のコンポーネントマッピングの使用
従来のコンポーネントマッピングを使用してAEM Sites プリセットを作成する手順は、上記の コンポーネントマッピング セクションで説明した手順と同じです。 ただし、プリセットの作成中は、新規出力プリセット ダイアログで「レガシーコンポーネントマッピングを使用」オプションを選択していることを確認してください。
マップコンソールでは、従来のコンポーネントマッピングのプリセット設定オプションが次のタブに整理されています。
- 一般
- コンテンツ
- クロスマップ参照
一般
「一般」タブには、次の設定オプションが含まれています。
ここで指定した名前のAEM リポジトリ内のノードが作成されます。 サイト名を指定しない場合、サイトノードはDITA マップファイル名で作成されます。
ここで指定したサイト名は、ブラウザータブのタイトルとしても使用されます。
サイト名の設定時に変数を使用することもできます。 詳細については、宛先パス、サイト名、またはファイル名のオプションを設定するための変数の使用を参照してください
user-guide、出力パスを/content/output/aem-guidesに指定した場合、最終的な出力は/content/output/aem-guides/user-guide ノードの下に生成されます。出力パスの設定時に変数を使用することもできます。 詳細については、宛先パス、サイト名、またはファイル名のオプションを設定するための変数の使用を参照してください
公開中に既存のページを強制的に削除するには、削除および作成 オプションを選択します。 このオプションは、ページノードとそのコンテンツおよびその下のすべての子ページを削除します。 出力プリセットのデザインテンプレートを変更した場合、または出力先に既に存在する追加ページを削除する場合は、このオプションを使用します。
トピック a.dita、b.dita、およびc.ditaを含むDITA マップを公開したとします。 マップを再度公開する前に、マップからb.dita トピックを削除しました。 これで、このオプションを選択した場合、b.ditaに関連するすべてのコンテンツがAEM Sites出力から削除され、a.ditaとc.ditaのみが公開されます。
メモ：削除されたページに関する情報も、出力生成ログに取り込まれます。 ログファイルへのアクセスについて詳しくは、 ログファイルを表示して確認してください。
注意：トピックを削除すると、公開されたサイトからページを使用できなくなります。 トピックが削除される前に、警告が表示されます。 削除することを確認してください。
カスタムデザインテンプレートを使用して出力を生成する方法について詳しくは、公開管理者にお問い合わせください。
出力を生成したら、一時ファイルをダウンロード
メモ: ファイルのプロパティが生成中に追加された場合、出力された一時ファイルには、それらのプロパティを含むmetadata.xml ファイルも含まれます。
コンテンツ
「コンテンツ」タブには、次の設定オプションが含まれています。
なし：公開された出力に条件を適用しない場合は、このオプションを選択します。
DITAVALの使用：条件付きコンテンツを生成するには、DITAVAL ファイルを選択します。 参照ダイアログまたはファイルパスを入力して、複数のDITAVal ファイルを選択できます。 ファイル名の近くにある十字アイコンを使用して削除します。 DITAVal ファイルは指定された順序で評価されるので、最初のファイルで指定された条件は、後のファイルで指定された一致する条件よりも優先されます。 ファイルを追加または削除することで、ファイルの順序を維持できます。 DITAVal ファイルが別の場所に移動されたり、削除されたりした場合、マップダッシュボードから自動的に削除されることはありません。 ファイルが移動または削除された場合は、場所を更新する必要があります。 ファイル名にカーソルを合わせると、ファイルが保存されているAEM リポジトリ内のパスを表示できます。 DITAVal ファイルのみを選択でき、他のファイルタイプを選択した場合はエラーが表示されます。
条件プリセット：出力の公開中に条件を適用するには、ドロップダウンから条件プリセットを選択します。 このオプションは、DITA マップファイルの条件を追加した場合に表示されます。 条件設定は、DITA マップコンソールの「条件プリセット」タブで使用できます。 条件プリセットについて詳しくは、条件プリセットの使用を参照してください。
ファイル（Assets）のプロパティ
注: メタデータのプロパティでは、大文字と小文字が区別されます。
ベースラインを選択した場合、プロパティの値は、選択したベースラインのバージョンに基づきます。ベースラインを選択していない場合、プロパティの値は最新バージョンに基づいています。
DITA-OT パブリッシングを使用して、メタデータを出力に渡すこともできます。 詳細については、DITA-OTを使用してメタデータを出力に渡します。
注意: 「プロパティ」オプションで
cq:tagsを定義していない場合、公開用のベースラインを選択した場合でも、cq:tagsの値が現在の作業コピーから選択されます。マッププロパティをフォールバックとして使用
文字列、日付、または長い（1つの値と複数値の）プロパティのみをAEM サイトページに渡すことができます。String タイプ プロパティのメタデータ値は、特殊文字（
@, #, " "など）をサポートしていません。*このオプションは、
Properties オプションと共に使用する必要があります。クロスマップ参照
このリストには、scope ="peer"とのクロスマップ参照を含むトピックが含まれています。 他のDITA マップで使用可能なトピックにscope="peer"を含むクロスマップ参照のリストに対して、公開コンテキストを指定できます。 このタブは、Experience Manager Guides（UUID）バージョンを使用している場合に表示されます。
詳細については、以下の「 リンクされたトピックの操作」セクションを参照してください。
リンクされたトピックの操作
Experience Manager Guidesでは、peer @scopeを使用してトピック参照を作成できます。 次に、AEM Sites プリセットからこれらの参照の公開コンテキストを定義し、リンクされたトピックの出力を最終的に生成できます。
詳細については、他のマップからトピックをリンクする出力を生成を参照してください。
次の手順を実行して、相互リンクされたファイルの公開コンテキストを指定します。
-
「クロスマップ参照」タブを開きます。 このタブを表示するには、
<xrefs>に一意のIDがあることを確認してください。<xrefs>の一意のIDは、IDがない場合、古いコンテンツの編集または保存時に自動的に生成されます。次の場合、クロスマップリンクを表示できません。
- 4.6 リリースより前に作成されたプリセットについては、「相互参照」タブが無効になり、「マップダッシュボードを参照」というツールヒントが表示されます。
- マップダッシュボードから作成されたプリセットについては、マップダッシュボード ツールヒントを参照してください。
- OOTB プリセットについては、マップダッシュボードのツールヒントを参照してください。
- グローバルプリセットの場合は、このグローバルプリセットのローカルコピーを作成して、クロスマップ参照を設定します。
-
トピックとその参照のリストが表示されます
note note NOTE 「クロスマップ参照」タブには、 scope="peer"のみを使用してリンクされているトピックが表示されます。scope="local"のリンクの場合、公開コンテキストを指定する必要はありません。リンクされたすべてのトピックには、最新の出力プリセットとマップがデフォルトで選択されています。 リンクされたすべてのトピックの公開コンテキストは、デフォルトで
<Most recently generated>マップに設定されています。
-
マップ内の各依存ファイルの最近公開された出力を使用する場合は、すべての依存トピックに対して最近生成された公開コンテキストを使用するを選択します。
リンクされたトピックを含むマップを公開する前に、親マップとして選択したマップを公開する必要があります。 リンクされたトピックを含むマップが公開されていない場合、リンクはAEM Sites出力にハイパーリンクではなく通常のテキストとして表示されます。
リンクされたトピックに対して、同じ種類のAEM Sites プリセットを選択する必要があります。 例えば、現在のAEM Sites プリセットで従来のコンポーネントマッピングを使用している場合は、リンクされたトピックの同様のAEM Sites プリセットを選択します。 -
親マップ ドロップダウンリストで、現在のマップの出力をリンクする出力を含むマップファイルを選択します。
マップファイルを選択すると、親マップ UUID列にマップのUUIDが表示されます。 選択したマップに関連付けられている出力プリセットは、親マップのプリセットリストにリストされます。 例えば、マップ Aのトピック 1には、トピック 2への参照が含まれています。 トピック 2は、単一または複数のマップで使用できます。 親マップと、各リンクに対して特定のプリセットまたは最近公開された出力を選択できます。 -
同じトピックがファイル内で複数回参照される場合は、各インスタンスに対して異なる公開コンテキストを追加できます。 これにより、コンテンツに対する柔軟性と制御が向上します。 例えば、トピック 3はマップ Bとマップ Cの両方に存在します。トピック 1には、トピック 3への2つの参照が含まれています。 最初のリンクの親マップとしてマップ Bを選択し、2番目のリンクの親としてマップ Cを選択できます。
-
親マップのプリセット ドロップダウンリストで、現在のマップの出力をリンクする出力プリセットを選択します。
note note NOTE 現在のマップの様々なAEM Sites プリセットがドロップダウンリストに表示されます。 プリセットを選択しないと、警告アイコンが表示され、出力生成が失敗します。 -
すべてのソーストピックに必要なマップとその出力プリセットを選択し、生成を選択します。
親トピック： 出力プリセットについて