Function

urlwithparameters( path, parameterNames, parameterValues )

This function allows you to build a URL from an expression, using arrays of process and constant data.

Parameters

Keyword	Type	Description
path	Text	The URL path. This can be a fully qualified path or a relative path. The path will not be encoded as it is the responsibility of the designer to provide a valid path.
parameterNames	Text Array	The parameters to append to the URL.
parameterValues	Text Array	The parameter values corresponding to the parameter names to append to the URL.

Returns

Textpath (Text)

Usage considerations

Only arrays are accepted for the 2nd and 3rd parameters.

Arrays must be enclosed in curly brackets {}.

Parameter names are encoded to form a valid URL. For example, spaces are replaced with "%20".

The return value is a fully qualified or relative URL path that is not encoded or validated.

Examples

You can copy and paste these examples into the Expression Rule Designer to see how this works.

"<a href=" & urlwithparameters("/tio/viewPayments.do", {"claimNumber"}, {pv!claimNumber}) & ">View Payments</a>" returns View Payments

Feature compatibility

The table below lists this function's compatibility with various features in Appian.

Feature	Compatibility	Note
Portals	Partially compatible	Can be used with Appian Portals if it is connected using an integration and web API.
Offline Mobile	Partially compatible	Can be used with offline mobile if it is loaded at the top of the form.
Sync-Time Custom Record Fields	Incompatible
Real-Time Custom Record Fields	Incompatible	Custom record fields that evaluate in real time must be configured using one or more Custom Field functions.
Process Reports	Incompatible	Cannot be used to configure a process report.
Process Events	Incompatible	Cannot be used to configure a process event node, such as a start event or timer event.