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