Dashboard Overview
The Documentation Space Dashboard implements a Polarion wiki page using Nextedy Solutions macros to provide:
- Macro Library Navigation — Access to the shared Velocity macro library (
nextedy_solutions.vm) containing all reusable UI components
- Data Model Reference — Links to complete RTM domain model documentation showing work item type relationships
- V-Model Process Guide — Navigation to ISO 26262 V-model development lifecycle documentation
- Space Branding — Consistent visual identity for the Documentation space using branded headers and footers
- Help and Support Links — Quick navigation to PowerSheet documentation and external support resources
Dashboard Components
| Property | Type | Value | Description |
|---|
| Macro | String | #nxSpaceBanner() | Nextedy macro for branded space headers |
| Level | Integer | 2 | Heading level (h2) for the banner title |
| Title | String | "Documentation" | Space name displayed in banner |
| Description | String | "Macro Library, Data Model, and V-Model Process Reference" | Subtitle text describing space purpose |
| Primary Color | Hex | #424242 | Main banner background color (dark gray) |
| Secondary Color | Hex | #616161 | Accent color for visual elements (medium gray) |
| Purpose | String | Branding | Creates visual separation and consistent space identity across all solution dashboards |
The banner renders as an HTML5 <section> element with inline CSS styling applied by the Nextedy macro. Icon, title, and description are left-aligned with primary color background and white text.
Macro Library Link Card
| Property | Type | Default | Description |
|---|
| Card Title | String | "Macro Library Reference" | Navigation card headline |
| Card Description | String | "Reusable Velocity components for dashboards" | Brief description of macro library purpose |
| Target URL | String | /polarion/#/project/TA/wiki/nextedy_solutions | Wiki page containing the shared Velocity macro library |
| Icon | String | :fontawesome-solid-code: | Font Awesome icon for code/development |
| Implementation | Velocity Macro | #nxLinkCard() | Nextedy card component macro |
Purpose: The macro library (nextedy_solutions.vm) is the foundation for all Nextedy dashboard customization, providing reusable UI components including:
#nxSpaceBanner() — Branded space headers
#nxLinkCoverage() — Traceability coverage calculations
#nxKpiCard() — Key performance indicator displays
#nxStatCount() — Live work item counts
#nxDocInventoryTree() — Hierarchical document navigation
#nxCoverageBar() — Progress bars with drill-down queries
#nxRiskMatrix() — Risk assessment matrices
#nxCommonStyles() — CSS injection for consistent styling
Configuration Pattern:
#import('nextedy_solutions.vm')
#nxInit()
#nxCommonStyles()
## Define card content
#set($cardTitle = 'Macro Library Reference')
#set($cardUrl = '/polarion/#/project/TA/wiki/nextedy_solutions')
#nxLinkCard($cardTitle, 'Reusable Velocity components', $cardUrl, 'code')
Data Model Reference Link Card
| Property | Type | Default | Description |
|---|
| Card Title | String | "Data Model Reference" | Card headline |
| Description | String | "Work item types, relationships, and RTM domain model" | Describes data model content |
| Target URL | String | /polarion/#/project/TA/wiki/data-model-overview | Link to data model documentation |
| Icon | String | :fontawesome-solid-diagram-project: | Diagram/model icon |
| Content Scope | String | Reference | Documents complete RTM domain model including entity types, relationships, cardinality constraints |
Data Model Scope: The reference page documents:
- Entity Types — All 25+ work item types (requirement, hazard, failure mode, test case, etc.)
- Relationships — Link roles between entities (refines, verifies, validates, mitigates, assesses)
- Cardinality — One-to-many vs. many-to-many relationship patterns
- Expansion Paths — PowerSheet entity expansion rules for hierarchical queries
- Custom Fields — Domain-specific properties (severity, occurrence, detection, ASIL, etc.)
The RTM domain model is the contract between Risksheet/PowerSheet configurations and Lucene queries. Any changes to work item types, link roles, or custom fields must be reflected across all three systems to maintain data consistency.
V-Model Process Guide Link Card
| Property | Type | Default | Description |
|---|
| Card Title | String | "V-Model Process Guide" | Navigation card title |
| Description | String | "ISO 26262 development lifecycle, traceability, and documentation" | Describes V-model content |
| Target URL | String | /polarion/#/project/TA/wiki/v-model-methodology | Link to V-model documentation |
| Icon | String | :fontawesome-solid-code-branch: | Branch/flow icon representing V-model structure |
| Content Type | String | Concept | Explains ISO 26262 V-model methodology |
V-Model Phases Documented:
The V-model documentation explains:
- Requirements Phase — Customer (CRs) and System Requirements (SysReqs) definition
- Design Phase — Design Requirements (DesReqs), Functions, Characteristics decomposition
- Implementation Phase — Failure modes, risk controls, design solutions
- Verification Phase — Test cases linked via
verifies relationship to requirements and design elements
- Validation Phase — End-to-end validation linked via
validates relationship to customer requirements
- Traceability Requirements — ISO 26262 Part 8 Clause 6 bidirectional traceability across V-model phases
Link Cards Grid Layout
| Property | Type | Value | Description |
|---|
| Macro | String | #nxLinkCardsGrid() | Container macro for card layout |
| Layout Type | String | CSS Grid | Responsive grid with 3 cards per row on desktop |
| Card Component | Macro | #nxLinkCard() | Individual card macro nested within grid |
| End Marker | Macro | #nxLinkCardsGridEnd() | Closing macro for grid container |
| Spacing | Integer | 16px | Gap between cards (standard MkDocs Material spacing) |
| Responsive Behavior | String | Mobile-first | 1 column on mobile, 2 on tablet, 3 on desktop |
Markup Pattern:
#nxLinkCardsGrid()
#nxLinkCard('Macro Library Reference', 'Reusable Velocity components', $url1, 'code')
#nxLinkCard('Data Model Reference', 'Work item types and relationships', $url2, 'diagram')
#nxLinkCard('V-Model Process Guide', 'ISO 26262 development lifecycle', $url3, 'branch')
#nxLinkCardsGridEnd()
| Property | Type | Value | Description |
|---|
| Macro | String | #nxSectionHeader() | Nextedy macro for visual section breaks |
| Parameter | String | Section title | The text displayed in the section header |
| Visual Style | String | Bold, left-aligned | Creates visual hierarchy and readability |
| Use Cases | String | Multiple | Separating dashboard sections for clarity |
Example Usage:
#nxSectionHeader('Reference Documentation')
#nxSectionHeader('Quick Links')
#nxSectionHeader('Macro Library')
| Property | Type | Default | Description |
|---|
| Widget Type | String | scriptBlock | Polarion script block widget for custom HTML/JavaScript |
| Redirect URL | String | https://go.nextedy.com/powersheet-support-portal | External PowerSheet documentation portal |
| Redirect Delay | Integer | 2000 (ms) | Time to display transitional message before navigation |
| Message | String | "Redirecting to PowerSheet Help..." | User-facing message during redirect |
| JavaScript Implementation | String | setTimeout() | Client-side navigation using standard browser API |
| Pattern | String | Help redirect | Maintains in-context access to external resources |
Implementation Pattern:
<div id="redirect-container">
<p>Redirecting to PowerSheet Help Portal...</p>
<p>If you are not redirected automatically,
<a href="https://go.nextedy.com/powersheet-support-portal" target="_blank">
click here to continue
</a>.
</p>
</div>
<script>
setTimeout(function() {
window.location = 'https://go.nextedy.com/powersheet-support-portal';
}, 2000);
</script>
PowerSheet documentation is hosted externally rather than in-Polarion to maintain a centralized support portal. Users accessing PowerSheet help from within Polarion are redirected automatically. If the external portal is unavailable, provide a fallback link to local documentation.
| Property | Type | Value | Description |
|---|
| Macro | String | #nxSpaceFooter() | Nextedy macro for consistent footer branding |
| Implementation | Velocity Macro | Part of Nextedy Solutions library | Renders standardized footer across all solution dashboards |
| Purpose | String | Branding and licensing | Displays solution footer with copyright and licensing information |
| Placement | String | Bottom of page | Pairs with #nxSpaceBanner() at page top for frame consistency |
Dashboard Layout Structure
Configuration Properties
Nextedy Solution Initialization
| Property | Type | Required | Description |
|---|
| Import Statement | Velocity | Yes | #import('nextedy_solutions.vm') — loads macro library |
| nxInit() Call | Macro | Yes | Must be called before other Nextedy macros; sets up context |
| nxCommonStyles() Call | Macro | Yes | Injects CSS for consistent dashboard styling |
| Project Prefix | String | Yes | Project prefix (e.g., TA for TestAuto2) used in Lucene queries |
| Space ID | String | No | Optional space filter for document inventory queries |
Page Header Template:
#import('nextedy_solutions.vm')
#nxInit()
#nxCommonStyles()
#set($projectId = $context.getProject().getKey())
#set($spaceId = 'Documentation')
Color Scheme
| Element | Hex Code | RGB | Usage |
|---|
| Primary | #424242 | 66, 66, 66 | Space banner background, headers |
| Secondary | #616161 | 97, 97, 97 | Accent colors, borders |
| Text Primary | #FFFFFF | 255, 255, 255 | Banner text, light backgrounds |
| Text Secondary | #212121 | 33, 33, 33 | Card text, standard content |
| Hover State | #303030 | 48, 48, 48 | Interactive element hover |
Link Resolution
| Link Type | Pattern | Example | Resolution |
|---|
| Wiki Page | /polarion/#/project/TA/wiki/<PageName> | /polarion/#/project/TA/wiki/nextedy_solutions | Direct wiki page navigation |
| Space Page | /polarion/#/project/TA/wiki/<SpaceName>/<PageName> | /polarion/#/project/TA/wiki/Documentation/Macro Library | Page within specific space |
| External URL | https://go.nextedy.com/<path> | https://go.nextedy.com/powersheet-support-portal | External support portal |
| Relative Path | Relative to wiki root | ../reference/data-model.md | Not used in Polarion wiki (use absolute paths) |
Space and page names with spaces must be URL-encoded (e.g., %20 for space). Alternatively, use Polarion’s $utils.urlencode() Velocity function for dynamic URL generation.
Navigation and Discovery
Documentation Space Purpose
The Documentation Space consolidates all reference materials for TestAuto2 — Automotive Safety Solution:
- Macro Library — Foundation for all Nextedy dashboard customization and UI components
- Data Model Reference — Complete RTM domain model documentation (entity types, relationships, constraints)
- V-Model Methodology — ISO 26262 development process and traceability requirements
- Standards Compliance — Links to ISO 26262, AIAG-VDA FMEA, IATF 16949, SOTIF guidance
- PowerSheet Help — Redirect to external PowerSheet documentation portal
- Configuration Guides — Risksheet/PowerSheet customization patterns and best practices
Access Patterns
| User Role | Entry Point | Typical Actions |
|---|
| Documentation Engineer | Home Dashboard → Documentation Space | Review macro library, reference data model, check V-model phases |
| System Administrator | Documentation Space → Macro Library | Customize dashboard widgets, add new macros |
| Safety Engineer | Documentation Space → V-Model Guide | Understand traceability requirements, link types |
| Design Engineer | Documentation Space → Data Model | Reference work item types, custom field definitions |
| All Users | Home Dashboard quick links | Access PowerSheet help, macro reference |
Velocity Script Integration
Standard Page Template
#import('nextedy_solutions.vm')
#nxInit()
#nxCommonStyles()
#set($projectKey = $context.getProject().getKey())
#set($spaceKey = 'Documentation')
## Render space banner
#nxSpaceBanner(2, 'Documentation', 'Macro Library, Data Model, and V-Model Process Reference', '#424242', '#616161')
## Render link cards
#nxLinkCardsGrid()
#set($cardUrl1 = "/polarion/#/project/${projectKey}/wiki/nextedy_solutions")
#nxLinkCard('Macro Library Reference', 'Reusable Velocity components for dashboards', $cardUrl1, 'code')
#set($cardUrl2 = "/polarion/#/project/${projectKey}/wiki/data-model-reference")
#nxLinkCard('Data Model Reference', 'Work item types, relationships, and RTM domain model', $cardUrl2, 'diagram')
#set($cardUrl3 = "/polarion/#/project/${projectKey}/wiki/v-model-methodology")
#nxLinkCard('V-Model Process Guide', 'ISO 26262 development lifecycle, traceability, and documentation', $cardUrl3, 'branch')
#nxLinkCardsGridEnd()
## Render space footer
#nxSpaceFooter()
Related Pages
| Property | Value |
|---|
| Solution | TestAuto2 — Automotive Safety Solution |
| Last Updated | February 2026 |
| Supported Polarion Versions | 2021+, 2022+, 2023+, 2024+ |
| Nextedy Solutions Version | 3.x+ |
| Dependencies | nextedy_solutions.vm macro library |