Output Handling Parameters for REST API
The following table describes the Output Handling parameters for REST API.
Parameter |
Description |
---|---|
Element JsonPath |
Enables you to specify the JsonPath manually. Relevant only when you select Content Type JSON. |
Element XPath |
Enables you to specify the XML path manually. Relevant only when you select Content Type XML. |
If |
Defines the relationship between response elements to analyze. Valid values:
Relevant for JSON or XML only. If you select Other, the valid values are:
|
Do |
Defines the action for the Response parameters. Relevant for JSON and XML Content-Type. Valid values:
|
Fail the job |
Defines what happens the when the job fails. |
Keep value in Runtime Parameter |
Enables you to save the extracted value for future use. Relevant for JSON and XML Content-Type. |
Keep value of related element |
Enables you to keep the value of the element on the same level or child element in the XML response. Relevant for JSON and XML Content-Type. |
Save content to file |
Enables you to save the output to a file. You must type the file name and you can change the default extension. Click the Append date and time field to avoid overriding the file per execution. |
Runtime parameter |
Defines the name of the Runtime parameter where the full path of the file response content is saved to. You can use this Runtime parameter to appear in the Designer area for the end user or in following operations, such as copying the file to a specific location. NOTE: You can use the Runtime Parameter with the same name in in other steps, but it appears only once in Runtime Parameters in the Designer area. |
Element Name |
Defines the response element name to analyze which includes sibling and child to extract. Relevant for HEADER only. |
If |
Enables you to select one of the output options from the drop-down list. You can add parameters where required. Relevant for HEADER only. |
Do |
Defines the action for the Response parameters. Valid values:
|
Extract data |
Extracts data from one of the following:
For more information, see Examples: Extracting Data. |
Whole Line |
Extracts data from the whole line. |
Match regular expression |
Enables you to match the expression by typing a pattern in the Pattern field. You can view the text in the Preview line. You can change the preview text by clicking |
Part of the Line |
Enables you to extract data from the start or end of a line by selecting from the drop-down lists the start and end positions of the text. You need to complete the X box to define the text. You can also do the following:
|
Columnar Data |
Enables you to extract Column data, when the output is column based, such as CSV format or SQL output format, by completing the following:
Select the checkbox to Remove blanks (trim) |
Keep extracted data in Runtime parameter Name |
Defines the name of the Runtime parameter where the extracted data belongs. Appears in Runtime Parameters in the Designer area. |
Fail the job if extracted data |
Defines how the data behaves if the job fails or succeeds. |