Button Widget


Apps - Widget - Button icon.png  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

Open url.png  see General remarks on widgets

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

Best Practice big icon.pngBest 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

      EVApps - widget Button - Example.png button  ==>  Opens the messaging system with a preloaded email -   Open url.png  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 Apps - Edit Html icon.png 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.
         Example documentation icon EN.png  

  • You want to display the Logo - EasyVista.png website:  URL = http://easyvista.com
  • You want to open the user's messaging system:  URL = mailto:support@easyvista.com?subject=Information request

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

  Open url.png  see Properties description

Procedure

How to retrieve the launch URL of an app

1. In the App Gallery, click Apps - Application properties icon.png next to the app you want to run.

2. In the graphic editor, click EVApps - GUI - Share icon.png in the toolbar.

             EVApps - GUI - Share Apps.png

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 Apps - Text Editor - Hyperlink icon.png 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 Logo - Cisco WebEx.png

Tags:
Last modified by Unknown User on 2017/07/25 11:37
Created by Administrator XWiki on 2014/09/02 11:43

Shortcuts

Recent Updates

Haven't been here in a while? Here's what changed recently:

-   Product name - ev itsm.png
-   Product name - ev sas.png

Interesting Content

How to Automate Integration
Add a Shortcut to an App
History
Quick Dashboard
Full text search - Stop Words

Powered by XWiki ©, EasyVista 2018