4.1.x リリースのAdobe Experience Manager Guides
このリリースノートでは、Adobe Experience Manager Guides（後で AEM Guides と呼ばれる）のバージョン 4.1.x のアップグレード手順、新機能および機能強化について説明します。
最新リリースへのアップグレード
AEM Guidesの現在のバージョンを 4.1.3 に簡単にアップグレードできます。AEM Guidesのバージョン 4.1.3 へのアップグレードを行う前に、次の点を考慮する必要があります。
- バージョン 4.1 または 4.1.x を使用している場合は、バージョン 4.1.3 に直接アップグレードできます。
- バージョン 4.0.x を使用している場合は、4.1.3 にアップグレードする前にバージョン 4.1 または 4.1.x にアップグレードする必要があります。
- バージョン 3.8.5 を使用している場合は、4.1 にアップグレードする前にバージョン 4.0.x にアップグレードする必要があります。
- 使用しているバージョンが 3.8.5 より前の場合は、製品固有のインストール ガイドのアップグレード セクションを参照してください。
詳しくは、 アップグレードの手順を参照してください。
4.1.3 | リリースノート
互換性マトリックス
この節では、AEM Guides 4.1.3 リリースでサポートされるソフトウェアアプリケーションの互換表を示します。
ADOBE EXPERIENCE MANAGER
非 UUID
バージョン 6.5 サービスパック 13、12、11、10
UUID
バージョン 6.5 サービスパック 13、12、11、10
詳しくは、Adobe Experience Manager Guidesのインストールと設定ガイドの技術要件の節を参照してください。
FrameMakerとFrameMaker Publishing Server
*AEMで作成されたベースラインと条件は、2020.2 以降の FMPS リリースでサポートされます。
酸素コネクタ
修正された問題
修正されたバグを以下に示します。
- Web エディターが空白のページを断続的に読み込む。 （10678）
4.1.2 | リリースノート
互換性マトリックス
この節では、AEM Guides 4.1.2 リリースでサポートされるソフトウェアアプリケーションの互換表を示します。
ADOBE EXPERIENCE MANAGER
非 UUID
バージョン 6.5 サービスパック 13、12、11、10
UUID
バージョン 6.5 サービスパック 13、12、11、10
詳しくは、Adobe Experience Manager Guidesのインストールと設定ガイドの技術要件の節を参照してください。
FrameMakerとFrameMaker Publishing Server
*AEMで作成されたベースラインと条件は、2020.2 以降の FMPS リリースでサポートされます。
酸素コネクタ
修正された問題
様々な領域で修正されたバグを以下に示します。
- すべてのフォルダープロファイルを選択すると、非表示のフォルダープロファイル（正しくない）が表示されます。 （10393）
- ユーザーのタイムゾーンがサーバーのタイムゾーンと異なる場合、ベースラインの作成で最新バージョンが選択されない。 （10336）
- AEM Guides 4.1 のインストール後、Control + F ショートカットを使用しても、Assets コンソールでブラウザー検索モーダルが開かない。 （10339）
- フォルダーへの参照を持つトピックに対して、ベースライン作成エラーが発生します。 （10383）
- 「出力プリセット」タブに空白の画面が断続的に表示され、編集できないプリセットが表示される場合があります。 （10390）
- キースペース管理は、例外やエラーの原因となります。 （10449）
回避策に関する既知の問題
-
翻訳時に書き出されたベースラインが、エディターの「ベースライン」タブに読み込まれない。
回避策: DITA マップダッシュボードの「ベースライン」タブを使用します。
4.1 | リリースノート
このリリースノートでは、Adobe Experience Manager Guides（後で AEM Guides と呼ばれる）のバージョン 4.1.x のアップグレード手順、新機能および機能強化について説明します。
互換性マトリックス
この節では、AEM Guides 4.1 リリースでサポートされるソフトウェアアプリケーションの互換表を示します。
ADOBE EXPERIENCE MANAGER
非 UUID
バージョン 6.5 サービスパック 13、12、10、11
UUID
バージョン 6.5 サービスパック 13、12、10、11
詳しくは、Adobe Experience Manager Guidesのインストールと設定ガイドの技術要件の節を参照してください。
FrameMakerとFrameMaker Publishing Server
*AEMで作成されたベースラインと条件は、2020.2 以降の FMPS リリースでサポートされます。
酸素コネクタ
新機能と機能強化
AEM Guidesは、4.1 リリースで多くの機能強化と新機能を提供しています。
ネイティブPDF公開
ネイティブPDFの作成のサポートは、AEM Guides 4.1 リリースでも追加されました。 次の機能を備えた新しいパブリッシュエンジンが導入されました。
- CSS テンプレートの作成
- 様々なページテンプレートの作成
- CSS とページテンプレートで構成されるデザインPDFテンプレート
- PDF形式のPublishのマップとトピックコンテンツ
記事ベースの公開でのナレッジベースサイトパスのサポート
AEM Guidesには、1 つ以上のトピックの出力を増分的に生成したり、コンテンツをナレッジベースプラットフォームに公開したりするための記事ベースの公開機能が用意されています。 4.1 リリースでは、トピック/マップを公開する必要があるナレッジベースのサイトパスを選択する追加のオプションがあります。 パスを選択すると、指定したパスに出力が生成されます。
Web エディターの強化
- キーの解像度の向上
DITA コンテンツキー参照は、あるトピックから別のトピックにコンテンツの一部を挿入します。 キーを使用してコンテンツを検索します。 DITA トピックに関連付けられたキー参照を解決する必要があります。 キー参照を解決する場合、選択したルートマップが最も優先されます。
これで、次の優先順位で設定されたルート マップに基づいて、キー参照が解決されます。
- ユーザーの環境設定
- マップ ビューパネル
- フォルダープロファイル
詳しくは、Adobe Experience Manager Guidesの使用ガイドの キー参照の解決 の節を参照してください。
- 左パネルでのカスタムパネルの追加
これで、web エディターの左パネル内にカスタムパネルを追加できます。 カスタムパネルは、ヘルプの提供やプロジェクトのテストなど、様々な目的で使用できます。 カスタムパネルが設定されている場合は、エディター設定 内のパネルのリストにも表示されます。 スイッチを切り替えて、カスタムパネルの表示と非表示を切り替えることができます。
- DITA マップ内のトピックの文書状態を変更する機能
これで、DITA マップ内で選択したトピックの文書状態を簡単に変更できます。 DITA マップ内の選択したトピックのプロパティを、「マップビュー」パネルの下部にある その他のオプション メニューから開いて編集することもできます。
- プレビューモードで表示されるバージョン情報
Web エディターは、バージョンの管理に役立ちます。 トピックのプレビューモードで、トピックの「ファイル」タブの右上隅にアクティブなトピックのバージョンまたは DITA マップが表示されるようになりました。
- Web エディターの更新動作の改善
Web エディターのブラウザー更新操作で、次の機能強化が利用できるようになりました。
-
これで、の編集中にブラウザーを更新するサポートを受けることができます
web エディターのコンテンツ。 ブラウザーの更新アイコンをクリックした際に、1 つ以上のファイルに次の情報が含まれている場合：
保存されていない変更は編集のために開かれ、ファイルを保存するか、更新操作をキャンセルするかを尋ねられます。 -
ブラウザーを更新しても、左パネルと右パネルのビューは保持されます。
-
アクティブなトピックまたは DITA マップがコンテンツ編集領域で再び開きます。
-
カスタマイズされたテンプレートに基づいてマップを作成する
これで、カスタマイズされたマップ テンプレートを作成する強力な機能が得られます。 これらを使用して、マップテンプレートで参照されるトピックテンプレートおよびマップテンプレートとともに DITA マップを作成できます。
カスタマイズしたマップ テンプレートから、他のマップ テンプレートおよびトピック テンプレートを参照することもできます。 参照されるマップ テンプレートは、さまざまなマップ テンプレート、トピック テンプレート、トピック、マップ、イメージ、ビデオ、およびその他のアセットを参照できます。
カスタマイズされたマップ テンプレートを使用すると、マップ テンプレートおよび参照されているフォルダ構造全体を非常に簡単に複製できます。 これらのカスタマイズされたテンプレートは、再帰構造と参照を持つ複数のマップを作成および再作成する場合に特に便利です。
- Schematron サポート
「スキーマトロン」は、XML ファイルのテストを定義するために使用される、ルールベースの検証言語を参照します。 Schematron ファイルを使用すると、特定の規則を定義し、DITA トピックまたはマップに対して検証できます。 Web エディターは、Schematron ファイルをサポートします。 Schematron ファイルを読み込んで、Web エディターで編集することもできます。 Web エディターのスキーマトロンのサポートは、一連のルールに対してファイルを検証し、トピック全体で一貫性と正確性を維持するのに役立ちます。
- ファイルを閉じるときのダイアログを改善しました
AEM Guidesでは、Web エディターで開いたファイルを閉じようとすると、変更内容を保存し、ロックされているファイルのロックを解除するように求められます。 プロンプトは、管理者が設定した 閉じるときにチェックインを要求する および 閉じるときに新しいバージョンを要求する の設定に基づいて表示されます。
設定に基づいて、変更を保存し、ドキュメントの新しいバージョンを作成するオプションを使用できます。 または、ファイルをチェックインして、変更内容を現在のバージョンに保存することもできます。
詳しくは、『Adobe Experience Manager Guidesの使用ガイド』の ファイルを閉じるシナリオと保存シナリオ 節を参照してください。* キーワードを挿入 機能が改善されました。 アルファベット順にリストされるため、挿入するキーワードを見つけやすくなりました。 検索ボックスに検索文字列を入力してキーワードを検索することもできます。
- Markdown ドキュメントのサポート
Markdown は、プレーンテキストドキュメントに書式設定要素を追加するのに役立つ軽量のマークアップ言語です。 Web エディタを使用すると、DITA 文書とともに Markdown 文書（.md）を使用できます。 Web エディタで Markdown 文書を簡単に作成およびプレビューでき、DITA マップエディタを使用してマップファイルに追加することもできます。 詳しくは、『Adobe Experience Manager Guidesガイドの使用』の web エディターからの Markdown ドキュメントの作成 節を参照してください。
-
デフォルトのタグビューを設定できる
ユーザーが web エディターからタグビューを有効にした場合、セッション間でも有効のままになります。 つまり、後でタグビューにアクセスするためにタグビューを再度有効にする必要はありません。 管理者は、web エディターのタグ表示のデフォルト状態を設定できます。 新しいユーザーのセッションのタグビューのデフォルト値は、ui_config.json ファイルの tagsView プロパティによって決まります。 -
これで、リポジトリ表示で、ファイルがバッチで読み込まれます。 メインまたは
/content/dam folderに存在するすべてのファイルが一覧表示されます。 しかし、次のレベルまたはセカンダリフォルダーから 75 ファイルが一度に読み込まれます。 このバッチ読み込みは効率的で、フォルダー内に存在するすべてのファイルを読み込む場合に比べて、より迅速にファイルにアクセスできます。
新規ベースラインダッシュボード
AEM Guides 4.1 リリースでは、web エディター内に統合されたベースライン機能が提供されています。 Web エディターからベースラインを作成し、それらを使用して、様々なバージョンのトピックを公開または翻訳できるようになりました。
注意：アップグレードしたシステムの場合、フォルダープロファイルの最新の ui_config.json を更新してください。
この機能を使用すると、特定の日時に使用可能なトピックの特定のバージョンでベースラインを作成できます。 また、API サポートを受けて、トピックのバージョン用に定義されたラベルでベースラインを作成または更新できます。
ファイル名またはファイルの場所に基づいてファイルを検索できます。 また、ベースライン編集ウィンドウに表示されるトピックをフィルタリングし、特定の列に基づいて並べ替えることもできます。
ベースライン作成プロセスのパフォーマンスがさらに向上しました。 ベースラインを作成するプロセスは非同期なので、ベースラインの作成中に Web エディタで他のファイルを編集し続けることができます。 詳しくは、『Adobe Experience Manager Guidesの使用ガイド』の Web エディターからのベースラインの作成と管理 を参照してください。
注：マップ ダッシュボードの [ ベースライン ] タブは、既定では非表示になっています。 管理者は、マップダッシュボードの「ベースライン」タブを有効にすることができます。
- Download Map への API のベースラインパラメーターで、ベースラインのタイトルを使用して、バージョン管理されたコンテンツを取得するようになりました。
翻訳プロセスの向上
- スコーピング翻訳プロジェクトを作成する機能
翻訳するプロジェクトの範囲のみを作成する必要がある場合は、「新しいスコーピング翻訳プロジェクトを作成」を選択します。 これにより翻訳用のコピーが送信されることはなく、ファイルの元の翻訳ステータスが維持されます。
- 言語 リストには、言語フォルダーと言語コードが表示されます。 例えば、フランス語（fr）やドイツ語（de）です。
翻訳について詳しくは、『Adobe Experience Manager Guidesガイド』の Web エディターからドキュメントを翻訳する 節を参照してください。
公開機能の強化
- マップダッシュボードから出力を生成する際に、「出力」タブから 0}Publish ダッシュボード } にアクセスすることもできます。 すべてのアクティブな公開タスクのリストは、Publish ダッシュボードに表示されます。
-
マップダッシュボードから複数の DITAVAL ファイルを選択して、条件付きコンテンツを生成できます。 ファイルを追加または削除することで、ファイルの順序を維持できます。 また、ファイル名にカーソルを合わせると、AEM リポジトリ内でファイルが格納されているパスが表示されます。
-
AEM サイト出力のメタデータのベースラインが尊重されるようになりました。 ベースラインバージョンのプロパティをメタデータとして処理することもできます。 ベースラインが定義されていない場合、最新バージョンのプロパティはメタデータとして処理されます。
-
HTML5、EPUB、カスタム出力の各プリセットに、File Name オプションと DITA-OT Command Line Arguments オプションが追加されました。 これで、出力を保存するファイル名を指定できます。 出力の生成時に DITA-OT で処理する追加の引数を指定することもできます。
Map ダッシュボード
DITA マップのダウンロードを選択すると、リクエストはキューに入れられ、マップのダウンロード準備が整うと通知が届きます。 マップファイルを直ちにダウンロードするか、AEM通知インボックスに表示されるリンクから後でダウンロードするかを選択できます。
その他の機能強化
- AEM Guidesは、Oxygen XML オーサーバージョン 24.1 をサポートするようになりました。
- Download Map への API のベースラインパラメーターで、ベースラインのタイトルを使用して、バージョン管理されたコンテンツを取得するようになりました。
廃止される機能
AEM Guidesは、FrameMaker文書の DITA 出力形式の生成をサポートしなくなりました。 この DITA オプションは、マップダッシュボードの出力プリセットからも削除されました。
修正された問題
様々な領域で修正されたバグを以下に示します。
- オーサリングサポートは、公開用のファイルパスベースの参照の代替手段としては使用できません。 （8076）
- DITA アドオンパッケージは、DAM 重複アセットの検出を防ぎます。 （8417）
- Oxygen からAEMにドキュメントをチェックインすると、ドキュメント内の日本語のコンテンツが疑問符に置き換えられます（???）。 （9124）
- Oxygen の Web 認証を使用したログで、チェックアウトしたファイルの更新が機能しない。 （9179）
- ファイルを Oxygen で開いてもチェックアウトされない。 （9192）
- Oxygen からAEMにドキュメントをチェックインすると、ドキュメント内の日本語のコンテンツが疑問符に置き換えられます（???）。 （9276）
- Oxygen で web 認証が機能しない。 （9296）
- ファイルが既にAEMの同じ場所に存在する場合、Oxygen で再アップロードが失敗します。 （9328）
- AEMとローカルシステムの間でコンテンツを強制的に同期するオプションを使用できない。 （9439）
- セカンダリツールバーの 再利用可能なコンテンツを挿入 ダイアログを使用して追加された要素の ID が自動的に生成されない。 （5826）
- エディターを使用して、既存のファイルと同じ名前の画像をアップロードしても、確認ダイアログが表示されない。 （6011）
- 文字パレットで改行しないスペースを使用できません。 （7523）
- 暗いテーマでは、要素リスト（Alt+Enter）がグレー表示されます。 （7913）
- マップ パネル ツールバーからトピックのリビジョンを保存しても、バージョンが更新されない。 （8228）
- 外部参照は、有効な位置でも挿入できません。 （8354）
- 「getversionlabels」操作には制限があり、期待されるパフォーマンスが得られません。 （8513）
- ロックまたは編集されたファイルを閉じても、エディターで現在開かれていない場合、確認ダイアログで問題が発生します。 （8692）
- ユーザー ID が数値の場合、フォルダープロファイルでユーザーを管理者として追加すると、エラーが発生する。 （8908）
- マップ エディタで DITA マップを開いた場合でも、移動パネルが表示されます。 （9053）
- 言語コードは、翻訳パネルの言語と共に表示されません。 （9108）
- 「翻訳」タブと「ベースライン」タブがマップ ダッシュボードにしばらく表示されます。 （9146）
- 翻訳が完了すると、翻訳済みアセットの追加バージョンが作成されます。 （9310）
- ターゲット言語コードに
fr_caのような 5 文字が含まれている場合、承認済みの翻訳はターゲット言語に統合されません。 （9357） - 作成したターゲット言語コードが
fr-fr,、en-usと記述されている場合、翻訳されたコンテンツは破損します。 （9527） - 言語フォルダーの外部にある DITA マップを読み込むと、バックエンドで例外がログに記録されます。（9543）
- エディタからカスタム DITA テンプレートを使用して DITA ファイルを作成できません。 （7262）
- FMPS を使用して UUID DITA マップを公開すると、DITA マップが失われます。 （7278）
- AEM Guidesでは、アセットをコピーして貼り付ける際に、アセットの一意でないプロパティはコピーされません。 （8241）
- 作成時に DITA マップファイル名が小文字に変換されません。 （8383）
- レビュータスクの説明が、新しいレビュータスクが割り当てられたときに送信されるメール通知に表示されない。 （8507）
- ダウンロードマップ API | ダウンロードプロセスのエラーが発生した場合、一時フォルダーがクリーンアップされません。 （8523）
columnpreview.jspは SP に依存します。 （8543）- 「待機中」や「実行中」などのステータスを持つ出力ジョブが、Publish Dashboard でクリーンアップされません。 （8569）
- 「生成」ボタンを使用してレポートを生成するときに選択されるデフォルトのアイコン（アイコンプロパティが定義されている場合も含む）。 （8573）
- 3.8.X から 4.0 へのアップグレード中に、レビュープロセスで問題が発生します。 （8788）
- Web エディターのレビューパネルで、ユーザー名が長い場合、承認/拒否するアイコンが明確に表示されません。 （8793）
- トピックを削除して移動操作を実行すると、参照ツリーが壊れる。 （8804）
- ユーザーが定義したカスタム DTD は、DITA-OT に埋め込まれた標準の DITA DTD より優先されません。 （9104）
- 左右に並べて表示すると、ハイライト表示の位置が正しくありません。 （9305）
- 参照脚注を使用しても、AEM サイト出力の脚注セクションまでスクロールしない。 （9061）
- AEM サイト出力の脚注の順序が正しくありません。 （9327）
- 新しく作成された DITA アセットは、常に別のユーザーによってチェックアウトされます。 （9387）
- 新しいコンテンツの作成では常にエラーがログに記録されます。 （9388）
- レビュータスク作成プロセスの 3 番目の画面には、用語集のリストは表示されません。 （4558）
- FrameMaker/酸素コネクタから複数のファイルをアップロードする際に割り当てられた UUID 参照が正しくありません。 （8269）
- レビュータスクがインボックスで再割り当てされている場合、メール通知が送信されない。 （8376）
- 2 人目の管理者ユーザーを最初の管理者ユーザーとしてフォルダーに追加することはできません。 （8430）
- 「ベースライン」タブの ラベルを適用 ダイアログで、ドロップダウンにラベルが表示されません。 （8455）
- トピックで画像を conref としてベースライン公開を使用すると、画像が出力で公開されません。 （8564）
- 大量の出力履歴ノードが残っている場合、出力のパージ機能が失敗します。 （8568）
- バージョン履歴パネル内の「現在のバージョン」セクションには、誤ったタイムスタンプと変更者の情報が表示されます。 （8765）
- 定義されたラベルに基づいてベースラインが更新されません。 （8799）
- ファイル名に特殊文字が含まれる親フォルダーを持つファイルが、（「酸素で編集 ボタンを使用して）酸素で開かれると エラーが発生します。 （8918）
- Oxygen からAEMへのファイルのアップロードに失敗します。 （9157）
- コンテンツが他のフォルダーに移動された場合、ベースラインを使用したマップのダウンロードが機能しません。 （9331）
- AEMでバージョンを元に戻した後に、Oxygen が間違ったバージョンのトピックをチェックアウトする。 （9411）
- リポジトリパネルと topicref 参照ダイアログで検索すると、コンテンツが大きいときに画面がフリーズする。 （9432）
- 「アップロードしたファイルの新しいバージョンを作成」設定がオンの場合、フリーズされたノードに戻して保存すると、新しいバージョンが作成されます。 （9473）
- ファイルバージョンを元に戻すと、Assets UI に誤ったタイムスタンプの違いが表示される。 （9480）
- どのバージョンに戻しても、ファイルは自動的にチェックアウトされます。 （9482）
- エディターからファイルをチェックインした場合でも、リポジトリビューにロックアイコンが表示される。 （5756）
- Web エディターのオーサービューを使用してブックマップに frontmatter、backmatter 要素を追加できない。 （7652）
- プレビューモードは、DITA
deliveryTarget条件付き処理属性をサポートしていません。 （7685） - XML エディターで用語集トピックを開くと、AEMは変更されていない場合でも保存します。 （8105）
- UI を使用して subjectref をマップに追加すると、参照を挿入ダイアログが開く。 （8212）
- 特殊文字
[または*を検索すると、コンテンツパネルがクラッシュして再利用できます。（8279） - Glossentry をオーサリングする際、web エディターにはコンテンツがメモとして表示されます。 （8384）
- XML エディターがコードブロック内の改行を削除します。 （8522）
- ソースモードとオーサーモードを切り替えると、トピックがダーティとマークされ、コンテンツを再度保存する必要があります。（8524）
- ロックが解除されたトピックを閉じることができません。 （8545）
- 記事ベースの公開プリセットでナレッジベースのパスを選択するオプションはありません。 （8636）
- お気に入り表示からドラッグ&ドロップしてチャプターをブックマップに追加すると、属性が表示されません。 （8746）
- キーワードを挿入ダイアログに検索機能がなく、キーワードが並べ替えられた順序でリストされません。 （9094）
- XML エディターで検索を実行すると、ページがフリーズする。 （9452）
- 「出力」タブのAEM プリセットには、サイトは表示されません。 （9567）
- XML エディターのオーサーモードで正しくレンダリングされないSVG画像。 （9426）
- Salesforce 経由での公開中、ベースラインに対処できません。 （8953）
- ユーザーの環境設定から rootmap をクリアする機能はありません。 （8534）