2023 年 6 月リリースのAdobe Experience Manager Guidesas a Cloud Service

このリリースノートでは、2023 年 6 月バージョンのAdobe Experience Manager Guides(後の AEM Guides as a Cloud Service)で修正されたアップグレード手順、互換性マトリックスおよび問題について説明します。

新機能と機能強化について詳しくは、AEM Guides as a Cloud Serviceの 2023 年 6 月リリースの新機能 ​ を参照してください。

2023 年 6 月リリースへのアップグレード

次の手順を実行して、現在のAEM Guides as a Cloud Service設定をアップグレードします。

  1. Cloud Services の Git コードをチェックアウトし、アップグレードする環境に対応する、Cloud Services パイプラインで設定されたブランチに切り替えます。
  2. Cloud Services Git コ <dox.version>/dox/dox.installer/pom.xml ファイルのプロパティを 2023.6.297 に更新します。
  3. 変更内容をコミットし、Cloud Services パイプラインを実行して、2023 年 6 月リリースのAEM Guides as a Cloud Serviceにアップグレードします。

サーブレットを使用したスクリプトのトリガーを有効にする手順

インストールが完了したら、トリガーを押して翻訳ジョブを開始できます。

投稿:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

応答:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

前の応答 JSON では、キー lockNodePath は、送信されたジョブを指す、リポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除されますが、その時点まで、ジョブの現在のステータスについては、このノードを参照できます。

このジョブが完了するのを待ってから、次の手順に進みます。

NOTE
ノードがまだ存在するかどうか、およびジョブのステータスを確認する必要があります。
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

壊れたリンクレポートを使用するために、既存のコンテンツを後処理する手順

(2023 年 6 月リリースのAEM Guides as a Cloud Serviceより前のバージョンを使用している場合のみ)

既存のコンテンツを後処理し、新しい壊れたリンクのレポートを使用するには、次の手順を実行します。

  1. (オプション)システムに 100,000 個を超える Dita ファイルがある場合は、queryLimitReadsorg.apache.jackrabbit.oak.query.QueryEngineSettingsService を大きい値(存在するアセットの数を超える値は、たとえば 200,000)に変更してから再デプロイします。

    • Adobe Experience Manager Guidesのインストールと設定の 設定の上書き の節で説明している手順を使用します
      as a Cloud Service(設定ファイルを作成する場合)

    • 設定ファイルで、次の(プロパティ)の詳細を指定して queryLimitReads オプションを設定します。

      table 0-row-3 1-row-3
      PID プロパティキー プロパティの値
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値:200000 デフォルト値:100000
  2. (正しい認証で) サーバーへの POST リクエストを実行します – http://<server:port>//bin/guides/reports/upgrade

  3. API は jobId を返します。 ジョブのステータスを確認するには、同じエンドポイント http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId} にジョブ ID を含むGET リクエストを送信します。
    (例:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

  4. ジョブが完了すると、前回のGET リクエストが正常に応答します。 何らかの理由でジョブが失敗した場合は、失敗がサーバーログに記録されます。

  5. 手順 1 で変更した場合は、デフォルトまたは以前の既存の値 queryLimitReads に戻します。

「レポート」タブで新しい「検索と置換」および「トピック」リストを使用するために、既存のコンテンツにインデックスを作成する手順は次のとおりです。

(AEM Guides as a Cloud Serviceの 2022 年 9 月リリースより前のバージョンを使用している場合のみ)

既存のコンテンツのインデックスを作成する次の手順を実行し、「レポート」タブの新しい検索と置換のテキストをマップレベルとトピックリストで使用します。

  1. サーバー\(正しい認証\) - http://<server:port\>/bin/guides/map-find/indexing に対して POST リクエストを実行します。 (オプション:マップの特定のパスをインデックスに指定できます。デフォルトでは、すべてのマップにインデックスが付けられます||例:https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)。

  2. ルートフォルダーを渡して、特定のフォルダー(およびそのサブフォルダー)の DITA マップのインデックスを作成することもできます。 例えば、http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test のようになります。paths パラメーターと root パラメーターの両方が渡される場合、paths パラメーターのみが考慮されることに注意してください。

  3. API は jobId を返します。 ジョブのステータスを確認するには、同じエンドポイント http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}\(例:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42\)にジョブ ID を含むGET リクエストを送信します

  4. ジョブが完了すると、前回のGET リクエストが成功を返し、失敗したマップがあるかどうかを示します。 正常にインデックス化されたマップは、サーバ ログから確認できます。

互換性マトリックス

この節では、2023 年 6 月リリースのAEM Guides as a Cloud Serviceでサポートされるソフトウェアアプリケーションの互換表を示します。

FrameMakerとFrameMaker Publishing Server

AEM Guides as a Cloud リリース
FMPS
FrameMaker
2023.06.0
互換性がありません
2022 以上

酸素コネクタ

AEM Guides as a Cloud リリース
酸素コネクタウィンドウ
酸素コネクタMac
酸素ウィンドウで編集
Oxygen Macで編集
2023.06.0
2.9-uuid-2
2.9-uuid-2
2.3
2.3

修正された問題

様々な領域で修正されたバグを以下に示します。

オーサリング

  • レイアウトビューからオーサービューまたはソースビューに切り替えると、Navtitle が content33 から削除されます。 (12174)
  • DITA マップをクリックすると、アプリケーションエラーが発生することがあります。 (11842)
  • Web エディター | トピックの編集中に、XML エディターに改行なしのスペースが追加される。 (11786)
  • アセット UI | リスト表示では、オーバーレイされた使用可能な列は結合できません。 (11528)
  • Keyref はマップ ビューでは解決されません。 (11490)
  • XML エディター内を移動すると、トップメニューが表示されない。 (10868)
  • ph タグの conref |表示される参照ダイアログが正しくありません。 (9481)
  • 他の要素へのローカルリンクは、web エディターでは解決されません。 (8790)
  • Matches ()関数はスキーマトロン機能では動作しません。 (11224)

管理

  • Web エディタ UI の「レポート」タブに、4.2 へのアップグレード前に作成された古い DITA マップのトピックリストが表示されません。 (11708)

  • 4.2 リリースでは、Assets UI の「ファイルをアップロード」ボタン機能が機能しなくなりました。 (11633)

公開

  • 更新または再起動された可能性のあるポッドから一時ファイルを読み取ると、AEM サイトへの公開が失敗する。 (12113)
  • ネイティブ PDF | brackets ()を含む出力クラスを持つコンテンツを公開すると、公開が凍結される。 (11936)
  • JSON 出力 | プロパティ値が "value in spaces and double quotes" であるマップメタデータを指定すると、公開エラーが発生します。 (11933)
  • Web エディター |AEMプリセットで出力パスとテンプレートを選択することはできません。 (11530)
  • ネイティブ PDF | カスタム属性は、一時的なHTMLやPDF エンジンには生成されません。 (DXML-12005)
  • ネイティブ PDF | Java OutOfMemoryError は、大きなコンテンツの公開時に発生します。 (11789)
  • JSON 出力 | JSON の jcrfmUuid ノードの :content プロパティが、JSON 内の「id」と異なる。 (11564)
  • JSON 出力 | ファイル名が同じマップとトピックが存在する場合、マップの JSON は削除されます。 (11524)
  • ネイティブ PDF | Xref は、Xref ラベルの代わりに href トピック タイトルの内容を印刷しています。 (11322)
  • ネイティブ PDF | PDF テンプレート設定を保存できません。 (10751)
  • ネイティブ PDF |複数の外部参照を含むの列の幅を超えて、テキストが延長されます。 (10876)
  • ネイティブ PDF |<note> </note> 要素で、そのタイプの追加の span タイトルが生成されない。 (10549)
  • ネイティブ PDF |生成されるPDFで言語メタデータを WCAG 2.0 に準拠するように設定することはできません。 (12296)

翻訳

  • 2 月のクラウドリリース(2302)以降、すべての翻訳コンテンツに「同期されていません」または「コピーがありません」と表示されるようになりました。 (11834)

レビュー

  • 新しいレビュー UI |条件は、Web エディターでの作業とは異なり、作業の強調表示と表示を切り替えます。 (11628)
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178