ドキュメントAEM GuidesAEM Guides ドキュメント

Adobe Experience Manager Guides as a Cloud Serviceの2023年10月リリース

最終更新日： 2026年5月15日

作成対象：

  • {"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"}

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

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

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

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

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

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

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

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

投稿：

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

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

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

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

  1. （オプション）システムに100,000個を超えるDITA ファイルがある場合は、org.apache.jackrabbit.oak.query.QueryEngineSettingsServiceのqueryLimitReadsを大きな値（存在するアセット数よりも大きい値、例えば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を返します。 ジョブのステータスを確認するには、ジョブ IDを持つGET リクエストを同じエンドポイントに送信できます。 http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId}
    （例：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の2023年6月リリース以前のバージョンを使用している場合のみ）

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

  1. サーバー\（正しい認証\）に対してPOST リクエストを実行します – http://<server:port\>/bin/guides/map-find/indexing。 （オプション：マップの特定のパスを渡してインデックスを作成できます。デフォルトでは、すべてのマップにインデックスが付けられます（例：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 のようになります。 パス パラメーターとルート パラメーターの両方が渡された場合は、パス パラメーターのみが考慮されます。

  3. APIはjobIdを返します。 ジョブのステータスを確認するには、ジョブ IDを持つGET リクエストを同じエンドポイント 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\）に送信できます

  4. ジョブが完了すると、以前のGET リクエストは成功して応答し、マップが失敗した場合にメンションします。 正常にインデックス化されたマップは、サーバーログから確認できます。

互換性マトリックス

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

FrameMakerとFrameMaker Publishing Server

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

Oxygen コネクタ

AEM Guides as a Cloud リリース
Oxygen コネクタウィンドウ
Oxygen Connector Mac
Oxygen ウィンドウで編集
Oxygen Macで編集
2023.10.0
3.2-uuid 5
3.2-uuid 5
2.3
2.3

ナレッジベースのテンプレートバージョン

コンポーネントパッケージ名
コンポーネントバージョン
テンプレートバージョン
Cloud Service用AEM Guides コンポーネントコンテンツパッケージ
dxml-components.all-1.2.2
aem-site-template-dxml.all-1.0.15

修正された問題

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

オーサリング

  • ベースラインの作成に対して、午後の時間は​ 日付 ​に設定されていません。 (12712)
  • Web エディターの<codeblock>要素にJSON コードをペーストできません。 (12326)
  • 未保存のバージョン変更とそれらの指標は、大きなファイルには表示されません。 (11784)
  • 韓国語で編集する場合、最初の文字がデフォルトに変わります。 (10049)

公開

  • ネイティブ PDF | PDF出力の生成時に、トピックの順序が固定されない。 (13157)
  • ネイティブ PDF| <p>要素に使用できるデフォルトのスタイルタグはありません。 (12559)
  • Native PDF | コンテンツリージョンに適用されるインラインスタイルは、フロントマターとバックマターのトピックには適用されません。 (13510)
  • AEM サイト出力の生成時にDeliveryTarget属性が反映されません。 (13132)
  • 特定のエラーを伴うコンテンツのAEM サイト出力を生成する際に、公開 ワークフローが停止する。 (12000)

管理

  • アセットにdc:format プロパティが存在しない場合でも、バージョン履歴が表示されません。 (10463)

レビュー

  • トピックのレビューに誤ったコメントが表示される。 (13453)

翻訳

  • 翻訳 ダッシュボードから書き出されたベースラインが失敗し、ターゲット言語で開きません。 (13466)

  • 選択した既存の翻訳プロジェクトに新しいジョブを追加する代わりに、新しい翻訳プロジェクトが作成されます。 (10214)

既知の問題

Adobeでは、2023年10月リリースの既知の問題を次のように特定しました。

  • コンテンツフラグメントの再公開に失敗しました。
recommendation-more-help
experience-manager-guides-help-product-guide