Financial Management › Events and Notifications › Watch Events › Define a Watch Event

Define a Watch Event

CA APM lets you define a watch event to monitor a field and have the workflow provider (for example, CA Process Automation) notify you about inactivity on a particular field. For example, you can define a watch event on the Lifecycle Status field for an asset. You can define one or more watch events for a single field.

Note: If your administrator has granted you the correct permissions, you can complete this task.

To define a watch event

1. Click the tab and optional subtab for the event definition that you want to configure.
2. On the left, click CONFIGURE: ON.

   The configuration of the event is enabled.

3. In the Configuration Information area of the page, select an existing global or local configuration.

   Important! Global configuration changes affect all users, regardless of their role. Local configuration changes only affect users in the roles assigned to the selected configuration.

4. Next to the field, click the Event Configuration icon.

   The Events page for the selected field appears.

5. Click New.
6. Specify the information for the watch event.

   Important! The Value Changed From and Value fields work together to start the timer for the watch event. The timer continues for the duration that you specify in the Days After field. The Value Changed To and Value fields work together to indicate the value that you want to achieve and stop the timer. If the value that you want to achieve does not occur in the specified time period after the timer starts, the watch event occurs and indicates that the defined workflow did not happen.

   The following fields require explanation:

   Event Type

   Select the type of event as a watch event. After you select the event type and save the event, you cannot change the event type. If you select the incorrect event type when defining an event, delete the event and define it again using the correct event type.

   Event Cause

   Select the type of action that must happen to the field for the watch event to occur. A supported event cause is when a field is changed.

   Days After

   Specify a positive number to indicate how many days to wait after the Value Changed From field value to start the watch timer.

   Note: If the Value Change To field value does not occur, the watch timer expires after the number of days that you specify. After the watch timer expires, the watch event is created. However, the watch timer will stop when the Value Change To field value changes to the specified value and no watch event is created.

   Value Changed From

   Select the initial field value to start the timer to create the watch event. Supported field value changes include the following options:

   • Any value. Any field value starts the timer for the watch event.
   • Blank. A blank field value starts the timer for the watch event.
   • Old value. A specific initial value starts the timer for the watch event.

   Value

   Available when you select Old value in the Value Changed From field. Enter a specific value to start the timer for the watch event.

   Value Changed To

   Select the final state of the field value that stops the timer for the watch event and prevents the watch event from occurring. Supported field value changes include the following options:

   • Any value. Any field value stops the timer for the watch event and prevents the watch event from occurring.
   • Blank. A blank field value stops the timer for the watch event and prevents the watch event from occurring.
   • New value. A specific field value stops the timer for the watch event and prevents the watch event from occurring.

   Value

   Available when you select New value in the Value Changed To field. Enter a specific value to stop the timer for the watch event and prevent the watch event from occurring.

   Inactive

   Select this check box to indicate that the watch event is inactive. When you make a watch event inactive, no new notifications are created for the event. However, pending notifications are processed.

   Event Provider

   Select the workflow provider to notify users that the watch event has occurred (for example, CA IT Process Automation Manager). When you select a provider, all available workflow processes for the selected provider appear in the Workflow Process field.

   Workflow Process

   Identifies the workflow process for the workflow provider. When you select a workflow process, all available process parameters for the workflow provider appear.

   • Notification and One Escalation–Notifies the initial recipient and sends a reminder email. If the recipient acknowledges the notification, the process marks the event as completed. If the recipient does not acknowledge in the specified time frame, the process escalates the notification to the escalation recipient. If the escalation recipient responds, the process marks the event as completed. If the escalation recipient does not respond, the process marks the event as failed.
   • Notification without ACK–Notifies the initial recipient and marks the event as completed. The recipient does not need to acknowledge the notification.
   • Notification without Escalation–Notifies the initial recipient and sends a reminder email. If the recipient does not acknowledge the notification within the specified time period, the process marks the event as failed. If the recipient acknowledges within the specified time period, the process marks the event as completed.
   • (Optional) Additional Process Types–Uses processes you defined in the workflow provider.

   Notification Parameters

   Specify each process parameter for the workflow provider by doing one of the following in each field:

   • Enter an actual (hard-coded) value.
   • Click Map Fields to map the parameter to a CA APM object attribute.
   • Enter an actual (hard-coded) value and, in the same field, click Map Fields to map the parameter.

   Note: Refer to the field tooltips for specific information about the format and content of each parameter field.

7. Click Save.
8. Click CONFIGURE: OFF.

   The configuration of the watch event is complete.