C.2 Transmission information file
In a transmission information file, you set information about a request to a web API. The file format and items that can be specified in the file differ depending on the web API to be called. If there is no information to be sent when a request is sent, you do not need to create the transmission information file.
If you include security information (such as a password) in this file, you do so on your own responsibility.
This file is not used if extended mode is used when the versions of JP1/AJS3 - Manager and JP1/AJS3 - Agent are 12-50 or later. For details about the extended mode, see 2.4.12 Linking with a business system on the web (example of defining a jobnet that uses HTTP connection jobs).
The following table describes the specifications of the transmission information file.
|
No. |
Definition |
Description |
|---|---|---|
|
1 |
Permission |
The job execution user requires read permission for the file. |
|
2 |
Character encoding |
The character encoding to specify depends on the value specified for the charset parameter of the Content-Type header that is specified for the Header item in the connection configuration file. |
|
3 |
Maximum size |
When the GET request is sent : 8 megabytes When one of the POST request, PUT request, and DELETE request is sent : 10 megabytes |
Place the transmission information file at any location on the agent host on which the HTTP connection job is executed.
- Supplementary notes
-
-
When the GET request is sent, the content of the transmission information file is recognized as a URL parameter.
-
When one of the POST request, PUT request, and DELETE request is sent, the content of the transmission information file is recognized as the message body. Note that you can specify URL parameters in the message body, but you cannot specify request information other the URL parameters at the same time.
-
To specify URL parameters, in the transmission information file, specify the parameters in the following format without using newline characters. Note that you do not need to add a question mark (?) at the beginning of a line.
parameter-name=parameter-value[¶meter-name=parameter-value¶meter-name=...]
-
If the request information contains a value that requires URL encoding, in the transmission information file, you must specify the value in the URL-encoded format.
-