現在表示中:

移行ユーティリティは、Correspondence Management アセットやアダプティブフォームアセットを以前のバージョンで使用した形式から AEM 6.3 Forms で使用する形式に変換します。

移行へのアプローチ

以前の AEM Forms バージョンから最新バージョンの AEM 6.3 Forms にアップグレードするか、新規インストールを実行することができます。以前のインストールをアップグレードするか、新規インストールを実行するかにより手順が異なるので、次の該当する手順を実行してください。

インプレースアップグレード

同じサーバーインスタンス上で以前の AEM Forms を AEM 6.3 Forms にアップグレードできます。インプレースアップグレードを実行した場合、アップグレードインスタンスにはすでにアセットやドキュメントが存在します。ただし、これらのアセットやドキュメントを使用する前に移行ユーティリティを実行し、アセットやドキュメントを更新する必要があります。JEE 上または OSGi 上で以前のバージョンの AEM Forms から AEM 6.3 Forms にアップグレードする方法については、AEM 6.3 Forms ユーザーガイドページにある適切なドキュメントを参照してください。

新規インストール

新規インストールの場合は、以前の AEM Forms システム上でPre-Migration Utility を実行し(Correspondence Management アセットのみ、AEM 6.2 Forms より前のバージョンから移行する場合のみに該当)、以前の AEM Forms システムからアセットをエクスポートしてから、AEM 6.3 Forms にインポートします。次に AEM 6.3 Forms システム上で移行ユーティリティを実行します。

注意:

移行する古いアセットを読み込んでいる間、管理者アカウントを使用してログインします。

前提条件

移行ユーティリティを実行する前に、次の重要なタスクを行ってください。

  • 関連する AEM 6.3 Forms アドオンパッケージがインストールされていることを確認します。パッケージの取得およびインストールに関する詳細は、「AEM Forms のインストールと設定」を参照してください。
  • 管理者権限があることを確認します。
  • 移行による Correspondence Management とアダプティブフォームの変更」を確認します。
  • インプレースアップグレードの場合、アセットとカスタマイズが含まれるリポジトリ(crx-repository フォルダー)のバックアップを作成します。
  • 新規インストールでは、ADEP からアセットを書き出す場合、パッチ M03 P10 を ADEP サーバーに適用してから Correspondence Management アセットを書き出します。このパッチを適用しないと、AEM 6.3 Forms にアセットを読み込めません。ADEP パッチは、カスタマーサポートに連絡して取得してください。
  • 新規インストールの場合は、アセットをエクスポートするセットアップ上で Pre-Migration Utility を実行する必要があります(Correspondence Management アセットのみ、AEM 6.2 Forms より前のバージョンから移行する場合のみに該当)。

Correspondence Management アセットにおける Pre-Migration Utility の実行

新規インストールにおいて、AEM Forms 6.2 以前の設定からアセットを直接エクスポートして新しいバージョンの AEM Forms にインポートする場合、Correspondence Management アセットをエクスポートする前に、アセットをエクスポートする既存のセットアップ上で「Pre-Migration utility」を実行します。 

Pre-Migration Utility は、既存のシステム上の Correspondence Management アセットに必要な変更を加えます。これにより、テストデータがレター内で欠落していたり、データ辞書にローカライゼーションデータが存在しなかったりする場合でも、新規インストールでのインポート資産処理が成功します。

注意:

Pre-Migration Utility を実行して変更されるアセットの状態は、「変更済み」に変更されます。すべてのアセットがエクスポートされていることを確認するには、Pre-Migration Utility を実行する前に、その状態を「発行準備完了」または「発行済み」に設定します。

  1. 移行ユーティリティをダウンロードしてインストールします。

    注意:

    AEM パッケージのインストール方法については、『パッケージ共有のダウンロードとインストール』を参照してください

  2. 次の URL にアクセスし、管理者としてログインします。

    http://[hostname]:[port]/[context path]/content/changeType.html

  3. 『フォルダの種類を変更する』をクリックします。

    Pre-Migration Utilityが実行されます。正常に完了すると、ブラウザに「完了」と表示されます。例外またはエラーが発生した場合は、管理者としてログインしていることを確認してください。 

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

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

必要条件をすべて実行したら、AEM 6.3 Forms サーバーにアクセス可能なマシン上でブラウザーを開き、オーサーインスタンスで移行ユーティリティを実行します。次の手順に従って、移行ユーティリティを実行します。

注意:

移行プロセスの実行中は、Correspondence Management アセットまたはアダプティブフォームアセットのユーザーインターフェイスが開かれていないことを確認してください。

移行ユーティリティを実行した後で、アセットに変更を加えたり、アセットを作成したりします。移行ユーティリティは、アセットの変更や作成後に実行しないことをお勧めします。 

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

    注意:

    移行ユーティリティをはじめて実行する場合、\\cq-quickstart\logs\aem-forms-migration.log というパスと名前でログが作成されます。これにより、アセットの移動など、Correspondence Management とアダプティブフォームの移行情報の更新が維持されます。

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

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

    ブラウザーには次の 3 つのオプションが表示されます。

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

    • アセットを移行するには、「アダプティブフォームアセットの移行」をタップしてから、次の画面で「移行を開始」をタップします。次のものが移行されます。
      • アダプティブフォームとアダブティブドキュメント
      • ドキュメントフラグメント
      • テーマ
      • レター
      • データディクショナリ

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

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

    • カスタムコンポーネントのルールとスクリプトを移行するには、「アダプティブフォームカスタムコンポーネントの移行」をタップしてから、次の画面で「移行を開始」をタップします。次のものが移行されます。
      • ルールエディターで作成されたルールとスクリプト(6.1 FP1 以降)
      • 6.1 以前の UI の「スクリプト」タブで作成されたスクリプト
    • テンプレートを移行するには、「アダプティブフォームテンプレートの移行」をタップしてから、次の画面で「移行を開始」をタップします。次のものが移行されます。
      • 古いテンプレート – AEM 6.1 Forms 以前を使用して /apps に作成されたアダプティブフォームテンプレート。これには、テンプレートコンポーネントに定義されたスクリプトも含まれます。
      • 新しいテンプレート – テンプレートエディターを使用して /conf に作成されたアダプティブフォームテンプレート。これには、ルールエディターで作成されたルールとスクリプトが含まれます。
    移行プロセスの実行時は、ブラウザーウィンドウにそれぞれ以下が表示されます。
    • アセットを更新したとき:アセットは正しく更新されました。
    • 移行が完了したとき:アセットの移行が完了しました。

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

    • タグをアセットに追加:タグ「Correspondence Management:移行済みアセット」または「アダプティブフォーム:移行済みアセット」を移行済みのアセットに追加します。これにより、ユーザーは移行済みアセットを識別できます。移行ユーティリティを実行するときは、システム内の既存のアセットはすべて移行済みとしてマークされます。
    • タグを生成:以前のシステムに存在するカテゴリおよびサブカテゴリはタグとして作成され、これらのタグは AEM 内で関連する Correspondence Management アセットに関連付けられます。例えば、レターテンプレートのカテゴリ(要求)およびサブカテゴリ(要求)は、以下のスクリーンショットで示すようにタグとして生成されます。
    • 画像およびコンテンツを DAM に移動:画像モジュールおよびコンテンツモジュールは、移行後は DAM アセットとして使用できます。
    • レイアウトおよびレイアウトフラグメントを AEM 6.3 Forms ユーザーインターフェイスに移動:レイアウトテンプレートおよびレイアウトフラグメントは、AEM 6.3 Forms ユーザーインターフェイスセクションにフォームとして追加されます。
    • レターのサンプルデータを一時フォルダーにダンプ:レターのサンプルデータを、一時保存場所にある SampleData フォルダー(<temp folder>/SampleData/)にダンプします。一時保存場所は、Correspondence Management 設定の crx Config Manager を使用して構成します。以前は、すべての個々のレターにサンプルデータが含まれていました。現在は、サンプルデータはデータ辞書に関連付けられています。一時フォルダーのプロパティの構成方法に関する詳細は、「Correspondence Management 設定プロパティ」を参照してください。
    • プロセスの名前を先頭に挿入:AEM 6.3 Forms は、Forms と AEM workflows のどちらもサポートします。識別できるようにプロセス名が先頭に挿入されます。Forms workflows は、「Forms Workflow ->」が先頭に挿入され、AEM workflows は「AEM Workflow ->」が先頭に挿入されます。例えば、以下のスクリーンショットに表示されているレターテンプレートのプロパティの場合、関連付けられた後処理の名前の前に「Forms Workflow ->」が挿入されています。

    注意:

    Correspondence Management では、アセットを含んだ新しいフォルダーが UI に表示されます。アセットを見つけるためこれらのフォルダーを確認する必要がある場合があります。 

  4. 移行ユーティリティが実行を終了した後、ハウスキーピングタスクに進みます。

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

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

  1. リポジトリ(crx-repository フォルダー)のバックアップを作成します。すべての重要なマイルストーンでバックアップを作成する必要があります。移行済みアセットの検証を実行した後にのみ、新規アセットの作成またはアセットの変更を続行します。 
  2. レイアウトおよびフラグメントレイアウトの XFA バージョンが 3.3 以降であることを確認してください。旧バージョンのレイアウトおよびフラグメントレイアウトを使用している場合、レターのレンダリングで問題が発生する可能性があります。旧バージョンの XFA を最新バージョンの XFA に更新するには、以下の手順を行ってください。
    1. Forms ユーザーインターフェイスから XFA を zip ファイルとしてダウンロードします。
    2. ファイルを解凍します。
    3. 最新の Designer で XFA ファイルを開き、保存します。XFA が最新バージョンに更新されます。
    4. XFA を Forms ユーザーインターフェイスでアップロードします。
  3. 移行された古いアセットのダンプ済みサンプルデータにデータ辞書を関連付けます。以前は、サンプルデータはレターに関連付けられていました。現在は、サンプルデータはデータディクショナリに関連付けられています。レターの作成に関する詳細は、「レターの作成」を参照してください。
  4. 移行前に以前のシステムで発行されたすべてのアセットを発行します。移行ユーティリティは、オーサーインスタンスでのみアセットを更新して、アセットを発行する必要のあるパブリッシュインスタンスでアセットを更新します。
  5. 書き出しおよび読み込みの場合は、古いシステム(書き出し側システム)の構成設定を新しいシステム(読み込み側システム)に複製します。これは、外観や設定(監査有効化・無効化、キャッシュ、再読み込み有効化・無効化など)を、最新バージョンの AEM Forms でも以前のバージョンと同じにするためです。プロパティの構成に関する詳細は、「通信管理設定プロパティ」を参照してください。
  6. AEM 6.3 Forms を新規インストールする場合、新規ユーザーを作成し、フォームユーザーのグループ(OSGI 上の AEM Forms の場合)または Forms Manager 管理者ロール(JEE 上の AEM Forms の場合)を割り当てます。インプレースアップグレードの場合、新規グループまたはロールを既存のユーザー(OSGI のフォームユーザーグループおよび JEE の Forms Manager Administrator 権限)に割り当てます。
  7. 6.3 では、フォームユーザーグループの権限のいくつかが変更されました。ユーザーが XDP やスクリプトを含むアダプティブフォームをアップロードしたりコードエディターを使用したりできるようにするには、そのユーザーを forms-power-users グループに追加する必要があります。同様に、template-authors グループのユーザーは、ルールエディターのコードエディターを使用できなくなります。ユーザーがコードエディターを使用できるようにするには、そのユーザーを af-template-script-writers グループに追加します。ユーザーをグループに追加する方法については、「ユーザーとユーザーグループの管理」を参照してください。

移行による Correspondence Management とアダプティブフォームの変更

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

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー