Specification Detail Page

A specification's detail page, by default, shows a structured view of the specification and all chapters, comments, and requirements (and all sub requirements, test cases, and parameters for the requirement) associated with the specification.

Note: The Structure View page for a chapter contains the same columns and actions as the specification's detail page.

Required access roles:

  • Baseline: Reader, Author, or Leader

To access this page from a specifications list, select the specification name. See Requirement Specifications Page.

To access this page for a chapter:

  1. Open the chapter. See Opening a Chapter.
  2. From the navigation pane, select Structure View.

This topic describes:

This page discusses:

Columns

Column Name Description
Title The object's short descriptive title. This title is used in all lists in which the specification appears. The icon identifies the type of object:

Icon Meaning


Specification
Chapter


Comment
Requirement
Sub Requirement
Test Case
Parameter

Click the title to open the item in a new browser window.

Revision The current revision level of the object. indicates that there is a higher revision of the item.
Content A free-form area that contains rich content for requirements and comments. By default, you can use the XHTML controls to format text, add tables and graphics, link to external resources, and so on. See Editing Rich Content.
(Refining Requirements) indicates that this requirement does not refine other requirements.

indicates that this requirement refines other requirements (that is, it is a downstream requirement). The number indicates how many other requirements this requirement refines. The color of the number's highlight indicates the worst status of the links to the requirements that this requirement refines:

Number color Meaning
Green The worst link status is "Valid."
Yellow The worst link status is "Suspect."
Red The worst link status is "Invalid."

Note: This column is blank for all item types other than requirements.
(Covered Requirements) indicates that this requirement does not cover other requirements.

indicates that this requirement covers other requirements (that is, it is downstream from other requirements). The number indicates how many requirements this requirement covers. The color of the number's highlight indicates the worst status of the links to the requirements that this requirement covers:

Number color Meaning
Green The worst link status is "Valid."
Yellow The worst link status is "Suspect."
Red The worst link status is "Invalid."

Note: This column is blank for all item types other than requirements.
Classification Identifies the requirement classification:

Status Meaning
Functional This is a functional requirement.
Non-functional This is a non-functional requirement.
Constraint This requirement has a constraint.
None There is no classification for this requirement.

Note: This column is blank for all item types other than requirements.
State Indicates the current lifecycle state of the item.
Indicates whether a change order is associated with the item.
(Reserve State) Indicates whether the specification is reserved by a user:

Icon Meaning


The specification is reserved by you.


The specification is reserved by another user.

(Parenthood Status) Indicates the status of the link between sub requirements and the parent requirement:

Icon Meaning
The worst status of all links to sub requirements is "Valid".
The worst status of all links to sub requirements is "Suspect".
The worst status of all links to sub requirements is "Invalid".
The worst status of all links to parent requirements is "Valid".
The worst status of all links to parent requirements is "Suspect".
The worst status of all links to parent requirements is "Invalid".
The requirement is not allocated to another requirement as a child or parent.

Double arrows indicate requirement objects are connected at both the "From" and "To" sides. The colors indicate the parenthood link status of each side of the connection.

(Difficulty) Indicates the difficulty of the requirement:

Icon Meaning
Low difficulty
Medium difficulty
High difficulty

Note: This column is blank for all item types other than requirements.
(Priority) Indicates the priority of the requirement:

Icon Meaning


Low priority


Medium priority


High priority


Urgent priority


Pre-assigned priority

Note: This column is blank for all item types other than requirements.
Validation Indicates, in the following order, the number of test cases associated with the requirement that have:
  • Not yet been replayed (in blue)
  • Partially passed validation (in yellow)
  • Failed validation (in red)
  • Passed validation (in green)
Note: This column is blank for all item types other than requirements.
Owner The person who owns the object.
Configuration Context The configuration context that is required to configure the product revision or feature option effectivity associated with this object. See Configuring Criteria.
Variant/Option

Only has a value when variant/option and evolution effectivity have been uncoupled.

The uncoupled variant and option effectivity expression defined for the requirement specification. You can edit the effectivity in this cell when the page is in Edit mode.
Note: You can edit the effectivity in this cell when the page is in Edit mode.
Evolution

Only has a value when variant/option and evolution effectivity have not been uncoupled.

The coupled effectivity expression defined for the requirement specification.

Note: You can edit the effectivity in this cell when the page is in Edit mode.

Actions Menu/Toolbar Commands

Required responsibilities:

  • Baseline: Leader (when the object is in the Frozen state) or Author

Action Description
Insert New > Chapter Creates a new chapter and links it to the specification.
Insert New > Comment Creates a new comment and links it to the specification.
Insert New > Requirement Creates a new requirement and links it to the specification.
Insert New > Sub Requirement Creates a new sub requirement and links it to the requirement.
Insert Existing > Chapter Links an existing chapter to the specification.
Insert Existing > Comment Links an existing comment to the specification.
Insert Existing > Requirement Links an existing requirement to the specification.
Insert Existing > Sub Requirement Links an existing sub requirement to the requirement.
Configuration Management > Add Contexts Adds a model configuration context to the selected items.
Configuration Management > Remove Contexts Removes the model's configuration context from the selected items. Select OK to confirm.
Structure Compare Compares objects from the same specification or folder to those in the same or another specification or folder.
Import Existing Structure Creates a requirement specification by importing existing structure (chapters, comments, requirements, and parameters) from another specification.
Spec Structure History Opens the history of objects added to and removed from the specification structure in a new browser window.
Subscribe Allows you to select the events for which you would like to be notified for the selected requirements.
Change > Change Request > Add to Existing Adds the selected objects to an existing change request.
Change > Change Request > Add to New Creates a new change request and adds the selected objects to it.
Change > Change Order > Add to Existing Adds the selected objects to an existing change order.
Change > Change Order > Add to New Creates a new change order and adds the selected objects to it.
Change > Change Action > Add to Existing Adds the selected objects to an existing change order.
Change > Change Action > Add to New Creates a new change order and adds the selected objects to it.
Change > Mass Release Releases all selected objects. Selected objects must be in a state prior to "Released" and cannot be connected to an incomplete change action. The Create Change Order page opens where you can create a change order to govern the mass change. You must use the "Fast track Change" policy.
Change > Mass Obsolete Makes all selected objects obsolete. Selected objects must be in the "Released" state and cannot be connected to an incomplete change action. The Create Change Order page opens where you can create a change order to govern the mass change. You must use the "Fast track Change" policy.
Revision Creates a new revision of the root requirement in the structure.
Replace by New Revision Creates a new revision of the selected object in this location in the structure.
Replace by Last Revision Links the latest revision of the selected object in this location in the structure.
Reserve Reserves the selected items so that they cannot be edited or deleted by another user.
Unreserve Unreserves the selected items so that can be edited or deleted by another user.
Delete/Remove > Delete Selected Objects Removes all selected objects from the specification structure and deletes them from the database. Click OK to confirm.
Note: You cannot delete a specification or requirement that includes objects reserved by another user.
Delete/Remove > Delete Selected Object and Children Removes all selected objects and their children from the specification structure and deletes them from the database. Click OK to confirm.
Note: You cannot delete a specification or requirement that includes objects reserved by another user.
Delete/Remove > Detach from Structure Removes the selected objects from the specification structure, but does not delete them from the database. Click OK to confirm.
Link Sub/Downstream Requirement > Mark as Source Marks the selected requirement as the source of either a sub requirement or downstream requirement.
Link Sub/Downstream Requirement > Link as Downstream Requirement Links the selected requirement as a downstream requirement of the marked source requirement.
Link Sub/Downstream Requirement > Link as Sub Requirement Links the selected requirement as a sub requirement of the marked source requirement.
Export to Word Exports the specification and all associated chapters, comments, and requirements as a Microsoft Word document in the same format that is used to import specifications and requirements from Word.
Important: This app creates reports or generates content that contains personal data. Manage these in accordance with good personal data treatment practices.
Mass Promote Mass promotes all selected objects to the next lifecycle state.
Mass Demote Mass demotes all selected objects to the previous lifecycle state.
Search within Context Searches for and highlights child objects of the selected object without having to expand the structure.
Expand Rich Text Expands the Content column to show all rich text content for the requirements associated with the specification.
Requirement Specification QuickCharts Opens the Requirement Specification QuickCharts panel.

Contextual Menu for Specifications

Right-click on any specification in the structure display or in the Structure View to access the available contextual commands.

Required responsibilities:

  • Baseline: Leader (when the object is in the Frozen state) or Author

Action Description
Expand All Expands all of the objects under the selected specification.
Collapse All Collapses all of the objects under the selected specification.
Select Direct Children Selects all of the direct children objects of the specification.
Unselect Direct Children Unselects the direct children objects of the specification.
Select All Descendants Selects all descendant objects (children and their children) of the specification.
Unselect All Descendants Unselects all descendant objects (children and their children) of the specification.
Insert New > Chapter Creates a new chapter from scratch and links it to the specification.
Insert New > Comment Creates a new comment from scratch and links it to the specification.
Insert New > Requirement Creates a new requirement from scratch and links it to the specification.
Insert Existing > Chapter Links an existing chapter to the specification.
Insert Existing > Comment Links an existing comment to the specification.
Insert Existing > Requirement Links an existing requirement to the specification.
Attributes Shows the property attributes of the specification.
Lifecycle Shows the Lifecycle, Tasks/Signatures, and Approvals tabs of the specification in a new window.
Add to Collection > Add to Clipboard Adds the selected specification to your clipboard.
Add to Collection > New/Add to Collections Adds the selected specification to a new or existing collection.

Contextual Menu for Requirements

Right-click on any requirement in the structure display or in the Structure View to access the available contextual commands.

Required responsibilities:

  • Baseline: Leader (when the object is in the Frozen state) or Author

Action Description
Expand All Expands all of the objects under the selected requirement.
Collapse All Collapses all of the objects under the selected requirement.
Select Direct Children Selects all of the direct children objects of the requirement.
Unselect Direct Children Unselects the direct children objects of the requirement.
Select All Descendants Selects all descendant objects (children and their children) of the requirement.
Unselect All Descendants Unselects all descendant objects (children and their children) of the requirement.
Insert New > Chapter Creates a new chapter from scratch and links it to the specification.
Insert New > Comment Creates a new comment from scratch and links it to the specification.
Insert New > Requirement Creates a new requirement from scratch and links it to the specification.
Insert New > Sub Requirement Creates a new sub requirement from scratch and links it to the requirement.
Insert Existing > Chapter Links an existing chapter to the specification.
Insert Existing > Comment Links an existing comment to the specification.
Insert Existing > Requirement Links an existing requirement to the specification.
Insert Existing > Sub Requirement Links an existing sub requirement to the requirement.
Detach from Structure Removes the requirement from the specification structure, but does not delete it from the database. Select OK to confirm.
Delete Removes the requirement from the list and delete it from the database. Select OK to confirm.
Note: You cannot delete a specification or requirement that includes objects reserved by another user.
Attributes Shows the property attributes of the requirement.
Lifecycle Shows the Lifecycle, Tasks/Signatures, and Approvals tabs of the requirement in a new window.
Add to Collection > Add to Clipboard Adds the selected requirement to your clipboard.
Add to Collection > New/Add to Collections Adds the selected requirement to a new or existing collection.

Contextual Menu for Sub Requirements

Right-click on any sub requirement in the structure display or in the Structure View to access the available contextual commands.

Required responsibilities:

  • Baseline: Leader (when the object is in the Frozen state) or Author

Action Description
Expand All Expands all of the objects under the selected sub requirement.
Collapse All Collapses all of the objects under the selected sub requirement.
Select Direct Children Selects all of the direct children objects of the sub requirement.
Unselect Direct Children Unselects the direct children objects of the sub requirement.
Select All Descendants Selects all descendant objects (children and their children) of the sub requirement.
Unselect All Descendants Unselects all descendant objects (children and their children) of the sub requirement.
Insert New: Sub Requirement Creates a new sub requirement from scratch and links it to the selected sub requirement.
Insert Existing: Sub Requirement Links an existing sub requirement to the selected sub requirement.
Detach from Structure Removes the sub requirement from the specification structure, but does not delete it from the database. Select OK to confirm.
Delete Removes the sub requirement from the list and deletes it from the database. Select OK to confirm.
Note: You cannot delete a specification or requirement that includes objects reserved by another user.
Attributes Shows the property attributes of the sub requirement.
Lifecycle Shows the Lifecycle, Tasks/Signatures, and Approvals tabs of the sub requirement in a new web browser window.
Add to Collection > Add to Clipboard Adds the selected sub requirement to your clipboard.
Add to Collection > New/Add to Collections Adds the selected sub requirement to a new or existing collection.

Contextual Menu for Chapters and Comments

Right-click on any chapter or comment in the structure display or in the Structure View to access the available contextual commands.

Required responsibilities:

  • Baseline: Leader (when the object is in the Frozen state) or Author

Action Description
Expand All Expands all of the objects under the selected object.
Collapse All Collapses all of the objects under the selected object.
Select Direct Children Selects all of the direct children objects of the object.
Unselect Direct Children Unselects the direct children objects of the object.
Select All Descendants Selects all descendant objects (children and their children) of the object.
Unselect All Descendants Unselects all descendant objects (children and their children) of the object.
Insert New > Chapter Creates a new chapter from scratch and links it to the specification.
Insert New > Comment Creates a new comment from scratch and links it to the specification.
Insert New > Requirement Creates a new requirement from scratch and links it to the specification.
Insert Existing > Chapter Links an existing chapter to the specification.
Insert Existing > Comment Links an existing comment to the specification.
Insert Existing > Requirement Links an existing requirement to the specification.
Delete Selected Objects Removes the object from the list and delete it from the database. Select OK to confirm.
Note: You cannot delete a specification or requirement that includes objects reserved by another user.
Delete Selected Object and Children Removes the object and all of its child objects from the list and deletes them from the database. Select OK to confirm.
Note: You cannot delete a specification or requirement that includes objects reserved by another user.
Detach from Structure Removes the object from the specification structure, but does not delete it from the database. Select OK to confirm.
Properties Shows the property attributes of the object.
Lifecycle Shows the Lifecycle, Tasks/Signatures, and Approvals tabs of the specification in a new window.
Add to Collection > Add to Clipboard Adds the selected specification to your clipboard.
Add to Collection > New/Add to Collections Adds the selected specification to a new or existing collection.