Open topic with navigation

Softdial Scripter™ Page Editor

Button

Button control

Fig. 1 - Button control

An on-screen button for the user to perform the action specified in the ButtonAction property (see below).

Properties that are common to this and many other controls are described in Common Properties.

ClosedButton properties

Property Description
Background See Common Properties
BorderBrush See Common Properties
BorderThickness See Common Properties
ButtonAction Determines what happens when the user clicks the button.
ClosedMore details

Fig. 2 shows the options available.

Button Action Options

Fig. 2 - Button Action Options

The available options can be separated into the following categories:

ClosedNavigation

OptionDescription
BackButtonStops processing the current step and moves to the previous step.
OutcomeThe script (flow chart) moves to the next step using the specified ButtonOutcome.
MoveToStepJumps to the step defined in the StepName field.
ClosedShow example

The following example is part of the Hotel demo script, and describes a typical application (Fig. 3):

Changing Script Flow 1

Fig. 3 - Changing Script Flow 1

This script has a Greeting screen step which is the first page displayed, and a Select (Select Room Page) screenstep (bottom right of script). In this example, we will move the script execution from the Select screenstep to the Greeting screen step.

  1. In the Script Resources window, double click the Select screen to open the Select Room Page screen in Page Editor (Fig. 4).

    Changing Script Flow 2

    Fig. 4 - Changing Script Flow 2

  2. Place a button from the Toolbox onto the page.
  3. In the Properties window, there are two new Properties (Fig. 5) that allow script flow redirection:
    1. ButtonAction - change this to MovetoStep
    2. StepName - enter the name of the step to which you want to move (e.g. Greeting)

    Changing Script Flow 3

    Fig. 5 - Changing Script Flow 3

  4. Save the changes
  5. Publish the script. On the Select page, when the Go To Greeting button is pressed, the script will now redirect to the Greeting page .
ClosedCall Control

OptionDescription
ToggleRecordStarts / Stops the Call Recording function. See the Request Recording [RR] message
ToggleMuteStarts / Stops the Recording Mute function. See the Request Mute [RM] message
ToggleHoldPuts the call on Hold or takes the call off Hold. See the Request Hold [RH] message
EndcallEnds the current call, finishes the script and returns the agent to the 'Waiting' state. See the Transaction Complete [TC] message
BeginDialDeprecated Call Control Outcomes -
Now replaced by Script Steps but retained for backwards compatibility.
Don'tDial
AcceptCalls
RejectCalls
ClosedAgent Control
OptionDescription
BreakRequestSends a request to CallGem to go on break. See the Agent Unavailable [AU] message
ClosedCall Outcome Presets

OptionDescription
AnsweringMachineEnds the current call and puts the agent to the Wrapping state. See the Start Wrap [SW] message.
For the system campaign, this ends the current call and also finishes the script.
FaxMachine
SIT
ButtonOutcome A user-defined outcome, which is then available as a screen step outcome in the script (flowchart)

To enable, ButtonAction must be set to the value Outcome.
ButtonShortcut Assigns the button action to a keyboard F key (i.e. F1 to F12)
Content Defines the text to display on the button
FontFamily See Common Properties
FontSize See Common Properties
FontStyle See Common Properties
FontWeight See Common Properties
Foreground See Common Properties
Height See Common Properties
IsEnabled See Common Properties
Language See Common Properties
Margin See Common Properties
Name See Common Properties
StepName The target step if the ButtonAction is MoveToStep
TabIndex See Common Properties
Validate If checked, the button will be disabled until valid values are entered into all ValidationTextBox controls present on the page
Visibility See Common Properties
Width See Common Properties
ClosedAssigning actions to buttons

Toolbox button example

Fig. 6 - Toolbox button example

The example in Fig. 6 shows a button control (Next) being positioned on a screen. The function of the new button here is to move forward in the script to the next screen in the script.

To configure the button to do this, the ButtonAction property is set to Outcome. This means that when the user clicks this button, the script step ends with the outcome defined in the ButtonOutcome field.

  • The ButtonOutcome configured for the screen determines the next step in the script (flow chart).
  • The Content field defines the text shown on the button control itself, in this case Next.

The term 'Outcome' used in the ButtonAction field refers to the Screen Step Outcome, not the Call Outcome (see Call Outcome Presets below).

See also the ImageButton control.

 

Copyright © 2004 - 2019  Sytel Limited