HTTPPost - HTTP(Post)サービスの呼び出し

HTTPのPostメソッドを使ってHTTPサーバーへデータを送信します。
SSL通信を行う場合、管理コンソールで登録された証明書を使用してPKI基盤に従って通信を行います。

■ストリーム情報

入力	フォーマット	Binary,Text,HTML,ParameterList,CSV,FixedLength,MIME,XML,JSON
	接続数	1
	説明	入力ストリーム型にParameterListを使用した場合は、各パラメーターがフォームフィールドとして送られます。
出力	フォーマット	XML,CSV,FixedLength,Text,HTML,Binary,MIME,JSON

出力ストリーム変数

名前	データ型	説明
StatusCode	int	HTTPレスポンスのステータスコード

■コンポーネントプロパティ

名前	プロパティ型	マッピング	説明
コネクションを使用	boolean	-	接続先に以下のコネクション名 を使用するかどうか選択します。 はい [true] - 以下のコネクション名 で指定されたHTTP接続名をHTTPの接続先サーバーとして使用します。 いいえ [false] - コネクション情報 以下のプロパティを使ってHTTPによる接続を行います。
コネクション名	connection	-	コネクションを使用 が「はい」の場合に接続先のHTTPサーバーを指定します。 コネクションペインまたは管理コンソールにて作成したHTTP接続名を選択します。
コネクション情報	group	-	コネクションを使用 プロパティが「いいえ」の場合に使用されるプロパティ群です。
URL	string	入力＆出力	取得するロケーションとしてのURLを設定します。 指定するURLは「 http(s)://～ 」の形式でフルパス指定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
URLエンコーディング	choice	入力＆出力	入力ストリームがParameterListの場合、そのパラメーター名と値をBodyに設定するときにどのようにエンコーディングするかを指定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。URLのエンコーディングについては、下記トピック「URLのエンコーディングについて」を参照してください。
タイムアウト（秒）	int	入力＆出力	リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
認証	group	-	コネクションを使用 が「いいえ」の場合に使用される認証プロパティ群です。 サポートしている認証方式は以下の3つです。 Basic認証 Digest認証 WSSE認証
ユーザー名	string	入力＆出力	接続先のサーバーで認証を行う場合のユーザー名を設定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
パスワード	password	入力＆出力	接続先のサーバーで認証を行う場合のパスワードを設定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
ユーザーのクライアント証明書を使用	boolean	-	クライアント認証でユーザーの証明書を使用するかどうかを指定します。 ユーザーの証明書は管理コンソールのアカウント設定で登録します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。 はい [true] - ユーザーの証明書を使用します。 いいえ [false] - ユーザーの証明書を使用しません。
クライアント証明書のエイリアス	string	入力＆出力	ユーザーのクライアント証明書を使用 が「はい」の場合に、ユーザーの証明書として使用するエイリアス名を指定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。
プロキシ設定を使用	boolean	-	管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。 コネクションを使用 が「いいえ」の場合にこの設定が参照されます。 はい [true] - プロキシ設定を使用します。 いいえ [false] - プロキシ設定を使用しません。
パス	string	入力＆出力	取得するロケーションとしてのURLを設定します。 ここで指定したURL文字列は上記のコネクション名 またはURL で指定されているURLに付加されます。 ※URLのパス名に付加するパス文字列であり、スキームやホスト名を含むことはできません。
HTTPのバージョン	choice	-	リクエストに使用するHTTPのバージョンを指定します。 HTTP/1.1 の場合 ヘッダーに Connection:close がヘッダーに強制的に設定されます。 HTTP/1.0 - HTTP/1.0を使用します。 HTTP/1.1 - HTTP/1.1を使用します。
リトライ回数	int	入力＆出力	リクエスト時にHTTPサーバーに接続できなかったときに自動的にリトライするカウントを指定します。リトライしない場合は0を指定します。
リトライ間隔（秒）	int	入力＆出力	上記リトライ時に再度接続リクエストを送るまでの間隔を秒単位で指定します。
リダイレクトを処理	boolean	-	サーバーからリダイレクト先が返されたときの処理の方法を設定できます。 はい [true] - サーバーから返されたリダイレクトに自動的にリダイレクトします。 いいえ [false] - リダイレクトされません。
送信ヘッダー	category	入力	送信ヘッダー タブで指定したパラメーターをHTTPヘッダーに載せて、HTTP POSTリクエストを発行します。
受信ヘッダー	category	出力	HTTPサーバーからのレスポンスを受信した際に、受信ヘッダー タブに指定したパラメーターに一致するヘッダー属性がある場合、そのヘッダー属性の値を受信ヘッダー タブの指定したパラメーターに設定して返します。また、このプロパティは自動的にストリーム変数になります。本コンポーネントの後に連結したマッパーで、ストリーム変数として見えるようになっています。ストリーム変数については、「はじめに」-「詳細なトピック」-「フローの構成要素」-「変数」-「ストリーム変数」を参照してください。

■トランザクション処理

コミット	何もしません。
ロールバック	何もしません。

■エラー処理

タイプ	パラメーター	エラー処理フロー へのストリーム	エラー コード	説明
汎用	なし	コンポーネントの入力ストリーム	なし	コネクション名 に指定したコネクションが見つからない場合
			なし	HTTPサーバーに接続できない場合
HTTPException	「HTTPExceptionのパラメーター 」 を参照してください。	サーバーから返されたHTTPレスポンスのMIME	HTTPレスポンスのステータスコード	HTTPサーバーがエラーを返した場合

■「HTTPException」のパラメーター

No.	名前	説明
1	HTTPStatusLine	サーバーから返されたHTTPステータスラインが返されます。
2	HTTPBody	サーバーから返されたHTTPレスポンスのボティが返されます。

■フローの強制終了

フローを強制終了すると、通常は実行中のコンポーネントの処理が終了してから次のコンポーネントに制御が遷移する時点でフローがアボートしますが、本コンポーネントでは実行中の処理を強制的に終了してフローがアボートします。

■URLのエンコーディングについて

例えば、入力ストリームのParameterListの「param」というフィールドに「あいう」という値が設定されている場合、URLエンコーディング にShift_JISを指定するとPOSTするデータは以下のようになります。

	param=%82%A0%82%A2%82%A4
	

URLエンコーディング に指定するエンコーディングの詳細についてはRFC1738をご参照ください。

■コネクションを使用するケース

コネクションを使用しない場合は接続先のURLに関する情報をすべてコンポーネントで設定しなければなりませんが、 コネクションを使用する場合は接続先ホストの基本情報をコネクションとして定義しておき「パス」プロパティとの組み合わせでURLを組み立てることができます。
例えば、コネクション定義でURLとして

	http://SERVERNAME
	

のようにホスト名だけを指定しておき「パス」プロパティに「/page1.html」を指定することで

	http://SERVERNAME/page1.html
	

に対してリクエストを実行することができます。
同一Webサーバーに対して複数のHTTPコンポーネントからアクセスする必要がある場合に

• そのWebサーバーが認証を必要とする
• そのWebサーバーが別のホストに変更される可能性がある

ようなケースではコネクションを使用する方が便利です。

■備考

• タイムアウト（秒） でコネクション接続時のタイムアウトまでの時間を設定できますが、OSの管理するタイムアウトまでの時間を越える値を設定してもOSの管理するタイムアウトが優先されます。
  たとえばOSの管理するタイムアウトまでの時間が30秒である場合に、タイムアウト（秒） に60秒を設定したとしても30秒でタイムアウトとなります。