Model Instance

How to define Model Instances

Model Instance Definition

The Model Instance wizard allows to create a new Model Instace starting from a Model Definition. This operation include the possibility to:

• replicate the entire Model definition, comprehensive of the KPIs ,Thresholds and attributes associated to each model node
• select a subset of the Model definition nodes.

• The KPIs, Thresholds and attributes inherited from the Model definition can be updated and customized for every Model Instance Node.
• The Model Instance configuration include the selection of one or more resources to it. For example, projects, IT services or Business Process.
• The KPI Document, associated to the Model Instance, shows the KPI values that are computed (from the data contained on Spago4Q DWH) for the resources linked to the Model Instance.

Add Model Instance

To create a new Model Instance click on the menu item KPI Model and on Model Instance.

A page with existing Model Instances is presented (next figure shows an empty list).

To insert a new Model Instance, click on the Add button . The list of the Model definitions is presented.

From this form it's possible to select the Model definition to use as template for the new Model Instance.

• click on to make a copy of the whole selected Model definition
• click on to add only the root node of the selected Model definition. Additional nodes from the Model definition may be dragged and dropped to the new Model Instance.

Create Model Instance as a copy of the source model

Clicking on the model instance is created as showed in figure below:

Now it's possible to modify all the properties of every Model Instance:

• Label: the value of the label is automatically generated. The Label is used for the KPI document definition. Anyway, it's possible to overwrite the Label value custom mnemonic code (the constraint is that the Label is a unique identifier).
• Name: the Name of the Model Instance
• Description: it describes the Model Instance.

Node Detail - Tab KPI Instance

Select a node and click on to the KPI Instance tab to update the configuration for this KPI Instance.

• Type: to bind to the current Model Instance Node a Specific KPI or to set a reference to another KPI Model Instance Node (UUID).
  • KPI Instance: inherit the KPI Definition from the Model Definition Node .
  • Model Instance UUID: insert the Label of another Model Instance Node, in this way it's possible to reuse in the current Model Instance node the kpi value calculated on a different Model Instance for the same resource.

• Kpi: to define the computational rule. It's possible to overwrite the value inherited from the Model definition, or leave it blank.

• Threshold: to define or change the Threshold respect to the one configured on the KPI Definition.
• Weight: to define or change the Weight value respect to the one configured on the KPI Definition.
• Target: to define or change the Target value respect to the one configured on the KPI Definition.
• Periodicity: this Parameter it's used to specify the period of time after which a new value for the KPI will be computed (engine default behaviour).
• Chart Type: with this option it’s possible to select the type of the chart to display by default on the KPI Document.
• Save History: saving the detail with this flag cause the storage in the history of this KPI Instance of the previous configuration. The execution of a KPI Document at a specific date retrieves the appropriate configuration of every KPI Instance.
• Restore Default: selecting this option, and saving the detail, cause the restore of the default settings for the selected KPI.

Node Detail - Tab Source

The tab shows for the selected Model Instance Node the details of the corresponding Model definition node.

Remove Model Instance or Nodes

It's possible to delete the whole Model Instance (see example) or nodes from the Model Instance tree structure by right-clicking over a single node, and selecting Remove Model Instance Node from the context menu (as shown in the picture below).

Create Model Instance as a subset of the Model definition

Clicking on only the Model Instance root node is created, as showed in figure.

To add another Model Instance node, select a node from the Model definition and drag and drop it to the Model Instance panel.
Referring to the following figure, selecting the node NSD-NewSoftwareDevelopment and checking Import Sub-tree also, the drag and drop will add the node and its subnodes.
Click on to update the Model Instance.

Referring to the example, to include only a specific subnode UC-SLA-2.03 of the node MSHD-SwMaintenanceAndHelpDesk, drag and drop the node without checking the Import sub-tree also flag.

then drag and drop the node UC-SLA-2.03.

Resource Management

The Resource is the entity subjected to the monitoring, evaluation or measurement based on the kpi defined for a specific Model Instance. So it’s mandatory that one or more resources have to be linked to a Model Instance.
The Resource type can be for example a Project, IT Service, Business Process or a custom type.

To manage the resource click on the menu item “KPI Model” and on “Resource definition”.

Create Resource

The list of the resource is showed.

Click on to insert a new resource.

• Name: the name of the Resource.
• Code: mnemonic code of the resource
• Description: the descriptive field for the Resource.
• Table Name and Column Name: these fields can be used as reference (using the Name field) to extend the properties of the Resource in an already existing environment.
• Type: the type of the Resource (Project, Process, Service,...) It’s possible to extend and customize the types updating the database directly.

Resource - Model Instance Association

To link one or more resources to a specific Model Instance you have to:

• select the model from the Model Instance list (Menu KPI Model and Model Instance )
• select the tab “Resource”, the tab shows the list of all the available resources
• check one or more resources and save.