Appboard/2.5/builder/widgets/actions/show data tip: Difference between revisions

imported>Cmace
(action filtering based on data source, not data collection)
 
imported>Jason.nicholls
m (1 revision)
 
(No difference)

Latest revision as of 15:52, 26 June 2014

The Show Data Tip Action displays a pop-up box that lists selected fields and values for records in a Widget's Data Collection. This Action is available under both "Mouse Click" and "Mouse Hover" types and allows for the display of additional information about a node in a Widget without having to drill down to another Widget.


Show Data Tip Example


How To Create a Show Data Tip Action

For instructions on adding an Action to a Widget, see the general instructions in How To Create an Action in a Widget.


How To Configure a Show Data Tip Action

Show Data Tip Configuration


  1. Follow the instructions above to create the Action in the Widget Actions panel.
  2. Name: Enter a name for this Action. For convenience, a default name is provided. The Name is not used anywhere else in AppBoard, and only displayed on this configuration page.
  3. On selection of:
    1. Select "any" or "specific" for the type of data selection by the User that will trigger the Action. When selecting "specific", perform the following additional steps:
      1. Click the Filter button. The Filter Editor is displayed.
      2. Click Add Rule to create one or more rules that indicate what data should trigger the Action, when selected.
      3. Click Close to save the Filter settings.
    2. Select the Data Source name. When the Widget is run, selection of data in this Data Source will trigger the Action.
  4. Show Data Tip: Drag and drop the fields from the list on the left to the area to the right. Once the fields are in the right section they can be rearranged by dragging from the upper left corner of the row and dropping once the bold white line is displayed in the desired area.
    1. Display Name: The default display name will be set as the "Field Name", but you can enter a different name to be displayed for the field in the Data Tip.
    2. Date Format: Only for DATE fields, this allows the displayed date format to be changed. The system ships with a large list of formats but this can also be extended, see the Client Date Formats documentation.
  5. Click Close to exit.

Show widget generated data tip string: This option will be available if your action is for one of the Chart Widgets or the Table Widget's Sparkline Renderer. When selected it will concatenate the widget's default data tip string with what is selected in the show data tip section.

Sample Use Case

In many instances, it is useful to be able to access more extensive details on records without having them displayed in the body of the Widget. For example, in a map displaying each of the offices for a company it would be useful to be able to access information such as how many employees work in each office, how much money each office has produced in sales, and what jobs are in demand at each office. However, it would not be possible or visually appropriate to have these details listed in the map. Instead, a Show Data Tip Action can be set to show these details when the user moves the pointer over the node for an office, or the user clicks on a node.