辞書ファイルの配布について

JPAddressを使用したアプリケーションでは、ランタイムファイルの他に辞書ファイルが必要です。そのため、JPAddressを使用したアプリケーションを配布する場合、辞書ファイルをアプリケーションやランタイムファイルと共に配布する必要があります。

辞書ファイル

JPAddressの辞書ファイルは、 [%インストールフォルダ%]\Dataフォルダにインストールされるzip形式の圧縮ファイル(JPAddressDB.zip)に含まれています。辞書ファイルを直接配布する場合は、このファイルを解凍してご利用ください。開発したアプリケーションをインストーラやClickOnceで配布する場合は、ブートストラッパを利用することも可能です。ブートストラッパを利用する場合は、これらの辞書ファイルが既定のフォルダに自動的に配布されます。圧縮ファイル内の辞書ファイルを配布する必要はありません。
既定のフォルダについての説明や必要な辞書ファイルについては、「辞書ファイルについて」をご確認ください。

Windowsフォーム／WPFアプリケーションの辞書ファイルの配置フォルダ

WindowsフォームやWPFのようなデスクトップアプリケーションの場合、辞書ファイルは以下のいずれかのフォルダに配置します。

既定のフォルダに配置する
アプリケーションのEXEと同じフォルダに配置する
任意のフォルダをアプリケーション構成ファイルに指定して配置する

Webアプリケーションの辞書ファイルの配置フォルダ

Web アプリケーションの場合は、辞書ファイルをBinフォルダ以下に配置しない場合に限り、辞書ファイルを任意のフォルダに配置してそのパスをWeb.configファイルに記載します。また、自動更新機能を利用する場合はIISで辞書ファイルの配置フォルダに対してアクセス権限の設定が必要です。辞書ファイルは自動更新機能で最新のファイルに更新されますので、書き込みの権限を与える必要があります。

辞書ファイルの配布方法

辞書ファイルの配布方法にはいくつかのシナリオが考えられます。
次のフローチャートは、アプリケーションの配布形態に応じた辞書ファイルの配布シナリオを表しています。辞書ファイルの更新の方法、または辞書ファイルの配置場所の違いに応じて辞書ファイルの適切な配布方法が異なります。

（図）辞書ファイルの配布シナリオ

以下では、各配布シナリオについて解説します。

自動更新機能により辞書ファイルを配布（配布シナリオ１）

Updateメソッドによる最新の辞書ファイルへの自動更新機能を使用する場合、アプリケーションと共に辞書ファイルを配布する必要はありません。アプリケーションの実行環境に辞書ファイルが存在しない場合は、自動更新機能により最新の辞書ファイルが指定のフォルダにダウンロードされます。

辞書ファイルを手動で更新する場合（配布シナリオ２）

辞書ファイルを手動で更新するケースでは、アプリケーションの配布と共に辞書ファイルを実行環境に配布する必要があります。または、辞書ファイルを実行環境ではなくネットワーク上の共有のフォルダで共有するような場合では、共有先のフォルダに辞書ファイルを配置する必要があります。
アプリケーションの実行環境に辞書ファイルを配置しない場合など、既定のフォルダ（[%CommonApplicationData%]\GrapeCity\JPAddress）以外に配置する場合は、辞書ファイルのブートストラッパーによる配布は利用できません。また、この場合、アプリケーション構成ファイル(App.config)に辞書ファイルの配置位置を設定する必要があります。

辞書ファイルを既定のフォルダに配置する場合（配布シナリオ３）

辞書ファイルをアプリケーションと共に配布する場合には、製品に付属するWindowsインストーラブートストラッパを使用する方法と直接コピーする方法の2種類があります。
辞書ファイルをJPAddressの辞書ファイルの既定フォルダ（[%CommonApplicationData%]\GrapeCity\JPAddress）に配置する場合は、ブートストラッパを使用して辞書ファイルを配布する方法を推奨します。
ブートストラッパ（bootstrapper）とは、アプリケーションのインストールの前にそのアプリケーションの実行に必要なランタイムファイルをインストールするインストーラの総称です。JPAddressがインストールされた開発環境には、JPAddress専用のランタイムブートストラッパと辞書ファイル用のブートストラッパが用意されており、セットアッププロジェクトまたはClickOnceへ簡単に組み込むことが可能です。
セットアッププロジェクトまたはClickOnceに辞書ファイルのブートストラッパを組み込むには、「ランタイムファイルの配布方法」の手順に従います。

辞書ファイルを既定のフォルダ以外に配置する場合（配布シナリオ４）

辞書ファイルをアプリケーションと共に配布する場合で、かつ既定のフォルダ（[%CommonApplicationData%]\GrapeCity\JPAddress）以外の位置に配置する場合は、アプリケーションの配布と共に辞書ファイルの配布も必要になります。もしくは、ネットワーク上の共有のフォルダで辞書ファイルを共有するような場合では、共有先のフォルダに辞書ファイルを配置する必要があります。
この場合、ブートストラッパによる配布は利用できません。また、アプリケーション構成ファイル(App.config)に辞書ファイルの配置位置を設定する必要があります。

ASP.NET用のSP6以降をご利用の場合、既定フォルダは[%CommonApplicationData%]\MESCIUS\JPAddressフォルダになります。

辞書ファイルの配布に関する注意

製品のインストールによって開発環境にコピーされる辞書ファイルは再配布可能なファイルです。この辞書ファイルは、JPAddressを使用して開発されたアプリケーションと共に配布される場合に限って数量の制限なく配布できます。

製品に含まれる辞書ファイルは製品の発売時点のものです。
JPAddress 辞書更新のテスト利用により取得した辞書ファイルを、運用環境に再配布してご利用いただくことも可能です。