Update Current Browser Address (DriveWorks Documentation)

Update Current Browser Address

Will update the address of the current browser window, without refreshing any content.

When updating content in Single Page Applications this can be used to store values to the URL.

For example, the parameters applied to filter a data table can be stored in the URL.

The special variable DWCurrentClientUrl can be used to read the current URL into the specification.

Do not use this task on any Events or Transitions in the Specification Flow.

This task should only be used on a Macro Button or Operation.

Properties

Property Name	Description
Relative Address	The relative address to set to the current browser window, without refreshing the content. This value will be appended to the end of the current origin.
Store in browser history	If True, the updated address should be added as an entry in the browser's session history. When stored, the user can navigate backwards and forwards to this address.
Notify page content	Whether the parent page should be notified that the address has been updated, via a popstate event. The Special Variable DWCurrentClientUrl will update regardless of this setting.

Examples

Property Name	Example Rule	Meaning
Relative Address	"#hello"	Will append #hello to the current URL For example: https://www.company.com/run.html?project=MyProject&specificationId=97#hello
Store in browser history	True (checked)	Will store the appended URL in the browser history.
Notify page content	True (checked)	Will notify the parent page of the updated URL.

Property Name

Example Rule

Meaning

Relative Address

"#hello"

Will append #hello to the current URL

For example:

https://www.company.com/run.html?project=MyProject&specificationId=97#hello

Store in browser history

True (checked)

Will store the appended URL in the browser history.

Notify page content

True (checked)

Will notify the parent page of the updated URL.

Using the Task in a Specification Macro

This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.

Outputs are only available within Specification Macros.

Status Outputs

This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs.

The status output navigation is as follows:

Success

Task ran successfully.

Success with Warnings

N/A - Should never be fulfilled

Failed

No Relative Address specified.

DriveWorks Pro 24 Update Current Browser Address