2. Using VB Migration Partner／VB Migration Partnerを使用する

The first thing to do at this point is checking all the errors and warnings in Visual Studio’s Error List window, and then all the items in the Task List window.

この時点で最初にすることは、Visual StudioのError Listウィンドウにすべてのエラーと警告をチェックすることと、Task Listウィンドウにすべてのアイテムがあることをチェックします。

VB Migration Partner can generate for different type of comments in the converted application:

VB Migration Partnerは変換されたアプリケーションに異なるタイプのコメントを生成することができます。

• • UPGRADE_ISSUE: serious migration issues that you should solve immediately

• • UPGRADE_ISSUE：　速やかに改善すべき深刻な移行問題点。

• • UPGRADE_WARNING: migration warnings that might or might not affect the converted application

• • UPGRADE_WARNING：　変換されたアプリケーションとして、影響があるかどうかわからない移行の警告。

• • UPGRADE_TODO: suggestions about how to manually edit the migrated code to avoid a potential problem

• • UPGRADE_TODO：　潜在的な問題を回避するために、手動でコードを編集することを提案。

• UPGRADE_INFO: information about the generated VB.NET code, including information about unused constant and methods and recommendations about the .NET type or methods that can replace a Declare statement.
• 
  UPGRADE_INFO：　生成したVB.NETコードについての情報。使用されていない定数やメソッド、宣言文に置き換えることができる.NETの型やメソッドについての提案。

By default, only warnings and to-do comments appear in Visual Studio’s Task List pane. We suggest that you use the Tools-Options command to add the UPGRADE_ISSUE comment to the list of comments that the Task List recognizes and set its importance to High.

デフォルトでは警告とToDoコメントのみVisual Studioのタスク一覧画面に表示されます。.NETの「ツール　メニュー　オプション」を実行し、「UPGRADE_ISSUE」コメントをコメントリストに追加し、タスク一覧が認識できるように優先順位を「高」にしてセットすることをお勧めします。

If there are no compilation errors you can run the VB.NET application and see how it behaves. It’s unlikely that a complex application runs smoothly at the first attempt, therefore be prepared for runtime exceptions. We recommend that you enable the option Break When An Exception Is Thrown in the Debug-Exceptions dialog box, so that you immediately catch unexpected runtime errors that would go unnoticed because of an On Error statement.

コンパイルエラーがなければ、VB.NETアプリケーションを実行し、どのように動作しているか見ることができます。複雑なアプリケーションにおいては最初の起動でスムーズにいくことはあまりありませんのでランタイムエラーが起こることを想定しておいてください。「デバッグ　メニュー　例外」を実行し、ダイアログボックスのCommon Language Runtime Exceptionsの「スローされるとき」チェックボックスを有効にすることをお勧めします。その設定により、On Error Statementによる気がつかない、予期せぬランタイムエラーが起こった際にすばやくキャッチすることができます。

At the end of the conversion process VB Migration Partner displays a detailed report in the Metrics tab in the right portion of the main window.

変換プロセスの終わりにVB Migration Partnerはメインウィンドウの右側にある「Metrics」タブの中に詳細なレポートを表示します。

1. 1. Select an item in the tree on the left, to display code metrics at the solution, project, or file level.

1. 1. Solution、Project、またはFileレベルにおけるコード指標を表示させるために、左にあるツリーの中のアイテムを選択してください。

1. 1. Select an item from the combobox to further restrict the report to just forms, classes, public or private members, methods or properties, and so forth.

1. 1. レポートに制限させるために、フォーム、クラス、パブリックまたはプライベートのメンバ、メソッドやプロパティなどの項目をコンボボックスから選択します。

1. 1. Select an item in the grid to see a more detailed report in the lower area of the Metrics tab.

1. 1. 表の中の項目を選択すると、Metricsタブの下段にあるより詳細なレポートを見ることができます。

1. 1. Sort the items in the grid in either ascending or descending order, by clicking on a column header.

1. 表の中の項目で列ヘッダをクリックすることで、各項目列の昇順、降順の並び替えをすることができます。

The sorting feature is especially useful when focusing on the most problematic portions of the VB6 solution to be converted. For example, you can sort all methods on their cyclomatic index in descending order to immediately find the most complex methods in the application.

ソート機能は変換されたVB6ソリューションで特に最も問題となる部分に焦点をおくように利用すると便利です。たとえば、アプリケーションの中で最も複雑なメソッドを見つけるために、「Cyclomatic Index」にあるすべてのメソッドを降順で並び替えることができます。

The Metrics tab of the Tools-Options dialog allows you to configure which code metrics appear in the grid and in the area underneath the grid.

「Tools -> Options」を実行し、Optionsダイアログの「Metrics」タブでグリッドの下にあるエリアにどのコード指標を表示させるか設定することができます。

The name of most code metrics values is self-explanatory, but a few might require an explanation. 

ほとんどのコード統計値の名称は一目瞭然かと思いますが、いくつか説明をします。

• • Total Lines is the sum of all code lines in the file, project, or solution. It includes the lines in the hidden portion of .frm and .ctl files.
  • 
    Total LinesはFile、Project、Solutionのすべてのコード行の合計です。.frmと.ctlの隠れたコードも行数に含みます。

• • Code Lines is the number of lines that contain actual executable code; it doesn’t include empty and remark lines (which are counted by separate code metrics).

• • Code Linesは実際の実行コードを含むコード行数です。空行とコメント行は含みません。（分割したコード統計によりカウントされます）

• • Remark to Code Lines Ratio provides a broad measure of how well the original VB6 project is documented; the higher this value, the better.

• • Remarks to Code Lines RatioはオリジナルのVB6のドキュメントに記載されているものよりもより高く、より広範囲に測定したコード比率を提供します。

• • Implicit Local Variables is the number of local variables that aren’t explicitly declared; they are typically converted as Object variables, therefore you might need to add the original VB6 code to use a more efficient type.

• • Implicit Local Variablesは明示的に宣言されていないローカル変数の数です。それらは通常オブジェクト変数として変換されます。そのために、より効果的な型を使用するようにオリジナルのVB6コードに追加する必要があるかもしれません。

• • Variant Variables is the number of Variant variables; they are migrated as Object variables, therefore it is recommend that you carefully scrutinize each of them and change them to a more efficient type if possible, or possibly use a SetType pragma to convert them to VB6Variant variables.

• • Variant Variablesはバリアント型変数の数です。それらはオブジェクト変数として移行されます。そのために、それらをひとつひとつ注意深く精査し、より効果的な型に変えることを勧めます。できれば、VB6Variant変数にそれらを変換するようにSetType　Pragmaを使用してみてください。

• • Fixed Length Variables is the number of fixed-length strings. By default they are converted to instances of the VB6FixedLength class, but you might want to edit the original VB6 code (or use a UseSystemString pragma) to transform them into regular string.

• • Fixed Length Variablesは固定長型変数の数です。デフォルトではそれらはVB6FixedLengthクラスのインスタンスに変換されます。しかし、通常のStringに変換するためにオリジナルのVB6コードを編集して下さい。（UseSystemString　Pragmaを使うこともできます）

• • Auto-Instancing Variables is the number of variables declared with the “As New” keyword. These variables have a different semantics in VB.NET and might behave differently.

• • Auto-Instancing Variablesは「As New」キーワードで宣言されている変数の数です。これらの変数は、VB.NETでは異なる意味を持っており、違った動作をすることもあります。

• • Non-Zero Bound Array Variables is the number of arrays whose lower index is nonzero; such arrays require a pragma to compile correctly under VB.NET.

• • Non-Zero Bound Array Variablesは最小IndexがNon-Zeroの配列の数です。VB.NET配下でそのような配列を正しくコンパイルするためのPragmaが必要です。

• • Gotos, Gosubs, On Gotos and Gosubs are the total number of GoTo keywords, GoSub keywords, and calculated GoTo/GoSub keywords, respectively. VB.NET supports the GoTo keyword and VB Migration Partner generates code that simulates GoSubs and calculated GoTo/GoSub; nevertheless, it is strongly recommended that you edit the original VB6 application to get rid of them.

• • Gotos, Gosubs, On Gotos and GosubsはGotoキーワード、Gosubキーワード、計算されたGoTo/GoSubキーワードの合計数です。それぞれVB.NETはGoToキーワードをサポートし、VB Migration PartnerはシミュレートされたGoSubs、そして計算されたGoTo/GoSubをコード生成します。しかしながら、それらを除去するためにオリジナルのVB6コードを編集することを強く推奨します。

• • On Errors and Resumes are the number of On Error statements and of Resume/Resume Next statements. VB.NET supports them, but you should replace them with more structured and efficient Try…Catch blocks.

• • On Errors and ResumesはOn Errorステートメント、Resume/Resume Nextステートメントの数です。VB.NETはそれらをサポートします。しかし、より構造的かつ効果的にTry･･･Catchブロックに置き換えて下さい。

• • File Operations is the number of Open, Get#, Put#, and other file-related statements. These keywords don’t behave in exactly the same way in VB6 and VB.NET and VB Migration Partner doesn’t automatically account for all these differences, therefore you might need to carefully test each of them.

• • File OperationsはOpen、Get#、Put#、その他ファイル関連ステートメントの数です。これらのキーワードは、VB6とVB.NETではまったく同じ動作をするとは限りません。VB Migration Partnerはこれらの違いを自動的に把握するわけではないので、注意深くテストを十分に行う必要があります。

• • Exit Points is the number of Exit Sub, Exit Function, and Exit Property keywords. This value is included in the code metrics report because many developers prefer to have a single exit point for each method.

• • Exit PointsはExit Sub、Exit Function、Exit Propertyキーワードの数です。ほとんどの開発者はそれぞれのメソッドにひとつのExitがあることを好むために、この値をコード分析レポートに含めました。

• • Cyclomatic Index is the number of all possible code execution paths in a method and is therefore equal to the number of tests that should be performed to prove that the method behaves correctly in all situations. When evaluated at the file, project, or solution level it returns the sum of cyclomatic index of all contained methods and therefore can be assumed as a broad measure of the overall complexity of that file, project, or solution.

• • Cyclomatic Indexはメソッド内のすべてのコードが実行されるパスの数です。この数はすべての状況下でメソッドが正確に動作することを証明するために実行すべきテストの数とイコールになります。File、Project、Solutionレベルを評価するときに、すべての含まれたメソッドのサイクロマティック指数の合計を返します。したがって、File、Project、Solutionの広範な複雑性の測定として想定することができます。

• • Nesting Level is the maximum nesting level of blocks inside a method. For example, a method that contains a For loop that contains an If block has a nesting level equal to 2. When evaluated at the file, project, or solution level it returns the sum of nesting level of all contained methods.

• • Nesting Levelはメソッド内部のブロックのネストしているレベルの最大値です。たとえば、For Loopを含んだメソッドが含んでいるブロックをネストレベル２に相当します。File、Project、Solutionレベルを評価するときに、すべての含まれたメソッドのネストしているレベルの合計を返します。

• • If Directives is the number of #If, #ElseIf, and #Else keywords. VB Migration Partner is capable to evaluate #If conditions and converts only the portion of code that is contained in the “true” portion of the #If block. All other sections must be converted manually, therefore it is a good idea to revise the original VB6 application and ensure that #If and #Const expressions exactly define the code that you want to convert.

2.7 Using assessment features／評価機能を使用

If the VB6 project has been already converted, VB Migration Partner can generate an assessment report and export it Microsoft Excel. The report contains detailed information about each project in the original application, including code metrics, number of migration issues and warnings, and an estimation of time (and money) required to complete the conversion process.

もしVB6プロジェクトが既に変換されているのであれば、VB Migration Partnerは評価レポートを生成し、Microsoft Excelにてエクスポートすることもできます。そのレポートはオリジナルアプリケーションのそれぞれのProjectについて詳細な情報を含みます。ほかにコード分析、移行の警告と問題の数、変換プロセスを完成させるに必要な見積時間（費用）などもレポートに含まれます。

Run the assessment feature by selecting the Tools-Generate Assessment Report menu command or by clicking on the Assessment toolbar button.

「Tools　メニュー　Generate Assessment Report」を実行するか、ツールバーの「Generate the assessment report」ボタンをクリックして評価機能を起動してください。

VB Migration Partner lets you select the name of the target Microsoft Excel file and then creates the assessment report. This step can take several seconds, or even minutes, for long and complex VB6 applications. At the end of the process a message box allows you to load the generated report inside Microsoft Excel.

VB Migration PartnerはMicrosoft Excelファイル名を指定し、評価レポートを生成します。この手順には長くて複雑なVB6アプリケーションでは数秒もしくは数分かかります。プロセスの最後に生成されたレポートをMicrosoft Excelに読み込ませるかどうかのメッセージボックスを表示します。

The first worksheet generated Microsoft Excel file provides a summary of estimated costs for the entire application. If the VB6 application contains two or more project, a separate worksheet is generated for each project.

生成されたMicrosoft Excelの最初のワークシートは、アプリケーション全体の費用見積合計を提供します。もしVB6アプリケーションが２つもしくはそれ以上のProjectを含んでいる場合は、ワークシートを分割し、それぞれのProject毎に生成します。

The “Config – Resources” worksheet allows you to define five different developer roles and assign a different hourly cost to each of them. The predefined roles are Project Manager, Architect, Junior Developer, Senior Developer, and Senior Tester, but you can change their name and cost as you see fit. (You can also add more roles, if you are an expert Microsoft Excel user.)

「Config – Resources」ワークシートは５つの異なった開発者の役割を定義し、それぞれに１時間あたりの費用を割り当てます。その所定の役割とは、プロジェクトマネージャー、設計者、中級レベル開発者、上級レベル開発者、上級レベルテスターです。それらの名前やコストは変更することができます。（Microsoft Excel エキスパートユーザであれば他の役割を追加することもできます。）

The “Config – Migration Warnings” worksheet is where you configure how many minutes it takes for each developer role to fix a given issue or warning message. Each message is identified by an obscure hexadecimal ID, but you can read its description in the rightmost column.

「Config – Migration Warnings」ワークシートはそれぞれの開発者役割が与えられた問題や警告メッセージを修正するのにどれくらいの時間（分）がかかるかを設定します。それぞれのメッセージは16進数の表記によるIDで識別されますが、右端の列の説明を読むことができます。

Finally, in the “Config – Code Tasks” you configure the duration (in minutes) for tasks that aren’t related to specific migration error and warning messages – for example, the time required to check 100 lines of code to ensure that they have been migrated correctly.

最後の「Config – Code Tasks」ワークシートは仕様的な移行の問題や、警告メッセージに関連しないタスクにかかる時間（分）を設定します。たとえば、正しく移行されたのを保証するために100行のコードをチェックするのに要求される時間。

After configuring a report according to your preferences, you should save it to a different Microsoft Excel file, so that you can reuse it as a template for subsequent assessments – either for the same or a different VB6 project. You select which template should be used in the Assessment Report tab of the Tools-Options dialog box.

好みに応じたレポートの設定の後で、異なったMicrosoft Excelファイルを保存してください。同じProjectや別のVB6Projectの次回の評価のためのテンプレートとして再利用することができます。「Tools メニュー Options」のダイアログのReportsタブでどのテンプレートをデフォルトで使うかを指定することができます。

2.8 Customizing the code window／コードWindowのカスタマイズ