ナレッジベース検索ツールガイド

Eclipse を起動

プロジェクト作成ウィザードの起動

File → New → Project...

Java Projectの作成

Java Project → Next

New Java Project ウィザードで、移植元の環境に応じて適宜設定を行いプロジェクトを作成します。

移植元ソースファイル群の配置

移植元となるソースファイル群を作成したプロジェクトに配置します。

	Note
	*.java だけでなく、*.jar, *.xml, *.jsp, *.properties, *.xsd などアプリケーションの動作に必要なファイル群全てを配置してください。

	Note
	ビルドが成功する状態にする必要はありません。

検索リソースの選択

検索したいリソース上で右クリックし、以下のメニューを選択します。

tubame → ナレッジベース検索

Figure 1. ナレッジベース検索実行メニュー

検索条件の設定

以下の入力項目を設定します。

以下の出力項目を設定します。

検索の実行

Finish をクリックすると検索が開始されます。

Figure 3. ナレッジベース検索実行メニュー

目視確認項目のチェック

移植規模を算出するためには、目視確認を行う必要があります。手順は、 目視状況のチェック を参照。

ヒアリング確認項目のチェック

移植規模を算出するためには、ヒアリング確認項目を行う必要があります。手順は、 ヒアリング状況のチェック を参照。

TODO:SE手動算出項目のチェック

移植規模を算出するために、検索結果編集画面で表示される各項目で、SEが手動でライン数を入力する項目があります。修正内容を確認して、ライン数を手動で設定します。 手順は、 ステップ数の設定 を参照。

不明項目（移植方法が不明となっている項目）のチェック

移植規模を算出するために、検索結果編集画面で表示される各項目で、検索結果編集画面の難易度が「不明」となっている場合は、移植方法を別途検討する必要があります。 移植検討の結果、移植検討の対象外とする場合は、 移植不要項目の削除 機能で、項目自体を削除します。

作業状況情報の表示

作業ビューより作業状況を確認します。以下の作業状況を表示します。手順は、 作業状況ビューによる作業状況の確認 を参照。

	Warning
	作業項目がすべて完了すると、「確認項目作業が完了しました」と表示されるので、各作業項目の残数が0になるまで、確認項目作業を行います。

移植不要項目の削除

	Warning
	移植不要項目の削除 を実施しない場合、レポート生成機能でレポート出力した際に、移植不要項目も移植工数として計上されるため、移植不要項目は必ず削除する必要があります。

報告書の出力

TUBAMEでは以下の機能のいずれかを利用して、レポート生成を行います。

jbm ファイルのオープン

検索結果として保存した jbm ファイルをダブルクリックして開きます。

	Note
	検索機能実行後は自動的に検索結果ファイルが開かれるため、本作業は不要です。

検索結果編集画面の確認

検索結果編集画面では、移植が必要な可能性のある項目が一覧で表示されます。各表示項目の概要を以下に記載します。 任意の行をダブルクリックすると、拡張子に関連付けされているエディタを開き、該当ファイルを表示することができます。

Figure 1. 検索結果編集画面

Table 1. 検索結果編集画面の表示項目

項目	説明
項番	検索した条件の項番です。
大項目	-
中項目	-
難易度	移植の為の難易度を難易度アイコン別に表示します。 Note 以下の種類があります。 High 実装内容の大規模な修正が必要で、実装や設定等の大幅な見直しが必要 Middle 実装内容を考慮した小規模な修正が必要 Low 実装内容を考慮せず軽微な修正で対応可能 Unknown 難易度不明 NOT_TRN 移植不可
ヒット数	検索条件にヒットした数です。
ファイル名	対象ファイルのプロジェクトルートからのパスです。
行	対象ファイルの行番号です。
ライン数	移植に必要な概算修正ライン数です。 Note 以下の種類があります。 数値 移植に必要な概算修正ライン数 TODO:SE 手動算出 解説に基づき個別に算出すべき項目 不明 ライン数不明なため独自に算出すべき項目 確認済 (移植不要) ヒアリング確認が完了している (問題なしと判断した項目) 確認済 (移植要) ヒアリング確認が完了している(移植が必要と判断した項目)
ライン数根拠	移植に必要な概算ライン数の根拠です。
合計ライン	ヒット数×ライン数です。
ガイド章	移植性検討ガイドラインの章番号です。 項目をクリックすると、移植性検討ガイドラインにリンクすることができます。 Note ガイドの配置場所はTUBAMEのリファレンスページより、確認・変更できます。
目視確認内容	目視確認する内容の説明です。 （初期表示時は列幅0で表示されている）
ヒアリング確認内容	ヒアリング確認する内容の説明です。 （初期表示時は列幅0で表示されている）
目視状況	目視確認の現在の状況です。 Note 以下の種類があります。 空白 目視確認する必要なし 未 目視確認する項目がまだ存在している 未確認 目視確認が未実施である 済 目視確認が完了している 確認済 (移植不要) 目視確認が完了している (問題なしと判断した項目) 確認済(移植要) 目視確認が完了している (移植が必要と判断した項目)
ヒアリング状況	ヒアリング確認の現在の状況です。 Note 以下の種類があります。 空白 ヒアリング確認する必要なし 未 ヒアリング確認する項目がまだ存在している 未確認 目視確認が未実施である 済 ヒアリング確認が完了している 確認済 (移植不要) ヒアリング確認が完了している (問題なしと判断した項目) 確認済 (移植要) ヒアリング確認が完了している(移植が必要と判断した項目)

チェックリスト情報ビューの確認

チェックリスト情報ビュー では、検索結果編集画面で選択している項目に対する詳細情報を確認することができます。以下のような情報を確認することができます。

作業状況ビューの確認

作業状況ビュー では、現時点の編集作業状況を確認することができます。

Table 3. 作業状況ビューの表示項目

項目	説明
現在の作業状況	現在の作業状況が表示されます。 Note 以下の種類があります。 確認項目作業が完了しました。 目視/ヒアリング確認項目を確認して下さい。 不明/TODO:SE手動算出項目を確認して下さい。 ファイルを上書きしてください。
現在の目視確認 / ヒアリング確認状況	検索結果編集画面に表示されている 目視確認状況 および ヒアリング確認状況 の残件数 / 全件数を表示します。
不明 / TODO：SE手動算出項目修正状況	検索結果編集画面に表示されている 不明項目修正状況 および SE手動算出項目修正状況 の残件数 / 全件数を表示します。

目視状況のチェック

目視状況 が 未確認 の項目は、目視で移植要否を確認する必要があります。 チェックリスト情報ビューの目視確認内容を参考に、該当のファイルを確認し移植の必要性をチェックしてください。移植要否が明確になったら、その結果を該当行の 列のステータスを変更します。 該当箇所で右クリックし、ステータスを以下の状態に変更する事が出来ます。

	Note
	以下の種類があります。 未確認 未確認 確認済 (移植不要) 問題なし 確認済 (移植要) 移植が必要

Figure 1. 目視状況のステータス変更画面

	Note
	ShiftキーやCtrlキーにより複数選択することができます。 ( ただし、選択範囲に目視確認項目ではない行が含まれていた場合、上記のメニューは表示されません)

ヒアリング状況のチェック

ヒアリング状況 が 未確認 の項目は、開発者にヒアリングして移植要否を確認する必要があります。 検索結果編集画面のヒアリング状況が「未」のものについて、ヒアリングを行います。チェックリスト情報ビューのヒアリング確認内容を参考に、プロジェクトにヒアリングを行い、 移植項目か確認を行い、確認済 (移植不要) 又は　確認済(移植要)に設定します。 該当の箇所について開発者へ移植の必要性を確認してください。移植要否が明確になったら、その結果を該当行の ヒアリング状況 列のステータスを変更します。 該当箇所で右クリックし、ステータスを以下の状態に変更する事が出来ます。

	Note
	以下の種類があります。 未確認 未確認 確認済 (移植不要) 問題なし 確認済 (移植要) 移植が必要

Figure 2. ヒアリング状況のステータス変更画面

	Note
	ShiftキーやCtrlキーにより複数選択することができます。 ( ただし、選択範囲に目視確認項目ではない行が含まれていた場合、上記のメニューは表示されません)

作業状況ビューによる作業状況の確認

作業状況ビューにより、作業状況を確認できます。

Figure 3. 作業状況ビュー画面

移植不要項目の削除

移植に関係しない項目など、画面上から項目を削除することができます。 個別に行を選択して削除する方法と、一括削除する方法の2つがあります。

Figure 4. チェック済みの移植不要項目の削除の実行画面

	Note
	行削除は、移植不要項目の削除ボタンの右のボタンを実行します。 ShiftキーやCtrlキーにより複数選択することができます。

ステップ数の設定

検索結果編集画面のライン数がTODO:SE 手動算出の項目は、 ガイド章をクリックし、HTMLガイドビューの修正内容を参考に、ライン数を手動で設定します。

ステップ数 が TODO:SE 手動算出 になっている項目は、 TODO:SE 手動算出 にカーソルを合わせることで、ステップ数が個別に入力可能となりますので、 ガイド章 をクリックして移植方法などを確認して、ステップ数を入力します。

Figure 5. ステップ数の設定画面

検索結果編集画面より行番号が表示されているアイテムを選択し、右クリックよりソースコードビューを開く を選択します

Figure 1. ソースコードビュー画面

jbm ファイルのオープン

検索結果として保存した jbm ファイルをダブルクリックして開きます。

移植方法表示

検索結果編集画面より、検索結果に対応するガイド章番号をクリックし、HTMLガイドビューより移植方法を確認できます。

保存

Eclipse メニューの CSV保存 を選択し、CSVファイルを出力します。

CSVファイルの分析

CSVファイルの分析ツールは本ツールでは提供していません。 利用者側で分析ツールを作成するなど適宜対応してください。

TUBAMEコミュニティのmigration-knowledgeリポジトリより、最新版のアーカイブを取得する。

https://github.com/TUBAME/migration-knowledge/archive/master.zip

利用するナレッジのコピー

ダウンロードしたmigration-knowledge-master.zipを展開すると、TUBAMEコミュニティで管理しているナレッジ(XML)がすべて同梱されているため、利用対象のナレッジをEclipseのプロジェクトにコピーする。

本例では、migration-knowledge-master.zipを展開したStruts1ToSpringMVCフォルダをEclipseプロジェクトにコピーする

								
migration-knowledge-master
 - apserver(APサーバ移行)
    -en
    -ja
      - JBossEAP4.3toJBossEAP6
         |- *.xml(JBossEAP4.3toJBossEAP6のナレッジXML)
         |- index.html (JBossEAP4.3toJBossEAP6のマイグレーションガイドHTML)  
      - WLS9toJBossEAP6
         |- *.xml (ナレッジXML)
         |- index.html (マイグレーションガイドHTML)
      - Tomcat5.5to6.0
         |- *.xml (ナレッジXML)
         |- index.html (マイグレーションガイドHTML)
      - Tomcat...(以降省略)
 - framework(フレームワーク移行)
    -en
    -ja
      - Struts1ToSpringMVC
         |- *.xml (ナレッジXML)
         |- index.html (マイグレーションガイドHTML)
							

Figure 2. Struts1ToSpringMVCフォルダをコピーしたEclipseプロジェクト

インストール済みパッケージの確認

rpmコマンドを実行し、Pythonおよびlxmlがインストール済みか確認する。インストールされていない場合はインストールを行う。

インストールの実施

yumコマンドを実行し、Pythonおよびlxmlをインストールする。

$ su - 
# yum install python python-lxml
				

インストーラのダウンロード

以下のリンク先より自身の環境に合わせたインストーラをダウンロードする。

	Note
	Python2.7.6：http://python.org/download/releases/2.7.6 lxml3.2.4：https://pypi.python.org/pypi/lxml/3.2.4

Pythonインストーラの実行

ダウンロードしたpython-2.7.6.*.msiを実行し、ウィザードに従ってインストールを行う。

lxmlインストーラの実行

ダウンロードしたlxml-3.2.4.*-py2.7.exeを実行し、ウィザードに従ってインストールを行う。