3DDashboard Widgets

A widget is an app that you can add to a dashboard to enrich the functional scope of your dashboard.

This page discusses:

See Also
Managing Widgets

Run Your App

This widget lets you create your own apps by entering the app URL. You can develop your own apps to fit your specific needs. To know how to develop widgets, read the 3DEXPERIENCE Developer Assistance .

Widget Preferences

Widget URL: Provides the URL where your app is stored.

Feed Reader

For more information, see Information Intelligence: Dashboard Intelligence: Dashboard Intelligence: Feed Reader.

Web Notes

This widget lets you add multiple notes to your dashboard in the same widget. Click Add new note to create a note. You can enter up to 50,000 characters using a basic rich text editor along with a formatting toolbar. Select a note to access the note toolbar.

Important: If another user tries to edit a note you are currently editing, your changes will not be erased by his own modifications. The content edition is blocked until he refreshes the widget.

Widget Preferences

  • Title: Provides the widget title.
  • Set editor toolbar position as fixed. Fixes the editor toolbar at the top of the note body.

6WTags and search interactions

You can search within the titles and the body of the notes. The strings that match the search criteria are highlighted in the titles, and bodies of the displayed notes.

Important: You cannot add a new note from the search result list.

Widget Interactions

Action or Command Description
Adds a new note.

Edit your note content, and format your text using the rich text editor toolbar.

Note: If the title or the body of the note are too long, an ellipsis is automatically added at the end of the text that appears in the left pane.
Note Toolbar It appears on the upper-right of the note body when you select a note on the left pane. It gives you access to the following:
  • Edit color: Changes the color of the note. Click it and select a new color. Click Close to exit the color palette..

    The default color is white.

  • Rename: Edits the note title.

    Press Enter to validate your modifications.

    Note: You can edit the title by clicking it or in the widget preferences' Title field

  • Delete: Deletes the note.

    Click OK to validate.

Notes:
  • While you edit your note, this keeps blinking, both on the note itself and on the footer of the note, until your modifications are saved. The icon disappears once the note is saved.
  • If the note is not up to date and you refresh its content, this icon is displayed along the given note, click it and select one of the choices proposed on the right pane. You can either refresh and lose your changes, or duplicate the note.
  • The creation and update dates are displayed at the bottom right of the note along with the number of maximum characters left.
Move / Merge / Duplicate

Hover your mouse over a note in the list to access Move.

It ets you:
  • Drag the note to another position in the list within the current widget.
  • Merge the content of two different notes or with the note itself. On the note you want to merge, hold Move, and drop it to the Drop note here to merge it section that appears in the target note on the right pane.

  • Duplicate a note. Select a note in the list, and drop it to the Drop note here to duplicate it section that appears on the top of the list of notes.
Back Collapses the note details in the right pane and displays the list of notes only.

Click a note in the list to edit it.
Toggle Collapse When a note is selected, collapses the list of notes in the left pane and displays the selected note only.
Toggle Collapse Deploys the list of notes in the left pane without losing the selected page details.

Web Page Reader

This widget lets you embed the content of a web page or a PDF file.

Important:
  • External web pages which do not belong to your platform might not be embedded. This may happen because some web sites do not allow their web pages to be embedded.
  • If the target URL is a PDF file stored in a server requiring authentication, the file might not be displayed.

Widget Preferences

The widget preferences are listed below:

Preference: Description
Title: Provides the title of the web page.
Web URL: Provides the URL of the page or PDF file you want to display.
Important: We recommend you use the SSL (Secured Socket Layer) protocol to avoid loading unsafe scripts. Otherwise, you will have to allow your browser to load unsafe scripts. For example, enter https://www.3ds.com instead of http://www.3ds.com.
Scrolling: Activate or deactivate the web page scrolling. The default value is Auto .

6WTags and search interactions

—No interactions are available for this widget.—

Calculator

This widget lets you perform standard calculations such as divisions, subtractions, multiplications, additions, and advanced scientific capabilities.

Widget preferences: —No preferences are available for this widget.—

6WTags and search interactions: —No interactions are available for this widget.—

Mail

This widget lets you read your emails from your dashboard using IMAP (Internet Message Access Protocol) or POP (Post Office Protocol).

Important:
  • You have to allow less secure applications to access your Yahoo email account, otherwise you will not be able to fetch any email. For more information, see Yahoo documentation.
  • Gmail credentials are managed by Google in a dedicated pop-up. For more information, see Google documentation.

Widget Preferences

The widget preferences are listed below:

Preference Description
Title: Provides a title for your account. The title may be useful if you set several mail accounts.
Protocol: Select IMAP or POP.
SSL: Selected by default. Unselect the SSL protocol option if your mail account does not require this protocol to be activated.
Server: Provides the server name. For example, imap.myemailprovider.com. When you add the widget to a dashboard for the first time, some popular email services like Gmail, Yahoo, and Outlook are proposed. You just have to enter your personal information to start reading your emails.
Login: Provides your email account login.
Note: Gmail login must be provided in the Gmail pop-up.
Password: Provides your email account password.
Note: Gmail password must be provided in the Gmail pop-up.
Display profile pictures If a sender uses an avatar, it displays his profile picture.

Widget Interactions:

Action or Command Description
Collapses the email details in the right pane and displays the list of emails only.
Collapses the list of emails in the left pane and displays the selected email only.
Deploys the list of emails in the left pane without losing the selected email details.


Replies to the sender.


Replies to the sender and all other recipients.

6WTags and search interactions:

You can create user-defined tags for this widget. For more information about user-defined tags and search interactions, see 3DEXPERIENCE Basics: 6WTags and Maximize Widgets.

Automatically extracted tags are generated on each email:

6WTags Lets you filter your search results by...
Who > Originator sender.
When > Created received date.
How > State read / unread IMAP flag status.
How > Flagged flagged (follow-up) IMAP flag.
How > With the number of enclosures for emails containing attached files.
Important:
  • Filtering and searching only work on emails that are displayed in the widget.
  • The search functionality does not launch a search on the server.

Metrics Reader

This widget lets you create charts based on JSON or CSV well-formatted files data.

Note: This widget is available if you use an on-premises or a virtual private cloud solution. For more information about the Metrics Reader widget available for a public cloud solution, please see Information Intelligence: Dashboard Intelligence: Metrics Reader

The first time you add this widget to a dashboard, a wizard lets you quickly set the data source and the chart options. To provide the data that will be used in your chart, do either of the following:

  • Enter the URL of the source data. This is the option selected by default. If you select this option, an optional refresh value can be selected in the Refresh list.
  • Paste data from a JSON or CSV file
  • Drag and drop the source file to the Drop file here section that appears when you drag the source file over the widget.

Once you have provided the data source you can select the chart type. Review Data and Chart Options let you edit the data content and chart options before validating the final version.

You can easily edit either the data or chart options by clicking the Edit icon in the top right corner of the widget. The available options are described below:

  • Chart options:
    • Title . (optional) Enter the name of the widget. This name appears in the header of the widget.
    • Chart Name . (optional) Enter the name that appears above the chart.
    • Chart Type . Select one of the available charts below:
      • Line
      • Column
      • Pie
      • Donut
      • Table
    • Show advanced options:
      • Optional: X Axis:
        • Optional: Title . (optional) Enter the name of the x-axis.
        • Optional: Type . (optional) Select one of the options below:
          • Optional: Linear . Option selected by default.
          • Optional: Date:/ Time. (optional) If you select this option the numbers are displayed in milliseconds. This option is only compatible with JSON data.
          • Category . Enter a category name.
      • Optional: Y Axis:
        • Optional: Title . (optional) Enter the name of the y-axis.
      • Optional: Data unit . (optional) Enter the unit of the chart values.
      • Stacking type:
        • None
        • Normal . Applies stacking by value.
        • Percent . Applies stacking by percentage.
      • Preview . Displays a preview of the chart before saving your changes. By default, if the set of data is too large, only the first ranges are displayed. Click Show all data to display a full data preview.
    • Hide advanced options
  • Optional: Data content:
    • Enter URL Enter a new URL of a JSON or CSV file containing the new data source.
    • Paste data or drag a file Paste the new data from a JSON or CSV file into the Paste your data here... section.
    • Use existing data Default option. It displays a read-only version of the data. You must select the Paste data or drag a file: option above to edit the existing data.

6WTags and search interactions

Depending on the type of data you provide, you can use 6WTags to search and filter the widget content. You can create user-defined tags for this widget. For more information about user-defined tags and search interactions, see 3DEXPERIENCE Basics: 6WTags and Maximize Widgets.

Search interactions—No interactions are available for this widget.—.

Note: If you run a search after selecting the Search In Current Dashboard filter, the widget is greyed.

The following automatically extracted tags may be generated:

6WTags Lets you filter your search results by...
When > Ends and Starts end and start dates.
What > Type graph type or x-axis type.
What > Unit of Measure graph units.
What > Constituent series names.
What > Category category.