Messages and limitations of the REST connector
Message code list of REST category
The following message codes correspond to errors that occur in REST Connector.
This message code is output when an undefined error occurs.
|
Cause |
Solution |
|---|---|
|
An undefined error occurred. |
Check the error message or the help of the operation in which the error has occurred. |
Corresponding error
-
None
This message code is output when a response with status code "5xx" was returned from the destination HTTP server.
|
Cause |
Solution |
|---|---|
|
A response with status code "5xx" was returned from the destination HTTP server. |
Refer to the contents of the error message to check the status of the HTTP server specified in Destination or the contents of the request. |
Corresponding error
-
RestServerException
This message code is output when a response with status code "4xx" was returned from the destination HTTP server.
|
Cause |
Solution |
|---|---|
|
A response with status code "4xx" was returned from the destination HTTP server. |
Refer to the contents of the error message to check Path or the contents of the request. |
Corresponding error
-
RestClientException
This message code is output when the path to the file of data to be stored in the part's body isn't set in the input data when sending multipart form data.
|
Cause |
Solution |
|---|---|
|
The path to the file of data to be stored in the part's body isn't set in the input data when sending multipart form data. |
Check whether the path is set in path element of the input data. |
Corresponding error
-
PathIsRequiredException
This message code is output when an error has occurred while sending a request.
|
Cause |
Solution |
|---|---|
|
An error occurred while sending a request. |
Check the contents of the error message. |
Corresponding error
-
org.apache.http.client.ClientProtocolException
This message code is output when a timeout has occurred while connecting to the HTTP server or the proxy server.
|
Cause |
Solution |
|---|---|
|
A timeout has occurred while connecting to the HTTP server or the proxy server. |
Check the setting of Connection timeout of Destination. |
Corresponding error
-
org.apache.http.conn.ConnectTimeoutException
This message code is output when the connection to the HTTP server or the proxy server can't be established.
|
Cause |
Solution |
|---|---|
|
Unable to connect to the HTTP server or the proxy server. |
Check whether it's possible to connect to the destination HTTP server or the proxy server. |
Corresponding error
-
org.apache.http.conn.HttpHostConnectException
This message code is output when an error occurs while converting the input data to JSON.
|
Cause |
Solution |
|---|---|
|
An error occurred while converting the input data to JSON. |
Check the contents of the input data. |
Corresponding error
-
javax.json.stream.JsonGenerationException
This message code is output when an error occurred while processing the response body as JSON format.
|
Cause |
Solution |
|---|---|
|
An error occurred while processing the response body as JSON format. |
Refer to the contents of the error message to check the settings of Receive settings and the contents of the response. |
Corresponding error
-
javax.json.stream.JsonParsingException
Exception messages of REST category
|
Exception name |
Cause |
Solution |
|---|---|---|
|
FileIsDirectoryException |
The path entered in File path is a directory. |
Enter a file path in File path. |
|
InvalidPropertyConfigurationException <Property name> is not specified. |
<Property name> isn't specified. |
Specify <property name>. |
|
InvalidPropertyConfigurationException Required item of the resource is not specified. :<property name> |
<Property name> of Destination isn't specified. |
Specify <property name> of Destination. |
|
java.net.ConnectException connect timed out |
The connection has been timed out. |
Check the setting of Connection timeout. |
|
java.net.ConnectException Connection refused: connect |
The connection has been rejected by the destination. |
Check the host name and port number specified in URL. |
|
java.net.java.net.UnknownHostException <host name> |
The host name is invalid. |
Check the host name specified in URL. |
|
java.net.MalformedURLException |
The URL is in an invalid format. |
Check the setting of URL. |
|
java.net.SocketTimeoutException |
After connecting to the HTTP server, a timeout has occurred in the response process between sending the request and receiving the response. |
Check the setting of Response timeout of Destination. |
|
javax.json.stream.JsonGenerationException |
An error occurred while converting the input data to JSON. |
Check the contents of the input data. |
|
javax.json.stream.JsonParsingException |
An error occurred while processing the response body as JSON format. |
Refer to the contents of the error message to check the settings of Response settings and the contents of the response. |
|
org.apache.http.client.ClientProtocolException |
An error occurred while sending a request. |
Check the contents of the error message. |
|
org.apache.http.conn.ConnectTimeoutException |
A timeout has occurred while connecting to the HTTP server or the proxy server. |
Check the setting of Connection timeout of Destination. |
|
org.apache.http.conn.HttpHostConnectException |
Unable to connect to the HTTP server or the proxy server. |
Check whether it's possible to connect to the destination HTTP server or the proxy server. |
|
PathIsNotAbsoluteException |
The path entered in Path or File path is a relative path. |
Enter an absolute path in Path or File Path. |
|
PathIsRequiredException |
The path to the file of data to be stored in the part's body isn't set in the input data when sending multipart form data. |
Check whether the path is set in path element of the input data. |
|
ResourceNotFoundException Resource definition is not found. Name: [] |
Destination isn't specified. |
Specify Destination. |
|
ResourceNotFoundException Resource definition is not found. Name: [<connection resource name>] |
The resource definition selected in Destination isn't found. |
Check the connection resource specified in Destination. |
|
RestClientException |
A response with status code "4xx" was returned from the HTTP server. |
Refer to the contents of the error message to check the path entered in Path or the contents of the request. |
|
RestServerException |
A response with status code "5xx" was returned from the HTTP server. |
Refer to the contents of the error message to check the status of the HTTP server specified in Destination or the contents of the request. |
Limitations of REST category
Connection resource properties
Specification limits
-
When you specify a query parameter or a URL fragment in URL, it will be ignored.
-
The proxy server settings aren't referred to in the connection test.
Specification limits
-
The HTTP version of requests is 1.1.
-
When you specify a query parameter or a URL fragment in Path, it will be ignored.
-
When the response body isn't in the format selected in Data format, an error occurs.
-
When Error when response status code is 4xx or 5xx is selected and the error occurs, if there's a response body, the result data is output.
-
Double byte characters can't be entered in Name and Value of Request header.
-
In Name of Response header, the names defined as component variables can't be entered.
-
Multiple headers with the same name can't be specified in Response header.
-
Cookies are passed over within a script. However, as cookies are allocated to a thread, they're not passed over to threads generated by the Thread operation.
Notes
-
SSL connection failure
When SSL connection is performed for a Web server without the certificate imported to the keystore, an error such as javax.net.ssl.SSLHandshakeException might occur, and the connection fails.
= Remarks =Contact support when you import the certificate.
Specification limits
-
The HTTP version of requests is 1.1.
-
When you specify a query parameter or a URL fragment in Path, it will be ignored.
-
When Data format is XML or JSON, the data is encoded with UTF-8 and sent.
-
When the response body isn't in the format selected in Data format, an error occurs during analysis of the response body.
-
When Error when response status code is 4xx or 5xx is selected and the error occurs, if there's a response body, the result data is output.
-
The following headers can't be specified in Request header.
-
Content-Length
-
Content-Transfer-Encoding
-
-
Double byte characters can't be entered in Name and Value of Request header.
-
In Name of Response header, the names defined as component variables can't be entered.
-
Multiple headers with the same name can't be specified in Response header.
-
Cookies are passed over within a script. However, as cookies are allocated to a thread, they're not passed over to threads generated by the Thread operation.
Notes
-
SSL connection failure
When SSL connection is performed for a Web server without the certificate imported to the keystore, an error such as javax.net.ssl.SSLHandshakeException might occur, and the connection fails.
= Remarks =Contact support when you import the certificate.
Specification limits
-
The HTTP version of requests is 1.1.
-
When you specify a query parameter or a URL fragment in Path, it will be ignored.
-
When Data format is XML or JSON, the data is encoded with UTF-8 and sent.
-
When the response body isn't in the format selected in Data format, an error occurs during analysis of the response body.
-
When Error when response status code is 4xx or 5xx is selected and the error occurs, if there's a response body, the result data is output.
-
The following headers can't be specified in Request header.
-
Content-Length
-
Content-Transfer-Encoding
-
-
Double byte characters can't be entered in Name and Value of Request header.
-
In Name of Response header, the names defined as component variables can't be entered.
-
Multiple headers with the same name can't be specified in Response header.
-
Cookies are passed over within a script. However, as cookies are allocated to a thread, they're not passed over to threads generated by the Thread operation.
Notes
-
SSL connection failure
When SSL connection is performed for a Web server without the certificate imported to the keystore, an error such as javax.net.ssl.SSLHandshakeException might occur, and the connection fails.
= Remarks =Contact support when you import the certificate.
Specification limits
-
The HTTP version of requests is 1.1.
-
When you specify a query parameter or a URL fragment in Path, it will be ignored.
-
When Data format is XML or JSON, the data is encoded with UTF-8 and sent.
-
When the response body isn't in the format selected in Data format, an error occurs during analysis of the response body.
-
When Error when response status code is 4xx or 5xx is selected and the error occurs, if there's a response body, the result data is output.
-
The following headers can't be specified in Request header.
-
Content-Length
-
Content-Transfer-Encoding
-
-
Double byte characters can't be entered in Name and Value of Request header.
-
In Name of Response header, the names defined as component variables can't be entered.
-
Multiple headers with the same name can't be specified in Response header.
-
Cookies are passed over within a script. However, as cookies are allocated to a thread, they're not passed over to threads generated by the Thread operation.
Notes
-
SSL connection failure
When SSL connection is performed for a Web server without the certificate imported to the keystore, an error such as javax.net.ssl.SSLHandshakeException might occur, and the connection fails.
= Remarks =Contact support when you import the certificate.
Specification limits
-
The HTTP version of requests is 1.1.
-
When you specify a query parameter or a URL fragment in Path, it will be ignored.
-
When the response body isn't in the format selected in Data format, an error occurs.
-
When Error when response status code is 4xx or 5xx is selected and the error occurs, if there's a response body, the result data is output.
-
Double byte characters can't be entered in Name and Value of Request header.
-
In Name of Response header, the names defined as component variables can't be entered.
-
Multiple headers with the same name can't be specified in Response header.
-
Cookies are passed over within a script. However, as cookies are allocated to a thread, they're not passed over to threads generated by the Thread operation.
Notes
-
SSL connection failure
When SSL connection is performed for a Web server without the certificate imported to the keystore, an error such as javax.net.ssl.SSLHandshakeException might occur, and the connection fails.
= Remarks =Contact support when you import the certificate.