項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
接続先 |
必須 |
使用不可 |
グローバルリソースを選択します。
グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。
- [追加]:
新規にグローバルリソースを追加します。
- [一覧の編集]:
「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
|
|
パス |
省略可 |
使用可 |
[接続先]の[URL]に入力したURLからの相対パスを指定します。 |
[エンコード]で選択または入力したエンコードでURLエンコーディングされます。
|
エンコード |
省略可 |
使用可 |
URLエンコーディングに使用するエンコードを選択または入力します。
入力する場合は、Java SE Runtime Environment 8でサポートされているエンコードを指定します。
詳細については、「Supported Encodings」(http://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html)を参照してください。
|
- デフォルト値は「UTF-8」で、省略した場合は「UTF-8」が設定されます。
|
クエリパラメータ |
省略可 |
- |
URLに連結させるクエリパラメータの名前と値を指定します。
各クエリパラメータは以下のボタンで操作することができます。
- [追加]:
クエリパラメータを追加します。
- [上へ]:
選択しているクエリパラメータの順序を一つ上に上げます。
- [下へ]:
選択しているクエリパラメータの順序を一つ下に下げます。
- [削除]:
クエリパラメータを削除します。
|
[エンコード]で選択または入力したエンコードでURLエンコーディングされます。
|
クエリパラメータ/名前 |
省略可 |
使用可 |
クエリパラメータの名前を入力します。 |
- 省略した場合、クエリパラメータはURLに連結されません。
|
クエリパラメータ/値 |
省略可 |
使用可 |
クエリパラメータの値を入力します。 |
|
項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
データ出力先 |
必須 |
使用不可 |
レスポンスボディの出力先を選択します。
- [データ]:(デフォルト)
結果データに出力します。[データ形式]で選択した形式で出力します。
- [ファイル]:
[ファイルパス]で指定したファイルに出力します。
|
|
データ形式 |
必須 |
使用不可 |
レスポンスボディのデータ形式を選択します。
- [XML]:(デフォルト)
XML形式で処理します。
- [JSON]:
JSON形式で処理します。
- [その他のデータ形式]:
テキスト形式またはバイナリ形式で処理します。
|
- [データ出力先]に[データ]を選択した場合、表示されます。
- 選択したデータ形式により出力スキーマが異なります。
出力スキーマについては、「出力スキーマ」を参照してください。
|
ファイルパス |
必須 |
使用可 |
レスポンスボディを出力するファイルのパスを選択または入力します。
[参照]ボタンを押下するとファイルチューザが起動し、ファイルの選択ができます。
|
|
XMLとして不正な文字を削除する |
省略可 |
使用不可 |
JSON形式のデータの解析中にXMLとして不正な文字列が見つかった場合に自動で削除するかどうかを選択します。
- [チェックあり]:
XMLとして不正な文字列を削除します。
- [チェックなし]:(デフォルト)
XMLとして不正な文字列を削除しません。
|
- [データ形式]に[JSON]を選択した場合、表示されます。
|
自動でリダイレクトする |
省略可 |
使用不可 |
レスポンスにリダイレクト先が含まれている場合、自動でリダイレクトするかどうかを選択します。
- [チェックあり]:
自動でリダイレクトします。
- [チェックなし]:(デフォルト)
自動でリダイレクトしません。
|
|
レスポンスのステータスコードが4xx、5xxの場合エラーにする |
省略可 |
使用不可 |
レスポンスのステータスコードが「4xx」または「5xx」の場合、処理をエラーにするかどうかを選択します。
- [チェックあり]:
処理をエラーにします。
- [チェックなし]:(デフォルト)
処理をエラーにしません。
|
|
要素名 |
属性名 |
説明 |
備考 |
root |
- |
JSONオブジェクトをラップするルート要素です。 |
|
type |
JSONの型を表す属性値が設定されます。
属性値 |
説明 |
string |
JSONの文字列型を表します。
例:文字列型からなるJSONオブジェクト
"Suzuki"
上記例のJSONオブジェクトは以下のXMLデータに変換されて出力されます。
<root type="string">
<value>Suzuki</value>
</root>
|
number |
JSONの数値型を表します。
例:数値型からなるJSONオブジェクト
37
上記例のJSONオブジェクトは以下のXMLデータに変換されて出力されます。
<root type="number">
<value>37</value>
</root>
|
boolean |
JSONの真偽値型を表します。
例:真偽値型からなるJSONオブジェクト
true
上記例のJSONオブジェクトは以下のXMLデータに変換されて出力されます。
<root type="boolean">
<value>true</value>
</root>
|
object |
JSONのオブジェクト型を表します。
例:オブジェクト型からなるJSONオブジェクト
{"name":"Suzuki"}
上記例のJSONオブジェクトは以下のXMLデータに変換されて出力されます。
<root type="object">
<name type="string">Suzuki</name>
</root>
|
array |
JSONの配列型を表します。
例:配列型からなるJSONオブジェクト
["apple","grape","orange"]
上記例のJSONオブジェクトは以下のXMLデータに変換されて出力されます。
<root type="array">
<element type="string">apple</element>
<element type="string">grape</element>
<element type="string">orange</element>
</root>
|
null |
JSONのnull型を表します。
例:null型からなるJSONオブジェクト
null
上記例のJSONオブジェクトは以下のXMLデータに変換されて出力されます。
<root type="null">
<value/>
</root>
|
|
|
value |
- |
ルートが以下のJSONの型である場合に、その値に使われる要素です。
|
|
JSONメンバの名前 |
- |
JSONメンバを表す要素です。 |
|
type |
JSONの型を表す属性値が設定されます。
属性値 |
説明 |
string |
JSONの文字列型を表します。
例:文字列型の値を持つJSONメンバ
{"name":"Suzuki"}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<name type="string">Suzuki</name>
|
number |
JSONの数値型を表します。
例:数値型の値を持つJSONメンバ
{"age":37}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<age type="number">37</age>
|
boolean |
JSONの真偽値型を表します。
例:真偽値型の値を持つJSONメンバ
{"success":true}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<success type="boolean">true</success>
|
object |
JSONのオブジェクト型を表します。
例:オブジェクト型の値を持つJSONメンバ
{"name":{"first":"Ichiro","last":Suzuki"}}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<name type="object">
<first type="string">Ichiro</first>
<last type="string">Suzuki</last>
</name>
|
array |
JSONの配列型を表します。
JSONの配列型の要素は「element」要素で表されます。
JSONの配列型の要素の型がオブジェクト型の場合、JSONオブジェクトを表すスキーマを持ったXMLデータが「element」要素の子要素に出力され、それ以外の型の場合、値が「element」要素の要素内容に出力されます。
スキーマは以下の通りです。
<JSONメンバの名前 type="array">
<element type="JSONの型を表す属性値">値</element>
:
</JSONメンバの名前>
例:配列型の値を持つJSONメンバ
{"fruits":["apple","grape","orange"]}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<fruits type="array">
<element type="string">apple</element>
<element type="string">grape</element>
<element type="string">orange</element>
</fruits>
|
null |
JSONのnull型を表します。
例:null型の値を持つJSONメンバ
{"name":null}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<name type="null"/>
|
|
|
element |
- |
配列の要素を表す要素名です。 |
|
type |
JSONの型を表す文字列が出力されます。
JSONメンバの名前のtype属性と同じ属性値が設定されます。
|
|
member |
- |
JSONメンバの名前がXMLの要素名として不正な場合に使われる要素名です。 |
|
type |
JSONの型を表す文字列が出力されます。
JSONメンバの名前のtype属性と同じ属性値が設定されます。
|
|
name |
JSONメンバの名前が出力されます。
例:XMLの要素名として不正な名前を持つJSONメンバ
{"1name":"Suzuki"}
上記例のJSONメンバは以下のXMLデータに変換されて出力されます。
<member type="string" name="1name">Suzuki</member>
|
|
コンポーネント変数名 |
説明 |
備考 |
status_code |
レスポンスのHTTPステータスコードが格納されます。 |
|
reason_phrase |
レスポンスのHTTPステータスコードに関連したテキストフレーズが格納されます。 |
|
error_response_body |
レスポンスのステータスコードが「4xx」または「5xx」の場合のレスポンスボディが格納されます。 |
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
error_type |
エラー発生時、発生したエラーの種類が格納されます。 |
- デフォルト値はnullです。
- エラーの種類は、以下のような形式となります。
例:「java.io.FileNotFoundException」
DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
- デフォルト値はnullです。
DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
- デフォルト値はnullです。
DataSpider Cloudのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。
|
例外名 |
原因 |
対策 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[] |
[接続先]が指定されていません。 |
[接続先]を指定してください。 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>] |
[接続先]で選択されたリソース定義が見つかりません。 |
[接続先]で指定したグローバルリソースを確認してください。 |
InvalidPropertyConfigurationException リソースの必須項目が指定されていません。:<プロパティ名> |
[接続先]の[<プロパティ名>]が指定されていません。 |
[接続先]の[<プロパティ名>]を指定してください。 |
InvalidPropertyConfigurationException
<プロパティ名>が指定されていません。 |
[<プロパティ名>]が指定されていません。 |
[<プロパティ名>]を指定してください。 |
FileIsDirectoryException |
[ファイルパス]に入力されたパスがディレクトリです。 |
[ファイルパス]にはファイルパスを入力してください。 |
PathIsNotAbsoluteException |
[パス]または[ファイルパス]に入力されたパスが相対パスです。 |
[パス]または[ファイルパス]には絶対パスを入力してください。 |
RestServerException |
HTTPサーバからステータスコードが「5xx」のレスポンスが返されました。 |
エラーメッセージの内容を参考に[接続先]に指定しているHTTPサーバの状態やリクエストの内容を確認してください。 |
RestClientException |
HTTPサーバからステータスコードが「4xx」のレスポンスが返されました。 |
エラーメッセージの内容を参考に[パス]で入力したパスやリクエストの内容を確認してください。 |
org.apache.http.conn.HttpHostConnectException |
HTTPサーバまたはプロキシサーバに接続できませんでした。 |
接続先のHTTPサーバまたはプロキシサーバに接続可能かどうか確認してください。 |
org.apache.http.conn.ConnectTimeoutException |
HTTPサーバまたはプロキシサーバとの接続時にタイムアウトが発生しました。 |
[接続先]の[接続タイムアウト]の設定を確認してください。 |
java.net.SocketTimeoutException |
HTTPサーバに接続後、リクエストを送信してからレスポンスを受信するまでの応答でタイムアウトが発生しました。 |
[接続先]の[応答タイムアウト]の設定を確認してください。 |
javax.json.stream.JsonParsingException |
レスポンスボディをJSON形式として処理中にエラーが発生しました。 |
エラーメッセージの内容を参考に[レスポンス設定]の設定とレスポンスの内容を確認してください。 |