配布・ライセンス

下記のいずれかに配布します。配布方法の詳細については、「アプリケーションの配布」を参照してください。

アプリケーションと同じフォルダに配置する

単純なファイルコピーのみで使用が可能です。本体のコンポーネント以外に、サテライトアセンブリファイルを、本体コンポーネントを配布したフォルダに"\ja"というフォルダを作成して、その中に配置する必要があります。配布後に、アプリケーションの表示が英語になってしまう場合は、このサテライトアセンブリが正しく配布されているかどうかを確認してください。詳細については、「ランタイムファイルの配布について」を参照してください。

Windowsアプリケーションの場合、EXEファイルと同一のフォルダに配置します。
Webアプリケーションの場合、DLLファイルと同一のフォルダ（通常は仮想フォルダ内の\binフォルダ）に配置します。aspxファイルが配置されているフォルダではありませんので、ご注意ください。

Windowsアプリケーションの例

/Bin

     - WindowsApplication1.exe
     - GrapeCity.ActiveReports.dll
     - GrapeCity.ActiveReports.Document.dll
     - GrapeCity.ActiveReports.Viewer.Win.dll

      /ja
           - GrapeCity.ActiveReports.v12.resources.dll
           - GrapeCity.ActiveReports.Document.v12.resources.dll
           - GrapeCity.ActiveReports.Viewer.Win.v12.resources.dll

Webアプリケーションの例

WebForm1.aspx

.

省略

/Bin

       - WebApplication1.dll
       - GrapeCity.ActiveReports.dll
       - GrapeCity.ActiveReports.Document.dll
       - GrapeCity.ActiveReports.Viewer.Win.dll

        /ja
            - GrapeCity.ActiveReports.v12.resources.dll
            - GrapeCity.ActiveReports.Document.v12.resources.dll
            - GrapeCity.ActiveReports.Viewer.Win.v12.resources.dll

メモ: Flashビューワを使用する場合は、別途、SWFファイルを配布する必要があります。詳細については、「ランタイムファイルの配布について」を参照してください。

グローバルアセンブリキャッシュ（GAC）に登録する

Webアプリケーションの場合や、コンピュータ上の複数のアプリケーションで同じコンポーネントを使用する場合に、グローバルアセンブリキャッシュに格納します。Windowsアプリケーションで複数のアプリケーションから同じコンポーネントを使用しない場合は、格納する必要はありません。格納方法に関しては、Visual Studioのマニュアルを参照してください。

.NET Frameworkには厳密なアセンブリ識別機構が盛り込まれており、Visual Studioで作成した実行ファイルやアセンブリは、それらが使用するアセンブリを、名前とバージョンおよびその他の情報を使って判別します。この機構により、Visual Studioで作成した実行ファイルやアセンブリは、それらが依存するアセンブリと同名のアセンブリが存在していても、バージョンが一致しなければ動作しません。

たとえば、開発環境のActiveReportsをバージョンアップし、リビルドしたアプリケーション（EXEやDLL）を旧バージョンが動作していた実行環境に配布する場合、既存のアセンブリDLLファイルも新しいバージョンに入れ替える必要があります。

実行環境に配置されているActiveReportsのアセンブリDLLファイルが、旧バージョンのままである場合には、アプリケーションが使用するアセンブリが見つからないため、本エラーが発生します。適切なバージョンのアセンブリを実行環境に配布してください。

ライセンス認証が正しく設定されていない場合、次のようなライセンスエラーが発生します。

「XXXX（コントロール名）のライセンスが見つかりませんでした」エラーが発生する
「アプリケーションにライセンスが正しく付与されていません」エラーが発生する
例外（LicenseException）が発生する

この場合、次の要因が考えられます。

ライセンス認証をしていない

ActiveReportsをご使用になるには、インストール後にライセンス認証マネージャを実行し、ライセンス認証する必要があります。トライアル版としてご使用いただく場合も、トライアル版のプロダクトキーを入力してライセンス認証する必要があります。

ActiveReportsがライセンス認証されているかどうかは、ライセンス認証マネージャを実行することで確認できます。
Standardのライセンスで、Professionalの機能を利用している

Standardのライセンスで、Professionalでのみご利用できるコントロールを使用した場合、本エラーが発生します。この場合、プロジェクトからProfessionalのコントロールを削除してください。また、licenses.licxファイルからも、 Professionalのコントロールの記述を削除します。（licenses.licxファイルの記述方法は、以下の「プロジェクトにlicences.licxファイルが組み込まれていない」を参照してください。）

プロジェクトにlicences.licxファイルが組み込まれていない

設計時に、ActiveReports for .NETのコントロールをフォームに貼り付ける、または、ActiveReports for .NETのレポートレイアウトファイルをプロジェクトに追加することで、 licenses.licxファイルが自動的に作成され、必要なライセンスがプロジェクトに組み込まれます。しかし、実行時にコントロールを生成する場合は、licenses.licxファイルは作成されません。このような場合は、次のようにlicences.licxファイルを作成し、プロジェクトに追加してください。また、ファイルが存在していてもプロジェクトで利用しているコンポーネントに対応したライセンスの記述がない場合は、以下の3.の手順を実施してください。

ソリューションエクスプローラでプロジェクト名を右クリックし、［追加］-［新しい項目］を選択します。
表示されたダイアログボックスからテキストファイルを選択します。ファイル名を「licenses.licx」とし、[開く]をクリックします。

以下の文字列から該当するコンポーネントに関するものを選んで、licenses.licxに入力します。

licenses.licxに入力します。	コードのコピー
GrapeCity.ActiveReports.SectionReport, GrapeCity.ActiveReports.v12 GrapeCity.ActiveReports.Viewer.Win.Viewer, GrapeCity.ActiveReports.Viewer.Win.v12 GrapeCity.ActiveReports.Web.WebViewer, GrapeCity.ActiveReports.Web.v12 GrapeCity.ActiveReports.Design.Designer, GrapeCity.ActiveReports.Design.Win.v12 GrapeCity.ActiveReports.Export.Pdf.Section.PdfExport, GrapeCity.ActiveReports.Export.Pdf.v12

licenses.licxに入力します。

コードのコピー

GrapeCity.ActiveReports.SectionReport, GrapeCity.ActiveReports.v12
GrapeCity.ActiveReports.Viewer.Win.Viewer, GrapeCity.ActiveReports.Viewer.Win.v12
GrapeCity.ActiveReports.Web.WebViewer, GrapeCity.ActiveReports.Web.v12
GrapeCity.ActiveReports.Design.Designer, GrapeCity.ActiveReports.Design.Win.v12
GrapeCity.ActiveReports.Export.Pdf.Section.PdfExport, GrapeCity.ActiveReports.Export.Pdf.v12

licenses.licx内の文字列に対応する機能は以下の通りです。

license.licxの先頭文字列	対応する機能
GrapeCity.ActiveReports.SectionReport	ActiveReportsレポート
GrapeCity.ActiveReports.Viewer.Win.Viewer	Windowsフォーム用レポートビューワ
GrapeCity.ActiveReports.Web.WebViewer	WebViewerコントロール、HTTPハンドラ（Professionalのみ）
GrapeCity.ActiveReports.Design.Designer	エンドユーザーデザイナ（Professionalのみ）
GrapeCity.ActiveReports.Export.Pdf.Section.PdfExport	PDFエクスポートフィルタ

licences.licxファイルに必要なコンポーネントの記述が不足している

実行時にコントロールを作成する場合や、HTTPハンドラを使用する場合は、licences.licxファイルに手動でライセンスの記述を行う必要があります。（licenses.licxファイルの記述方法は、前述の「プロジェクトにlicences.licxファイルが組み込まれていない」を参照してください。）

licences.licxファイルの「ビルドアクション」プロパティが「埋め込まれたリソース」に設定されていない

アプリケーションに正しくライセンスを供与するには、licences.licxファイルの「ビルドアクション」プロパティを「埋め込まれたリソース」に設定する必要があります。（licenses.licxファイルの記述方法は、前述の「プロジェクトにlicences.licxファイルが組み込まれていない」を参照してください。）

App_Licenses.dllが存在しない

Visual StudioでWebサイトを作成し、ActiveReports for .NETを使用する際、設計時にコントロールをフォームに貼り付けると、 App_Licenses.dllが自動的に作成されます。しかし、実行時にコントロールを生成する場合はApp_Licenses.dllを手動で作成する必要があります。この場合、licenses.licxファイルの組み込み後、以下の手順に従いApp_Licenses.dllを作成してください。（licenses.licxファイルの記述方法は、前述の「プロジェクトにlicences.licxファイルが組み込まれていない」を参照してください。）

ソリューションエクスプローラにてlicenses.licxをクリックします
メニューから［ビルド］-［ランタイムライセンスのビルド］を選択します

ActiveReportsが使用されていないアセンブリから、ActiveReportsが使用されているアセンブリを呼び出している

ActiveReportsをクラスライブラリなどで使用し、他のアセンブリからクラスライブラリを通して再利用する（リフレクションによる動的な呼び出しを含む）場合、呼び出し元のプロジェクトにもActiveReportsのライセンスが必要です。この場合、コントロールを動的に作成した場合と同じように呼び出し元のプロジェクトのlicenses.licxファイルにライセンス情報を追加します。

たとえば、次のようにクラスライブラリでのみActiveReportsを使用している場合は、

ActiveReportsのライセンス情報は呼び出し元のプロジェクトに必要です。

なお、複数のプロジェクトを使用している場合は、最初に実行されるプロジェクト（アセンブリ）にライセンス情報が必要である点に注意してください。

正しくは次のようになります。

アプリケーションにライセンスを組み込む方法については、「アプリケーションのライセンスの組み込み」を参照してください。

プロジェクトをビルドすると、「"LC.exe" はコード -1 を伴って終了しました。」というエラーが発生します。この現象は、次の要因が考えられます。

licences.licxファイルに、使用していないコンポーネントの記述がある
licences.licxファイルに、プロジェクトでは使用していないコンポーネントの記述がある場合、この現象が発生します。例えば、プロジェクトでデザイナコンポーネントを使用していないのに、licenses.licx ファイルに「GrapeCity.ActiveReports.Design.Designer, GrapeCity.ActiveReports.Design.Win.v12」の記述がある場合が該当します。この場合、license.licxファイルから不要な記述を削除します。licenses.licxファイルの記述方法は、「アプリケーションのライセンスの組み込み」を参照してください。
licences.licxファイルに、旧バージョンの記述が残っている

licences.licxファイルに、ActiveReports for .NET 6.0J以前のライセンスの記述がある場合、この記述を削除してください。アプリケーションにライセンスを組み込む方法については、「アプリケーションのライセンスの組み込み」を参照してください。

クライアントアプリケーションを作成した場合、ActiveReports for .NETのレポートエンジンやビューワコントロール等は、作成したアプリケーションと共に自由に配布できます。

サーバーアプリケーションを作成した場合、ActiveReports for .NETのレポートエンジンやプレビューコントロールなどを配布するには、コアサーバーライセンスが必要です。必要となるライセンスの詳細は、製品の「ソフトウェア使用許諾契約書」をご確認ください。

PDFやExcelにエクスポートする場合、別途ライセンスやAdobe Acrobat、Microsoft Excel等は不要

PDFやExcelエクスポートを行う際に、Adobe AcrobatやMicrosoft Excelの製品やライセンスは必要ありません。ActiveReportsのコンポーネントのみで、レポートのPDFやExcelエクスポートが可能です。ActiveReportsでエクスポートしたこれらのファイルを表示したり印刷する場合に、Adobe ReaderやMicrosoft Excelが必要になります。

エンドユーザーデザイナ（独立したデザイナアプリケーション）コンポーネント - Professionalのみ

作成したデザイナアプリケーションを配布する際に、別途ライセンスやロイヤリティが必要になることはありません。