An event handler is a program that watches for events on a TeamForge site and
communicates them to another system. You can add your own event handlers to the set that are
built into TeamForge.
For example, some of your site's members may be using TeamForge alongside a legacy
issue tracking system. You may want to write an event handler that listens to the
"Artifact Create" event on your TeamForge site and sends the details about any newly
created artifact to the legacy system through a webservice.
-
Create your custom event handler and package it as a .jar
file.
-
Check with your system administrator that the
ENABLE_UI_FOR_CUSTOM_EVENT_HANDLERS variable in the site
configuration file is set to true.
-
Click Admin in the site navigation bar.
-
Click SYSTEM TOOLS on the site administration
toolbar.
-
Click Custom Event Handlers.
-
Click Create and use the Browse
control to locate your .jar file.
-
Click Add.
Note: If the system reports "Error Parsing Event Jar File," debug your
event handler until the error message no longer appears.
Your .jar file is uploaded to your TeamForge site and the event
cache is cleared. All the events you specified in your event handler are now captured
and sent to the external web service.