Dashboard Widgets
The previous section, Customizing the Dashboard, gave a high level overview of the dashboard types, how to create new personal dashboards, edit the dashboard layout, and remove personal dashboards. This section will give an overview of how to work with individual Widgets, and options available in each Widget type.
Before you begin working with individual Widgets, make sure that you have reviewed the information contained in Customizing the Dashboard and are familiar with the tasks outlined there.
Working with Widgets
Adding Dashboard Widgets
To add a widget to personalize your dashboard, click on the "Add Widget" button at the top of the page.
Then, click on the name of the Widget you want to appear on your page. It will automatically be added into the leftmost column of your page.
Some Widgets may only have one instance per dashboard, whereas other Widgets may be able to have multiple instances per dashboard. The Add New Widget dialog will only show you the widgets you have available to add.
For detailed information on each individual Widget, view the Available Widgets section on this page.
Move a Widget:
Individual Widgets may be moved around the page by clicking and dragging on the "Move" icon on the right side of the Widget header.
While mousing over the move icon (when the cursor changes to a hand icon) click and hold your left mouse button, then drag the widget up or down to the desired location.
To move the Widget to another column, drag the widget sideways to the column, then up to briefly hover over a Widget already in the desired column (this "selects" the column for the Widget). Then, drop the Widget in the desired location in that column.
Maximize / Pop-Out a Widget:
Widgets can temporarily be viewed at a larger size by hitting the "Maximize" icon on the Widget header. This will "pop out" the widget information to a larger page size for easier viewing.
While maximized, you may interact with the widget as normal. When done, hit the "Close" button.
Edit a Widget (Widget Action Menu):
To open the edit menu for a widget, click on the Action Menu (wrench icon) on the right side of the Widget header. A drop down menu will appear with some of the following options:
Edit: Opens an edit widget pop up, where widget-specific options may be changed. Options may include changing the title, links, applicable resources, and so forth depending on the particular Widget.
Resize: For Widgets able to be resized vertically, brings up a draggable black bar at the bottom of the widget. Drag the bar up or down to the desired widget height, then select the Action Menu again and click on "Save Resize" to save and complete the size edit.
Save Resize: Available only after the "Resize" action has been used. After resizing a Widget, selecting the Action Menu again and clicking on "Save Resize" will save the Widget size.
Delete: Deletes the widget.
Available Widgets
Activity Chart (Admin only)
Illustrates activity level for API, IPAM, DNS, Peering, and Resource areas of ProVision. The Activity Chart is only visible to Admin users. Only one Activity Chart Widget may exist on a dashboard.
Activity Chart Actions:
Radio Buttons: Select the desired ProVision activity area to view by clicking on the radio buttons (API, IPAM, DNS, Peering, or Resources).
Chart: While hovering over the chart, you can:
Use the Scroll Wheel to zoom in or out of the date/time detail level
Double click to zoom into the next date/time detail level
Click & Drag left or right to move to an earlier or later date/time at the current zoom level
Single Click on a bubble will show the activity detail, and resource / IP block links if applicable.
Activity Chart Edit Options:
Title: Edits the title of the Widget shown on the header.
Resource Tree
Interactive graphical display of the resource structure for a parent resource.
Resource Tree Actions:
Users may:
Click & Drag to move the chart within the Widget,
Use the Scroll Wheel to zoom in or out
Click on Filled dots to expand the tree to show the children of that resource.
Double click on a resource in the tree to give you the option to navigate to the resource's entry page.
Resource Tree Edit Options:
Title: Edits the title of the Widget shown on the header.
Orientation: Select "Horizontal" to view the tree in horizontal form, with the top level resource on the leftmost side of the widget, and children expanding to the right. "Vertical" will show the tree with the top level parent at the top of the widget, with children expanding downward.
Resource: A text search box to select the resource that will be the top level resource for the tree.
When done editing, hit "Apply" to save your changes, or "Cancel" to exit without saving.
IP Charts
Illustrates the percentage of assigned, unassigned, allocated, and holding tank hosts for 1918 / IPv4 / IPv6 space out of the total available hosts in ProVision viewable by the user.
Hovering over a particular status will display detailed data in the center of the chart for that status type.
IP Charts Edit Options:
Title: Edits the title of the Widget shown on the header.
IPAM Stats
The IPAM Stats widget contains read-only IPAM data on host count by status, assigned date range, assignment rate, and projected runout under three tabs.
Users may select to view IPv4, IPv6, or 1918 stats by clicking on the tab for the block type you wish to view.
RSS Feed
Shows the most recent five entries of a selected RSS Feed. Feed links open in a new window when clicked.
RSS Feed Edit Options:
Title: Edits the title of the Widget shown on the header.
Feed URL: Edits the URL of the RSS Feed to show.
Status
Shows 6connect ProVision status information, including number of user accounts (admin only), number of admin accounts (admin only), current version number, and a link to the "Coming Soon" section of the ProVision documentation.
Status Edit Options:
Title: Edits the title of the Widget shown on the header.
Clock
Shows the current time for the selected time zone.
Clock Edit Options:
Title: Edits the title of the Widget shown on the header.
Time Pattern: Sets the desired format for the current time. Example: "HH:mm:ss z" shows hours, then minutes, then seconds, then time zone.
Date Pattern: Sets the desired format for the current date. Example: "YYYY-MM-DD" shows 4 digit year, then month, then day.
Time Zone: The desired time zone to show the current time for.
Contact Us
Provides support email, phone, and feedback form information. Only one Contact Us Widget may exist on a dashboard.
Contact Us Edit Options:
Title: Edits the title of the Widget shown on the header.
Feedback Email: Sets the desired email address for the feedback form.
Markdown
The Markdown Widget is a blank slate where users may add links, text, or other content through use of the Markdown language. Multiple Markdown Widgets may exist on a dashboard.
Markdown Edit Options:
Title: Edits the title of the Widget shown on the header.
Markdown Content: Area to enter the markdown content.
Links
Provides a list of website links. Multiple Links Widgets may exist on a dashboard.
Link Edit Options:
Title: Edits the title of the Widget shown on the header.
Links: Enter the desired link text, then the URL of the website to link. Click "Add" to add a new link, or "Remove" to remove an individual link. Hit "Apply" to save your changes.
iFrame
Set a https URL to be viewed in an iFrame. Useful to view stats or commonly referenced websites.
iFrame Edit Options:
Title: Edits the title of the Widget shown on the header.
URL: Sets the desired https address of the website to display in the frame
Advanced:
Sandboxing: Allow Scripts: Check to allow scripts.
Not all webpages allow themselves to be embedded into iframes. If the target server has set X-Frame-Options or CSP directives to prevent embedding, the widget will appear blank.