FVS Jumping to Web Links/Pop-up Box Events

  • Last update:August 09, 2024
  • Overview

    This document is applicable to users who have installed the FineVis Data Visualization plugin to learn operations related to FVS dashboards.

    Version

    Report Server Version

    Plugin Version

    Functional Change

    11.0

    V1.X

    /

    11.0.16

    V2.0.0

    Merged the original pop-up box and web link events into the 

    URL/Pop-up Box entry. 

    Changed the opening method of the dialog box option to the pop-up box option.

    11.0.22V2.6.1

    Added Text Prompt to Content Event for title and image 

    components, allowing you to input text directly.

    Added Triangle Arrow (display method) and Corner Radius to Style.

    Supported Style setting for mobile terminals.

    Application Scenarios

    1. You can open a webpage/another template and pass parameters in the current window/a new window or through a popup box and pass parameters by clicking the title component, the series/classification of the chart component, or the three-dimensional component data layer in the FVS template.

    2. You want a pop-up box for some simple text explanation when clicking a component.

    The following figure shows the effect.

    1.2.gif

    Function Introduction

    Select a component, choose Interaction > Click > Add Click Event URL/Pop-up Box to add an event in the pop-up setting box.

    iconNote:
    Add Click Event is not supported in some components.

    2 1).png

    Event Name

    You can customize the event name which cannot be empty or the same as that of the event in the current component.

    Opening Type

    Opening Type supports New Window, Current Window, and Pop-up. When selecting Pop-up, you can set Style for it.

    iconNote:
    If you open a template mounted in the decision-making platform, with Opening Type set to New Window or Current Window, you will open the new tab page or the current tab page of the platform.

    Content URL

    iconNote:
    The previous setting will not be saved if you switch the content URL type after you set the content. You are advised to proceed with caution.

    URL

    URL supports both absolute and relative paths and also allows for inserting formulas into paths.

    Type

    Description

    Example

    Absolute path

    Webpage: Ensures that the current server can assess the URL.

    https://community.finereport.com/

    Template: Ensures that the current server can assess the 

    template path.

    http://localhost:8075/webroot/decision/view/report?viewlet=GettingStarted.cpt

    Relative path

    Webpage: Saves resource files to the path 

    %FR_HOME%\webapps\webroot.

    /webroot/1.png

    Template: Saves template files to the path 

    %FR_HOME%\webapps\webroot\WEB-INF\reportlets.

    General report:

    /webroot/decision/view/report?viewlet=

    GettingStarted.cpt

    FVS template:

    /webroot/decision/view/duchamp?viewlet=The First FVS Dashboard.fvs

    Template Link

    After you select Template Link, the Select Template button appears on the right. You can click the button to choose any report files in the current project.

    dc2f6ca0251120dc4d0c6cb79bf903a.png

    You can also manually input and suffix a template path. For example, you can suffix &op=write to the path of the .cpt data entry template.

    b3dda6bfa1ca989e12f782575d960ad.png

    Text Prompt

    In version 2.6.1 and later, you can add Text Prompt (always taking effect when Opening Type is set to Pop-up) for title or image components.

    The use of text prompts is consistent with that of rich text components. You can directly input text and add formulas.

    0a8c73cdedbb03e7af9abb152d04561.png

    Parameter

    Parameter addition is supported when Content URL is set to URL/Template Link. Three parameter types are supported:

    Parameter Type

    Parameter Content

    Component Field

    You can combine parameter content with component content, 

    such as map area names and column chart series names.

    Custom Formula

    You can input formula content.

    Custom Content

    You can input text content.

    cc7a106ceded7ac7d673578e5cc2b7b.png

    Style

    You can set styles of pop-ups for PC/mobile terminals separately when Opening Type is set to Pop-up.

    You need to click the ef4d7c73a66f7a68757701979b230d0.png or 3fa5a783e816a38dbed3501cecd9b31.png icon in the top toolbar of the template to switch to the corresponding mode before going to the event to set Style.

    iconNote:
    In version 2.6.1 and earlier, pop-ups on mobile terminals are displayed in a fixed style and cannot be set.

    The following table describes each setting item.

    Settings

    Description

    Display Position

    You can select Centered Display or Dynamic Display. For mobile terminals, when Content URL is set to URL/Template Link, Display Position is fixed as Centered Display.

    Display Method

    You can set Display Method (namely the connection effect between the trigger object and the pop-up 

    box) when setting Display Position to Dynamic Display.

    You can set Association Line or Triangle Arrow. For mobile terminals, Display Method is fixed as 

    Triangle Arrow.

    2eb871295e664ae3e9fcf195ce1fba0.png  40903c48c6f8043c57875f1ddc01eee.png

    You can set the color for Association Line/Triangle Arrow. You can set the opacity of the color, 

    and when the opacity value is set to 0, the association line/triangle arrow can be hidden.

    e70c14c16ba6851a7f2e1d838e497d0.png

    Size

    You can set the size for the pop-up box.

    PC: The width and height of the pop-up box can be set in pixels (px).

    Mobile terminal: You can select Custom Width/Height or Height Adaptation and set 

    Pop-up Screen Proportion for Mobile and Pad terminals separately.

    Title

    You can select or deselect Display Title (event name). You can set the font style, color, and alignment 

    method for the title text.

    Border Background

    You can set None, Color, Resource Center, and Custom Upload.

    The setting method is the same as that of the component border background.

    Padding

    You can set the distance between the content and the edges of the pop-up box.

    Corner Radius

    You can set the corner radius of the pop-up box.

    Example

    Template Creation

    Choose File > New FineVis Visualization Dashboard to create a blank dashboard, select Template Style as the light theme in Built-in Style, and click Create Dashboard.

    6578dd20ac7c73ea28658743048327c.png

    Data Preparation

    2. Create a database query ds1 with the SQL query statement SELECT * FROM Sales_Volume.

    图片2.png

    Component Addition

    1. Add a title component, an image component, and a pie chart component to the canvas and adjust their sizes and layout.

    2. Save the image 1714375012597549.png to the local, click the image component, select Type as Custom Upload on the right panel, upload the image, and select it for use.

    be5a4ff61163d270584bc5a0c9b3440.png

    3. Click the pie chart component, select Dateset as ds1, select Category as None, select Series as Region, and select Value as Sales_Volume.

    12bc51fdcf0eb36abc28fba9303392b.png

    Web Link/Pop-up Box Event Setting

    Setting a Text Prompt Pop-up Box for the Image Component

    1. Click the image component and choose Interaction > Add Click Event > URL/Pop-up Box.

    2. Set Event Name, set Opening Type to Pop-up, set Content URL to Text Prompt, and input the text that needs to be prompted.

    3. Select the text content, modify the text color, and set the alignment methods to left-right centering and vertical centering.

    3.4.1.png

    4. Click Style and set Display Position to Dynamic Display, as shown in the following figure.

    图片4.png

    Setting a Template Link Pop-up Box for the Pie Chart Component

    1. Click the pie chart component and choose Interaction > Add Click Event > URL/Pop-up Box.

    2. Set Event Name, set Opening Type to Pop-up, and set Content URL to Template Link.

    3. Click Select Template and select the designer built-in template GettingStartedEN.cpt.

    4. Set Parameter Name to Region (same as the parameter name in the template GettingStartedEN.cpt), set Parameter Type to Component Field, and set Parameter Content to Series Name.

    3.4.2.png

    5. Click Style and set Display Position to Centered Display, as shown in the following figure.

    图片6.png

    Style Setting for Mobile Terminals

    1. Click the 3fa5a783e816a38dbed3501cecd9b31.png icon to switch to the mobile mode, click the image component, click Interaction on the right panel, click the c83da7e58ba0aaf2703e2d8c0f5fb08.png icon to go to the setting box, and click Style to perform style setting for mobile terminals and pad terminals

    2. Set Display Position to Dynamic Display, set Size to Mobile, select Height Adaptation from the drop-down list, and set Pop-up Screen Proportion to 40 (%).

    3. Keep other settings default to inherit the PC terminal settings. (You can modify the settings if you want.)

    175bdaa65fcfde8ee68102251f4acd5.png

    4. Keep the settings default for the pie chart component. (For mobile terminals, Display Position is fixed as Centered Display, with the size remaining the default value. Other settings inherit from the ones for PC terminals.)

    09dd87189886eef98f8ad175f2c41ad.png

    Effect Display

    PC

    Save the template and click the Preview button in the upper right corner to preview it. The effect is shown in section "Application Scenario."

    Mobile Terminals

    For details about preview methods, see FVS Template Preview and Mounting. The following figure shows the effect.

    iconNote:
    To obtain the mobile terminal effect of this example, you need to enable Reset Phone Layout and Reset Tablet Layout, and combine the title component with the image component. For details, see FVS Mobile Attribute.

    222.gif

    Template Downloading

    You can download the sample template: FVS Example of Jumping to Web Link or Popup Box.fvs.

    Recommended Document

    DocumentIntroduction
    FVS Clicking 3D Component to Trigger Pop-up Box

    Adds the web link/pop-up box event to the 3D component data layer. Then you 

    can click the 3D component model to trigger the pop-up box for more content 

    display.

    FVS Achieving Navigation to Different Web Links

    Uses the JavaScript event to navigate to different web links based on different

    parameters.


    Attachment List


    Theme: FineVis Data Visualization
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy