HTTPPost - HTTP(Post)サービスの呼び出し
HTTPのPostメソッドを使ってHTTPサーバーへデータを送信します。
■ストリーム情報
| 入力 | フォーマット | Binary,Text,HTML,ParameterList,CSV,FixedString,MIME,XML |
|---|---|---|
| 接続数 | 1 | |
| 説明 | 入力ストリーム型にParameterListを使用した場合は、各パラメータがフォームフィールドとして送られます。 | |
| 出力 | フォーマット | XML,CSV,FixedLength,Text,HTML,Binary,MIME |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクションを使用 | boolean | － |
接続先に以下のコネクション名を使用するかどうか選択します。
|
||||||
| コネクション名 | connection | － | コネクションを使用が「はい」の場合に接続先のHTTPサーバーを指定します。 コネクションペインまたは管理コンソールにて作成したHTTP接続名を選択します。 | ||||||
| コネクション情報 | group | － | コネクションを使用が「いいえ」の場合に使用されるプロパティ群です。 | ||||||
| URL | string | 入力＆出力 | 取得するロケーションとしてのURLを設定します。 指定するURLは「 http(s)://～ 」の形式でフルパス指定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 | ||||||
| URLエンコーディング | choice | 入力＆出力 |
入力ストリームがParameterListの場合にそのパラメータ名と値をBodyに設定するエンコーディング名で、HTTPサーバーが受理できるエンコーディングを指定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 例えば、入力のParameterListの「param」というフィールドに「あいう」という値が設定されている場合、 URLエンコーディングプロパティにShift_JISを指定した場合はPOSTするデータは以下のようになります。 param=%82%A0%82%A2%82%A4 URLエンコーディングプロパティに指定するエンコーディングの詳細についてはRFC1738をご参照ください。 |
||||||
| タイムアウト（秒） | int | 入力＆出力 |
リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 |
||||||
| ベーシック認証 | group | － | コネクションを使用が「いいえ」の場合に使用されるベーシック認証プロパティ群です。 | ||||||
| ユーザー名 | string | 入力＆出力 |
接続先のサーバーでベーシック認証を行う場合のユーザー名を設定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 |
||||||
| パスワード | password | 入力＆出力 |
接続先のサーバーでベーシック認証を行う場合のパスワードを設定します。 コネクションを使用が「いいえ」の場合にこの設定が参照されます。 |
||||||
| プロキシー設定を使用 | boolean | － |
管理コンソールで設定したプロキシー設定を使用するかどうかを指定します。
コネクションを使用が「いいえ」の場合にこの設定が参照されます。
|
||||||
| パス | string | 入力＆出力 | POSTデータに使われるURLのパスを記述します。ここで指定したURL文字列は上記のコネクション名で指定されているURLに付加する形でリクエスト時に使用されます。 | ||||||
| HTTPのバージョン | choice | － |
リクエストに使用するHTTPのバージョンを指定します。
|
||||||
| リトライ回数 | int | 入力＆出力 | リクエスト時にHTTPサーバーに接続できなかったときに自動的にリトライするカウントを指定します。リトライしない場合は0を指定します。 | ||||||
| リトライ間隔（秒） | int | 入力＆出力 | 上記リトライ時に再度接続リクエストを送るまでの間隔を秒単位で指定します。 | ||||||
| リダイレクトを処理 | boolean | － |
サーバーからリダイレクト先が返されたときの処理の仕方を設定できます。
|
||||||
| 送信ヘッダー | category | 入力 | 送信ヘッダータブで指定されているパラメータをHTTPヘッダーに載せて、HTTP POSTリクエストを発行します。 ※ Cookieは指定することができません。 |
||||||
| 受信ヘッダー | category | － | HTTPサーバーからのレスポンスを受信した際に、送信ヘッダータブに指定されているパラメータに一致する、ヘッダー属性がある場合、その値を参照される送信ヘッダーの属性値に設定して返します。また、このプロパティは自動的にストリーム変数になります。本コンポーネントの後に連結したマッパーで、ストリーム変数として見えるようになっています。ストリーム変数については、フローデザイナーマニュアルのストリーム変数、コンポーネント定義のストリーム変数を参照してください。 |
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラ メータ | エラー処理フロー へのストリーム | エラー コード | 説明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 汎用 | なし | コンポーネントの入力ストリーム | なし | コネクション名に指定したコネクションが見つからない場合 | |||||||||
| なし | HTTPサーバーに接続できない場合 | ||||||||||||
| HTTPException |
| サーバーから返されたHTTPレスポンスのMIME | なし | HTTPサーバーがエラーを返した場合 |
■備考
- HTTPのレスポンスコード(200 OK、404 Not Found など)は取得することはできません。
-
タイムアウト（秒）でコネクション接続時のタイムアウトまでの時間を設定できますが、OSの管理するタイムアウトまでの時間を越える値を設定してもOSの管理するタイムアウトが優先されます。
たとえばOSの管理するタイムアウトまでの時間が30秒である場合に、タイムアウト（秒）に60秒を設定したとしても30秒でタイムアウトとなります。