IM-VisualDesigner Migration Tool 移行支援ガイド(互換運用環境用) 第3版 2021-04-01

6.1. 移行支援ツールの内部仕様

ステップ1 IM-VisualDesigner Ver.7.2 から intra-mart Accel Platform への移行

コラム

トランザクションデータのうち、PublicStorageにコピーした添付ファイルの情報ファイルの文字コードを intra-mart WebPlatform 7.2 をインストールした際の文字コードから intra-mart Accel Platform に設定されている文字コードへ変換します。

ステップ2 IM-VisualDesigner のドキュメントから IM-FormaDesigner のアプリケーションのひな形生成

コラム

入力された情報を基に IM-FormaDesigner のアプリケーションを生成します。 IM-VisualDesigner のドキュメント情報からフォーム・テーブルに関する情報を抽出し、 IM-FormaDesigner 用にデータの変換を行い、生成したアプリケーションに設定します。
  • IM-FormaDesigner 用に生成されるテーブルのカラム名・フィールドID

    Oracleデータベースをご利用の場合、23文字以上のフィールドIDが存在するフォームを変換すると、22文字以上のフィールドIDは一部の情報がシステム側で自動採番された値に更新されます。カラム名も同様に変換されます。
    Oracleデータベースではカラム名の長さに関して30バイトの制限があるため、製品間でのカラム接頭辞の差を考慮し変換処理を実施しております。
    • IM-VisualDesigner
      • vd_ud_[フィールドID]
    • IM-FormaDesigner
      • imfr_ud_[フィールドID]
  • IM-FormaDesigner 用に生成されるテーブルのテーブル名

    • ヘッダーテーブル
      • imfr_ut_[アプリケーションID]
    • 明細行テーブル
      • imfr_ut_[アプリケーションID]_[IM-VisualDesigner のテーブルアイテムのID]
  • IM-FormaDesigner に移行される情報

IM-VisualDesigner => IM-FormaDesigner
フォーム => フォーム (注1)
テーブル設定 => テーブル設定 (注2)
DB参照機能(クエリー) => データソース定義 (注3)
IM-Workflow 連携設定
(ドキュメントID - コンテンツID)
=>
WF連携設定
(アプリケーションID - コピーされたコンテンツID)
(注1) フォームの変換については、「 フォーム変換ルール 」を参照してください。
(注2) テーブル設定には IM-FormaDesigner 用に生成されたるテーブルの情報が設定されます。
(注3) データソース定義については、DB参照機能(クエリー)設定のSQLと抽出条件が移行されます。
  • IM-Workflow に移行される情報
IM-VisualDesigner => IM-FormaDesigner
ドキュメントに紐付くコンテンツ定義 => コピーされたコンテンツ定義
コンテンツ定義に紐付くフロー定義 => コピーされたフロー定義
フロー定義に紐付くルート定義 => コピーされたルート定義
案件プロパティ設定、追記設定 => (注4)
(注4) 案件プロパティ設定、追記設定は IM-FormaDesigner 側に移行されないため、別途設定が必要です。
設定手順については「 IM-FormaDesigner アプリケーションの開発および検証する手順 」を参照してください。
(注5) 移行元が IM-VisualDesigner ワークフロー連携ドキュメント(IM-Workflow) でない場合、 IM-Workflow の定義情報/連携情報は作成されません。

ステップ3 IM-VisualDesigner → IM-FormaDesigner 切替

コラム

運用中の IM-VisualDesigner のドキュメントを、ステップ2で開発した IM-FormaDesigner のアプリケーションへの切替を行います。
IM-VisualDesigner の画面で入力されたトランザクションデータと IM-Workflow の案件データを IM-FormaDesigner へ移行します。
  1. IM-FormaDesigner のアプリケーションへの切替

    IM-Workflow 連携しているドキュメントの場合、データの移行前に IM-Workflow の定義情報/案件情報に対して IM-VisualDesigner のドキュメントから IM-FormaDesigner のアプリケーションへの切替を行います。
    具体的には、 コンテンツ定義の画面のパスとユーザプログラムのパスを IM-FormaDesigner の情報へ差し替えます。
    • 【画面パスの変換】

      画面定義に設定されている IM-VisualDesigner のパスを IM-FormaDesigner のパスへ変換します。
      一時保存画面
      straform/imw/view/apply_view → forma/imw/view/apply_view
      
      再申請画面
      straform/imw/view/retry_view → forma/imw/view/retry_view
      
      処理画面
      straform/imw/view/approve_view → forma/imw/view/approve_view
      
      処理詳細画面
      straform/imw/view/reference_view → forma/imw/view/reference_view
      
      参照画面
      straform/imw/view/reference_view → forma/imw/view/reference_view
      
      未申請画面
      straform/imw/view/apply_view → forma/imw/view/apply_view
      
      申請画面
      straform/imw/view/apply_view → forma/imw/view/apply_view
      
      確認画面
      straform/imw/view/approve_view → forma/imw/view/approve_view
      
      確認詳細画面
      straform/imw/view/reference_view → forma/imw/view/reference_view
      
      過去案件詳細画面
      straform/imw/view/reference_view → forma/imw/view/reference_view
      
    • 【ユーザプログラム定義の変換】

      承認アクション処理
      straform/imw/process/approve_process → forma/imw/process/approve_process
      
      案件プロパティ設定処理
      straform/imw/process/edit_matter_prop_process → forma/imw/process/edit_matter_prop_process
      
      申請アクション処理
      straform/imw/process/apply_process → forma/imw/process/apply_process
      
    • 【独自のユーザプログラム・画面パスの変換】

      独自のユーザプログラム・画面パスについては、下記の変換ルールでパスの差し替えを行います。
      IM-VisualDesigner => IM-FormaDesigner
      スクリプト開発モデル => JavaScript のファイル名の末尾に”_forma”を付与
      JavaEE開発モデル => Java のファイル名の末尾に”4Forma”を付与
    • 【 IM-FormaDesigner WF連携設定のコンテンツIDの変換】

      IM-Workflow のコンテンツ定義と IM-FormaDesigner のアプリケーションの紐づき設定を変更します。
      ひな形生成時にコピーしたコンテンツ定義から IM-VisualDesigner のドキュメントが紐づいていたコンテンツ定義へ紐づきを変更します。
  2. データ移行

データ移行については、1レコードずつトランザクションを分離します。
  • 【 入力データ管理テーブル情報】

    IM-VisualDesigner ドキュメントの画面上から入力されたデータを IM-FormaDesigner のアプリケーション用のテーブルへ移行します。
    IM-VisualDesigner => IM-FormaDesigner
    ヘッダテーブル => ヘッダテーブル
    明細行テーブル => 明細テーブル
  • 【添付ファイル情報】

    IM-VisualDesigner ドキュメントの画面上からアップロードされた添付ファイルを IM-FormaDesigner の管理テーブルとPublicStorageへ移行します。
    IM-VisualDesigner => IM-FormaDesigner
    PublicStorageファイル
    Storage Service/Straform/attach/%グループID%/commit/%ドキュメントID%/%登録ID%/
    =>
    PublicStorageファイル
    forma/fileupload/アプリケーションID/commit/ファイルID
    => 管理テーブル(imfr_t_fileupload)
  • 【案件テーブルのデータ移行】

    IM-Workflow の案件と画面から入力された情報を紐づけるためのレコードを IM-VisualDesigner の管理テーブル(”vd_t_imw_matter”)から IM-FormaDesigner の管理テーブル(”imfr_t_imw_matter”)へ移行します。
    • IM-Workflow の案件のシステム案件ID - IM-VisualDesigner ドキュメントのインサートID
    • IM-Workflow の案件のシステム案件ID - IM-FormaDesigner アプリケーションの登録データID(insertId)
  • 【 IM-Workflow 案件情報の変更】

    コンテンツ定義の設定に対して実施した画面のパスとユーザプログラムのパスの変更を IM-Workflow の展開された各案件の情報に対しても実施します。