Creating a GraphSet Definition
A GraphSet Definition is MetaClass-specific.
The GraphSet Definition is based either on:
• an object or an object collection (an occurrence or a set of occurrences of the source MetaClass)
The GraphSet Definition creation consists in connecting a source MetaClass (concrete or abstract) to the GraphSet Definition.
• a query (a set of occurrences)
The GraphSet Definition creation consists in defining the query that collects the entry points.
If needed, you can create a query parameter for this purpose.
Creating an object collection-based GraphSet Definition
When you create a GraphSet Definition based on an object or an object collection, you need to define a Source MetaClass.
In that case the following items are automatically created:
• a Graphset Entry Point Collection (collection type parameter) of the same type as the source MetaClass.
• a GraphSubSet with the same name as the GraphSet Definition
The GraphSubSet definition is automatically initialized with a node with the same MetaClass as the source MetaClass. This node is defined as entry point and its name is the MetaClass name.
To create a GraphSet Definition based on an object:
1. Access the GraphSet Definitions folder
2. Right-click the GraphSet Definitions folder and select New > GraphSet Definition.
The Creation of GraphSet Definition window appears
3. In the Name field, enter your GraphSet Definition name.
By default the GraphSet Definition name is: GraphSet Definition-x (x is a number).4. Define the Root section:
• In the Collection is populated by field keep "Collection Parameter".
• In the MetaClass field, click the arrow and in the drop-down menu select the MetaClass you want to define as the source MetaClass of your GraphSet Definition.
In the field, enter the first letters of the MetaClass for a quick access.Example: Application.
5. Click OK.
The selected MetaClass is defined as your GraphSet Definition source MetaClass.
Your GraphSet Definition is created and added in the GraphSet Definitions folder.
6. In the GraphSet Definitions folder, expand your GraphSet Definition.
A GraphSubSet is automatically created with the same name as your GraphSet Definition.
7. In your GraphSet Definition properties, display its Characteristics page.
In the Parameters section a Collection type parameter of the same type as the source MetaClass is automatically created with value "N" as multiplicity.
Example: with "Application" as source MetaClass, the Collection Type is "Application" MetaClass.
8. If you do not want a collection of objects but a single object only as entry point, in the Collection Multiplicity field, select "1".
9. In the _GUIName field, enter a name.
Example: "List of applications to extract".
This parameter is displayed in the GraphSet Definition Preview page.
You may need to add other entry point collections.
10. In your GraphSet Definition properties, display its Definition page.
The GraphSubSet, automatically created, already includes a Node, defined as entry point.
Example: with "Application" as source MetaClass, the node "Application" is created.
11. Define the GraphSubSet (its nodes and arcs and their fields).
Creating a query-based GraphSet Definition
When you create a GraphSet Definition based on a query, you need to define:
• its root MetaClass
• its populating query based on the root MetaClass selected
In the GraphSet Definition you can also define parameters that are used in any query used in the GraphSet Definition.
To create a query-based GraphSet Definition:
1. Access the GraphSet Definition folder
2. Right-click the GraphSet Definitions folder and select New > GraphSet Definition.
The Creation of GraphSet Definition window appears
3. In the Name field, enter your GraphSet Definition name.
Example: "Appli from Portfolio"
By default the GraphSet Definition name is: GraphSet Definition-x (x is a number).4. In the Root section:
• In the Collection is populated by field, select "Query".
The Populating Query field appears.
• In the MetaClass field, click the arrow and in the drop-down menu select the MetaClass you want to define as the root MetaClass of your GraphSet Definition.
In the field, enter the first letters of the MetaClass for a quick access.Example: Application.
• In the Populating Query field, use the drop-down menu to select the query used to collect the entry point.
Only the root MetaClass related queries are available.Example: "APM - Get Applications of a Portfolio".
5. Click OK.
You report GraphSet Definition is created and added to the GraphSet Definition folder.
6. In your GraphSet Definition properties, display its Characteristics page:
• The Root Population Queries section displays the query used to populate the GraphSet.
• The Parameters section displays the Property Parameter automatically created when used in the populating query.
Eg.: here Portfolio.
Select Application Where Initiative.Owner Portfolio = &Portfolio Or Deployed Object:Software Installation.Initiative.Owner Portfolio = &Portfolio
7. In your GraphSet Definition properties, display its Definition page.
The GraphSubSet, automatically created, already includes a Node, defined as entry point.
Example: with "Application" as source MetaClass, the node "Application" is created.
8. Define the GraphSubSet (its nodes and arcs and their fields).
9. Display the GraphSet Definition Preview page and test the report.