AEM Forms のアセットとドキュメントの移行

移行ユーティリティは、アダプティブFormsアセットクラウド設定Correspondence Managementアセットを、以前のバージョンで使用されていた形式からAEM 6.5Formsで使用されていた形式に変換します。 移行ユーティリティを実行すると、次の項目が移行されます。

  • アダプティブフォームのカスタムコンポーネント
  • アダプティブフォームと Correspondence Management のテンプレート
  • クラウドの設定情報
  • Correspondence Managementとアダプティブフォームアセット
メモ

アウトオブプレースアップグレードを実行する場合(Correspondence Management のアセットを移行する場合)は、アセットをインポートするたびに、移行ユーティリティを実行することができます。Correspondence Management を移行する場合は、Forms 互換性パッケージがインストールされている必要があります。

移行の方法

AEM Forms6.4、6.3、または6.2からAEM Forms6.5の最新バージョンにアップグレードするか、新しいインストールを実行できます。 以前のインストール環境をアップグレードしたのか、新規インストールを実行したのかに応じて、以下に示すいずれかの手順を実行してください。

インプレースアップグレードを実行した場合

インプレースアップグレードを実行した場合、アップグレードインスタンスにはすでにアセットやドキュメントが存在します。ただし、これらのアセットやドキュメントを使用する前に、AEMFD 互換性パッケージ(Correspondence Management 互換性パッケージが含まれています)をインストールする必要があります。

次に、移行ユーティリティを実行して、アセットとドキュメントを更新する必要があります。

新規インストールを実行した場合

アセットとドキュメントを使用する前に、アセットが不適切な(新規の)インストールである場合は、AEMFD互換パッケージ(Correspondence Management互換パッケージを含む)をインストールする必要があります。

次に、新しい設定でアセットパッケージ(zipまたはcmp)を読み込み、移行ユーティリティ](#runningmigrationutility)を実行して[アセットとドキュメントを更新する必要があります。 Adobeでは、移行ユーティリティを実行した後にのみ、新しいセットアップで新しいアセットを作成することをお勧めします。

後方互換性に関する要件が変更されたことに伴い、CRX リポジトリ内のいくつかのフォルダーの場所が変更されています。以前の設定から新規環境に対して、依存関係(カスタムライブラリおよびアセット)を手動で書き出し、読み込みます。

移行を進める前にを読んでください

Correspondence Management のアセットを移行する場合は、以下の点に注意してください。

  • 以前のプラットフォームから読み込んだアセットに対して、プロパティが追加されます。fd:version=1.0
  • AEM 6.1 Forms 以降、コメントは初期状態では使用できません。以前に追加したコメントはアセット内で使用できますが、インターフェイスには自動的に表示されません。 コメントを表示させるには、AEM Forms のユーザーインターフェイスで extendedProperties プロパティをカスタマイズする必要があります。
  • LiveCycle ES4 など、旧バージョンの一部では Flex RichTextEditor を使用してテキストを編集しましたが、AEM 6.1 Forms 以降では HTML エディターを使用します。このレンダリングにより、フォント、フォントサイズ、フォントマージンの外観は以前のバージョンの作成者ユーザーインターフェイスでの外観と異なる可能性があります。ただし、レターは同じように表示されます。
  • テキストモジュールのリストが改善され、別々にレンダリングされるようになりました。外観や表示が今までと異なるところがあります。テキストモジュールのリストを使用している場所で、レターのレンダリングや表示を行うことをお勧めします。
  • 移行中に画像コンテンツモジュールは DAM アセットおよびレイアウトに変換され、フラグメントはフォームに追加されるため、これらのモジュールの更新者プロパティは管理者に変更されます。
  • アセットのバージョン履歴は移行されず、移行後は使用できなくなります。移行後のバージョン履歴は保持されます。
  • AEM 6.1 Forms 以降では、「発行準備完了」の状態は廃止されました。このため、「発行準備完了」の状態にあったすべてのアセットは、変更済みの状態に変更されます。
  • AEM Forms 6.3 ではユーザーインターフェイスが更新されているため、カスタマイズを行うための手順も異なります。6.3 よりも前のバージョンのアセットを移行する場合は、カスタマイズをやり直す必要があります。
  • レイアウトフラグメントは、/content/apps/cm/layouts/fragmentlayouts/1001 から /content/apps/cm/modules/fragmentlayouts に移動しました。アセットのデータディクショナリ参照には、名前の代わりにデータディクショナリのパスが表示されます。
  • タブスペースを使用してテキストモジュールを調整した場合は、再調整する必要があります。詳しくは、「Correspondence Management - タブスペースを使用したテキスト調整の詳細」を参照してください。
  • Asset Composerの設定がCorrespondence Managementの設定に変更されました。
  • アセットは、「Existing Text」や「Existing List」などの名前のフォルダーに移動されます。

移行ユーティリティの使用

移行ユーティリティの実行

移行ユーティリティを実行した後で、アセットに変更を加えたり、アセットを作成したりします。移行ユーティリティは、アセットの変更や作成後に実行しないことをお勧めします。移行プロセスの実行中は、Correspondence ManagementまたはアダプティブFormsアセットのユーザーインターフェイスが開いていないことを確認してください。

移行ユーティリティを初めて実行すると、[aem-installation-directory]\cq-quickstart\logs\ というパスに「aem-forms-migration.log」という名前でログファイルが作成されます。それ以降は、移行ユーティリティを実行するたびに、Correspondence Management とアダプティブフォームの移行に関する情報(アセットの移行に関する情報など)がこのログファイルに記録されます。

メモ

移行ユーティリティを実行する前に、必ず CRX リポジトリのバックアップを作成してください。

  1. ブラウザーセッションで、AEM オーサーインスタンスに管理者としてログインします。

  2. ブラウザーで次の URL を開きます。

    https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html

    ブラウザーに、以下に示す 4 つのオプションが表示されます。

    • AEM Forms アセットの移行
    • アダプティブフォームカスタムコンポーネントの移行
    • アダプティブフォームテンプレートの移行
    • AEM Forms クラウド設定の移行
  3. 移行するには、次の手順を実行します。

    • アセット​を移行する場合は、「AEM Forms アセットの移行」をタップし、次の画面で「移行を開始」をタップします。次のものが移行されます。

      • アダプティブフォーム
      • ドキュメントフラグメント
      • テーマ
      • レター
      • データディクショナリ
    メモ

    移行中、「競合が見つかりました…」のような警告メッセージが表示される場合があります。このようなメッセージは、アダプティブフォームの一部のコンポーネントのルールを移行できなかったことを示しています。 例えば、コンポーネントにルールとスクリプトの両方がある場合、スクリプトの後にルールが発生した場合はそのコンポーネントのルールは移行されません。ただし、そのようなルールは、アダプティブフォームのオーサリングでルールエディターを開くことで移行することができます。

    これらのコンポーネントは、アダプティブフォームのルールエディターで開くことで移行できます。

    • カスタムコンポーネントのルールとスクリプト(6.3からアップグレードした場合は不要)を移行するには、「アダプティブFormsカスタムコンポーネントの移行」をタップし、次の画面で「開始の移行」をタップします。 次の移行が行われます。 >

    • ルールエディターで作成されたルールとスクリプト(6.1 FP1 以降)

    • 6.1 以前の UI の「スクリプト」タブで作成されたスクリプト

    • テンプレートを移行する(6.3および6.4からアップグレードする場合は不要)には、「Formsテンプレートの適応移行」をタップし、次の画面で「開始の移行」をタップします。 次のものが移行されます。

    • 古いテンプレート — AEM 6.1Forms以前を使用して/appsの下に作成されたアダプティブフォームテンプレート。 これには、テンプレートコンポーネントに定義されたスクリプトも含まれます。

    • 新しいテンプレート — /confの下のテンプレートエディターを使用して作成されたアダプティブフォームテンプレート。 これには、ルールエディターで作成されたルールとスクリプトが含まれます。

    • アダプティブフォームのカスタムコンポーネントを移行するには、「アダプティブFormsカスタムコンポーネントの移行」をタップし、カスタムコンポーネントの移行ページで​開始の移行​をタップします。 次のものが移行されます。

      • アダプティブフォーム用に書き込まれたカスタムコンポーネント
      • コンポーネントのオーバーレイ(存在する場合)
    • アダプティブフォームテンプレートを移行するには、「アダプティブFormsテンプレートの移行」をタップし、カスタムコンポーネントの移行ページで​「開始の移行」をタップします。 次のものが移行されます。

      • AEM テンプレートエディターを使用して /apps フォルダーまたは /conf フォルダー内に作成されたアダプティブフォームテンプレート
    • 新しいコンテキスト認識クラウドサービスメカニズムを使用するには、AEM Forms クラウド設定サービスを移行する必要があります。このメカニズムには、タッチ操作が可能な UI が用意されています(/conf フォルダーに保管されています)。AEM Formsクラウド設定サービスを移行すると、/etcのクラウドサービスは/confに移動されます。 レガシーパス(/etc?lang=ja)に依存するクラウドサービスのカスタマイズがない場合は、6.5にアップグレードした直後に移行ユーティリティを実行し、以降の作業にはクラウド設定のタッチUIを使用することをお勧めします。 既存のクラウドサービスがカスタマイズされている場合は、移行後のパス(/conf フォルダー)に合わせてカスタマイズ内容を更新するまでは、アップグレード後のセットアップ環境で既存の UI を使用してください。カスタマイズ内容の更新が完了したら、移行ユーティリティを実行してください。

    次を含む​AEM Formsクラウドサービス​を移行するには、「AEM Formsクラウド設定の移行」をタップし(クラウド設定の移行はAEMFD互換パッケージとは独立)、「AEM Formsクラウド設定の移行」をタップし、設定の移行ページで​開始の移行​をタップします。

    • フォームデータモデルのクラウドサービス

      • ソースパス:/etc/cloudservices/fdm
      • ターゲットパス:/conf/global/settings/cloudconfigs/fdm
    • Recaptcha

      • ソースパス:/etc/cloudservices/recaptcha
      • ターゲットパス:/conf/global/settings/cloudconfigs/recaptcha
    • Adobe Sign

      • ソースパス:/etc/cloudservices/echosign
      • ターゲットパス:/conf/global/settings/cloudconfigs/echosign
    • Typekit クラウドサービス

      • ソースパス:/etc/cloudservices/typekit
      • ターゲットパス:/conf/global/settings/cloudconfigs/typekit

    移行プロセスの実行時は、ブラウザーウィンドウにそれぞれ以下が表示されます。

    • アセットを更新したとき:アセットは正しく更新されました。
    • 移行が完了したとき:アセットの移行が完了しました。

    完了後は、移行ユーティリティで以下を実行します。

    • タグをアセットに追加:タグ「Correspondence Management:移行済みアセット」または「アダプティブフォーム:移行済みアセット」を移行済みのアセットに追加します。これにより、ユーザーは移行済みアセットを識別できます。移行ユーティリティを実行すると、システム内の既存のアセットはすべて移行済みとしてマークされます。
    • タグを生成:以前のシステムに存在するカテゴリおよびサブカテゴリはタグとして作成され、これらのタグは AEM 内で関連する Correspondence Management アセットに関連付けられます。例えば、レターテンプレートのカテゴリ(「要求」)とサブカテゴリ(「要求」)は、タグとして生成されます。
  4. 移行ユーティリティが実行を終了した後、ハウスキーピングタスクに進みます。

移行ユーティリティ実行後のハウスキーピングタスク

移行ユーティリティを実行した後、次のハウスキーピングタスクを行います。

  1. レイアウトおよびフラグメントレイアウトのXFAバージョンが3.3以降であることを確認します。 古いバージョンのレイアウトとフラグメントレイアウトを使用している場合は、レターのレンダリングで問題が発生する可能性があります。 古いXFAのバージョンを最新バージョンに更新するには、次の手順を実行します。

    1. XFAをzip ファイルとしてFormsユーザーインターフェイスからダウンロードします。
    2. ファイルを解凍します。
    3. 最新の Designer で XFA ファイルを開き、保存します。XFA が最新バージョンに更新されます。
    4. XFA を Forms ユーザーインターフェイスでアップロードします。
  2. 移行前に以前のシステムで発行されたすべてのアセットを発行します。移行ユーティリティは、オーサーインスタンスでのみアセットを更新して、アセットを発行する必要のあるパブリッシュインスタンスでアセットを更新します。

  3. AEM Forms6.4および6.5では、formsユーザーグループの権限の一部が変更されています。 ユーザーが XDP やスクリプトを含むアダプティブフォームをアップロードしたりコードエディターを使用したりできるようにするには、そのユーザーを forms-power-users グループに追加する必要があります。同様に、template-authors グループのユーザーは、ルールエディターのコードエディターを使用できなくなります。ユーザーがコードエディターを使用できるようにするには、そのユーザーを af-template-script-writers グループに追加します。ユーザーをグループに追加する手順については、ユーザーとユーザーグループの管理を参照してください。

このページ