4.1

6 Call the functions that define the events to generate and monitor.
To generate flare events, the SolarSystemEventGenerator.generateFlareEvent() method calls the
StarFlareEventListener.starFlareEvent() method that the SolarSystemEventGenerator class defines.
public void generateFlareEvent(String sdkType, String id, double magnitude) {
String key = sdkType + "' / '" + id;
log.info("Generate Flare Event for : '" + key + "'");
Vector<IPluginEventPublisher> publishers = policyElements.get(key);
if (publishers != null) {
for (IPluginEventPublisher publisher : publishers) {
publisher.pushGauge(sdkType, id, "Flare", "magnitude", magnitude);
}
if (sdkType.equals("Star")) {
starFlareEventListener.starFlareEvent(id, magnitude);
}
}
You registered a policy gauge or a trigger that an Orchestrator policy can watch for events in the plugged-in
technology. If the events occur, the policy starts an operation in the Orchestrator server.
What to do next
Create plug-in triggers to start operations in the Orchestrator server when certain events occur in the plugged-
in technology.
Create a Plug-In Workflow Trigger
You can create plug-in workflow triggers to monitor events in the plugged-in technology on behalf of a Wait
Event element in a workflow. To create a workflow trigger, you create a Java class that implements the
PluginTrigger class from the Orchestrator plug-in API.
When a workflow trigger detects a change in the properties of an object that it is monitoring, it sends a
notification to any Orchestrator workflows that are waiting for the event. When the workflow receives the
notification from the workflow trigger, it stops waiting and resumes its run.
The PluginTrigger class defines methods to obtain or set the type and name of the object to monitor, the nature
of the event, and a timeout period.
You create implementations of the PluginTrigger class exclusively for use by Wait Event elements in
workflows. You define policy triggers for Orchestrator policies in classes that define events and implement
the IPluginEventPublisher.pushTrigger() method.
The solar system plug-in features a workflow trigger that creates an instance of the PluginTrigger class to
monitor solar flare events on a Star object in a SolarSystemRepository instance. These procedures present the
steps involved in creating a workflow trigger. To illustrate the process, they present code from the
SolarSystemTriggerGenerator class. The package of workflows, actions, and resources that accompany the
solar system example provides a workflow that contains a Wait Event element that monitors the workflow
trigger for solar flare events.
For a description of the role of the plug-in triggers and the other components of a plug-in, see “Overview of
Plug-Ins,” on page 139. For information about all the methods and parameters of the plug-in trigger class, see
“PluginTrigger Class,” on page 216.
Procedure
1 Set Up the Workflow Trigger on page 172
To create a workflow trigger, you create an implementation of the PluginTrigger class from the
Orchestrator plug-in API.
Chapter 7 Developing Plug-Ins
VMware, Inc. 171