Using Popups

You can use popups to design interactive analytic applications and dashboards.

Context

The popup helps application users to quickly enter information, perform configurations, or make selections. You can also use them to display more specific data for a selected item displayed on the main page of the application. Because the popup acts as a container widget, you can put any other widget into the popup, such as a table, button, or checkbox.

As an application designer, you can choose to design a popup starting from scratch, or enable the header and footer setting to turn the popup directly into a popup dialog that has a consistent look and feel compared to other dialogs in SAP Analytics Cloud stories.

Procedure

  1. In the Outline panel, expand Layout and click the button right next to Popups to create a new popup.

    Its icon and a default name are displayed under the Popups.

  2. Double-click the new popup and rename it.
  3. If you want to turn the popup into a dialog, go to the Designer panel and choose the Builder tab. In the Popup Settings, turn on the Enable header & footer option. Otherwise, skip to step 5.
  4. Optional: If you want to change the dialog title, add or remove buttons, change the IDs and descriptions of the buttons, or customize the button details such as visible or not, enabled or not, and highlighted or not, do so in the Builder panel, then click Apply to apply all the settings.
  5. Design the popup by adding widgets to the popup, such as dropdown boxes, tables, or charts. These widgets are the visualization of the popup. If no widgets are added, even if you save the empty popup to the analytic application you won't see the popup displayed when you trigger it while running the analytic application.

    For pop-up dialogs, you can only add widgets to areas other than the header and footer.

  6. Edit the style of the popup in the Styling panel; for instance, to change the popup's height and width.
    Note

    The height and width you set won't take effect if you add only one widget to the popup. To run the popup as designed, make sure you add more than one widget to the popup.

  7. Add a script to the popup by clicking the widget corresponding to the popup in the Outline panel and selecting the button.
    The script editor opens in a new tab where you can add scripts.
    Note
    In the script editor you can use the value help for data-related values when writing scripts. Consider the following points when using this value help:
    • The value help is always available for data-related widgets, such as tables and charts, in the main canvas.

    • For widgets in popups, the value help is only available after the popup has been opened at least once:
      • If you add a widget in a popup initially, the value help is available.

      • If you save an analytic application with tables or charts in a popup and reopen it, the value help is not available in the popup for these widgets unless you open the popup at least once in design time.

  8. To return to the popup itself or to the main canvas, click the button and choose your popup or the main canvas.
  9. To delete the popup, choose the button next to your popup in the Outline panel and choose (Delete).