Skip to main content

​
Overview

Open Browser Link opens a web address so trainees can access reference documents, manuals, or external tools. Add the action to a transition triggered by the trainee tapping a scene object. Leave Destination Step unset when opening the resource should keep the trainee in the current step.

​
When to Use

  • Link to reference documents or downloadable PDFs
  • Direct learners to safety data sheets (SDS) or compliance documents
  • Link to company intranet pages or knowledge bases
  • Reference external tools or websites related to the training

​
Parameters

​
Query Parameters and Preview URL

Under Query Parameters (Optional), enter a Parameter name and a value, then click Add parameter (+) or press Enter. You can edit an existing value or use Delete parameter to remove its row. To change a parameter name, delete the row and add it again with the new name. Use variables you have created and assigned before the action runs. For example, {{equipmentId}} inserts the current value of the equipmentId variable. Preview URL shows the configured URL and query values. It displays variable placeholders as entered; it does not substitute their runtime values or test whether the destination is reachable. Check the actual opened URL during training.

​
Example: Open a Maintenance Checklist

A trainee is inspecting equipment and can tap a help object to open a maintenance checklist. Use an existing scene object as the tap target and replace the example URL with your checklist’s address.
1

Create the tap transition

Select the inspection step and open Transitions. Add a transition, then add a Tap event targeting the help object in the scene.
2

Add Open Browser Link

Expand the transition’s Actions list. Click Add Action and choose Open Browser Link under Variables & Logic.
3

Enter the checklist URL

Set URL to https://docs.example.com/checklists/maintenance. Leave Query Parameters (Optional) empty unless the destination requires them.
4

Keep the trainee in the inspection step

Leave Destination Step unset. The transition opens the checklist without moving the trainee to a completion step.
5

Save and test

Save the training, then test the tap on the intended device. After reviewing the checklist, return to the training app on HMD or the original training tab in Web Trainee App.
Opening the checklist does not mark the inspection as complete. Keep the transition for completing the inspection separate from the transition that opens the link.

​
Example: Open a Manual for the Current Equipment

Create a String variable named equipmentId. Before the trainee can trigger the link, use Set Variable with Set Value to assign PUMP-07. Configure Open Browser Link with URL set to https://docs.example.com/manual and these query parameters: When the action runs with equipmentId set to PUMP-07, it opens:
The example assumes the destination accepts equipment and language parameters. Use the address and parameter names supported by your actual resource.

​
Execution and Browser Behavior

  • Opening is not a completion check: The action does not confirm that the trainee has read the resource or completed the linked task.
  • Web execution completes immediately: In Web Trainee App, the action completes after attempting to open the link. Wait Until Complete does not wait for the page to load, be read, or close; subsequent actions can run.
  • The transition controls navigation: If you configure a destination step, the transition can advance to it without waiting for the trainee to finish with the external resource.
  • Popups may be blocked in Web Trainee App: Prefer a link opened by a trainee’s tap. If no tab opens, check the browser’s popup notification and allow popups for the training site before trying again. Opening a link automatically in On Entry is more likely to be blocked.

​
Best Practices

  • Use full web addresses: Enter https:// or http:// URLs.
  • Explain the resource: Use Show Text or Show Panel to tell trainees which scene object opens it and how to return to training.
  • Check access: Verify the resource is reachable from the trainee’s device and network, including any intranet or sign-in requirements.
  • Test each target platform: Check opening the link, returning to training, and any query parameters on HMD and Web Trainee App as applicable.
  • Show Panel — Display instructions about the external resource
  • Show Text — Explain how to open the resource and return to training
  • Set Variable — Assign values used in query parameters