R6からR8/R9への移行

準備

移行元（R6）

定義ファイル

1. はじめに現在の Wagby R6 の定義ファイルを R6 系の最新版である R6.10 系へアップグレードします。
2. その後、Wagby R6 でビルド処理を行います。この、最後にビルドされた状態が移行の対象になります。（xls-modelフォルダに定義ファイルがあり、かつ、この定義ファイルを用いてR6環境で最後にビルドを行った状態としてください。）

データ

システム管理者で（現在稼働中の）Wagbyアプリケーションにログオンします。インポートエクスポート機能を使って現在のデータをすべて「エクスポート」します。

またはWagbyアプリケーションを起動せず、コマンドラインツール InitLoader.jar を使ってエクスポートすることもできます。

移行先（R8/R9）

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

移行ツールの使い方

1. 移行元の Wagby (R6) のフォルダと、移行先の Wagby (R8/R9) のフォルダがそれぞれ用意されているもの、とします。
2. コマンドプロンプトを開きます。
3. Wagbyをインストールしたフォルダのmiscに移動します。

   

4. 次のコマンドを実行します。

   java -jar RepositoryMigrationCUI.jar 6to9 ..\..\Wagby-6.10.U11

   
   R9への移行の場合、コマンドの第一引数は "6to9" とします。R8へ移行する場合は "6to8" としてください。第二引数は、移行元となる Wagby のフォルダを指定します。上の例では R9 インストールフォルダの misc フォルダの位置から相対パスで R6.10.U11 を指定しています。適切に読み替えてください。

作業ログ

コマンド実行後、miscフォルダ直下にlogs/repositorymigration.logファイルが生成されます。この内容をご確認ください。

移行のルール

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

• R6のマスタモデルは、R8の選択肢モデルとなります。
• R6の簡易計算式（時間の差、生年月日、パディング）はすべて関数を使った式に置換されます。動作は同じです。
• R6の「固定値」という型はR8では廃止されました。代わって「初期値」に式が設定されます。
• R6の「モデル参照 - 複数の項目を連結して表示する」機能は廃止されました。式を使って同様のことを行ってください。
• R6のカレンダビューではタイトル、場所、担当者、備考は複数の項目を指定することができました。しかしR8では1設定=1項目となります。式を使って同様のことを行ってください。
• R6の「（固定）メール設定」はすべて「メールテンプレート」方式に変更されました。
• R6の「（固定）帳票設定」はすべて「帳票テンプレート」方式に変更されました。
• R6のアカウントモデル(juser)の主キー項目idは廃止されました。代わってuserid項目が主キーとなります。
• R6のExcel一覧帳票印刷では、"画面上のデータのみ出力" と "全件出力" の2パターンが指定できましたが、R8では "全件出力" のみとなりました。
• R6.6 Update 9 以前の版で使われていた旧方式の計算式を、現在の方式に変換します。（四則演算式ならびに初期値の式を対象とします。）
• juserモデルを参照している項目で、juserのid項目を表示優先度に指定していた場合、これを参照モデル(juser)の主キーであるuserid項目を利用するように変換します。（juserのid項目は廃止されたため）
• juserモデルを参照している項目で、juserのid項目を内容、有効期限、絞込項目に指定していた場合、これをuserid項目へ置換するようにします。（juserのid項目は廃止されたため）
• juser,jgroup,jnews以外のシステム系モデルは、すべてR8最新版に置換されます。R6で、システム系モデルに適用した修正は移行されません。

移行後に行うこと

移行ツール適用後、logsフォルダにあるrepositorymigration.logに具体的な変更箇所が明記されています。 下記の内容に従って修正してください。

モデル参照 - 複数の項目を連結して表示する

R6ではモデル参照の内容に複数の項目を連結する記述がありました。しかしR8/R9では本表記は廃止され、代わりに式を使うことを推奨しています。

移行ツールによって、最初の項目だけが取得されます。（例えば設定欄に「empname+'('+empid+')'」と記述していた場合、移行によって参照モデルの内容は「empname」となります。）移行後に手動でこの設定を（式を使う形で）再定義してください。

カレンダビュー - タイトル、場所、担当者、備考に複数の項目を指定する

R6のカレンダビューではタイトル、場所、担当者、備考は複数の項目を指定することができました。しかしR8/R9では1設定=1項目となります。式を使って同様のことを行ってください。

入力欄へのスタイル指定

R6では標準HTML部品に対してスタイル(CSS)を適用していました。R8/R9ではDojotoolkitが提供する部品へスタイルを適用するようになりました。そのため表示結果が異なる場合があります。念のため目視で確認してください。

外部データベースの移行

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

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

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

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

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

• juser
• jgroup
• jnews

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

LDAP/ActiveDirectoryの設定

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

システム定義ファイル

R6の$(DEVHOME)/env/xls-commonフォルダに含まれる、次のシステム定義ファイルを変更していた場合は手動で同じ修正を適用してください。

• common-jfcjobschedule.xls
• common-jfclicenseholder.xls
• common-jfclockobject.xls
• common-jfcmailtemplate.xls
• common-jfcreporttemplate.xls
• common-jfcrepository.xls
• common-jfcworkflow.xls
• common-jfcworkflow2.xls
• common-jholiday.xls

帳票出力ファイル名の命名規則

R6では出力ファイル名に式を含めることができました。R8/R9では、R6でも用意されていた「帳票テンプレート」方式に統一されました。そのため出力ファイル名の命名規則が帳票テンプレート方式になります。

そこで出力ファイル名に式を含めていた場合、次の要領で定義を変更してください。

1. 当該モデルに文字列型の隠し項目（かつデータベース非保存項目）を追加します。計算式で、出力ファイル名を生成させます。例えばモデルdailyreportに隠し項目outputfilenameを用意し、元の式を記述して出力ファイル名を得られるようにします。

   ${name}+"_"+${currenttime}+"_"+${userid}

2. 移行後の帳票テンプレート定義で、出力ファイル名に上記の項目名と拡張子を記述します。このとき「"モデル名_p." + 項目名」と指定します。

   ${dailyreport_p.outpufilename}.xls

テンプレートデータの扱い

移行ツールによって、exportフォルダに「data_R6template」が作成されることがあります。 これはWagby定義ファイル上のメールと帳票の設定が、テンプレートファイル形式に変換されたものです。

ビルド後に、このフォルダ内のファイルをインポートします。次の手順で行ってください。

1. ビルドしたアプリケーション (wagbyapp) の bin フォルダに含まれている importR6_db.bat を実行します。(Linux OSの場合は importR6_db.sh です。)
2. アプリケーションを起動します。
3. メールテンプレートおよび帳票テンプレートの内容を確認します。Wagby定義ファイルの設定がテンプレート化されています。

テンプレートファイルをコピーする

上の手順で「帳票テンプレートモデル」に情報は移行されましたが、テンプレートファイル本体はまだ含まれていません。次の手順でコピーします。

1. WagbyR8/R9 フォルダ直下に upload_dir/jfcreporttemplate フォルダが存在することを確認します。（フォルダがない場合は手動で作成してください。）
2. R6のxls-reportフォルダに用意していたテンプレートファイルを、この upload_dir/jfcreporttemplate フォルダ内にコピーします。

このあと、アプリケーションから帳票印刷のテストを行ってください。

データ移行

旧データ (R6) を、移行先の R8/R9 へインポートします。

R6 と R8/R9 ではテーブルの構成が異なります。そこで R6 のデータベース環境は残しつつ、R8/R9 用に新しい論理データベース環境を作成することを推奨します。

1. コマンドプロンプトを開きます。
2. wagbyapp フォルダに含まれる bin フォルダに移動します。"cd C:\Wagby-9.1.0\wagbyapp\bin"
3. import_db.bat を実行します。引数に（取り込みたいデータが格納されている）フォルダ名を指定します。"import_db.bat ..\..\export\data_20180301090000"

ファイル型項目の扱い

「ファイル型」項目に対してアップロードを行ったファイルは、現行システムの upload_dir フォルダ以下に保存されています。同フォルダ以下を新システムに移動（またはコピー）します。

プリンシパル「マスタ更新者(jshparam_master)」の扱い

R6の「マスタモデル」は R8/R9で通常モデル（ストアモデル）と扱いが変わりました。これに伴い、マスタ更新者プリンシパルは再設定を行ってください。

1. Designer の "環境 > 権限" タブを開きます。
2. 「マスタ更新者プリンシパル(jshparam_master)」の右側にある "選択肢表示" を有効にします。（チェックします）
3. モデル一覧から、対象となるモデル（R6のときのマスタモデルだったもの）を選択します。
4. "権限 > 機能権限" で、プリンシパルに「マスタ更新者 (jshparam_master)」を指定します。

カスタマイズコード

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

コードの変更時に考慮するべき内容を「R6/R7からR8への移行」にも記載しています。

カスタマイズコード変更作業に個別対応することもできます。詳細はWagby販売パートナーへお問い合わせください。

R6とR8/R9で異なる点

R6との違いは次のとおりです。

• 32bit Java では動作しません。64bit Java をご利用ください。
• マスタモデルは廃止されました。代わって "選択肢モデル" が用意されています。
• マスタモデルが廃止されたため、旧マスタモデルの編集画面は、一覧更新画面に変わりました。
• マスタモデル参照は "選択肢モデル" への参照に変わります。ソートルールが「表示優先度」のとき、表示順の標準は「昇順（数字の小さい順）」となります。
• 簡易計算式（時間の差、生年月日、パディング）はすべて関数を使った式に置換されます。
• 「固定値」型は廃止されました。設定によって同様のことを実現できます。
• 文字列型の入力項目の種類「人工キー」は廃止されました。(R6でも非推奨機能でした。)
• 数値項目の入力では、整数部15桁・小数部6桁の範囲に制限されます。
• 日付時刻型の入力では、テキストフィールド形式の入力は廃止されました。日付部と時刻部は分離され、それぞれテキスト入力も行えるようになっています。
• モデル参照で、複数の項目を連結して表示する機能は廃止されました。具体的には、参照モデルの内容に「empname+'('+empid+')'」というような表記が行えません。式を使って同様のことを行ってください。
• 「入力制御 > 入力フィールド長」で、1文字の幅の単位は "em"となります。
• 「入力制御 > 入力欄のスタイル指定」で、入力欄に指定したスタイルは入力中には適用されません。
• R6のアカウントモデル(juser)の主キー項目idは廃止されました。代わってuserid項目が主キーとなります。この影響で juser の主キーを参照していたモデルは、その項目の型が int から String になります。
• メール送信・受信設定は「メールテンプレート」の利用に統一されます。
• Excel・PDF帳票設定は「帳票テンプレート」の利用に統一されます。
• Excel帳票で利用するライブラリで、JExcelAPIはご利用いただけません。このライブラリの対応は終了しました。
• R6のExcel一覧帳票印刷では、"画面上のデータのみ出力" と "全件出力" の2パターンが指定できましたが、R8で "全件出力" のみとなりました。
• パーミッション、プリンシパルの設定数の上限（パーミッションは50個まで、プリンシパルは30個まで）が撤廃されました。
• 帳票の定義数の上限（R6では30個まで）が撤廃されました。
• 画面のページタイトル設定とメニューボタンのラベルは連動しないようになりました。それぞれ独立に設定します。
• 添付文書の全文検索で、文書からテキストを抽出するライブラリはTikaのみとなります。(R6で対応していたTextPorterとxdoc2txtはR8ではサポート外となります。）
• 住所正規化コンバータR4,R5との連携機能は終了しました。住所正規化コンバータは新版となるR6と連携します。
• トランザクションに関するサーバサイドJavaScriptのファイル名および繰り返しコンテナの扱いが変更されました。
• Wadgetは廃止されました。代わってポータル機能が提供されました。
• タブ設定で、複数の繰り返しコンテナを一つのタブにまとめる場合、どの繰り返しコンテナをデフォルトタブにするかという設定は廃止されました。常に最初の繰り返しコンテナが選択されます。
• 画面レイアウト「シングルペイン」は廃止されました。マルチペインのみ、ですが、サブメニュー等の表示エリアは固定表示されないようになりました。
• 親モデルに表示される子モデル一覧表示の並び順は、子モデルの「モデルID」の辞書順になります。
• サーバサイドJavaScriptの実行ファイル名(.jsファイル)ルールが変わっています。R6のファイルはそのままではご利用になれません。新しい命名規則に従って変更してください。
• Java 6/7 でサーバサイドJavaScriptを利用していた場合、Java 8 以降では一部書き換えが必要になります。JavaScript エンジンが rhino から nashorn に変更された影響です。
• "URL型を使ってファイル共有を行う" 機能の説明はマニュアルから除かれました。本機能はブラウザのセキュリティ対策が進み、利用できなくなる見通しのためです。
• 一覧更新画面の「入力チェック」ボタンは廃止されました。（一覧更新機能および親子モデル同時更新機能で、入力エラー時はエラーメッセージを表示して編集画面に戻るようになったため。）この対応は R8.0.3 で行われました。
• ダウンロード機能でExcel形式で出力したとき、日付・時刻・日付時刻型のフォーマットは "JDBCタイムスタンプ・エスケープ形式" となります。それぞれ "yyyy-mm-dd", "h:mm:ss", "yyyy-mm-dd h:mm:ss" です。
• ダウンロード機能で検索条件部に「リセット」ボタンが用意されます。この対応はR7.12.8で行われました。
• 外部システムから直接、Wagby の任意の画面を開く方法で、ユーザ名とパスワードをパラメータに含めることはできなくなりました。これはセキュリティ対策のためです。
• R6では外部キー子モデルが存在した場合、一覧画面に新規登録ボタンが作成されない制約があった。この制約はR7.6で改善され、新規登録ボタンが用意されるようになった。
• 数値項目は右揃えになりました。この変更はR9.0.0で行われました。移行後のリポジトリを手動修正することで左揃えとすることはできます。
• R6にあった「休日種別モデル」はシステム内部に隠蔽されました。「全国」「地域」「特別」という選択肢が固定となります。

トラブルシューティング

• バージョンアップによってwagbyappに同梱されているJavaScriptファイルが更新されています。常に新しいJavaScriptを読み込むようにつくられていますが、ブラウザが古いファイル（キャッシュ）を使うと正しく動作しません。そのため、バージョンアップ後は利用者PCのブラウザのキャッシュクリアも行うことを推奨します。それでも動作がおかしい場合、キャッシュクリアとは別に、"SHIFT" + "リロード" で、強制的なページ再読み込みを行うことも効果があります。
• 古い定義ファイルを移行すると、管理処理メニューの設定が正しく行えなくなることがあります。例：「統計情報」機能は R6.7 Update 3 で提供されました。それより前の定義ファイルを R8 リポジトリへ移行すると、移行後の管理処理メニュー設定欄に「統計情報」アイコンが表示されません。そのため順番や色の設定が行えません。