Toolbar Layout
The toolbar is automatically rendered when a Powersheet document loads. It integrates with the document context, configuration, and permissions to determine which actions are available to the current user.Toolbar Actions
| Action | Description | Permission Required |
|---|---|---|
| Save | Persists all pending entity changes to Polarion | Editor |
| Refresh | Reloads data from the server without losing unsaved changes | Viewer |
| Views | Opens the Views Selector for switching column presets | Viewer |
| Export | Exports visible data to file format | Viewer |
| Import | Imports data from external file | Editor |
| Edit Config | Opens the YAML configuration editor | Administrator |
| Help | Opens documentation or context help | Viewer |
The exact set of toolbar buttons may vary depending on the Powersheet version, document permissions, and license status. The actions listed above represent the standard toolbar configuration.
Permission-Based Visibility
Toolbar actions are conditionally displayed based on the current user’s permissions:| Permission Level | Available Actions |
|---|---|
| Viewer | Refresh, Views, Export, Help |
| Editor | All Viewer actions + Save, Import |
| Administrator | All Editor actions + Edit Config |
Menu Integration
The toolbar integrates with the Menu system to provide additional actions through dropdown menus. Menu items are context-aware and adapt based on:- Current user permissions (viewer, editor, administrator)
- Document configuration
- Entity selection state
Data Guard
The toolbar and all sheet content are protected by a data initialization guard that prevents rendering until:- Document context is loaded (project, revision)
- Configuration is parsed (YAML sheet configuration)
- Metadata is fetched (domain model, entity types)
- Data sources are resolved (query parameters, dynamic values)
Document Context
The toolbar operates within the document context, which provides:| Context | Description |
|---|---|
| Document | Current Powersheet document identifier |
| Revision | Current data revision (for baseline queries) |
| Project | Active Polarion project |
| Configuration | Parsed YAML sheet configuration |
| Permissions | User access level for the current document |
License Panel
Below the sheet data area, a license status panel displays the current Nextedy POWERSHEET license state:| State | Display |
|---|---|
| Valid | No banner (or minimal indicator) |
| Trial | Trial period banner with remaining days |
| Expired | Expiration warning with link to obtain license |
| Invalid | Error banner with license troubleshooting link |
Configuration
The toolbar itself is not directly configurable via YAML. Its behavior is driven by the document configuration, access control settings, and the available views and sources defined in the sheet configuration.Related Configuration
Related Pages
- Menu — Context and ribbon menu items
- Views Selector — View switching interface
- Review Changes — Change tracking before save
- Sort and Filter — Column sorting and filtering
- Views — View configuration in sheet YAML
Sources
Sources
KB ArticlesSource Code
prod-powersheet-src/com.nextedy.powersheet.client/src/modules/Powersheet/Powersheet.tsxprod-powersheet-src/com.nextedy.powersheet.client/ltc-repo/packages/common/types/domain/document.ts