IoT Platform User Guide
Insights
Reporting and visualization workspace with folders, visualizations, and supported report types.
The Insights module is the reporting and visualization workspace for operational analytics. It helps teams organize content into folders, open existing visualizations, and create new analytics assets from supported sources. This area is intended to turn device and workflow data into decision-ready dashboards and views.
In the current platform, Insights supports a hierarchical browsing model: top-level folders, folder-level subfolders/visualizations, and a dedicated visualization view. Users can search, sort, star frequently used items, and manage folder or visualization metadata from context menus. Creation flows are action-driven through the New button and modals.
Open Insights
To open the Insights module, do the following:
- In the left sidebar, click
InsightsunderOperations. - Confirm the page title is
Insights. - Confirm the top-right actions include
NewandAsk Optra.
Understand the Insights Home View
The home view is designed for fast access. Recents provides recently updated folders/visualizations, while the table provides the full library. This layout helps users continue recent analysis work quickly and still manage a large catalog.
- Review
Recentsfor recently used insight folders. - Use the search box
Search folders and visualizations...to filter results. - Use table sorting by clicking sortable column headers.
- Use the star icon to mark or unmark frequently used folders.
Create a New Folder (Home)
To create a new folder from Insights home, do the following:
- On the Insights home page, click
New. - In the
New foldermodal, enterName. - Click
Save. - The system opens the new folder for next actions.
Open a Folder and Use Library Controls
Inside a folder, the page shows breadcrumbs, recents, library controls, and a combined table of subfolders and visualizations. This lets users manage structure and content without switching screens. The Starred quick toggle supports frequent access workflows for shared teams.
- Click any folder row to open it.
- Use breadcrumbs to navigate back to parent locations.
- Review
RecentsandLibraryin the folder context. - Toggle
Starredfor the current folder context when needed. - Use search:
Search folders and visualizations...in folder views.Search visualizations...in subfolder views.
Create New Insight Content from Folder Context
To create insight content from folder context, do the following:
- Inside a folder, click
New. - In
New insight, choose one:New folderNew visualization
- If creating a folder, enter a name and click
Save. - If creating a visualization, choose a supported report type and complete required fields.
Create a New Visualization
The New Visualization flow supports multiple source types depending on enabled features. This allows organizations to consolidate analytics content while preserving source-specific configuration paths.
- Open
New visualizationfrom folder context. - Select a report type (availability depends on feature enablement), such as:
PowerBI ReportSuperset ReportTableauWebpage EmbeddedVisualization
- Provide required source fields for the selected type.
- Complete the create flow and save.
- Open the created visualization from the table or recents list.
Edit or Delete Folders and Visualizations
To edit or delete folders and visualizations, do the following:
- In the insights table, open the row menu (
...) for the target item. - Click
Editto update metadata. - Click
Deleteto remove the item. - Confirm deletion in the confirmation modal.
- If deleting a folder, note that nested folders/visualizations are also deleted.
Work with Visualization View
When a visualization is opened, users can navigate back, star/unstar, and manage that item from the header. Depending on type, the page renders embedded source content (for example Power BI, Superset, Tableau, embedded site, or internal visualization).
- Open a visualization from folder or recents.
- Use the back button to return to folder view.
- Use the star icon to mark/unmark the visualization context.
- Use row/header menu actions to
EditorDeletethe visualization.