This type of widget belongs to the Basic category in the widget library. It is used to add an action button, activated when clicked, to access a web page or another app, open the messaging system, display a secondary information window, zoom in on an image, open a link for downloading a file, etc.

The action is assigned to the button using a URL.

Notes

   see General remarks on widgets

• The behavior of the different display options in the Target property depends on the Web browser used.

Best Practice

• The name of the action button is in non-formatted text. To modify its font or add an image, you should use the Secured HTML widget.
• To add buttons for navigating between the pages of an app, you can use the Page widget provided for this purpose.
• Avoid adding an excessive number of buttons that open secondary windows. These should be reserved for providing additional information, increasing the size of an image or providing contextual help.

Example

        button  ==>  Opens the messaging system with a preloaded email -     see Examples of messaging system settings

List of properties

Content

Label: Name of the action button. Enter the code directly in the field or click  to open the text editor.

URL to Load: URL of the object to be opened using the action button. If you want to display information, its display area will depend on the Target attribute.

Target: If the action button is used to view information, this attribute is used to define its display area:

• New Window: In a new window (popup) or in a new browser tab.
• Replace Window: In the current frame.
• Parent Window: In the frame's parent window.
• Top Window: In the current window.

Theme

     see Properties description

Procedure

How to retrieve the launch URL of an app

1. In the App Gallery, click  next to the app you want to run.

2. In the graphic editor, click  in the toolbar.

3. Copy the app launch URL.

4. Return on your app and paste the URL:

• either in the URL property of a hyperlink inserted on a Label, Header/Footer or HTML Code properties of a widget (via  in the text editor);

• or in the URL to Load property of the Button widget ;

• or in the Data > Select Link Type property of the Menu widget.

Examples to configure the opening of the messaging system

The messaging system is opened using the mailto link followed by certain settings. A new message window will automatically open. Certain fields will be preloaded, e.g. recipient email address, subject, etc.
Notes: To insert carriage returns: %0d%0a. To insert spaces: %20.

• To preload the email addresses of several recipients: Note: Use the comma to separate email addresses.
      mailto:p.smith@society.com,j.martin@society.com

• To preload the recipient name:
      mailto:Paul%20Smith%20<p.smith@society.com>

• To preload the recipient on copy (Cc) and on blind copy (Bcc):
      mailto:p.smith@society.com?cc=j.martin@society.com&bcc=h.lewis@society.com

• To preload the subject of the message:
      mailto:p.smith@society.com?subject=Our%20Next%20Meeting

• To preload the message content:
      mailto:p.smith@society.com?body=Hello%0d%0aHere%20are%20the%20minutes%20of%20our%20next%20meeting%0d%0aRegards

• You can combine different settings:
      mailto:p.smith@society.com?cc=j.martin@society.com&bcc=h.lewis@society.com&subject=Our%20Next%20Meeting&body=Hello%0d%0aHere%20are%20the%20minutes%20of%20our%20next%20meeting%0d%0aRegards

Integration example

• Cisco WebEx