IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Developing monitor models > Create monitor models > Defining the visual model > Defining actions
Linking to other diagrams
A dashboard user can click a shape in the dashboard at run time and navigate to a diagram associated with another monitoring context or key performance indicator (KPI) context. You can either set the link to work only if the value of a metric or KPI matches a certain expression, or set the link to go to different diagrams based on the value.
In the Monitor Model editor, when you are testing the links, the linked diagram will use any test values that you added to its associated context. If these are metric test values, you can think of them as representing metrics for a single test instance.
In the dashboards, you can view a monitoring context diagram either with or without instance annotations. From Instances in the dashboards, you can pick a particular instance and show the diagram specific to that instance, in which case the diagram is annotated with the metric values for that instance.If the monitoring context diagram in the dashboard IS NOT annotated for a specific instance, linking to another monitoring context diagram will result in the display of a generic linked monitoring context diagram (one that is also not annotated for a specific instance). If the monitoring context diagram in the dashboard IS annotated for a specific instance, the link must be to a child monitoring context. If the current instance has one or more child instances, the linked diagram will be annotated with the values from the first of those child instances.
Regardless of whether the monitoring context is annotated for a specific instance, you can always link to a KPI context diagram (which is annotated by default in the dashboards). You can also add a link from a KPI context diagram to a monitoring context diagram. In the dashboards, the linked monitoring context diagram will not be annotated for a specific instance, since there is no current instance on which to base the annotations.
To link from one diagram to another diagram:
Procedure
- Place your mouse cursor on the diagram and find the shape set in the area of the diagram that you want to affect. The cursor changes to a hand when it is on the shape set. Click the diagram to highlight the corresponding shape set in the table at the bottom of the page.
- Right-click the shape set in the table and click Add Action > Set Diagram Link.
- To set the link based on an expression, add a condition in the Condition row.
For example, if you want the link to a specific diagram to work only if a KPI value is greater than 60, you would type KPI_name > 60. You can either type directly into the cell, or, for a large expression, click the button to open a resizable window. For help writing the expression, press Ctrl+Space.
Because you are creating expressions to be resolved at run time, you can only use the elements in the context that the diagram is attached to. If the diagram is attached to a monitoring context, you can use the metrics, keys, counters, and stopwatches in that context. If the diagram is attached to a KPI context, you can use the KPIs in that context.
- Select the target monitoring context or KPI context by clicking the button in the Target context row and choosing from all the contexts that are associated with SVG diagrams. When the dashboard user clicks the shape set at run time, the diagram will be replaced by the diagram associated with the target context.
What to do next
Tip: For each additional SVG diagram, create a KPI context. Unlike monitoring contexts, KPI contexts are not required to be associated with anything else and you can simply use them to attach diagrams.