GrapeCity ActiveReports for .NET 14.0J
プロジェクト移行ツール
ActiveReportsユーザーガイド > レポートのアップグレード > 旧バージョンからの移行 > プロジェクト移行ツール

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

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

旧バージョン(ActiveReports for .NET 1.0J、2.0J、3.0J、6.0J、7.0J、9.0J、11.0J、12.0J)で作成されたプロジェクトを14.0Jへ移行する場合は、プロジェクト移行ツールではなくActiveReportsファイルコンバータを使用します。

動作環境

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

開発環境

言語

Visual Studio 2013 Visual Basic
Visual C#
Visual Studio 2015 Visual Basic
Visual C#
Visual Studio 2017 Visual Basic
Visual C#
Visual Studio 2019 Visual Basic
Visual C#

移行対象

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

  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ファイル

変更箇所の詳細

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

移行対象ファイル

移行内容

プロジェクトファイル(*.vbprojファイル、*.csprojファイル) ActiveReportsのアセンブリバージョン情報を、最新のバージョン情報に変更します。
プロジェクト・ユーザー・オプション・ファイル(*.vbproj.userファイル、*.csproj.userファイル) ファイルを削除します。
Web.Configファイル、WebViewerコントロールを使用している*.aspxファイル ActiveReportsのアセンブリバージョン情報を、最新のバージョン情報に変更します。
licenses.licxファイル ActiveReportsのアセンブリバージョン情報が含まれている場合は、最新のバージョン情報に変更します。
※ バージョン情報が含まれていない場合は変更しません。また、バージョン情報が含まれていなくても特に問題はありません。
packages.configファイルおよびpackage.jsonファイル ActiveReportsのアセンブリバージョン情報が含まれている場合は、最新のバージョン情報に変更します。

作業手順

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

制限事項と注意点