Web Browser - Navigate

Declaration

<AMWEBBROWSER ACTIVITY="navigate" SESSION="text" URL="text" />

Related Topics   

Description

Navigates to a specific page URL in an established web browser session.

NOTE:
  • The Web Browser action is not backwards compatible with the Web Browser (Legacy) action.
  • Automation with the Web Browser action is only compatible with Internet Explorer, Chrome, Edge, and Firefox browsers.
  • The browser you specify must be updated to the latest version and installed on the target system to ensure the Web Browser action functions correctly.
  • Unlike other session-based actions where sessions are optional, the use of a session in the Web Browser action is required as each created session explicitly links to a specific web browser instance. A session is created using the Web Browser - Create session or Web Browser - Open activity. Numerous sessions are supported within a single task, however, since Web Browser actions are performed interactively (and not in the background), each session must run concurrently to avoid sending interactions to the wrong browser window.

Practical Usage

Normally used to navigate from one URL to another. This activity simulates the process of manually entering a URL in a web browser's address bar and pressing Enter.

Parameters

Browser

Property Type Required Default Markup Description
Session name Text Yes BrowserSession1 SESSION="mySession" The existing session to use with this activity. Numerous sessions can exist within a single task which allows several web browser operations to be performed simultaneously on separate browser windows.
NOTE: Sessions are supported in Internet Explorer, Chrome, Edge, and Firefox browsers only. Firefox does not require a separate extension to be installed with this version of the Web Browser action.
Page URL Text Yes (Empty) URL="www.helpsystems.com" The URL to use with this activity (for example, www.helpsystems.com or https://www.helpsystems.com).

Description

Error Causes

On Error

Example

NOTE:
  • The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
  • Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.

Description

This sample task opens a Firefox web browser window set to http://www.google.com/ and then navigates to https://www.helpsystems.com/product-lines/automate.

Copy 
<AMWEBBROWSER URL="www.google.com" BROWSER="firefox" SESSION="BrowserSession1" />
<AMWEBBROWSER ACTIVITY="navigate" SESSION="BrowserSession1" URL="https://www.helpsystems.com/product-lines/automate" />