プロジェクト移行ツールは、ActiveReports for .NET 14.0Jで作成されたプロジェクトやWebサイトを、最新のService Packのバージョンに置き換えます。プロジェクト移行ツールはプロジェクトファイル、ライセンスファイル、リソースのアセンブリ参照情報、ソースコードファイルの名前空間の情報をそれぞれ書き換え、プロジェクトの移行を支援します。プロジェクト移行ツールによるプロジェクトの移行は完全ではなく、手動による変更を必要とする場合があります。また、不完全な動作によるデータの損失に備え、操作対象のファイルをすべてプロジェクト移行ツール以外の方法で予めバックアップしてください。

このドキュメントではプロジェクト移行ツールの使い方について説明しています。

動作環境

プロジェクト移行ツールを実行するには.NET Framework 4.6.2／4.7／4.7.1／4.7.2／4.8のいずれかが正しくインストールされている必要があります。
プロジェクト移行ツールは次の開発環境と言語で作成されたプロジェクトファイルをサポートします。

移行対象

プロジェクト移行ツールで移行対象となるファイルは、次のとおりです。

1. Windows／Webプロジェクト
   
   • プロジェクトファイル（*.vbprojファイル、*.csprojファイル）
   • プロジェクト・ユーザー・オプション・ファイル（*.vbproj.userファイル、*.csproj.userファイル）
   • Web.Configファイル
   • WebViewerコントロールを使用している*.aspxファイル
   • licenses.licxファイル
   • packages.configファイル
   • package.jsonファイル
2. ASP.NET Webサイト
   
   • Web.Configファイル
   • WebViewerコントロールを使用している*.aspxファイル
   • licenses.licxファイル
   • packages.configファイル
   • package.jsonファイル

変更箇所の詳細

プロジェクト移行ツールは、移行対象ファイルに対して次の変更を行います。

作業手順

1. スタートメニューから［ActiveReports for .NET 14.0J 移行ツール］を選択します。もしくは、製品をインストールしたフォルダ内のTools\Migration\フォルダからAR14MigrationTool.exeを起動します。
2. ［移行の対象］で、移行するプロジェクト、もしくはプロジェクトが含まれるフォルダを指定します。
3. プロジェクトのバックアップを作成する場合、［オプション］の［バックアップを作成する］をチェックします。プロジェクトが存在するフォルダ内にBAKフォルダが生成され、その中に移行前のファイルがバックアップされます。
4. サブフォルダ内にあるファイルも移行する場合、［オプション］の［サブフォルダを含める］をチェックします。
5. ［実行］ボタンをクリックします。プロジェクトの移行が成功すると「移行が終了しました。」というメッセージが表示されます。
   ※ 移行後は、プロジェクトファイルと同じフォルダにログファイルが作成されます。
6. 移行したプロジェクトをVisual Studio上で開き、[ビルド]メニューから[ソリューションのリビルド]を実行して、ソリューション全体をリビルドしてください。

制限事項と注意点

• プロジェクト移行ツールでプロジェクトを移行する場合、プロジェクトファイルを基準に処理を行います。そのためプロジェクトファイルがない場合は、処理することができません。この場合、ダミーのプロジェクトファイル(拡張子が.csprojまたは.vbproj)を移行対象のファイルと同じフォルダに作成することで、プロジェクト移行ツールにより作業ができるようになります。
• 移行対象となるファイルが指定したフォルダのサブディレクトリに保存されている場合は、［オプション］で［サブフォルダを含める］をチェックして実行することですべてのファイルを移行することができます。
• 書き換えの際、Web.ConfigはUTF-8エンコーディングで出力されます。その他のファイルは、書き換え前のファイルのエンコーディングで出力されます。
• 何らかの原因で移行ツールが正しく動作しない場合は、テキストエディタやVisual Studioなどを使用し、上記の「変更箇所の詳細」を参照の上、手動で変更してください。