SEND_TO_URL

Sends data to a internet URL and waits for a response from the remote server.

Properties

Send to Endpoint ${}
sendurl_url

The URL that the outbound request will be sent to.

Method
sendurl_method

The HTTP header method used in the outbound request

valid options
GETCommonly used when retrieving information.
POSTCommonly used when sending data to the server.
PUTCommonly used to completely replace an existing record.
PATCHCommonly used to partially replace an existing record.
DELETECommonly used to delete an existing record.
COPYCommonly used to create duplicate of an existing record
HEADSimilar to a GET request, but the response only contains a header.
OPTIONSCommonly used when describing the communication options of the endpoint.
LINKCommonly used to establish a data reference between records.
UNLINKCommonly used to remove a data reference between records.
PURGECommonly used to delete cached resources.
LOCKCommonly used to restrict access to a specified record.
UNLOCKCommonly used unrestrict access to a specified record.
PROPFINDCommonly used when retrieving properties from a web resource.
VIEW

Send Format
sendurl_format

The outbound request record's content type which is to inform the remote service what type of data is being sent.

valid options
None
No content type header will be set
Form Submission
application/x-www-form-urlencoded
For sending simple form submission data
JSON
application/json
Data will be sent using JSON formatting.
Plain Text
text/plain
Text data will be sent as is with no formatting.
XML
text/xml
Data will be sent formatted as an XML document.
HTML
text/html
Data will be sent formatted as an HTML document.
CSV
text/csv
Data will be sent as a comma delimited flat file.

Response Format
sendurl_bodyFormat

Specifies to the remote service how their response is formatted.

valid options
JSON
application/json
JSON (Javascript Object Notation). Common format for communication between computer systems.
Plain Text
text/plain
The raw unparsed data in a text document
XML
text/xml
Uses XML syntax and structure. Common format for communication between computer systems.
HTML
text/html
Response is in HTML and is designed to be interpreted by a person viewing the results in a webpage
CSV
text/csv
Comma delimited flat file. Use this when importing the data into spreadsheet software.

Authorization
sendurl_authType

The authentication protocol used to access the remote service.

valid options
None
No formal authentication protocol will be used.
Basic Auth
Basic
Will use traditional basic authentication.
OAuth 1.0
OAuth
Will use Oauth 1.0 authentication. Oftened used for intra-network communications.
Instalink API/Consumer Token
InstalinkToken
Will use Instalink's built-in authentication method. Useful for authenticating calls between various Instalink hosted endpoints.
Amazon Signature Version 4
AmazonV4
DEPRECATED: Amazon Signature Version 4 authentication. Used when accessing AWS services.

Username ${}
sendurl_authBasicUsername

The username that is used for basic authentication

Password ${}
sendurl_authBasicPassword

The password that is used for basic authentication

Consumer Key ${}
sendurl_authOauth1ConsumerKey

The consumer key that the remote service has provided to use when accessing their service.

Consumer Secret ${}
sendurl_authOauth1ConsumerSecret

The consumer secret that the remote service has provided to use when accessing their service.

Token ${}
sendurl_authOauth1TokenKey

The token key that the remote service has provided to use when accessing their service.

Token Secret ${}
sendurl_authOauth1TokenSecret

The token secret that the remote service has provided to use when accessing their service.

Signature Method
sendurl_authOauth1SignatureMethod

The hashing algorithm to use to package the authentication request. Consult your remote service provider for information about which signature method(s) they accept.

Realm (optional) ${}
sendurl_authOauth1Realm

Optional field. The value of this property may differ depending on how your remote service provider implements Oauth 1.0. Some remote services require this property to be set. Please consult your remote service provider for more information about this property.

Token Value ${}
sendurl_authInstalinkToken

The Instalink provisioned token that has been provisioned access to the remote resource.

Template ${}
sendurl_template

The template used to format the data that is to be sent to the remote resource. Accepts template syntax.

Use Template
sendurl_useTemplate

When enabled the outbound request data will use the provided template instead of preformatted field values.

Record Identifier Template ${}
sendurl_recordIdentifierTemplate

Label that helps to identify outbound call records in the admin panel. Please set this to make your logs easier to navigate and search. Accepts template syntax.

Use Namespace for Output
sendurl_useNamespace

When enabled, all data recieved from the outbound request will be assigned to the key as defined in sendurl_namespace. By default the data is added to the root process data and is accessible by whatever keys may be provided in the request response. You should enable this if the request response is not expected to be an object with keys.

Output Namespace
sendurl_namespace

The key that will contain the data of the outbound request response.

CSV Header Expected
sendurl_csvHasHeader

When enabled and the body of the response from the server is a CSV document, the first row of the data is used to determine the keys for all subsequent records and the records will be returned as maps with these keys. When not enabled, the first row of the CSV data is not treated specially and all rows are returned as lists.

Send Data In Body
sendurl_sendDataInBody

Force the provided data to be sent in the body instead of the query string in a GET or HEAD HTTP request.

Set Request Timeout
sendurl_doTimeout

When enabled the outbound request will fail after a specified time if no response has been returned from the remote server.

Timeout Seconds
sendurl_timeout

When a timeout is enabled, sets the number of seconds for the timeout.

Enable GZIP Response
sendurl_gzip

When enabled, the outbound call will accept and transparently inflate a response from the remote server in a gzip encoding.

Fields
fields

A set of records that are used to define process data keys that are to be included when executing various actions.

Field Key
fields[].key

Where to find or set the data in the process data. Uses dot notation conventions.

Value ${}
fields[].value

The value to set in the process data. Accepts template syntax.