Build String

 

Inserts values into a URI query string.

 

This allows you to build URIs for passing to other applications (such as storm DTA). For example, you may construct the following URL for passing to storm DTA via the Route to Contact action cell:

http://mycrm.com/contacts?name=John%20Smith

Properties

Build String Section

Input Variables Section

Build String Section

Option

Description

Rule

‘URI’ is currently the only option.

Base Address

Use this field to provide the start of the URI, using a literal value (preceded by =) or a string variable. For  example:

   =http://myhost.com/path

Any special characters must be percent-encoded. For example, a space character is encoded with %20.

Note: this field is optional. If you do not provide a value, the string built by the action cell will have the format of a URI query.

Result Variable

Enter a string variable to store the resulting URI.

The value in the string variable will have the format:

<Build String Base>?<Build String Input Name 1>=<Build String Input Value 1>&<Build String Input Name 2>=<Build String Input Value 2>

with the Build String Input Name and Build String Input Value elements inserted in the order in which they are listed.

For example:

   http://myhost.com/path?param1=value1&param2=value2

Input Variables Section

Use this section to build a list of variables to be used to construct the URI.

Option

Description

Name/Value

In the Name field, enter the name of the variable as recognised by the service (use a literal value prefixed by =, or a string variable). In the Value field, provide the value to pass. Click ADD to add the Name and Value pair to the list below.

You can reorder the variables by clicking and dragging an item to the location indicated by the black line.

Exit Points

Exit Point

Description

Complete

This is taken if the URI query string is built successfully.

Error

This is taken if the URI query string could not be built, or the system has encountered an error.