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 へ移行します。
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 のドキュメントが紐づいていたコンテンツ定義へ紐づきを変更します。データ移行
データ移行については、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 の展開された各案件の情報に対しても実施します。