Adobe Experience Manager Guides as a Cloud Serviceの2023年7月リリース
このリリースノートでは、Adobe Experience Manager Guidesの2023年7月バージョン（後に AEM Guides as a Cloud Service と呼ばれます）で修正されたアップグレード手順、互換性マトリックス、および問題について説明します。
新機能と機能強化について詳しくは、AEM Guides as a Cloud Serviceの2023年7月リリースの新機能を参照してください。
2023年7月リリースへのアップグレード
次の手順を実行して、現在のAEM Guides as a Cloud Service設定をアップグレードします。
- Cloud ServicesのGit コードを確認し、アップグレードする環境に対応するCloud Services パイプラインで設定されたブランチに切り替えます。
- Cloud Services Git コードの
/dox/dox.installer/pom.xmlファイルの<dox.version>プロパティを2023.7.0.314に更新します。 - 変更を確定し、Cloud Services パイプラインを実行して、AEM Guides as a Cloud Serviceの2023年7月リリースにアップグレードします。
サーブレットを使用したスクリプトのトリガーを有効にする手順
（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は、送信されたジョブを指すリポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除されます。それまでは、このノードを参照してジョブの現在のステータスを確認できます。
このジョブが完了するまで待ってから、次の手順に進みます。
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
既存のコンテンツを後処理して、壊れたリンクレポートを使用する手順
（AEM Guides as a Cloud Serviceの2023年6月リリース以前のバージョンを使用している場合のみ）
既存のコンテンツを後処理し、新しい壊れたリンクレポートを使用するには、次の手順を実行します。
-
（オプション）システムに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
-
-
サーバーへのPOST リクエストを実行します（正しい認証を使用） -
http://<server:port>//bin/guides/reports/upgrade。 -
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） -
ジョブが完了すると、以前のGET リクエストは正常に応答します。 何らかの理由でジョブが失敗した場合は、サーバーログからエラーが表示されます。
-
手順1で変更した場合は、デフォルト値または以前の既存の値
queryLimitReadsに戻します。
「レポート」タブの新しい検索と置換およびトピックリストを使用して、既存のコンテンツをインデックス化する手順：
（AEM Guides as a Cloud Serviceの2023年6月リリース以前のバージョンを使用している場合のみ）
既存のコンテンツのインデックスを作成するには、次の手順を実行し、「レポート」タブのマップレベルとトピックリストで新しい検索と置換のテキストを使用します。
-
サーバー\（正しい認証\）に対してPOST リクエストを実行します –
http://<server:port\>/bin/guides/map-find/indexing。 （オプション：マップの特定のパスを渡してインデックスを作成できます。デフォルトでは、すべてのマップにインデックスが付けられます（例：https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>）。 -
ルートフォルダーを渡して、特定のフォルダー（およびそのサブフォルダー）のDITA マップをインデックス化することもできます。 例えば、
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/testのようになります。 パス パラメーターとルート パラメーターの両方が渡された場合は、パス パラメーターのみが考慮されます。 -
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\）に送信できます -
ジョブが完了すると、以前のGET リクエストは成功して応答し、マップが失敗した場合にメンションします。 正常にインデックス化されたマップは、サーバーログから確認できます。
互換性マトリックス
この節では、AEM Guides as a Cloud Service 2023年7月リリースでサポートされるソフトウェアアプリケーションの互換性マトリックスを示します。
FrameMakerとFrameMaker Publishing Server
Oxygen コネクタ
修正された問題
様々な領域で修正されたバグを以下に示します。
オーサリング
- インライン/表示属性は、Web エディターのレイアウトビューには表示されません。 (12498)
- Oxygen Plugin for AEM Guidesでファイルをアップロードする場合、クラウドサービスで機能しません。 をファイル名に含めます。 (12207)
- DITA マップの公開は、編集可能なテンプレートを使用すると非常に遅くなります。 (12075)
- グローバルプロファイル UI設定がフォルダープロファイルと一致しません。 (11970)
- DITA ファイルをコピーしてペーストすると、コンテンツ参照が破損する。 (11959)
- AEM Guidesがインストールされている場合、列表示でコンテンツフラグメントを編集できません。 (7342)
- ラップされていない外部参照がサブ要素タグの下にある場合、コンテンツは失われます。 (12532)
公開
- 右側のパネルのファイルプロパティからdocstateを「end state」に変更すると、承認ワークフローが機能しません。 (11026)