R7リポジトリからR8への移行

準備

移行元（旧版のR7）

Designerの運用タブから、zip 形式のリポジトリとして「バックアップ」してください。このファイルをR8で読み込ませることで、自動的に移行処理が行われます。

移行先（新版のR8）

初期リポジトリの状態に戻しておきます。

移行

運用メニューの「アップロード」欄から「ファイル選択」ボタンを開きます。ファイルダイアログが表示されるので、読み込むリポジトリファイル（通常は "wrb_" で始まる、zip 形式ファイル）を指定します。R7のDesignerでバックアップしたファイルを指定します。

ファイル選択後、「アップロード」ボタンを押下します。このとき、旧 R7 のリポジトリを、新しい R8 のリポジトリに移行される処理が自動的に適用されます。

移行のルール

移行ツールは次のルールに従って変換します。

• R7.0.xのアカウントモデル(juser)の主キー項目idは廃止されます。代わってuserid項目が主キーとなります。
• リポジトリの「値」部分は日本語表記から英語表記に変更になりました。そのため、移行後のリポジトリはキーは同じでも値部分が変わっています。
• Excel帳票で、利用ライブラリ "JExcelAPI" は廃止されました。R6/R7からの移行後はすべて "POI" を利用するようになります。
• スマートフォン対応で、携帯電話対応は廃止されました。"スマートフォン" に統一されます。
• スマートフォン対応で、軽量フレームワーク iUI は廃止されました。"スマートフォン" に統一されます。
• システムタブ内のモデルは移行対象ではなく、この版に同梱されているものを使うようになりました。ただし juser, jgroup, jnews, jfcstartworkstate, jfcsuspendworkstate を除きます。この5つのモデルは開発者が変更した定義が移行されます。

外部データベースの移行

R8 では外部データベースの指定がデータベースのバージョン毎に細かく指定できるようになりました。R7から移行したとき、次のようになります。移行後は必要に応じてデータベースの設定を変更してください。

• PostgreSQL は "PostgreSQL 8.2" という設定になります。
• Oracle は "Oracle 9i" という設定になります。
• SQLServer は "SQLServer 2005" という設定になります。

移行後に手動で行うこと

移行がスキップされるモデル

「システム」タブに含まれているモデルは、旧版からの移行ではなく、新版に含まれているものを使います。すなわち、移行ツールの対象外になります。

ただし以下のモデルは除きます。すなわち開発者が変更した定義が（移行後も）引き継がれます。

• juser
• jgroup
• jnews
• jfcstartworkstate
• jfcsuspendworkstate

上記以外のシステム系モデルを修正していた場合（例：メニュー体系を変更した）、手動で同じ修正を適用してください。

LDAP/ActiveDirectoryの設定

R7で利用していたLDAP/ActiveDirectoryの設定は廃止されました。R8方式の記載にあわせて再設定を行なってください。

カスタマイズコード

移行ツールでは、カスタマイズしたコード(Java,JSP,JavaScriptなど)は扱いません。 これらのファイルは開発者が手動で最新のR8向けコードに修正してください。[詳細...]

コードの修正方法の詳細は、Wagby販売パートナーへお問い合わせください。

データ移行

Wagbyが同梱しているシステムモデルの定義が変わっています。そのため既存のデータのバックアップを取得後、テーブルをいったん削除し、再作成を行なったあと、データのインポートを行なってください。

以下のモデルについては物理カラム名が変わったため、SQL文を使って手動対応を行なってください。

• システムモデル jfcpreferenceitem, jfccspreferenceitem テーブル の key という項目。共通設定機能を利用していない場合は移行不要です。
• システムモデル jfcworkflow_setting の繰り返しコンテナに対応したテーブル script_setting の condition という項目。ワークフローを使っていない、もしくはスクリプトによる制御を行なっていない場合は移行不要です。

SQLServer 2012 以降の対応

SQLServer 2012 以降で順序を利用したとき、SQLServer が提供する SEQUENCE を利用できるようにしました。R7まではWagbyが独自に提供する順序テーブル (seq) を用いていました。

このとき、順序の開始値は手動で設定する必要があります。R7まで用意されていた seq モデル内に、モデル毎の最終順序値が記録されています。この値を使って、SQLServer データベースに直接、順序の開始値を設定してください。この対応は R7 からの移行時の最初だけ必要です。

CASからSpringSecurityへの移行

R8 では認証モジュールが CAS から Spring Security に変わりました。外部認証サーバの再設定を行ってください。

設定の注意点は次のとおりです。

• 「ユーザ情報のDN」で、CAS でuid=%uと指定していた箇所は、Spring Security では uid={0} と記述します。

ログに変更履歴を残す設定

"画面>その他>ログに変更履歴を残す" を有効にする場合、設定欄に "CHANGE" と記載していましたが、これが R8 からチェックボックス方式に変わりました。移行ツールで引き継がれないため、この設定をしていたモデルは手動でチェックを有効にしてください。

R8.5.17/R9.1.11/R9.2.7でこの対応を行いました。

変更された仕様

• 32bit Java 環境では動作しません。稼働 OS および Java のいずれも 64bit 版をご利用ください。
• Excel帳票で、利用ライブラリ "JExcelAPI" は廃止されました。R6/R7からの移行後はすべて "POI" を利用するようになります。
• スマートフォン対応で、携帯電話対応は廃止されました。
• スマートフォン対応で、軽量フレームワーク iUI は廃止されました。
• LDAP や Windows Active Directory で認証するための CAS というライブラリは利用しないようになりました。代わりに Spring Security を採用しました。
• 外部システムから直接、Wagby の任意の画面を開く方法で、ユーザ名とパスワードをパラメータに含めることはできなくなりました。これはセキュリティ対策のためです。
• 画面レイアウト「シングルペイン」は廃止されました。マルチペインのみ、ですが、サブメニュー等の表示エリアは固定表示されないようになりました。

R8.3.1までの移行ツール利用時の注意点8.3.2

R8.3.1までの移行ツールでは、R7のリポジトリキーが存在しない場合 (*) に、正しく移行されないものがあることがわかりました。R8.3.2でこの不具合が修正されました。

すでにR7からR8へ移行済みだが、念のため正しく移行されないリポジトリがあるかどうかを確認する手順を示します。

1. 元の(R7の)リポジトリを使って、R8.3.2以降に含まれる移行ツールで移行処理を行う。
2. 移行後のログファイルを確認する。"set 値 key リポジトリキー modelId モデルID" という出力があった場合、このリポジトリキーの移行に問題があった可能性がある。現行のR8でその設定を確認し、R7と異なっていた場合、Desingerを使って手動で修正する。

問題のみつかったリポジトリキー