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

Adobe Experience Managerガイドのアップグレード id224MBE0M0XA

Last update: Thu Mar 07 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Experienced
  • Admin
NOTE
ライセンス版の製品に固有のアップグレード手順に従ってください。

現在のバージョンのExperience Managerガイドをバージョン 4.4.0 にアップグレードできます。

  • バージョン 4.3.1.5、4.3.1、4.3.0、または 4.2.1（ホットフィックス 4.2.1.3）を使用している場合は、バージョン 4.4.0 に直接アップグレードできます。
  • バージョン 4.2、4.1、4.1.x を使用している場合は、バージョン 4.4.0 にアップグレードする前に、バージョン 4.3.1、4.3.0、または 4.2.1（ホットフィックス 4.2.1.3）にアップグレードする必要があります。
  • バージョン 4.0 を使用している場合は、バージョン 4.3.x にアップグレードする前に、バージョン 4.2 にアップグレードする必要があります。
  • バージョン 3.8.5 を使用している場合は、バージョン 4.2 にアップグレードする前に、バージョン 4.0 にアップグレードする必要があります。
  • 3.8.5 より前のバージョンを使用している場合は、製品固有のインストールガイドの「Experience Managerガイドのアップグレード」の節を参照してください。
NOTE
AEMガイドのバージョンをアップグレードする前に、 Service Pack をExperience Managerする必要があります。

詳しくは、次の手順を参照してください。

IMPORTANT
アップグレードを開始する前に、完全なシステムバックアップを取り、データの損失を防ぎます。

バージョン 3.8.5 からバージョン 4.0 へのアップグレード id2256DK003E1

Experience Managerガイドバージョン 3.8.5 を使用している場合は、Experience Managerガイドのバージョン 4.0 にアップグレードできます。 アップグレード機能を使用すると、以前のバージョンのExperience Managerガイドをアンインストールする必要がなくなります。

プロセスを実行する前に、完了する必要があるタスクがあります。 以下のサブセクションでは、前提条件、レポートの生成、移行プロセスについて説明します。 また、Experience Managerガイドバージョン 4.0 をインストールした後、お客様の設定に応じて様々な設定をカスタマイズできます。

NOTE
このアップグレードプロセスは、バージョン 3.8.5 からバージョン 4.0 へのみ適用されます。バージョン 3.4 以降から 3.8.5 にアップグレードするプロセスについては、 アップグレードExperience Managerガイド に記載されている、製品固有のインストールガイドの「 」セクションを参照してください。 Adobe Experience ManagerガイドヘルプPDFアーカイブ.

​ ​前提条件​ ​

Experience Managerガイドのアップグレードプロセスを開始する前に、次の点を確認してください。

  1. トピック内のレビューコメントを読み込んでレビュー用に開きました。
  2. すべてのアクティブなレビューを閉じました。
  3. すべての翻訳タスクを閉じました。
  4. Experience Managerガイドの以前のバージョン（メジャーまたはパッチリリース）の上にインストールされているExperience Managerガイドのホットフィックスをアンインストールします。

バージョン 4.0 をインストールする前に

バージョン 4.0 をインストールする前に、次の手順を実行します。

  1. この時点で、Experience Managerガイドがバージョン 3.8.5 にあることを確認します。
  2. アップグレードスクリプトパッケージをダウンロードします。 そのためには、で「XML Documentation solution 4.0 Upgrade Package」を検索してください。 Adobeソフトウェア配布ポータル zip ファイルをダウンロードします。
  3. パッケージマネージャーを使用してこのパッケージをAEMにアップロードし、このパッケージをインストールします。
  4. アップグレードパッケージをインストールしたら、以下のスクリプトを同じ順序で実行し、指定された手順に従います。

アップグレード互換性 API を確認する

この API は、現在のシステムの状態を評価し、アップグレードが可能かどうかを報告するように設計されています。 このスクリプトを実行するには、次の特定のエンドポイントをトリガーします。

終点
/bin/dxml/upgrade/3xto4x/report
リクエストタイプ
GET AEMインスタンスに管理者としてログインしている Web ブラウザーを使用できます。
予想される応答
— 必要なすべてのノードを移動できる場合は、合格のチェックが表示されます。
— ターゲットの場所にノードが存在する場合は、関連するエラーが表示されます。 リポジトリ(delete node /var/dxml) をクリーンアップし、アップグレードパッケージを再インストールしてから、このエンドポイントを再度トリガーします。
注意： 3.x のExperience Managerガイドでは、target の場所は使用されていないので、これは一般的なエラーではありません。
— このスクリプトが成功しない場合は、続行せずに、カスタマーサクセスチームに報告してください。

システムデータ移行 API

この API は、 移行マッピング 」セクションに入力します。

  1. アップグレード互換性 API のチェックに失敗した場合は、このスクリプトを実行しないでください\（続行しないでください\）。
  2. アップグレード互換性の確認 API が正常に返されたら、アップグレードスクリプトを実行できます。
終点
/bin/dxml/upgrade/3xto4x
リクエストタイプ
POST このスクリプトはPOSTリクエストなので、Postmanなどのエージェントを介して実行する必要があります。
予想される応答
— 移行が正常に完了したら、XML Documentationソリューションバージョン 4.0 をインストールできます。
— エラーが発生した場合は、最後のチェックポイントに復元し、エラーログと API 出力を顧客成功チームと共有します。

移行マッピング：上記の API は、ソースの場所にあるすべてのデータをターゲットの場所に移行します。

ソース
ターゲット
/content/fmdita
/var/dxml
/content/dxml
/var/dxml
/etc/fmdita
/libs/fmdita

バージョン 4.0 のインストール id23598G006XA

  1. バージョン 4.0 は、アップグレード手順が正常に完了した場合にのみインストールします。

  2. から 4.0 バージョンのパッケージをダウンロード Adobeソフトウェア配布ポータル:

    • UUID バージョンのソフトウェアを使用している場合は、「4.0 UUID Release for AEM 6.5」を検索します。
    • 非 UUID バージョンのソフトウェアを使用している場合、「4.0 Non-UUID Release for AEM 6.5」を検索してください。
      CRX パッケージマネージャーを使用して既存のAEMサーバーインスタンスにパッケージをアップロードし、インストールします。
    note note
    NOTE
    すべてのシステムコンポーネントが起動するのを待ちます。

  3. パッケージをインストールした後で、ブラウザーのキャッシュをクリアします。

  4. AEMオーサーインスタンス上で Dispatcher が設定されている場合は、次の手順を実行します。

    • 以下が Dispatcher のルールで処理されることを確認します。
    • URL パターン/home/users/*/preferences がホワイトリストに登録されている。
    • URL パターン/libs/cq/security/userinfo.jsonはキャッシュされていません。

  5. Dispatcher キャッシュをクリア( すべての clientlibs キャッシュ) で使用できます。

バージョン 4.2 へのアップグレード id22A3F500SXA

バージョン 4.2 へのアップグレードは、バージョンガイドの現在のバージョンに依存していますExperience Managerガイド。

バージョン 4.0、4.1 または 4.1.x を使用している場合は、直接バージョン 4.2 にアップグレードできます。

​ ​前提条件​ ​

Experience Managerガイド 4.2 のアップグレードプロセスを開始する前に、次の点を確認してください。

  1. Experience Managerガイドバージョン 4.0、4.1、4.1.x にアップグレード。
  2. すべての翻訳タスクを閉じました。
  3. ログレベルをに変更しました。 情報 対象： com.adobe.fmdita.translationservices.TranslationMapUpgradeScript クラスを作成し、新しいログファイルにこれらのログを追加します。例： logs/translation_upgrade.log.
NOTE
アクティブなレビューをすべて閉じる必要があります。 4.2 へのアップグレード中にレビュータスクが閉じられない場合、古い進行中のレビュータスクは古いレビューページでユーザーを引き続き取り、アップグレード後に作成されたレビュータスクは機能の最新の更新を表示します。

バージョン 4.2 のインストール id2245IK0E0EV

  1. から 4.2 バージョンのパッケージをダウンロード Adobeソフトウェア配布ポータル.

  2. バージョン 4.2 パッケージをインストールします。

  3. パッケージのインストールが完了したら、ログで次のメッセージが表示されるまで待ちます。

    Completed the post deployment setup script

    上記のメッセージは、インストールのすべての手順が完了したことを示しています。

    次の ERROR プレフィックスが表示された場合は、カスタマーサクセスチームに報告してください。

    • デプロイメント設定後のスクリプトでエラーが発生しました
    • 翻訳 MAP の移植中に例外が発生しました
    • プロパティの v1 から v2 に翻訳マップをポートできません

  4. バージョン 4.2 でリリースされた Oxygen コネクタプラグインをアップグレードします（必要に応じて）。

  5. パッケージをインストールした後で、ブラウザーのキャッシュをクリアします。

  6. 次の節で詳しく説明するように、カスタマイズのアップグレードを続行します。

バージョン 4.2 のインストール後 id2326F02004K

IMPORTANT
アップグレードされたサーバーにハイテクテンプレートが表示されません。 サーバーにハイテクテンプレートを組み込むには、コピーします。ソース： /libs/fmdita/pdf/Hi-Tech Destination: /content/dam/dita-templates/pdf

Experience Managerガイドをインストールした後、新しくインストールしたバージョンから設定に適用される様々な設定を結合できます。

NOTE
dam-update-asset モデルはカスタマイズできます。 したがって、カスタマイズが行われている場合は、カスタマイズとExperience Managerガイドをモデルの作業用コピーに同期する必要があります。

  1. DAM アセットの更新ワークフロー（後処理の変更）:

  2. URL を開く：

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 選択 DAM アセットの更新ワークフロー.

  4. 編集 ​をクリックします。

  5. 次の場合、 DXML Post Process Initiator コンポーネントが存在する場合は、カスタマイズが同期されていることを確認してください。

  6. 次の場合、 DXML Post Process Initiator コンポーネントが存在しない場合は、次の手順を実行して挿入します。

  7. クリック コンポーネントを挿入 ( プロセスの最後のステップとしてExperience Managerガイドの後処理を担当します)。

  8. を設定します。 処理ステップ 次の詳細を含む：

    「共通」タブ

    タイトル： DXML Post Process Initiator

    説明：変更または作成されたアセットの DXML 後処理のための Sling ジョブをトリガーする、DXML 後処理開始者ステップ。

    「プロセス」タブ

    • 選択 DXML Post Process Initiator ​から プロセス ドロップダウン

    • 選択 ハンドラー処理の設定

    • 選択 完了

  9. クリック 同期 をクリックします。 成功通知が届きます。

    note note
    NOTE
    更新して、カスタマイズされた変更とExperience Managerガイドの後処理手順が最終的なワークフローモデルに存在することを確認します。

  10. 1 回 DAM アセットの更新ワークフロー が検証された場合は、対応するランチャー設定を確認します。 これをおこなうには、AEM Workflow インターフェイスに移動してランチャーを開きます。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    次に対応する\（必要に応じて\）次の 2 つのランチャー\（アクティブにする必要がある\）を検索し、変更します。 DAM アセットの更新ワークフロー:

  11. 「 」のランチャー​ 作成されたノード」が DAM アセットの更新ワークフロー — 条件の場合 "jcr:content/jcr:mimeType!=video"に設定する場合、「グロビング」の値は次のようにする必要があります。

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList'には "event-user-data:changedByWorkflowProcess".
    • 「 」のランチャー​ 変更されたノード」が DAM アセットの更新ワークフロー — 条件"jcr:content/jcr:mimeType!=video",
    • 「グロビング」の値は次のようにする必要があります。
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList'には "event-user-data:changedByWorkflowProcess".

  12. アップグレードが完了したら、カスタマイズ/オーバーレイが検証され、新しいアプリケーションコードに合わせて更新されることを確認します。 以下に例を示します。

    • /libs/fmditaor/libs からオーバーレイされたコンポーネントは、新しい製品コードと比較する必要があります。また、/apps の下のオーバーレイされたファイルで更新を行う必要があります。
    • 製品から使用される clientlib カテゴリは、変更の確認が必要です。 最新の機能を取得するには、上書きされた設定（以下の例を参照）を最新の設定と比較する必要があります。
    • elementmapping.xml
    • ui_config.json\（フォルダープロファイルに設定されている可能性があります）
    • 修正済み com.adobe.fmdita.config.ConfigManager
    • 任意の古いパスを使用していたカスタムコードがあるかどうかを確認します。 移行マッピング section) — カスタマイズも期待どおりに機能するように、新しいパスに更新する必要があります。

  13. 現在のリリースで導入された新しい設定についてお読みください( リリースノート) をクリックし、影響を受ける機能があるかどうかを確認して、適切なアクションを実行します。 例えば、バージョン 4.0 で導入された「ファイルとバージョンの処理の改善」を利用し、その場合、設定を有効にする必要があります。

新しい検索と置換を使用する既存のコンテンツのインデックスを作成する手順は次のとおりです。

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

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

  • 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リクエストは成功と共に応答し、マップが失敗した場合はメンションします。 正常にインデックス付けされたマップは、サーバーログから確認できます。

アップグレードジョブが失敗し、エラーログに次のエラーが表示される場合：

「 クエリ より多くを読む、または横断する 100000ノード. 他のタスクへの影響を回避するため、処理は停止しました。」

これは、アップグレードで使用されるクエリに対してインデックスが適切に設定されていないために発生する可能性があります。 次の回避策を試すことができます。

  1. damAssetLucene oak インデックスに、ブールプロパティを追加します。 indexNodeName as true ノード内に配置されます。
    /oak:index/damAssetLucene/indexRules/dam:Asset

  2. ノードの下に、名前抜粋を含む新しいノードを追加します。

    /oak:index/damAssetLucene/indexRules/dam:Asset/properties
    ノードで次のプロパティを設定します。

    code language-none 
    name - rep:excerpt
propertyIndex - {Boolean}true
notNullCheckEnabled - {Boolean}true

    の構造 damAssetLucene は次のようになります。

    code language-none 
    <damAssetLucene compatVersion="{Long}2" async="async, nrt" jcr:primaryType="oak:QueryIndexDefinition" evaluatePathRestrictions="{Boolean}true" type="lucene">
<indexRules jcr:primaryType="nt:unstructured">
  <dam:Asset indexNodeName="{Boolean}true" jcr:primaryType="nt:unstructured">
    <properties jcr:primaryType="nt:unstructured">
      <excerpt name="rep:excerpt" propertyIndex="{Boolean}true" jcr:primaryType="nt:unstructured" notNullCheckEnabled="{Boolean}true"/>
    </properties>
    </dam:Asset>
  </indexRules>
</damAssetLucene>

    （他の既存のノードおよびプロパティと共に）

  3. インデックスの再作成 damAssetLucene index （reindex フラグを次のように設定） true その下に false 再び（これは、インデックス再作成が完了したことを示します）。 インデックスのサイズによっては、数時間かかる場合があります。

  4. 前の手順を実行して、インデックス作成スクリプトを再実行します。

バージョン 4.2.1 へのアップグレード upgrade-version-4-2-1

TIP
Hotfix 4.2.1.3 をバージョン 4.2.1 の上にインストールすることをお勧めします。

バージョン 4.2.1 へのアップグレードは、バージョンガイドの現在のバージョンに依存していますExperience Managerガイド。 バージョン 4.1、4.1.x、4.2 を使用している場合は、直接バージョン 4.2.1 にアップグレードできます。

NOTE
後処理とインデックス作成には、数時間かかる場合があります。 オフピーク時にアップグレードプロセスを開始することをお勧めします。

​ ​前提条件​ ​

Experience Managerガイド 4.2.1 のアップグレードプロセスを開始する前に、以下が行われていることを確認します。

  1. Experience Managerガイドバージョン 4.1、4.1.x、または 4.2 にアップグレード。
  2. すべての翻訳タスクを閉じました。
  3. ログレベルをに変更しました。 情報 対象： com.adobe.fmdita.translationservices.TranslationMapUpgradeScript クラスを作成し、新しいログファイルにこれらのログを追加します。例： logs/translation_upgrade.log.
NOTE
アクティブなレビューをすべて閉じる必要があります。 4.2 へのアップグレード中にレビュータスクが閉じられない場合、古い進行中のレビュータスクは古いレビューページでユーザーを引き続き取り、アップグレード後に作成されたレビュータスクは機能の最新の更新を表示します。

バージョン 4.2.1 のインストール

  1. 4.2.1 バージョンパッケージをからダウンロードします。 Adobeソフトウェア配布ポータル.

  2. バージョン 4.2.1 パッケージをインストールします。

  3. 「トリガーをヒット」を選択して、翻訳マップのアップグレードジョブを開始できます。 詳しくは、 サーブレットを介したスクリプトのトリガーの有効化.

  4. パッケージのインストールが完了したら、ログで次のメッセージが表示されるまで待ちます。

    Completed the post deployment setup script

    上記のメッセージは、インストールのすべての手順が完了したことを示しています。

    次の ERROR プレフィックスが表示された場合は、カスタマーサクセスチームに報告してください。

    • デプロイメント設定後のスクリプトでエラーが発生しました
    • 翻訳 MAP の移植中に例外が発生しました
    • プロパティの v1 から v2 に翻訳マップをポートできません

  5. バージョン 4.2 でリリースされた Oxygen コネクタプラグインをアップグレードします（必要に応じて）。

  6. パッケージをインストールした後で、ブラウザーのキャッシュをクリアします。

  7. 次の節で詳しく説明するように、カスタマイズのアップグレードを続行します。

サーブレットを介したスクリプトのトリガーの有効化 enable-trigger-serverlet

POST:

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 は、送信されたジョブを指す、リポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除され、それまでは、このノードを参照してジョブの現在のステータスを確認できます。

サンプルログ：次に、スクリプトのトリガー後にログファイルに表示されるログの例を示します。

04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2

を探す com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 および com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 次の手順に進む前に、を参照してください。

バージョン 4.2.1 のインストール後

IMPORTANT
アップグレードされたサーバーにハイテクテンプレートが表示されません。 サーバーにハイテクテンプレートを組み込むには、コピーします。ソース： /libs/fmdita/pdf/Hi-Tech Destination: /content/dam/dita-templates/pdf

Experience Managerガイドをインストールした後、新しくインストールしたバージョンから設定に適用される様々な設定を結合できます。

NOTE
dam-update-asset モデルはカスタマイズできます。 したがって、カスタマイズが行われている場合は、カスタマイズとExperience Managerガイドをモデルの作業用コピーに同期する必要があります。

  1. DAM アセットの更新ワークフロー（後処理の変更）:

  2. URL を開く：

    code language-http 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 選択 DAM アセットの更新ワークフロー.

  4. 編集 ​をクリックします。

  5. 次の場合、 DXML Post Process Initiator コンポーネントが存在する場合は、カスタマイズが同期されていることを確認してください。

  6. 次の場合、 DXML Post Process Initiator コンポーネントが存在しない場合は、次の手順を実行して挿入します。

  7. クリック コンポーネントを挿入 ( プロセスの最後のステップとしてExperience Managerガイドの後処理を担当します)。

  8. を設定します。 処理ステップ 次の詳細を含む：

    「共通」タブ

    タイトル： DXML Post Process Initiator

    説明：変更または作成されたアセットの DXML 後処理のための Sling ジョブをトリガーする、DXML 後処理開始者ステップ。

    「プロセス」タブ

    • 選択 DXML Post Process Initiator ​から プロセス ドロップダウン

    • 選択 ハンドラー処理の設定

    • 選択 完了

  9. クリック 同期 をクリックします。 成功通知が届きます。

    note note
    NOTE
    更新して、カスタマイズされた変更とExperience Managerガイドの後処理手順が最終的なワークフローモデルに存在することを確認します。

  10. 1 回 DAM アセットの更新ワークフロー が検証された場合は、対応するランチャー設定を確認します。 これをおこなうには、AEM Workflow インターフェイスに移動してランチャーを開きます。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    次に対応する\（必要に応じて\）次の 2 つのランチャー\（アクティブにする必要がある\）を検索し、変更します。 DAM アセットの更新ワークフロー:

  11. 「 」のランチャー​ 作成されたノード」が DAM アセットの更新ワークフロー — 条件の場合 "jcr:content/jcr:mimeType!=video"に設定する場合、「グロビング」の値は次のようにする必要があります。

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList'には "event-user-data:changedByWorkflowProcess".
    • 「 」のランチャー​ 変更されたノード」が DAM アセットの更新ワークフロー — 条件"jcr:content/jcr:mimeType!=video"、「グロビング」の値は次のようにする必要があります。
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList は、 "event-user-data:changedByWorkflowProcess".

  12. アップグレードが完了したら、カスタマイズ/オーバーレイが検証され、新しいアプリケーションコードに合わせて更新されることを確認します。 以下に例を示します。

    • /libs/fmditaor/libs からオーバーレイされたコンポーネントは、新しい製品コードと比較する必要があります。また、/apps の下のオーバーレイされたファイルで更新を行う必要があります。
    • 製品から使用される clientlib カテゴリは、変更の確認が必要です。 最新の機能を取得するには、上書きされた設定（以下の例を参照）を最新の設定と比較する必要があります。
    • elementmapping.xml
    • ui_config.json\（フォルダープロファイルに設定されている可能性があります）
    • 修正済み com.adobe.fmdita.config.ConfigManager
    • 任意の古いパスを使用していたカスタムコードがあるかどうかを確認します。 移行マッピング section) — カスタマイズも期待どおりに機能するように、新しいパスに更新する必要があります。

  13. 現在のリリースで導入された新しい設定についてお読みください( リリースノート) をクリックし、影響を受ける機能があるかどうかを確認して、適切なアクションを実行します。 例えば、バージョン 4.0 で導入された「ファイルとバージョンの処理の改善」を利用し、その場合、設定を有効にする必要があります。

新しい検索と置換を使用する既存のコンテンツのインデックスを作成する手順は次のとおりです。

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

  • 次の点を確認します。 damAssetLucene インデックス作成が完了しました。 サーバー上に存在するデータの量に応じて、最大で数時間かかる場合があります。 インデックス再作成の完了を確認するには、で、再インデックスフィールドが false に設定されていることを確認します。
    http://<server:port>/oak:index/damAssetLucene. また、 damAssetLuceneの場合は、再度適用する必要が生じる場合があります。

  • 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 のようになります。paths パラメーターと root パラメーターの両方が渡される場合は、paths パラメーターのみが考慮されます。

  • 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リクエストは成功と共に応答し、マップが失敗した場合はメンションします。 正常にインデックス付けされたマップは、サーバーログから確認できます。

バージョン 4.3.0 へのアップグレード upgrade-version-4-3

バージョン 4.3.0 へのアップグレードは、バージョンガイドの現在のバージョンに依存していますExperience Managerガイド。 バージョン 4.2 または 4.2.x を使用している場合は、直接バージョン 4.3.0 にアップグレードできます。

NOTE
後処理とインデックス作成には、数時間かかる場合があります。 オフピーク時にアップグレードプロセスを開始することをお勧めします。

​ ​前提条件​ ​

Experience Managerガイド 4.3.0 のアップグレードプロセスを開始する前に、次の点を確認してください。

  1. Experience Managerガイドバージョン 4.2 または 4.2.x にアップグレードし、それぞれのインストール手順を完了しました。
  2. すべての翻訳タスクを閉じました。

バージョン 4.3.0 のインストール

  1. 4.3.0 バージョンパッケージをからダウンロードします。 Adobeソフトウェア配布ポータル.
  2. バージョン 4.3.0 パッケージをインストールします。
  3. パッケージをインストールした後で、ブラウザーのキャッシュをクリアします。
  4. のアップグレード ui_config.json ファイルを XML エディターの設定 」タブをクリックします。

バージョン 4.3.0 のインストール後

Experience Managerガイドをインストールした後、新しくインストールしたバージョンから設定に適用される様々な設定を結合できます。

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

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

  1. （オプション）システム内に 100,000 個を超える DITA ファイルがある場合、 queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService を大きい値 ( 存在するアセットの数（例：200,000）を超える値 ) に設定し、再デプロイします。

    table 0-row-3 1-row-3
    PID プロパティキー プロパティの値
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値：200000
    デフォルト値：100000

  2. 次の API を実行して、すべてのファイルの後処理を実行します。

    table 0-row-2 1-row-2 2-row-2
    終点 /bin/guides/reports/upgrade
    リクエストタイプ POST このスクリプトはPOSTリクエストなので、Postmanなどのエージェントを介して実行する必要があります。
    予想される応答 API は jobId を返します。 ジョブのステータスを確認するには、ジョブ ID を持つGETリクエストを同じエンドポイントに送信します。
    サンプル URL: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    終点 /bin/guides/reports/upgrade
    リクエストタイプ GET
    パラメーター jobId：前の post リクエストから受け取った jobId を渡します。
    予想される応答 — ジョブが完了すると、GETリクエストへの応答が成功します。
    — エラーが発生した場合は、エラーログと API 出力を顧客成功チームと共有します。
    サンプル URL: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

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

バージョン 4.3.1 へのアップグレード upgrade-version-4-3-1

バージョン 4.3.1 へのアップグレードは、バージョンガイドの現在のバージョンに依存していますExperience Managerガイド。 バージョン 4.3.0、4.2 または 4.2.1 を使用している場合は、バージョン 4.3.1 に直接アップグレードできます。

NOTE
後処理とインデックス作成には、数時間かかる場合があります。 オフピーク時にアップグレードプロセスを開始することをお勧めします。

​ ​前提条件​ ​

Experience Managerガイド 4.3.1 のアップグレードプロセスを開始する前に、以下が行われていることを確認します。

  1. Experience Managerガイドのバージョン 4.3.0、4.2、または 4.2.1 にアップグレードし、それぞれのインストール手順を完了しました。
  2. （オプション）すべての翻訳タスクを閉じました。
  3. ログレベルをに変更しました。 情報 対象： com.adobe.fmdita.translationservices.TranslationMapUpgradeScript クラスを作成し、新しいログファイルにこれらのログを追加します。例： logs/translation_upgrade.log.

バージョン 4.3.1 のインストール

  1. 4.3.1 バージョンパッケージをからダウンロードします。 Adobeソフトウェア配布ポータル.

  2. バージョン 4.3.1 パッケージをインストールします。

  3. 「トリガーをヒット」を選択して、翻訳マップのアップグレードジョブを開始できます。 詳しくは、 サーブレットを介したスクリプトのトリガーの有効化.

  4. パッケージのインストールが完了したら、ログで次のメッセージが表示されるまで待ちます。

    Completed the post deployment setup script

    上記のメッセージは、インストールのすべての手順が完了したことを示しています。

    次の ERROR プレフィックスが表示された場合は、カスタマーサクセスチームに報告してください。

    • デプロイメント設定後のスクリプトでエラーが発生しました
    • 翻訳 MAP の移植中に例外が発生しました
    • プロパティの v1 から v2 に翻訳マップをポートできません

  5. バージョン 4.2 でリリースされた Oxygen コネクタプラグインをアップグレードします（必要に応じて）。

  6. パッケージをインストールした後で、ブラウザーのキャッシュをクリアします。

  7. 次の節で詳しく説明するように、カスタマイズのアップグレードを続行します。

サーブレットを介したスクリプトのトリガーの有効化 enable-trigger-serverlet-4-3-1

POST:

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 は、送信されたジョブを指す、リポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除され、それまでは、このノードを参照してジョブの現在のステータスを確認できます。

サンプルログ：次に、スクリプトのトリガー後にログファイルに表示されるログの例を示します。

04.05.2023 14:17:12.876 *INFO* [[0:0:0:0:0:0:0:1] [1683190032736] POST /bin/guides/script/start HTTP/1.1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Acquiring lock for job : translation-map-upgrade
04.05.2023 14:17:12.897 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Starting the thread to upgrade translation map from V1 to V2
04.05.2023 14:17:12.899 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Initiating lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.901 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Starting porting of translation map from V1 to V2
04.05.2023 14:17:12.904 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Memory increase is of : 764 kB
04.05.2023 14:17:12.906 *INFO* [pool-59-thread-1] com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2
04.05.2023 14:17:12.907 *INFO* [pool-59-thread-1] com.adobe.dxml.common.executor.RunnableSynchronizedOTS Releasing lock for node : /var/dxml/executor-locks/translation-map-upgrade/1683190032886
04.05.2023 14:17:12.909 *INFO* [pool-59-thread-1] com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2

を探す com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 および com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 次の手順に進む前に、を参照してください。

バージョン 4.3.1 のインストール後

Experience Managerガイドをインストールした後、新しくインストールしたバージョンから設定に適用される様々な設定を結合できます。

NOTE
dam-update-asset モデルはカスタマイズできます。 したがって、カスタマイズが行われている場合は、カスタマイズとExperience Managerガイドをモデルの作業用コピーに同期する必要があります。

  1. DAM アセットの更新ワークフロー（後処理の変更）:

  2. URL を開く：

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 選択 DAM アセットの更新ワークフロー.

  4. 編集 ​をクリックします。

  5. 次の場合、 DXML Post Process Initiator コンポーネントが存在する場合は、カスタマイズが同期されていることを確認してください。

  6. 次の場合、 DXML Post Process Initiator コンポーネントが存在しない場合は、次の手順を実行して挿入します。

  7. クリック コンポーネントを挿入 ( プロセスの最後のステップとしてExperience Managerガイドの後処理を担当します)。

  8. を設定します。 処理ステップ 次の詳細を含む：

    「共通」タブ

    タイトル： DXML Post Process Initiator

    説明：変更または作成されたアセットの DXML 後処理のための Sling ジョブをトリガーする、DXML 後処理開始者ステップ。

    「プロセス」タブ

    • 選択 DXML Post Process Initiator ​から プロセス ドロップダウン

    • 選択 ハンドラー処理の設定

    • 選択 完了

  9. クリック 同期 をクリックします。 成功通知が届きます。

    note note
    NOTE
    更新して、カスタマイズされた変更とExperience Managerガイドの後処理手順が最終的なワークフローモデルに存在することを確認します。

  10. 1 回 DAM アセットの更新ワークフロー が検証された場合は、対応するランチャー設定を確認します。 これをおこなうには、AEM Workflow インターフェイスに移動してランチャーを開きます。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    次に対応する\（必要に応じて\）次の 2 つのランチャー\（アクティブにする必要がある\）を検索し、変更します。 DAM アセットの更新ワークフロー:

  11. 「 」のランチャー​ 作成されたノード」が DAM アセットの更新ワークフロー — 条件の場合 "jcr:content/jcr:mimeType!=video"に設定する場合、「グロビング」の値は次のようにする必要があります。

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList'には "event-user-data:changedByWorkflowProcess".
    • 「 」のランチャー​ 変更されたノード」が DAM アセットの更新ワークフロー — 条件"jcr:content/jcr:mimeType!=video"、「グロビング」の値は次のようにする必要があります。
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList は、 "event-user-data:changedByWorkflowProcess".

  12. アップグレードが完了したら、カスタマイズ/オーバーレイが検証され、新しいアプリケーションコードに合わせて更新されることを確認します。 以下に例を示します。

    • /libs/fmditaor/libs からオーバーレイされたコンポーネントは、新しい製品コードと比較する必要があります。また、/apps の下のオーバーレイされたファイルで更新を行う必要があります。
    • 製品から使用される clientlib カテゴリは、変更の確認が必要です。 最新の機能を取得するには、上書きされた設定（以下の例を参照）を最新の設定と比較する必要があります。
    • elementmapping.xml
    • ui_config.json\（フォルダープロファイルに設定されている可能性があります）
    • 修正済み com.adobe.fmdita.config.ConfigManager

既存のコンテンツのインデックスを作成する手順

NOTE
4.3.0 または 4.2.1 からアップグレードする場合、これらの手順を実行する必要はありません。

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

  • POSTリクエストをサーバーに対して実行します\（正しい認証で） - http://<server:port\>/bin/guides/map-find/indexing. （任意）マップの特定のパスを渡してインデックスを作成できます。デフォルトでは、すべてのマップにインデックスが作成されます|| 例： https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 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リクエストは成功と共に応答し、マップが失敗した場合はメンションします。 正常にインデックス付けされたマップは、サーバーログから確認できます。

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

NOTE
4.3.0 からアップグレードする場合、これらの手順を実行する必要はありません。

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

  1. （オプション）システム内に 100,000 個を超える DITA ファイルがある場合、 queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService を大きい値 ( 存在するアセットの数（例：200,000）を超える値 ) に設定し、再デプロイします。

    table 0-row-3 1-row-3
    PID プロパティキー プロパティの値
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値：200000
    デフォルト値：100000

  2. 次の API を実行して、すべてのファイルの後処理を実行します。

    table 0-row-2 1-row-2 2-row-2
    終点 /bin/guides/reports/upgrade
    リクエストタイプ POST このスクリプトはPOSTリクエストなので、Postmanなどのエージェントを介して実行する必要があります。
    予想される応答 API は jobId を返します。 ジョブのステータスを確認するには、ジョブ ID を持つGETリクエストを同じエンドポイントに送信します。
    サンプル URL: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    終点 /bin/guides/reports/upgrade
    リクエストタイプ GET
    パラメーター jobId：前の post リクエストから受け取った jobId を渡します。
    予想される応答 — ジョブが完了すると、GETリクエストへの応答が成功します。
    — エラーが発生した場合は、エラーログと API 出力を顧客成功チームと共有します。
    サンプル URL: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

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

バージョン 4.3.1.5 へのアップグレード upgrade-version-4-3-1-5

バージョン 4.3.1.5 へのアップグレードは、バージョンガイドの現在のバージョンに依存していますExperience Managerガイド。 バージョン 4.3.1 を使用している場合は、直接バージョン 4.3.1.5 にアップグレードできます。

バージョン 4.3.1.5 のインストール

  1. 4.3.1.5 バージョンのパッケージをからダウンロードします。 Adobeソフトウェア配布ポータル.

  2. バージョン 4.3.1.5 パッケージをインストールします。

  3. インストールプロセスが正常に完了するまで待ちます。

  4. 次の節で詳しく説明するように、カスタマイズのアップグレードを続行します。

バージョン 4.3.1.5 のインストール後

NOTE
org.apache.velocity バンドルを使用する場合は、バンドルをアップロードする前に次の手順を実行します。
  1. <server>:<port>/system/console/bundles にアクセスします。
  2. org.apache.velocity を検索します。
  3. 検索したバンドルをアンインストールします。
  4. 必要な Velocity バンドルをインストールします。

  1. アップグレードが完了したら、カスタマイズ/オーバーレイが検証され、新しいアプリケーションコードに合わせて更新されることを確認します。 以下に例を示します。

    • オーバーレイ元の任意のコンポーネント /libs/fmdita または /libs を新しい製品コードと比較する必要があります。また、の下のオーバーレイファイルで更新する必要があります。 /apps .
    • 製品から使用される clientlib カテゴリは、変更の確認が必要です。 最新の機能を取得するには、上書きされた設定（以下の例を参照）を最新の設定と比較する必要があります。
    • elementmapping.xml
    • ui\_config.json\ （フォルダープロファイルで設定されている可能性があります）
    • 修正済み com.adobe.fmdita.config.ConfigManager

バージョン 4.4.0 へのアップグレード upgrade-version-4-4-0

バージョン 4.4.0 へのアップグレードは、バージョンガイドの現在のバージョンに依存していますExperience Managerガイド。 バージョン 4.3.1、4.3.0、4.2、または 4.2.1（ホットフィックス 4.2.1.3）を使用している場合は、バージョン 4.4.0 に直接アップグレードできます。

NOTE
後処理とインデックス作成には、数時間かかる場合があります。 オフピーク時にアップグレードプロセスを開始することをお勧めします。

​ ​前提条件​ ​

Experience Managerガイド 4.4.0 のアップグレードプロセスを開始する前に、以下が行われていることを確認します。

  1. Experience Managerガイドのバージョン 4.3.1、4.3.0、または 4.2.1（ホットフィックス 4.2.1.3）にアップグレードされ、それぞれのインストール手順を完了しました。
  2. （オプション）すべての翻訳タスクを閉じました。
  3. ログレベルをに変更しました。 情報 対象： com.adobe.fmdita.translationservices.TranslationMapUpgradeScript クラスを作成し、新しいログファイルにこれらのログを追加します。例： logs/translation_upgrade.log.

バージョン 4.4.0 のインストール

  1. 4.4.0 バージョンパッケージをからダウンロードします。 Adobeソフトウェア配布ポータル.

  2. バージョン 4.4.0 パッケージをインストールします。

  3. 「トリガーをヒット」を選択して、翻訳マップのアップグレードジョブを開始できます。 詳しくは、 サーブレットを介したスクリプトのトリガーの有効化.

  4. パッケージのインストールが完了したら、ログで次のメッセージが表示されるまで待ちます。

    Completed the post deployment setup script

    上記のメッセージは、インストールのすべての手順が完了したことを示しています。

    次の ERROR プレフィックスが表示された場合は、カスタマーサクセスチームに報告してください。

    • デプロイメント設定後のスクリプトでエラーが発生しました
    • 翻訳 MAP の移植中に例外が発生しました
    • プロパティの v1 から v2 に翻訳マップをポートできません

  5. バージョン 4.4.0 でリリースされた Oxygen コネクタプラグインをアップグレードします（必要に応じて）。

  6. パッケージをインストールした後で、ブラウザーのキャッシュをクリアします。

  7. 次の節で詳しく説明するように、カスタマイズのアップグレードを続行します。

バージョン 4.4.0 のインストール後

Experience Managerガイドをインストールした後、新しくインストールしたバージョンから設定に適用される様々な設定を結合できます。

NOTE
dam-update-asset モデルはカスタマイズできます。 したがって、カスタマイズが行われている場合は、カスタマイズとExperience Managerガイドをモデルの作業用コピーに同期する必要があります。

  1. DAM アセットの更新ワークフロー（後処理の変更）:

  2. URL を開く：

    code language-none 
    http://localhost:4502/libs/cq/workflow/admin/console/content/models.html

  3. 選択 DAM アセットの更新ワークフロー.

  4. 編集 ​をクリックします。

  5. 次の場合、 DXML Post Process Initiator コンポーネントが存在する場合は、カスタマイズが同期されていることを確認してください。

  6. 次の場合、 DXML Post Process Initiator コンポーネントが存在しない場合は、次の手順を実行して挿入します。

  7. クリック コンポーネントを挿入 ( プロセスの最後のステップとしてExperience Managerガイドの後処理を担当します)。

  8. を設定します。 処理ステップ 次の詳細を含む：

    「共通」タブ

    タイトル： DXML Post Process Initiator

    説明：変更または作成されたアセットの DXML 後処理のための Sling ジョブをトリガーする、DXML 後処理開始者ステップ。

    「プロセス」タブ

    • 選択 DXML Post Process Initiator ​から プロセス ドロップダウン

    • 選択 ハンドラー処理の設定

    • 選択 完了

  9. クリック 同期 をクリックします。 成功通知が届きます。

    note note
    NOTE
    更新して、カスタマイズされた変更とExperience Managerガイドの後処理手順が最終的なワークフローモデルに存在することを確認します。

  10. 1 回 DAM アセットの更新ワークフロー が検証された場合は、対応するランチャー設定を確認します。 これをおこなうには、AEM Workflow インターフェイスに移動してランチャーを開きます。

    code language-http 
    http://localhost:4502/libs/cq/workflow/content/console.html

    次に対応する\（必要に応じて\）次の 2 つのランチャー\（アクティブにする必要がある\）を検索し、変更します。 DAM アセットの更新ワークフロー:

  11. 「 」のランチャー​ 作成されたノード」が DAM アセットの更新ワークフロー — 条件の場合 "jcr:content/jcr:mimeType!=video"に設定する場合、「グロビング」の値は次のようにする必要があります。

    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • 'excludeList'には "event-user-data:changedByWorkflowProcess".
    • 「 」のランチャー​ 変更されたノード」が DAM アセットの更新ワークフロー — 条件"jcr:content/jcr:mimeType!=video"、「グロビング」の値は次のようにする必要があります。
    code language-json 
    /content/dam(/((?!/subassets|/translation_output).)*/)renditions/original
    • excludeList は、 "event-user-data:changedByWorkflowProcess".

  12. アップグレードが完了したら、カスタマイズ/オーバーレイが検証され、新しいアプリケーションコードに合わせて更新されることを確認します。 以下に例を示します。

    • /libs/fmditaor/libs からオーバーレイされたコンポーネントは、新しい製品コードと比較する必要があります。また、/apps の下のオーバーレイされたファイルで更新を行う必要があります。
    • 製品から使用される clientlib カテゴリは、変更の確認が必要です。 最新の機能を取得するには、上書きされた設定（以下の例を参照）を最新の設定と比較する必要があります。
    • elementmapping.xml
    • ui_config.json\（フォルダープロファイルに設定されている可能性があります）
    • 修正済み com.adobe.fmdita.config.ConfigManager

  13. damAssetLucene にカスタマイズを追加した場合は、再度適用する必要が生じる場合があります。 これらの変更を行った後、reindex を true に設定します。 これにより、カスタマイズした既存のノードのインデックスがすべて再作成されます。 完了すると、再インデックスフラグが再び false に設定されます。 システム内のアセットの数によっては、この処理に数時間かかる場合があります。

既存のコンテンツのインデックスを作成する手順

NOTE
4.3.0 または 4.3.1 からアップグレードする場合、これらの手順を実行する必要はありません。

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

  • POSTリクエストをサーバーに対して実行します\（正しい認証で） - http://<server:port\>/bin/guides/map-find/indexing. （任意）マップの特定のパスを渡してインデックスを作成できます。デフォルトでは、すべてのマップにインデックスが作成されます|| 例： https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>)

  • 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リクエストは成功と共に応答し、マップが失敗した場合はメンションします。 正常にインデックス付けされたマップは、サーバーログから確認できます。

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

NOTE
4.3.0 または 4.3.1 からアップグレードする場合、これらの手順を実行する必要はありません。

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

  1. （オプション）システム内に 100,000 個を超える DITA ファイルがある場合、 queryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService を大きい値 ( 存在するアセットの数（例：200,000）を超える値 ) に設定し、再デプロイします。

    table 0-row-3 1-row-3
    PID プロパティキー プロパティの値
    org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads 値：200000
    デフォルト値：100000

  2. 次の API を実行して、すべてのファイルの後処理を実行します。

    table 0-row-2 1-row-2 2-row-2
    終点 /bin/guides/reports/upgrade
    リクエストタイプ POST このスクリプトはPOSTリクエストなので、Postmanなどのエージェントを介して実行する必要があります。
    予想される応答 API は jobId を返します。 ジョブのステータスを確認するには、ジョブ ID を持つGETリクエストを同じエンドポイントに送信します。
    サンプル URL: http://<server:port>/bin/guides/reports/upgrade
    table 0-row-2 1-row-2 2-row-2 3-row-2
    終点 /bin/guides/reports/upgrade
    リクエストタイプ GET
    パラメーター jobId：前の post リクエストから受け取った jobId を渡します。
    予想される応答 — ジョブが完了すると、GETリクエストへの応答が成功します。
    — エラーが発生した場合は、エラーログと API 出力を顧客成功チームと共有します。
    サンプル URL: http://<server:port>/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678

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

サーブレットを介したスクリプトのトリガーの有効化 enable-trigger-serverlet-4-4-0

NOTE
4.3.0 または 4.3.1 からアップグレードする場合、これらの手順を実行する必要はありません。

POST:

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 は、送信されたジョブを指す、リポジトリで作成されたノードへのパスを保持します。 ジョブが完了すると自動的に削除され、それまでは、このノードを参照してジョブの現在のステータスを確認できます。

を探す com.adobe.fmdita.translationservices.TranslationMapUpgradeScript Completed porting of translation map from V1 to V2 および com.adobe.fmdita.xmltranslation.ots.TranslationMapUpgradeOTS Completed the thread to upgrade translation map from V1 to V2 次の手順に進む前に、を参照してください。

NOTE
ノードがまだ存在するかどうか、およびジョブのステータスを確認する必要があります。

GET: http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

を処理する手順 'fmdita rewriter' 競合

Experience Managerガイドには custom sling rewriter クロスマップ（2 つの異なるマップのトピック間のリンク）の場合に生成されるリンクを処理するためのモジュール。

コードベースに別のカスタム Sling リライターがある場合は、 'order' 値が 50 より大きい (Experience Managerガイド sling rewriter が使用する ) 'order' 50. これを上書きするには、50 より大きい値が必要です。 詳しくは、 出力書き換えパイプライン.

このアップグレードの間、 'order' の値を 1000 から 50 に変更した場合、既存のカスタムリライターがある場合は、とマージする必要があります。 'fmdita-rewriter'.

親トピック： ​​ダウンロードとインストール

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178