Customization > Extensibility Through Profiles, Stereotypes, Tag Definitions and Scripts > PTC profiles > Utilities profile > Custom matrices > Defining the row items for a custom matrix (Utilities profile)
  
Defining the row items for a custom matrix (Utilities profile)
There are two ways of finding row items to include in a Custom Matrix:
• The Custom Matrix can find row items that are related to the Custom Matrix's Analyzed Packages.
• The Custom Matrix can find row items through a reference Tag Definition that is applied to the Custom Matrix, that is, items that are linked to the Custom Matrix through the reference Tag Definition or items that are found through a derived reference Tag Definition.
To find row items that are related to the custom matrix's analyzed packages:
1. Open the Custom Matrix's Property Pages.
2. Click the CustomSimpleMatrix tab.
3. Set the tagged value of the rowLabel tag definition to the name of the label you want for the row items in the matrix.
4. Set the tagged value of the rowItemsStartPoint tag definition to Analyzed Packages.
5. Set the tagged value of the rowItemsRole tag definition to the name of the Modeler Automation Interface role or Profile Helper association you want to use to find items that are related to the Analyzed Packages:
◦ For example, if you wanted to find Actors that are scoped to the Analyzed Packages, you would use the Actor role.
For information about what roles are available through the Modeler Automation Interface for a Package, see . Note that the roles are called associations in the Modeler Automation Interface Help.
◦ The Profile Helper associations are additional associations provided to support the PTC profile matrices.
To list the Profile Helper associations that are available for Packages, right-click a Package, point to Tools, point to Profile Extensions, and then click Wrapper Details. On the Meta Model Viewer, the available Profile Helper associations are listed as subfolders of the Roles folder. For example, you can use the REQUIREMENTS Requirement association to find the Requirements in an analyzed Package.
6. If you do not want to show the scoping of each row item that is shown in the Custom Matrix, set the tagged value of the rowItemsShowScope tag definition to FALSE.
After defining how the Custom Matrix finds its row items, you can define how it finds its column items. For more information, see Defining the column items for a custom matrix (Utilities profile).
To find row items through a reference tag definition:
1. Create the reference Tag Definition that returns the items you want to include as row items, and apply the reference Tag Definition to the Custom Matrix through a Stereotype.
The items that are found through the reference Tag Definition are those items that are linked to the Custom Table through the reference Tag Definition or those items that are found through a derived reference Tag Definition.
For information about derived Tag Definitions, see Overview of deriving tagged values through derived tag definitions.
To apply a Stereotype to a Custom Matrix, Text Diagram must be a valid model item type for the Stereotype.
2. Open the Custom Matrix's Property Pages.
3. Click the CustomSimpleMatrix tab.
4. Set the tagged value of the rowLabel tag definition to the name of the label you want for the row items in the matrix.
5. Set the tagged value of the rowItemsStartPoint tag definition to Table/Matrix.
6. Set the tagged value of the rowItemsRole tag definition to the name of the reference Tag Definition you created.
7. If you do not want to show the scoping of each row item that is shown in the Custom Matrix, set the tagged value of the rowItemsShowScope tag definition to FALSE.
After defining how the Custom Matrix finds its row items, you can define how if finds its column items. For more information, see Defining the column items for a custom matrix (Utilities profile).