PUT

The PUT operation updates a single record in a ServiceNow table. You must pass in the table name and sys_id of the record you want to retrieve to use this operation.

This operation will return a single result that is not in an array.

You must configure at least one ServiceNow Instance to use this operation.

Environment/Instance Properties

Property Name

Property Code

Required

Description





Project Properties

Property Name

Property Code

Required

Description





Inputs

Input Name

Input Code

Required

Description

ServiceNow Instance CodeFDSN_INSTANCE_CODEYes

The instance Code of the ServiceNow Instance created under Topology that you will connect to.

The URL, PORT, USERNAME, and PASSWORD are taken from the instance.

FDR_REQUEST_MEDIA_TYPEYes

Choose to return the data in JSON or XML format.

If you select JSON, then use JSONPATH notation in the path expression inputs

(see https://github.com/json-path/JsonPath)

If you select XML, then use XPATH notation in the path expression inputs.

Body PathFDR_REQUEST_BODY_PATHNo

The path to load a body as a file.

This data is patched into the existing object with the given sys_id. It does not need to be the entire object.

Only 1 of FDR_REQUEST_BODY_PATH or FDR_REQUEST_BODY should be supplied.

BodyFDR_REQUEST_BODYNo

This data is patched into the existing object with the given sys_id. It does not need to be the entire object.

Only 1 of FDR_REQUEST_BODY_PATH or FDR_REQUEST_BODY should be supplied.

Table NameFDSN_TABLE_NAMEYesThe ServiceNow Table that you want to retrieve records from (e.g. change_request)
sys_idFDSN_RECORD_SYS_IDYesThis is the sys_id of the record in ServiceNow.You will likely need to perform a getRecords operation first to find the sys_id to GET.
Fail workflow if http response code over 200FDSN_FAIL_IF_HTTP_CODE_OVER_200NoIf true, any http code over 200 will fail the step and the workflow.
FDSN_PATH_EXPRESSION_1NoUse XPATH or JSONPATH notation to return part of the response back to the workflow as FDSN_OUTPUT_1. See FDR_REQUEST_MEDIA_TYPE for more information
FDSN_PATH_EXPRESSION_2NoUse XPATH or JSONPATH notation to return part of the response back to the workflow as FDSN_OUTPUT_2. See FDR_REQUEST_MEDIA_TYPE for more information
FDSN_PATH_EXPRESSION_3NoUse XPATH or JSONPATH notation to return part of the response back to the workflow as FDSN_OUTPUT_3. See FDR_REQUEST_MEDIA_TYPE for more information
FDSN_PATH_EXPRESSION_4NoUse XPATH or JSONPATH notation to return part of the response back to the workflow as FDSN_OUTPUT_4. See FDR_REQUEST_MEDIA_TYPE for more information
FDSN_PATH_EXPRESSION_5NoUse XPATH or JSONPATH notation to return part of the response back to the workflow as FDSN_OUTPUT_5. See FDR_REQUEST_MEDIA_TYPE for more information

Outputs

Output Name

Required

Description


Returns the integer HTTP response code such as 200, 400, 500.

FDR_RESPONSE_STRING
Returns the complete JSON or XML response from the ServiceNow instance.
FDSN_OUTPUT_1
Returns the value returned by FDSN_PATH_EXPRESSION_1 if it is not null
FDSN_OUTPUT_2
Returns the value returned by FDSN_PATH_EXPRESSION_2 if it is not null
FDSN_OUTPUT_3
Returns the value returned by FDSN_PATH_EXPRESSION_3 if it is not null
FDSN_OUTPUT_4
Returns the value returned by FDSN_PATH_EXPRESSION_4 if it is not null
FDSN_OUTPUT_5
Returns the value returned by FDSN_PATH_EXPRESSION_5 if it is not null

Artifacts

This operation doesn’t consume or produce any artifacts.

Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.

Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

Example

The following macros are not currently supported in the footer:
  • style