Customization > Extensibility Through Profiles, Stereotypes, Tag Definitions and Scripts > PTC profiles > Utilities profile > Custom matrices > Defining the column items for a custom matrix (Utilities profile)
  
Defining the column items for a custom matrix (Utilities profile)
There are two ways of finding column items to include in a Custom Matrix:
• The Custom Matrix can find column items that are related to the Custom Matrix's Analyzed Packages.
• The Custom Matrix can find column items through a 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 column 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 columnLabel tag definition to the name of the label you want for the column items in the matrix.
4. Set the tagged value of the columnItemsStartPoint tag definition to Analyzed Packages
5. Set the tagged value of the columnItemsRole 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 column item that is shown in the Custom Matrix, set the tagged value of the columnItemsShowScope tag definition to FALSE.
After defining how the Custom Matrix finds its column items, you can define what intersections represent. For more information, see Defining the intersections for a custom matrix (Utilities profile).
To find column items through a reference tag definition:
1. Create the derived reference Tag Definition that returns the items you want to include as column items, and apply the derived Tag Definition to the Custom Matrix through a Stereotype.
The items that are found through the derived 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 columnLabel tag definition to the name of the label you want for the column items in the matrix.
5. Set the tagged value of the columnItemsStartPoint tag definition to Table/Matrix.
6. Set the tagged value of the columnItemsRole tag definition to the name of the reference Tag Definition you created.
7. If you do not want to show the scoping of each column item that is shown in the Custom Matrix, set the tagged value of the columnItemsShowScope tag definition to FALSE.
After defining how the Custom Matrix finds its column items, you can define what intersections represent. For more information, see Defining the intersections for a custom matrix (Utilities profile).