FAQ：アプリケーションビルドのライセンス取得とデプロイ

CData ADO.NET プロバイダーをアプリケーションのランタイムコンポーネントとしてライセンス取得し、配布する方法について説明します。

• Windows アプリケーションでプロバイダーをライセンス取得・配布するには？
• .NET Core/.NET Standard アプリケーションでプロバイダーをライセンス取得・配布するには？
• Web アプリでプロバイダーをライセンス取得・配布するには？
• Entity Framework アプリケーションでプロバイダーをライセンス取得・配布するには？
• ライセンスを移行するには？
• このエラーが発生する理由は？

.NET 3.5 または 4.0 を使用した Windows アプリケーションでプロバイダーをライセンス取得・配布するには？

CData ADO.NET プロバイダーは .NET ライセンススキームを使用しています。以下の手順に従って、ライセンスを埋め込みリソースとしてプロジェクトに追加してください。

1. Visual Studio でプロジェクトにライセンスファイル（Licenses.licx）を追加します。プロジェクトメニューの「既存項目の追加」をクリックして Licenses.licx を追加します。Licenses.licx は CData ADO.NET プロバイダーのインストールフォルダー内にあります。
2. アプリケーションをデプロイする際は、CData アセンブリを実行ファイルと同じディレクトリに配置してください。

ページトップへ

.NET Core/.NET Standard アプリケーションでプロバイダーをライセンス取得・配布するには？

.NET Standard プロバイダーを使用するには、事前にライセンスをアクティベートする必要があります。ライセンスをアクティベートするには、プロバイダーに付属している .NET Core アプリケーション install-license を使用します。

NuGet パッケージからプロバイダーをインストールした場合、このアプリケーションはパッケージのインストールディレクトリ内の tools フォルダーにあります。Windows では通常、パッケージは次の場所にあります：%USERPROFILE%\.nuget\packages\cdata.datasource

.NET Edition の一部としてライブラリがインストールされた場合、このアプリケーションはインストールディレクトリ内の lib/netstandard2.0 フォルダーにあります。

install-license アプリケーションを使用するには、次のコマンドを実行します：

dotnet ./install-license.dll key

key はプロダクトキーを指定します。これにより、該当するシステムにライセンスがインストールされます。

.NET Standard/.NET Core でのデプロイでは、CData プロバイダーの接続文字列に RuntimeKey（RTK）を指定する必要があります。RTK を取得するには、support@cdata.co.jp までメールでお問い合わせください。

ページトップへ

Web アプリでプロバイダーをライセンス取得・配布するには？

Web アプリは、App_Licenses.dll をコンパイルし、このアセンブリを実行ファイルおよび CData アセンブリと同じフォルダーにデプロイすることでライセンス取得できます。

1. アプリケーションにライセンスを適用するには、まず空のクラスプロジェクトを作成し、App_Licenses という名前を付けます。.NET Framework はメインプロジェクトと同じバージョンにしてください。
2. Licenses.licx ファイルをプロジェクトに追加します。Licenses.licx は CData ドライバーのインストールフォルダー（C:\Program Files\CData\CData ADO.NET Provider for ProviderName 20XX\lib）にあります。
3. プロジェクトをビルドして App_Licenses.dll を生成します。ビルド後、DLL はプロジェクトの debug フォルダー（App_Licenses\bin\Debug）に生成されます。
4. アプリケーションを配布するには、App_Licenses.dll をプロジェクトにコピーします。また、CData アセンブリと App_Licenses.dll を実行ファイルと同じフォルダー（Web アプリの場合は Bin フォルダーなど）にコピーする必要があります。

ページトップへ

Entity Framework アプリケーションでプロバイダーをライセンス取得・配布するには？

Entity Framework を使用するアプリケーション（MVC など）にライセンスを適用するには、以下の手順に従ってください。

1. 必要な CData アセンブリを実行ファイルと同じフォルダーにコピーします。CData ADO.NET プロバイダーのアセンブリは、インストールディレクトリの lib サブフォルダーにあります。.NET 4.0 の場合は、lib ディレクトリ内の 4.0 サブフォルダーにある DLL を使用してください。

   すべての CData ADO.NET プロバイダーは同じアセンブリを必要とします。以下は QuickBooks を例にしています：

   • System.Data.CData.QuickBooks.dll
   • System.Data.CData.QuickBooks.Entities.dll

     Entity Framework 6 を使用している場合は、System.Data.CData.Entities.EF6 を使用してください。

2. Machine.config からプロバイダーキーをアプリケーションまたはサイトの App.config または Web.config に追加します。Machine.config は、使用している .NET Framework バージョンの .NET Framework ディレクトリ内の Config フォルダーにあります。.NET 4.0 は C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config を使用し、.NET 2.0 は C:\Windows\Microsoft.NET\Framework\v2.0.50727\CONFIG を使用します。App.config または Web.config は、以下の QuickBooks の例のようになります：

   <system.data>
   <DbProviderFactories>
   ....
   <add name="CData ADO.NET Provider for QuickBooks".../>
   ....
   </DbProviderFactories>
   </system.data>

3. 製品にライセンスを適用するには、CData ADO.NET プロバイダーのインストールフォルダーにある Licenses.licx をビルドに追加します。Licenses.licx を右クリックし、「Build Runtime Licenses」を選択します。これにより App_Licenses.dll が生成されます。Windows Forms アプリケーションの場合、App_Licenses.dll は実行ファイルのビルド時に作成されます。

4. Windows Forms アプリケーションをデプロイするには、App_Licenses.dll と CData アセンブリの両方を実行ファイルと同じフォルダーに配置する必要があります。

   Web アプリをデプロイする場合は、CData アセンブリと App_Licenses.dll を bin フォルダーに配置する必要があります。Entity Framework を使用するアプリケーションには、CData アセンブリと CData Entities アセンブリの両方が必要です。プロバイダーがインストールされている lib フォルダーの 4.0 サブフォルダーにある .NET 4.0 アセンブリをコピーしてください。

ページトップへ

ライセンスを移行するには？

1. こちらで移行プロセスを完了してください：
   https://jp.cdata.com//lic/transfer/
2. マシンからプロバイダーを完全にアンインストールしてください。
3. ライセンスを移行したいマシンにプロバイダーをインストールしてください。両方のマシンの Node Id を取得する必要があります。Node Id ツールはこちらからダウンロードできます：
   https://jp.cdata.com//lic/nodeid.exe

ページトップへ

このエラーが発生する理由は？

• "Could not load file or assembly 'System.Data.CData.QuickBooks, Version=20.0.0.0, Culture=neutral, PublicKeyToken=f57f3fbecba6b076' or one of its dependencies. The system cannot find the file specified."

  このエラーは、System.Data.CData.QuickBooks.dll などの CData アセンブリがプロジェクトに参照として追加されていないことを意味します。アセンブリはプロバイダーをインストールした場所の Lib フォルダーにあります。

• "Could not load file or assembly 'System.Data.CData.SharePoint, Version=20.0.7450.0, Culture=neutral, PublicKeyToken=f57f3fbecba6b076' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference."

  このエラーは、Machine.config のエントリが使用しているアセンブリと一致していないことを示しています。このエラーを解決するには、使用している .NET Framework バージョンの Machine.config ファイル内のいくつかの設定を Web.config または App.config ファイルにコピーする必要があります。お使いのアプリケーションタイプに該当する手順を参照してください。