レポートの操作
マップダッシュボードの「レポート」タブでは、壊れたリンク、参照および再利用されるコンテンツ(conrefs)、相互参照、またはその他の欠落している情報を特定して解決できます。
演習の準備
練習用のサンプルファイルはここからダウンロードできます。
Assetsのアップロード
-
リポジトリビューで、メインフォルダーの省略記号アイコンを選択して、オプションメニューを開きます。
-
「Assetsをアップロード」を選択します。
-
フォルダーにアップロードするファイルを選択し、アップロードを選択します。
DITA ファイルが開き、コンテンツが見つからない場合、conrefsまたは相互参照に関する問題がないか確認する必要があります。
マップの作成
-
メインフォルダーの省略記号アイコンを選択して、オプションメニューを開きます。
-
作成/マップを選択します。
新しいマップを作成ダイアログが表示されます。
-
「テンプレート」フィールドで、ドロップダウンメニューから「Bookmap」(または、作成するコンテンツタイプに基づいて「Map」)を選択し、マップにタイトルを付けます。
-
「作成」を選択します。
マップが作成され、左側のパネルがリポジトリビューからマップビューに自動的に変更されます。
マップコンポーネントの挿入
-
左側のパネルで鉛筆アイコンを選択します。
これは編集アイコンで、マップをエディターで開くことができます。
-
リポジトリアイコンを選択して、リポジトリビューに戻ります。
-
リポジトリからエディターのマップにトピックをドラッグ&ドロップして、マップにトピックを追加します。
折れ線インジケーターは、トピックが配置される場所を示します。 -
必要に応じてトピックを追加し続けます。
-
完了したら、新しいバージョンとして保存を選択します。
-
新しいバージョン の コメント フィールドに、説明コメントを入力します。
-
「保存」を選択します。
AEM サイト出力の生成
-
リポジトリで、マップ上の省略記号アイコンを選択してオプションメニューを開き、マップダッシュボードを開きます。
マップダッシュボードが別のタブで開きます。
-
「出力プリセット」タブで、「AEM サイト」を選択します。
-
「生成」を選択します。
-
出力ページに移動して、生成された出力のステータスを表示します。
エラーがある場合、「出力」タブには、生成が完了したことを示す緑色ではなく、「生成設定」列の下にオレンジ色の円が表示される場合があります。 -
「生成設定」列の下にあるリンクを選択して、生成された出力を開きます。
不足しているコンテンツについて出力を確認します。
「レポート」タブ
「レポート」タブには、トピックの概要、トピック情報とマップ内の問題を含むテーブルが表示されます。
コンテンツを読み込んだ後は、必ずレポートでマップを確認することをお勧めします。
欠落している要素の列には、欠落している画像と壊れているconrefの数が示されます。 鉛筆 アイコンを選択して、エディターでトピックを開くことができます。
見つからない画像の解決
ファイルに画像が見つからない場合は、コンテンツがアップロードされたが、画像がアップロードされていないことが一般的な原因である可能性があります。 その場合は、ファイルで想定されるパスとファイル名に一致する特定のフォルダーに画像をアップロードして、画像の欠落に関する問題を解決します。
-
リポジトリビューで、画像フォルダーの省略記号アイコンを選択して、オプションメニューを開きます。
-
「Assetsをアップロード」を選択し、見つからない画像を選択します。
-
「アップロード」を選択します。
欠落している画像がアップロードされました。 これで、新しく生成されたAEM サイト出力にこれらの画像が表示され、「レポート」タブに不足している画像エラーが表示されなくなります。
壊れたconrefsの解決
別の場所で参照されているコンテンツ(conref)が、別のフォルダー内のファイルにリンクされている場合(例えば、「再利用」という名前のファイル)。 コンテンツがアップロードされない場合は、エラーを解決する必要があります。 例えば、「reuse」という名前のサブフォルダーを作成し、見つからないファイルを「reuse」にアップロードする必要があります。
Assets UIを使用したアセットのアップロード
「Assetsをアップロード 」オプションに加えて、Assets UIにドラッグ&ドロップしてアセットをアップロードできます。
-
リポジトリビューで、再利用フォルダーの省略記号アイコンを選択して、オプションメニューを開きます。
-
Assets UI で「表示」を選択します。
-
ファイルをフォルダーにドラッグ&ドロップします。
ファイルがアップロードされ、conref エラーが解決されます。
すべてのエラーが解決されました。 レポートページにはエラーがなくなり、AEM サイトを生成すると、コンポーネントが欠落することなく完全な出力になります。