Administration Access
Where do I find the Powersheet configuration pages in Polarion?
Powersheet administration pages are integrated into Polarion’s standard administration interface under the Administration > Nextedy POWERSHEET section. From there you can access:- Domain Models — manage domain model YAML files
- Sheet Configurations — manage sheet configuration YAML files
- Setup — initial Powersheet setup and configuration
- License — license management
What is the difference between global and project-specific configurations?
Powersheet supports two configuration scopes for both domain models and sheet configurations. Global configurations are stored at the repository level and are available to all projects — they appear with a “(Global)” suffix in the configuration picker. Project-specific configurations are stored within an individual project and are only available in that project context. Project configurations supplement or override global ones.Configuration Editor
What scopes does the configuration editor support?
The built-in configuration editor supports three scopes for managing configuration files:| Scope | Description |
|---|---|
instance | Per-instance override for a specific document |
template | Template-level configuration shared across documents |
default | Global defaults applied when no override exists |
ENABLED, DISALLOWED, or DISABLED depending on your permissions and the current editing context.
Does the editor support JSON Schema validation?
Yes. The configuration editor can attach a JSON Schema to validate your YAML content as you type. This provides real-time feedback on configuration errors, missing required fields, and invalid property values. The schema is auto-generated from the domain model definition, ensuring that your configuration references valid Polarion prototypes and entity types.Can I switch between YAML and JSON in the editor?
The editor supports both YAML and JSON as configuration languages. You can switch between them, and the content is automatically converted when you change the language setting. By default, the editor uses YAML (lang: yaml). Your language preference is saved in your browser and persists across sessions.
Additional editor features such as line wrapping and keyboard mode preferences are available in the editor toolbar.
Sheet Configuration Assignment
How does a Powersheet document find its configuration file?
Each Powersheet document has a custom field (nextedySheetConfig) that references a sheet configuration YAML file. Powersheet scans both the global and project-specific configuration directories for available YAML files and populates a picklist from which you select the desired configuration. If no configuration is selected, the document uses a bundled default configuration (powersheet.yaml).
Can I share a configuration across multiple documents?
Yes. Sheet configurations are stored as standalone YAML files in the repository, independent of any specific document. Multiple Powersheet documents can reference the same configuration file through theirnextedySheetConfig custom field. This is the recommended approach for maintaining consistency across related documents in a project.
How do I update the configuration for an existing document?
You can change a document’s sheet configuration by updating thenextedySheetConfig custom field on the document, either through the Polarion work item editor or programmatically. You can also edit the configuration YAML directly through Administration > Nextedy POWERSHEET > Sheet Configurations, which will affect all documents referencing that configuration.
See Creating Your First Sheet Configuration for a guided walkthrough.
Sources
Sources
Source Code
SchemaGenerator.javaprod-powersheet-src/com.nextedy.editor/src/types.d.tsprod-powersheet-src/com.nextedy.powersheet.client/cypress/e2e/admin/admin.cy.tsprod-powersheet-src/com.nextedy.powersheet.client/cypress/e2e/userFlows/multiple-entity-type-flow.cy.tsprod-powersheet-src/com.nextedy.powersheet/src/com/nextedy/powersheet/enumProvider/SheetConfigEnumProvider.java