マップ コンソールの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 プリセットを作成するには、次の手順を実行します。
-
出力プリセット パネルで、「+」アイコンを選択して出力プリセットを作成します。
-
新規出力プリセット ダイアログボックスの タイプ ドロップダウンから 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 の値は現在の作業コピーから取得されます。フォールバックとしてのマップ プロパティの使用
文字列、日付、または長い（単一および複数値）プロパティのみをAEM サイトのページに渡すことができます。 文字列タイプのプロパティのメタデータ値は、特殊文字（
@, #, " " など）をサポートしていません。*このオプションは、
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 の値は現在の作業コピーから取得されます。フォールバックとしてのマップ プロパティの使用
文字列、日付、または長い（単一および複数値）プロパティのみをAEM サイトのページに渡すことができます。 文字列タイプのプロパティのメタデータ値は、特殊文字（
@, #, " " など）をサポートしていません。*このオプションは、
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 は、1 つまたは複数のマップに存在できます。 各リンクの親マップと、特定のプリセットまたは最近公開された出力を選択できます。 -
同じトピックがファイル内で複数回参照される場合は、インスタンスごとに異なる公開コンテキストを追加できます。 これにより、コンテンツの柔軟性と制御が向上します。 たとえば、Topic 3 は Map B と Map C の両方に存在します。Topic 1 には、Topic 3 への 2 つの参照が含まれています。 最初のリンクの親マップとしてマップ B を選択し、2 番目のリンクの親としてマップ C を選択できます。
-
親マップのプリセット ドロップダウンリストで、現在のマップの出力をリンクする出力プリセットを選択します。
note note NOTE ドロップダウンリストには、現在のマップの様々なAEM Sites プリセットが表示されます。 プリセットを選択しないと、警告アイコンが表示され、出力の生成に失敗します。 -
すべてのソーストピックで必要なマップとその出力プリセットを選択して、「生成」を選択します。
親トピック： 出力プリセットについて