LANSA Webは、指定されたHTTPヘッダー変数の値をブラウザから取得し、その値を関数パラメータ (FUNCPARMS) としてWebアプリケーションに渡すことができます。
HTTPヘッダー変数のサポートは、LANSA Webアドミニストレータを使って、システムごとに有効にできます。取得するHTTPヘッダー変数についても、LANSA Web アドミニストレータで指定します。詳細は「HTTPヘッダー変数」を参照してください。指定したヘッダー変数およびそれぞれのデフォルト値は、構成ファイル webplugin.conf に格納されます。
URLの一部として使用される関数パラメータは、HTTPヘッダー変数の値の受け渡しに使用される関数パラメータより優先順位が高くなります。
要求のURLごとにWebアプリケーションに渡すことができる関数パラメータは、最大20件です。
HTTPヘッダー変数の動作
- 構成ファイル (
webplugin.conf) は、LANSA Webサーバー拡張機能またはJavaサーブレットが最初に開始された時にロードされます。このロード時に、HTTPヘッダー変数の値は、ホストLANSAシステムに送信されます。 Javaサーブレットを使用している場合、LANSAWebResetの後にJavaサーブレットが最初に呼び出される際に構成が再ロードされます。 - 指定されたHTTPヘッダー変数が存在しない場合は、ホストLANSAシステムに追加の情報は送信されません。
- 関連システムに指定されたHTTPヘッダー変数がある場合、ブラウザーにより要求される各URLに対して、IISプラグインまたはJavaサーブレットは、指定されたHTTPヘッダー変数を取得し、それらをFUNCPARMSとしてホストLANSAシステムに送信します。
- URLにすでに別のFUNCPARMSが含まれている場合、HTTPヘッダー変数の関連FUNCPARMSは、リストの末尾に追加されます。
- 指定のHTTPヘッダー変数値を取得できない場合、代わりに変数に指定されたデフォルト値が送信されます。
HTTPヘッダー変数が送信されたことの確認
HTTPヘッダー変数が送信されたことを確認するために、ユーザー・エージェント・ヘッダー変数を使用してテストします。HTTPヘッダー変数フィールドには、使用されたエージェントが反映されているはずです。そうでない場合は、このフィールドにデフォルト値が入ります。
ヒントとテクニック
- funcpar で指定された長さよりも長いヘッダー変数の値は切り捨てられます。
- ヘッダー変数値が取得できない場合、デフォルト値が送信されます。
- HTTPに続く番号は、1～20の範囲内でなければなりません (この範囲外の番号を持つ定義は処理されません）。
- HTTPヘッダー変数の値は大文字で受け取られます。
- デフォルト値を指定する必要があります (区切り文字の間に少なくとも1つのスペースを入力する必要があります)。
- ファンクションを*ALLに設定する必要があります (将来のリリースでこれを使用する可能性があります) 。