Tubame Hands-on

ナレッジXMLを利用したナレッジベース検索を行う。

	Hands-on-Task1.
	ナレッジベース検索を実行

移植項目を確認する。

	Hands-on-Task2.
	ナレッジベース検索結果を確認する

移植規模の概算を行う

レポート生成を行う。

	Hands-on-Task6.
	ナレッジベース検索のレポートを作成する

移行先環境を設定し、依存性検索を行う。

依存性検索結果を確認する。

	Hands-on-Task9.
	依存性検索結果を確認する

移行先環境で利用できないAPIを可視化する

	Hands-on-Task10.
	依存性検索のレポートを作成する

ナレッジベース検索ウィザードの起動

プロジェクトを右クリックし、以下のメニューを選択する。 tubame → ナレッジベース検索

Figure 1. ナレッジベース検索のメニュー選択

マイグレーションナレッジの選択

ナレッジベース検索ウィザードが表示されたら、 インポート ボタンをクリックし、 FrameworkMigration_Struts1_To_SpringMVC4 を選択する。

	Warning
	インターネット接続ができない環境の場合は、 ナレッジベース検索で利用する「Struts1からSpringMVCへの移行ナレッジ」 を参考に、手動でマイグレーションナレッジを取得してください。 取得後は、 参照 ボタンをクリックし、ファイルの選択ダイアログで利用するマイグレーションナレッジ（本Hands-onでは「tubame-knowledge/Struts1ToSpringMVC/Struts1ToSpringMVC.xml」）を選択する。 Figure 2. ナレッジベース検索ウィザード Figure 3. ナレッジベース検索ウィザードのファイル選択ダイアログ

ナレッジベース検索の実行

検索実行ダイアログの Finish ボタンをクリックする。

Figure 4. ナレッジベース検索の実行

ナレッジベース検索結果より、移植項目を確認する

ナレッジベース検索の実行結果（result.jbm）ファイルがプロジェクト配下に作成され、ファイルの内容が jbmファイルエディタ で表示されます。 修正項目一覧が表示され、抽出された各修正項目の修正難易度や修正ライン数、修正対象ファイルなどの情報が表示されます

	Warning
	jbmファイルエディタ がオープンしていない場合は、プロジェクト配下に作成されているresult.jbmファイルをダブルクリックしてください

Figure 1. jbmファイルエディタ(ナレッジベース検索パースペクティブ)

	Note
	ナレッジベース検索のGUI(パースペクティブ）の構成は、jbmファイルエディタ以外に以下が存在します。 チェックリスト情報ビュー 検索条件などの情報が表示される。目視/ヒアリング確認する内容も表示される 作業状況ビュー 移植規模を算出するために必要なタスク(目視/ヒアリング確認項目の状況)の表示。 HTMLガイドビュー jbmファイルエディタ の ガイド章番号 をクリックすると、該当項目の修正方法を表示する ソースコードビュー jbmファイルエディタ で表示される 行 にカーソルを合わせ、右クリック ソースコードビューを開く をクリックすると、検索ヒット箇所がViewで表示される Figure 2. ソースコードビューを選択 Figure 3. ソースコードビュー

	Important
	jbmファイルエディタはナレッジXMLにあるチェックポイントで設定された検索条件で検索した結果を一覧表示しています。 どんな検索をおこなっているかは、 チェックリスト情報ビュー より検索手順等を確認することできます。 検索該当箇所は、 ソースコードビュー より確認することができます。 移植方法については、jbmファイルエディタ のガイド章番号をクリックして、 HTMlガイドビュー より確認することができます。 全体的な修正項目を確認したい場合、 jbmファイルエディタ の 列No にカーソルを合わせ、右クリックで 全アイテムを折りたたむ を表示します。 jbmファイルエディタ の 大項目 及び 中項目 を確認することで、どんな移植項目が存在するかわかります。

作業状況ビューを確認する。

	Warning
	作業状況ビュー より、 現在の目視確認 を確認し、目視確認項目が１件存在することを確認してください。 Figure 1. 目視確認項目の残数確認(残1件)

目視確認を行う

jbmファイルエディタ の 目視確認項目 に対して、 チェックリスト情報ビュー の 目視確認項目 を確認する。

目視確認項目の特定。

目視確認項目は、jbmファイルエディタの列「目視状況」をクリックして、「未」と表示されているものが対象となります。 「未」と表示されている行をクリックし、チェックリスト情報ビューの目視確認内容を確認します。

目視確認項目を移植不要とする

	Warning
	本Hands-onでは、目視確認項目は移植不要とします。jbmファイルエディタの列「目視状況」が「未確認」と表示されている部分にカーソルを合わせ、 右クリックメニューより、「目視確認済み（移植不要）」を選択。 Figure 2. 目視確認項目に対する移植可否判定

jbmファイルのセーブ

作業後は、Ctrl+Sでセーブしてください。

	Warning
	セーブ後は、作業状況ビューを確認し、目視確認状況の残数が0になることを確認します。 Figure 3. 目視確認項目の残数確認(残0件)

作業状況ビューを確認する。

	Warning
	作業状況ビュー より、 ヒアリング確認状況 を確認し、ヒアリング確認状況が３件存在することを確認してください。 Figure 1. ヒアリング確認項目の確認(残3件)

ヒアリング確認項目の特定。

ヒアリング項目は、jbmファイルエディタの列「ヒアリング状況」をクリックして、「未」と表示されているものが対象となります。 「未」と表示されている行をクリックし、チェックリスト情報ビューの目視確認内容を確認します。

ヒアリング確認項目を移植要とする

	Warning
	本Hands-onでは、ヒアリング項目は移植要とします。jbmファイルエディタの列「ヒアリング状況」が「未確認」と表示されている部分にカーソルを合わせ、 右クリックメニューより、「ヒアリング確認済み（移植要）」を選択。 Figure 2. ヒアリング確認項目の移植可否判定

jbmファイルのセーブ

作業後は、Ctrl+Sでセーブしてください。

	Warning
	セーブ後は、作業状況ビューを確認し、ヒアリング確認状況の残数が0になることを確認します。 Figure 3. ヒアリング確認項目の確認(残0件)

作業状況ビューを確認する。

	Warning
	作業状況ビュー より、 SE手動算出項目修正状況 を確認し、確認項目が8件存在することを確認してください。 Figure 1. SE手動算出項目の確認(残8件)

SE手動算出項目の特定。

SE手動算出項目は、jbmファイルエディタの列「ステップ数」をクリックして、ステップ数が「TODO:SE 手動算出」と表示されているものが対象となります。

SE手動算出項目に対してステップ数を入力する。

	Warning
	本デモでは、難易度が高(High)のものは、500を入力し、難易度が中(Middle)は、ステップ数を50を入力してください。すべてのSE手動算出項目に対してステップ数を入力してください。 Figure 2. SE手動算出項目に対してステップ数を入力。

jbmファイルのセーブ

作業後は、Ctrl+Sでセーブしてください。

	Warning
	セーブ後は、作業状況ビューを確認し、SE手動算出項目修正状況の残数が0になることを確認します。 Figure 3. SE手動算出項目の確認(残0件)

作業状況ビューを確認する。

	Warning
	作業状況ビュー より、 確認項目作業が完了しました と表示されていることを確認する。 Figure 1. 作業状況ビューの確認

チェック済みの移植不要項目の削除

エディタのアクションメニューより「チェック済みの移植不要項目の削除」をクリックする。

Figure 2. チェック済みの移植不要項目の削除

レポート生成ウィザードを起動する。 プロジェクトを右クリックし、以下のメニューを選択する。 tubame → ナレッジベース検索

Figure 3. レポート生成ウィザード画面

レポートテンプレートを選択及びレポート生成実行。

	Warning
	本Hands-onでは「レポートテンプレート」はMVCフレームワークテンプレートを選択し、Finishをクリックしてください。 Figure 4. レポート生成ウィザードのレポートテンプレート選択画面

レポート生成完了

Figure 5. レポート生成完了画面

Eclipseプリファレンス設定の起動

Figure 1. プリファレンス設定の起動メニュー

Eclipseプリファレンス設定

Figure 2. Eclipseプリファレンス設定画面

TUBAMEライブラリ設定の確認

TUBAME → 依存性検索ツール → ライブラリ設定

Figure 3. TUBAMEライブラリ設定の確認

ライブラリ設定の変更。本Hands-onでは、springmvc4を移行先環境とするため、デフォルトで有効になっているeap6.2のチェックを解除し、springmvc4をチェックします。

Figure 4. TUBAMEライブラリ設定の変更後画面

依存性検索ウィザードを起動します。プロジェクトを右クリックし以下を実行します。

tubame → 依存性検索ツール

Figure 1. 依存性検索ウィザードの起動メニュー

依存性検索ウィザードでライブラリ設定を確認します。移行先環境ライブラリにspringmvc4が存在することを確認します。

Figure 2. 依存性検索ウィザードのライブラリ設定(移行先ライブラリ)

依存性検索の実行します。依存性検索ウィザードのFinishボタンをクリックします。

レポート生成ウィザードを起動する。 プロジェクトを右クリックし、以下のメニューを選択する。 tubame → ナレッジベース検索

Figure 1. レポート生成ウィザード画面

レポートテンプレートを選択及びレポート生成実行。

	Warning
	本Hands-onでは「レポートテンプレート」はMVCフレームワークテンプレートを選択し、Finishをクリックしてください。 Figure 2. レポート生成ウィザードのレポートテンプレート選択画面

レポート生成完了

Figure 3. レポート生成完了画面