Contents

IS_Action_SetForeground

Definition

This action brings the Scripter window to the top of all applications that are open on the desktop when an event happens in the page that is loaded in Scripter. Scripter will recognize click events from any HTML element whose name has an associated action documented in this API (e.g.: "IS_Action_CallComplete"). If the script needs to associate several buttons with the same action, then define the action using a meta element and call the click event on the meta element from the button(s).

Attributes

[callback]

The callback property ensures that this action executes asynchronously in Interaction Connect. Starting with 2018 R3, all Interaction Scripter actions (IS_Actions) provide a callback property for use in Connect scripts only. In the example below, statements inside the highlighted callback function block execute only after the action completes. The callback will return an error if the action fails. See Writing custom scripts for Interaction Connect or Scripter .NET.

Here's how to use the .callback property in a script for Interaction Connect:

function IS_Action_SetForeground() {
  IS_Action_SetForeground.callback = function(error) {
    if (error) {
      console.error("IS_Action_SetForeground failed.");
    } else {
      console.log("IS_Action_SetForeground succeeded.");
    }
  }
}

Example

<head>
    <meta name="IS_Action_SetForeground">
    <script language=javascript>
        window.onload = SetForeground;
        function SetForeground() {
            IS_Action_SetForeground.click();
        }
    </script>
</head>