Perform a PATCH method REST call against an endpoint.

Prior to the 7.0.0.0, 6.5.0.3, 6.0.0.7, 5.7.0.13 releases, the Patch operation always used a POST method with a header sent to tell the target server to override it as a post. Since those versions, if Java 8+ is found, it will be sent as an actual Patch method instead.

If no body is returned, an empty string will be present in FDR_RESPONSE_STRING.

Environment/Instance Properties

Property Name	Property Code	Required	Description

Project Properties

Property Name	Property Code	Required	Description

Inputs

Input Name	Input Code	Required	Description
REST URL	`FDR_REQUEST_URL`	Yes	URL to the desired REST Service @since 5.5.0.3 this input supports FlexDeploy property replacement. i.e. you can use ${{PROP1}} in the input value.
Query String	`FDR_QUERY_STRING`	No	Query String to be used. Use Groovy if desired to use FlexDeploy variables in the query string. 'a=b&c=d&e='+FD_TEMP_DIR+'&f=g' or, if not using Groovy, simply a=b&c=d Spaces will not be trimmed from the string. @since 5.3.0.1 The query string input also allows FlexDeploy property replacement to be used
Username	`FDR_USER`	No	The username for authentication
Password	`FDR_PASSWORD`	No	The password for authentication
Preemptive Authentication	`FDR_PREEMPTIVE_AUTH`	No	Use preemptive Basic authentication (provide authentication before being asked) if false, non-preemptive Universal authentication is used.
Request Media Type	`FDR_REQUEST_MEDIA_TYPE`	No	The media type to request from the server
Body Media Type	`FDR_REQUEST_BODY_MEDIA_TYPE`	Yes	The media type of the body
Body Path	`FDR_REQUEST_BODY_PATH`	No*	The file path containing the request body. Either Body or Body Path must be supplied. @since 5.5.0.3* this input supports FlexDeploy property replacement. i.e. you can use ${{PROP1}} in the input value.
Body	`FDR_REQUEST_BODY`	No*	The String to use as the request body. Either Body or Body Path must be supplied. @since 5.5.0.3* this input supports FlexDeploy property replacement. i.e. you can use ${{PROP1}} in the input value.
Ignore SSL Errors	`FDR_IGNORE_SSL_ERRORS`	No	If checked, SSL errors will be ignored. Otherwise they will cause the operation to fail.
Response Action	FDR_RESPONSE_ACTION	Yes	What action should be taken upon completion of this request? Possible options are: ReturnAsOutput - Save the response body and response code to the outputs described below SaveToTemp - Save the response body to a response file in the temp directory. File name will be 'response.json', 'response.xml', or 'response.txt' depending on the response type. SaveToArtifacts - Save the response body to a response file in the artifacts directory. Be sure to check 'produces artifacts' if intending to save the file to artifacts. File name will be 'response.json', 'response.xml', or 'response.txt' depending on the response type. @since 5.3.0.1
Headers	FDR_HEADERS	No	Headers to send with the request. Formatted as key=value. One key/value pair per line. For example: my-custom-header=abc123 x-client-secret=${{FD_CLIENT_SECRET}} The headers input also allows FlexDeploy property replacement to be used as seen in the x-client-secret header above @since 5.3.0.1
Validation Script	FDR_VALIDATION_SCRIPT	No	Groovy validation script to be run against the response body. This input expects a groovy script as plain text, meaning you should not enable the groovy script flag on the plugin input itself. Available variables: PAYLOAD - accessed as a Json object or a simple string if the return type is not Json RESPONSE_CODE - integer response code Example script: PAYLOAD.myField && PAYLOAD.myField.equals('myValue') @since 5.3.0.1
Validation Action	FDR_VALIDATION_ACTION	No	What action should be taken if the Groovy Validation Script fails? Valid options are: JustLog - Simply log the failed result and continue as if successful. GenerateTestResults - Generate a simple test results file. The results will not show up in the test results tab unless this is used in a test workflow FailExecution - Throw an error and fail this plugin execution @since 5.3.0.1
Connect Timeout	FDR_CONNECT_TIMEOUT	No	Time to wait to allow a connection to be established. Setting to 0 will wait forever. @since 5.3.0.1
Read Timeout	FDR_READ_TIMEOUT	No	Time to wait for a response after establishing a connection. Setting to 0 will wait forever. @since 5.3.0.1

Outputs

Output Name	Required	Description
`FDR_RESPONSE_CODE`	No	The Integer response code of from the REST response
`FDR_RESPONSE_STRING`	No	The first Response Entity is returned as a String.

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.