OutboundNameValueハンドラーは、HTTPプロトコルを使用してリモート・サーバーに名前の値ペアをポストできます。
詳細については、「5.2.6 Webブラウザー・コンテンツ」を参照してください。
このコンテンツ・ハンドラーのSENDコマンドが実行されると、以下のステップが行われます。
- オプションの作業リストを使用できる場合、名前の値ペア・データが作成されます。この作業リストには、名前とサイズの少なくとも2つのフィールドが必要です。ここで重要なのは、最初のフィールドに名前を指定し、2番目のフィールドに値を指定する点です。名前と値はURLでエンコードされます。
- 作業リストが使用できない場合は、長さゼロのコンテンツが作成されます。
- METHODキーワードがGETの場合、HTTP GETプロトコルを使用してリモート・ホストにアクセスできます。名前の値ペアのコンテンツが存在する場合は、URLの最後に追加され、URLとこのデータは「?」で区切られます。
- METHODキーワードがPOSTの場合、HTTP POSTプロトコルを使用してリモート・ホストにアクセスします。名前の値ペアのコンテンツが存在する場合、これはコンテンツとして含まれます。
構文：
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
SEND | HANDLER | OutboundNameValue | |
URI | 値 | 必須。リモートURI | |
HOST | 値 | 必須。リモート・サーバー | |
SNISERVER | 値 | 任意。TLS ハンドシェイクが使用するSNIホスト名です。指定の値、またはHOSTキーワード値に*HOSTを使用します。 LANSA Integrator では Java 仮想マシン (JVM) が Java バージョン 1.8 またはそれ以上のバージョンである場合にのみ、SNIがサポートされます。 | |
USER | 値 | 任意。基本認証ユーザー | |
PASSWORD | 値 | 任意。基本認証パスワード | |
PROXY | 値 | 任意。プロキシー・サーバー | |
PROXYUSER | 値 | 任意。基本認証ユーザー | |
PROXYPASSWORD | 値 | 任意。基本認証パスワード | |
METHOD | 任意。詳細は、「METHOD」を参照してください。 | ||
VERSION | 任意。詳細は、「VERSION」を参照してください。 | ||
SECURE | *YES | 任意。HTTPSプロトコルを使用します。 | |
*NO | デフォルト。HTTPプロトコルを使用します。 | ||
ENCODING | 任意。詳細は、「ENCODING」を参照してください。 フィールド値のエンコードに使用されます。 | ||
WAIT | *NO | 任意。HTTP応答を待機しません。 | |
*YES | デフォルト。HTTP応答を無限に待機します。 | ||
値 | 読み込み時間をミリ秒単位で待機します。 | ||
TIMEOUT | 値 | 任意。デフォルトは0で、無効を示します。 ホスト接続のタイムアウト(ミリ秒単位) | |
LOCALE | 任意。詳細は、「LOCALE」を参照してください。 | ||
NUMBERFORMAT | 任意。詳細は、「NUMBERFORMAT」を参照してください。 | ||
SPACE | *PLUS | デフォルト。スペースを+記号にエンコードします。 | |
*BLANK | スペースをブランクにエンコードします。 | ||
*PERCENT20 | スペースを%20にエンコードします。 |
例
SEND HANDLER(OutboundNameValue) HOST(…) URI(/cgi-bin/program) #WRKLST(NAME,VALUE)