Open Link (Click to Navigate)

What it is and what it's for

Open Link runs when a user clicks its component at runtime. Choose Internal page, External URL, System menu, or Run script under Destination.

How to use it: editor fields

Drag Open Link onto the target component, open the editor, and choose Destination. Fill the fields for the selected target type:

• Internal page: enter an exported page file such as Main.html in Page address, or click Select PPT page... to choose from this presentation. Relative addresses resolve from the current exported page and must stay within the asset root.
• External URL: select this destination for a complete external or intranet URL, then fill the fields shown for that mode.
• System menu: select this destination for a host menu and confirm the target configured in the host.
• Run script: use this when the destination depends on runtime state or the click combines actions.
• Open options: choose HMI window or Page only, then set Fullscreen and New tab as needed.
• Parameters (optional): add Key / Value pairs only when the destination needs context.

// Run script: choose a page by state
if (ReadTagBoolean("PLC_LINE01.PUMP01.FAULT", false)) {
  hqVisuDesigner.openPage("alarm_overview");
} else {
  hqVisuDesigner.openPage("production_overview");
}

Parameters: sending values and reading them on the destination

For Internal page, add Key / Value rows under Parameters when the destination needs context. A scripted openPage call may supply strings, numbers, booleans, or null; the destination reads text values. Repeated keys keep their original order.

• Editor sender: select Internal page and add Key / Value rows.
• Script sender: hqVisuDesigner.openPage(pageCode, { frameTarget, parameters }); parameters must be an array, not a plain object.
• Read the first value: GetPageParameter("PLC", "").
• Read every repeated value: GetPageParameterValues("Area").
• Read every parameter in original order: GetPageParameters().
• The equivalent hqVisuDesigner.getPageParameter / getPageParameterValues / getPageParameters methods are also available.

// Source page: navigate within the package and pass context
hqVisuDesigner.openPage("device_details", {
  frameTarget: "frame",
  parameters: [
    { key: "PLC", value: "PLC_LINE01" },
    { key: "Device", value: "PUMP_01" },
    { key: "Area", value: "AREA01" },
    { key: "Area", value: "AREA02" }
  ]
});

// Destination Page Script
var plc = GetPageParameter("PLC", "");
var device = GetPageParameter("Device", "");
var areas = GetPageParameterValues("Area");

When to use it

Use it to switch pages or open content, for example:

• A Pump Details button on the overview page: use Internal page to select the exported Pump page.
• For a host menu, choose System menu and verify its target in the host.
• For a help, work-order, or reporting site, choose External URL and enter an address reachable at runtime.
• For a static help page in the same package, enter its exported page address under Internal page.
• For a destination computed from live state, use Run script.