巡回(データ出力/パラメータ)

オペレーション名

巡回(データ出力/パラメータ)

機能概要

Webページにパラメータを渡してデータを取得します。

Standalone版では使用できません。

データモデル

本コンポーネントのデータモデルはXML型です。

プロパティ

基本設定

項目名	必須/省略可	変数の使用	説明	補足
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	補足
接続先	必須	使用不可	グローバルリソースを選択します。グローバルリソースの設定方法については「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」プロパティにて、グローバルリソースの設定を編集することができます。
パス	必須	使用可	接続するパスを入力します。相対パス("/"から始まっていないパス)を指定された場合は、自動的に"/"が先頭に追加されます。
メソッド	必須	使用不可	HTTPメソッドを選択します。 [GET]:(デフォルト) [POST]:
エンコード	必須	使用可	パラメータの値のエンコードを選択または入力します。 J2SE Development Kit 5.0でサポートされているエンコーディングを設定することができます。詳細についてはこちらを参照してください。
パラメータ	省略可	-	パラメータを設定します。各列は以下のボタンで操作することができます。 [追加]: 列を追加します。 [上へ]: 選択している列の順序を一つ上に上げます。 [下へ]: 選択している列の順序を一つ下に下げます。 [削除]: 列を削除します。
パラメータ/ヘッダ名	必須	使用可	ヘッダ名を入力します。
パラメータ/値	省略可	使用可	値を入力します。

認証

項目名	必須/省略可	変数の使用	説明	補足
認証モード	必須	使用不可	使用する認証モードを選択します。 [なし]:(デフォルト) 認証を使用しません。 [基本認証]: 基本認証を使用します。
ユーザ名	省略可	使用可	基本認証で使用するユーザ名を入力します。 [認証モード]に[基本認証]を選択すると有効になります。
パスワード	省略可	使用可	基本認証で使用するパスワードを入力します。 [認証モード]に[基本認証]を選択すると有効になります。

Cookie

項目名	必須/省略可	変数の使用	説明	補足
サブドメインのCookieをサーバへ送信する	省略可	使用不可	保存されているサブドメインのCookieを送信するかどうかを選択します。 [チェックあり]:(デフォルト) 保存されたサブドメインのCookieを送信します。 [チェックなし]: 保存されたサブドメインのCookieを送信しません。	Cookieの保存は、Webアダプタの各処理実行後に自動的に行われ、後続のWebアダプタの処理で使用されます。同じグローバルリソースを使用した後続のWebアダプタの処理においては、[チェックなし]を選択していても同一ドメインのCookieは自動的に送信されます。 [チェックあり]を選択した場合の詳細については、「サブドメインのCookie送信について」を参照してください。

コメント

項目名	必須/省略可	変数の使用	説明	補足
コメント	省略可	使用不可	このアダプタの簡単な説明を記述することができます。説明を記述すると、仕様書に反映させることができます。

トランザクション

トランザクションはサポートしていません。

大容量データ処理

大容量データ処理に対応していません。

使用できるコンポーネント変数

コンポーネント変数名	説明
error_type	エラーが発生したときに、エラーの種類を返します。 java.io.FileNotFoundExceptionというような形式で返されます。エラーが発生しなかった時にはnullを返します。バージョンにより、内容が変わる可能性があります。
error_message	エラーが発生したときのエラーメッセージを返します。バージョンにより、内容が変わる可能性があります。
error_trace	エラーが発生したときのトレース情報を返します。バージョンにより、内容が変わる可能性があります。

サブドメインのCookie送信について

サブドメインのCookieは、保存されたCookieの属性と接続先の情報を比較して、以下の条件をすべて満たす場合に送信します。

domain属性の値が、接続先のホストと後方一致する
ただし、以下の場合は完全一致のみ条件を満たすとみなします。
- domain属性が「.」が付かないホスト名である場合
- domain属性がIPアドレスである場合
path属性の値が、接続先のパスより上位、もしくは同じである
secure属性の値が、接続先との通信方法(HTTPS・HTTP)と合致する
expire属性の日時が、現在日時以後である

例：

接続先のURL	Cookieの属性				送信・送信しない
接続先のURL	domain	path	secure	expire	送信・送信しない
http://dataspider.test.jp/aaa/	.test.jp	/aaa/	false	無期限	すべての条件を満たすため送信する
http://dataspider.jp/aaa/	.test.jp	/aaa/	false	無期限	domain属性が後方一致しないCookieであるため送信しない
http://dataspider.test.jp/aaa/	.test.jp	/aaa/bbb/	false	無期限	path属性が下位のパスであるため送信しない
http://dataspider.test.jp/aaa/	.test.jp	/aaa/	true	無期限	secure属性が暗号化通信(https)の値であるため送信しない
http://dataspider.test.jp/aaa/	.test.jp	/aaa/	false	昨日の日時	expire属性が現在日時より過去の値であるため送信しない

同一のdomain属性、path属性、secure属性、name属性を持つCookieが複数保存されていた場合は、直前のWebアダプタの処理で保存されたCookieが送信されます。

主な例外

例外名	原因	対策
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[]	[接続先]が指定されていません。	[接続先]を指定してください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]	[接続先]で選択されたリソース定義が見つかりません。	[接続先]で指定したグローバルリソースを確認してください。
java.net.UnknownHostException	指定したWebサーバが見つからない例外です。	Webサーバの設定を確認してください。
java.net.ConnectException	Webサーバに接続できない例外です。	ポート番号、あるいは、Webサーバが起動していることを確認してください。
org.apache.commons.httpclient.HttpConnection$ConnectionTimeoutException	Webサーバに接続中にタイムアウトが発生しました。	ネットワークの状態を確認してください。または、[接続先]で指定したグローバルリソースの[タイムアウト]を確認してください。
org.apache.commons.httpclient.HttpRecoverableException java.net.SocketTimeoutException: Read timed out	Webサーバに接続後、サーバからの応答までにタイムアウトが発生した例外です。	接続するWebサーバの状態を確認してください。または、[接続先]で指定したグローバルリソースの[タイムアウト]を確認してください。

注意事項

パラメータの値に2バイト文字が含まれる場合には、エンコードを指定してください。

ルート証明書がJavaに登録されていないとき
Internet ExplorerなどのブラウザからはHTTPS接続可能で、WebアダプタからHTTPS接続不可能な場合は、DataSpiderが使用しているJavaにルート証明書が登録されていない可能性があります。
ルート証明書がJavaに登録されていないWebサーバにHTTPS接続したときには、javax.net.ssl.SSLHandshakeExceptionなどの例外が発生し、接続が失敗します。その際には、ルート証明書をJavaに登録することで解決できます。ルート証明書のインストール手順はこちらを参照してください。

テスト用証明書(自己作成証明書)を登録したいとき
テスト用の証明書(ルート証明機関の署名がない証明書)を登録したWebサーバにHTTPS接続したときには、javax.net.ssl.SSLHandshakeExceptionなどの例外が発生し、接続が失敗します。その際には、テスト用の証明書をJavaに登録することで解決できます。テスト用の証明書のインストール手順はこちらを参照してください。