簡単インストール方法

トップ | サンプル | AJAX Control Extender 対応 | 仕様 | ダウンロード | インストール | ライセンス | 購入

　

１．サーバー側設定

ASP.NET 1.1または2.0が動作するウェブサーバーへファイルを配置します。

検索エンジンファイルの配置

ASP.NETが動作可能な任意のディレクトリに以下のファイルをすべて同じディレクトリに配置します。以下のファイルはASP.NET 1.1/2.0兼用です。

ファイル名 内容 必須
YZipCode.asmx 郵便番号検索のためのWebService（SOAP)プログラム ●
YZipCode.ashx 郵便番号検索ダイアログウィンドウプログラム
※別ウィンドウ表示を使用しない場合不要。		 △
YZipCodeJS.aspx 郵便番号検索用JavaScriptライブラリ(.jsファイル）
※Microsoft AJAX Control Extender使用時には不要です。		 △
PostCodeData.xml XML形式の郵便番号データ（郵政公社配布の全国と事業所のデータを含む）
※App_Dataディレクトリに配置しても可。		 ●
YZipCodeProxy.aspx クロスサブドメイン使用時に必須（ページと異なるサーバーに配置される場合） △
CheckInstall.aspx 動作確認用ASPXページ。（運用時には不要） -

bin ディレクトリへDLLファイルの配置

以下のファイルをASP.NETの実行ファイル用ディレクトリへ配置します。実行ファイルディレクトリは通常IISでウェブアプリケーションディレクトリとして設定したディレクトリ上の /bin という名前のディレクトリになります。DLLは ASP.NET1.1と2.0で別になります。両バージョンのDLLを同じ bin ディレクトリに置いてはいけません。必ず環境のASP.NETバージョンに適合した1ファイルだけを設置します。

ファイル名 内容
Yokins.YZipCode.dll .NET 1.1/2.0 用コンパイル済み検索エンジン。
※配布パッケージでは .NET2.0用は bin.NET.2.0 サブディレクトリに入っています。
Yokins.Web.ZipCode.Extensions.dll Microsoft AJAX Extension対応モジュール。
※パッケージによって、.NET2.0対応のものと .NET3.5対応の2種類があります。

動作確認

ウェブブラウザから CheckInstall.aspxページを開きます。このページ上のフォームへ適当な候補文字列を入力して動作を確認してOKならサーバー側の設定は完了です。

２．フォームHTMLページへの設定

１つの郵便番号欄、１つの住所欄のシンプルなHTMLフォームへの組み込みは先の動作確認ページに表示されているJavaScriptをフォームのIDに注意しながら組み込むことで完了しますが、サンプルページにあるようないろんなフォームに対応するためにはJavaScriptの内容を若干修正する必要があります。

JavaScriptの記述方法については仕様ページを参照してください。

その他の形式のフォームに対する具体的な組み込み方法はサンプルページを参照してください。

なお、Internet Explorerではフォームのテキストボックスでブラウザ自身の自動補完機能が動作します。この自動補完機能と、郵便番号の自動補完機能が競合することをさけるために INPUT タグで  autocomplete="off" 属性をつけて回避します。

<input type="text" name="YUBIN" id="YUBIN" autocomplete="off">

３．コンテンツとは別のサーバーへのインストール

コンテンツ（郵便番号検索をインストールしたいHTMLフォーム）がLinuxサーバーやApacheサーバーなどである場合、ASP.NETをサポートする別のサーバーにインストールして問題を解決することができます。ただし、コンテンツサーバーとことなるサーバーに検索用サーバーを設定した場合、ウェブブラウザ自身のセキュリティ制限「クロスドメイン」に関するいくつかの制約が発生します。本来、JavaScriptが複数のサーバー（ドメイン、ホスト名）に渡って実行されるのを防ぐためのセキュリティ機能です。

別サーバー対応のためにHTMLフォームに特別な処理は必要ありませんが YZipCodeJS.aspx ファイルの参照をURLをフルに記述します。

例）
<script language="javascript" src="http://www2.sample.com/YZipCode/YZipCodeJS.aspx"></script>

※クロスドメインのセキュリティ問題が発生した場合は、ブラウザがJavaScriptエラーを出しますので、その環境では動作できないことになります。