郵便番号を入力した後、「住所の同期」ボタンをクリックします。すると、住所情報が補完されます。(図1,図2)
文字列型項目の型詳細設定で「郵便番号」を選択します。このときOKボタンは押すことができません。(図3)
郵便番号に対応する項目を指定します。(図4)指定後、OKボタンを押下します。
「郵便番号」型の項目に検索条件を指定した場合、対応する住所項目も合わせて検索条件に指定する必要があります。
郵便番号を途中まで入力して「住所の同期」ボタンをクリックすることもできます。郵便番号と住所の候補についての選択肢が表示されます。
図3では、先頭5桁を入力したところです。
「住所の同期」ボタンを押下すると、リストボックスに候補が出力されます。
候補から一つを選択し、再び「住所の同期」ボタンを押下することで、郵便番号と住所を確定させます。(図5,図6)
特別な定義はありません。標準で候補出力機能が動作します。
郵便番号は文字列型の一種であるため、標準では「文字列(一般)」フィルタが選択されます。
このフィルタは数値を半角文字に変換しますが、"ー"(全角ハイフン)は全角のままとなります。[詳細...]
そこで郵便番号の場合、フィルタを「文字列(一般)」から「全角→半角」を選択しなおすことを推奨します。 この変更によってハイフンを半角に統一することができるようになります。
Wagby には株式会社アイビスが提供する「zipcloud」と、日本郵政公社が提供する郵便番号データ(事業所別郵便番号)をベースに生成された郵便番号辞書ファイルが同梱されています。
日本郵政公社が提供する郵便番号には、イレギュラーなデータが含まれています。具体的には、プログラムで解釈不可能な、特別表記です。(例:"以下に記載のない住所は xxx とする" など)
株式会社アイビスの「zipcloud」では、このようなイレギュラーデータを可能な限り排除した形で加工されたものを提供しています。(しかし、すべての郵便番号の変換を保証するものではない、ということを予めご了承ください。)
Wagby のバージョン毎に、どの時点の郵便番号データが含まれているかについては、Wagbyの更新情報に記載しています。
郵便番号辞書の本体は WEB-INF/jmaster フォルダにある zipcode.dat というバイナリファイルです。
株式会社アイビス様が提供する郵便番号データと、日本郵政公社が提供する事業所の個別郵便番号データを用いて、zipcode.dat を作成する方法を説明します。
java -cp lib/j_util.jar;lib/commons-lang.jar jp.jasminesoft.util.address.GenerateMasterData
次のように出力されます。
C:\Wagby-7.x.x\wagbyapp\webapps\wagby\WEB-INF>java -cp lib/j_util.jar;lib/commons-lang.jar jp.jasminesoft.util.address.GenerateMasterData Generate Master Data Program. compaction=true Reading postal file...done. Creating zip file...done.
model/modelitem/@typeの値は "郵便番号" となります。
住所項目IDを格納するリポジトリキーはmodel/modelitem/zipcodeinfo/@addressfieldです。