目次：

インストール サンプルのインストール クライアントの準備 ローカルでのテスト環境作成について 外字データの準備 アプレットを利用したページの作成について 設定アプレットのパラメタ 表示アプレットのパラメタ 入力アプレットのパラメタ 一覧表示アプレットのパラメタ

インストール

下記の構成でＷＥＢサーバへファイルをアップロードします。
下記のファイルが、システムの最小構成になります。

「nph-cgij2.cgi」は、ＪＡＶＡアプレットと通信するためのＣＧＩです。
「eudcApl_v102.jar」は、ＪＡＶＡアプレット群で、ブラウザのページは、このアーカイブのアプレットを利用して外字データをページへ入出力します。

サンプルのインストール

パッケージにはサンプルが同梱します。
これらを実際に試す場合は、下記の構成でサーバにアップロードします。

「sample」パスにあるサンプルは、本パッケージを利用した「外字を利用できる住所録」です。
「test_page」パスにあるサンプルは、アプレット単機能のサンプルです。
これらプログラムは、ここ（←）に実際に導入してあるので、サーバー設置前に動作を確認することができます。
cgi／html で、ファイル名の最後に「_a」が付くサンプルは<APPLET>タグを利用したサンプル（IE/NN/Fierfox用）で、「_a」が付加しないサンプルは<OBJECT>タグを利用したサンプルになります。

注意：
上記サンプルは、サーバへアップロードする前に、それぞれのファイルで設定アプレットのパラメタを変更する必要があります。
すべてのcgi／html ファイルの、設定用アプレットの「URL」パラメタに、サーバにアップロードした
「nph-cgij2.cgi」の位置をフルパスで指定して下さい。
規定値は、ローカルのテスト環境で動かす場合の設定になっています。

クライアントの準備

クライアントのブラウザでＪＡＶＡアプレットを利用するため、Ｊ２ＳＥのランタイムが必要です。
Ｊ２ＳＥのランタイムをあらかじめダウンロードしインストールしておいてください。
ブラウザがIEで、<OBJECT>タグを利用してページを作成した場合、Ｊ２ＳＥが未インストールだと動的にダウンロードメッセージ表示されます。
（Ｊ２ＳＥは、Java Plug-in 1.5.0_06 のバージョンを利用）

ローカルでのテスト環境作成について

「ANHTTPD」と「ActivePerl」を利用して、１台のＰＣでテスト出来る環境を構築できます。
（動作は、ANHTTPD v1.42m　ActivePerl v5.8.4　のバージョンで確認）
これらプログラムの導入については、それぞれのドキュメント等を参照して下さい。

注意：
「ANHTTPD」を利用した場合、設定アプレットパラメタの「URL」パラメタにフルパスの記述ができません。
相対パスで「/cgi-bin/eudc/nph-cgij2.cgi」のように指定して下さい。
パッケージのサンプルの規定値は、この設定になっています。

外字データの準備

本システムでは、外字データ「EUDC.EUF」と、外字の読みデータ「EUDC.YMI」を利用します。
外字は、ＵＮＩＣＯＤＥを利用するので、6400文字まで利用できます。

「EUDC.EUF」をそのまま利用します。
「EUDC.EUF」は、Windows標準の外字エディタ（eudcedit.exe）を利用して外字を作成すると「EUDC.TTE」ファイルとペアで自動的に作成されます。
通常これらのファイルは、Windowsのシステムフォルダの「\fonts」の中に作成されます。
エクスプローラでは、システムフォルダの「\fonts」の外字ファイルをみることができません。
プロンプトから copy コマンドで（例：copy c:\windows\fonts\eudc.* c:\temp）取り出して下さい。

「EUDC.YMI」をそのまま利用します。
「EUDC.YMI」は「外字ザウルス」もしくは「EudcBrowser」で作成することができます。
「外字ザウルス」は外字サーバで外字作成をすると、インストールフォルダの「SHARE_FOLDER」フォルダ内に同ファイルを作成します。
「EudcBrowser」は、読みの管理を行うと指定した場合に、対象としている外字ファイルと同じフォルダ内に同ファイルを作成します。
詳細は、それぞれのパッケージのマニュアルを参照して下さい。

注意：
外字データのファイル名は、必ず「EUDC.EUF」「EUDC.YMI」として下さい。
すべて大文字のファイル名です。

アプレットを利用したページの作成について

ＨＴＭＬやＣＧＩを記述するときに、かならずＵＴＦ－８にて記述して下さい。
内部で扱うデータがＵＮＩＣＯＤＥなので、Ｓ－ＪＩＳやＥＵＣ等でページを記述すると正常に動きません。

ＣＧＩは、ＰｅｒｌでもＰＨＰでも、特に言語はなんでも構いませんが、ＵＴＦ－８のデータ入出力が出来る言語（バージョン）でなくてはなりません。

設定アプレットのパラメタ

ページには必ず１つだけ、このアプレットを記述する必要があります。
各アプレットは、この設定アプレットのパラメタを取得して稼働します。
記述は、ページ中の何処にあっても構いませんが、通常は見えないように「WIDTH=0 HEIGHT=0」のサイズで記述します。
（<OBJECT>タグを利用した記述は、各サンプルを参照して下さい）

「ARCHIVE=」は、このページのサーバ上のパスから、「eudcApl_v102.jar」の場所までの相対パスを指定します。
「URL」アプレットパラメタに、アプレット通信用ＣＧＩ「nph-cgij2.cgi」のURLをフルパスで指定します。
「PORT」アプレットパラメタに、HTTP通信のポート番号（通常は80）を指定します。

表示アプレットのパラメタ

外字を含む文字列を表示するアプレットです。
このアプレットは、ページ中に複数配置することができます。
（<OBJECT>タグを利用した記述は、各サンプルを参照して下さい）

「ARCHIVE=」は、このページのサーバ上のパスから、「eudcApl_v102.jar」の場所までの相対パスを指定します。
「WIDTH= HEIGHT=」は、このアプレットのサイズを指定します。
「STL」アプレットパラメタに、表示文字のスタイルを記述します。
「STR」アプレットパラメタに、表示する文字列（ＵＮＩＣＯＤＥ）を指定します。この文字列には外字を含む文字列を指定できます。

入力アプレットのパラメタ

外字を含む文字列を入力するアプレットです。
このアプレットは、ページ中に複数配置することができます。
このアプレットは、FORMタグの中に記述し、ＣＧＩと連携します。
（<OBJECT>タグを利用した記述は、各サンプルを参照して下さい）

「ARCHIVE=」は、このページのサーバ上のパスから、「eudcApl_v102.jar」の場所までの相対パスを指定します。
「WIDTH= HEIGHT=」は、このアプレットのサイズを指定します。
「ANS」アプレットパラメタに、入力をフィードバックする FORM と INPUT の NAME値を指定します。
「STL」アプレットパラメタに、表示文字のスタイルを記述します。

FORMタグに記述した実際の、外字入力アプレットは下記のようになります。

非表示となっている INPUT （name=EudcText）フィールドに、アプレットで入力した外字を含む文字列がフィードバックされます。
また、同フィールドのVALUE値に外字を含む文字列（ＵＮＩＣＯＤＥ）を設定すると、その値を初期表示として表示します。

一覧表示アプレットのパラメタ

利用できる外字の一覧を表示するアプレットです。
コード一覧と、読み一覧を、別ウィンドウにて表示します。
ボタンで呼び出す方法と、リンクで表示する方法（Ｊａｖａｓｃｒｉｐｔと連携）があります。
（<OBJECT>タグを利用した記述は、各サンプルを参照して下さい）

「ARCHIVE=」は、このページのサーバ上のパスから、「eudcApl_v102.jar」の場所までの相対パスを指定します。
「WIDTH= HEIGHT=」は、このアプレットのサイズを指定します。
「MODE」アプレットパラメタに、"yomi"を指定すると読み一覧、"list"を指定するとコード一覧の表示になります。

リンクで呼び出す場合は、アプレットに NAME パラメタを付けて、下記のようにＪａｖａｓｃｒｉｐｔと連携します。
アプレットのサイズは「WIDTH=0 HEIGHT=0」にして下さい。