Previous	Next		Contents	Index	Glossary	Library

procedure CancelGroup

(gid in number,
 cancel_comment in varchar2 default null);

Description

This procedure may be invoked by the sender or administrator to cancel the individual copies of a specific notification sent to all users in a notification group. The notifications are identified by the notification group ID (gid). The notification status is then changed to 'CANCELED' but the rows are not removed from the WF_NOTIFICATIONS table until a purge operation is performed.

If the notification was delivered via e-mail and expects a response, a 'Canceled' e-mail is sent to the original recipient as a warning that the notification is no longer valid.

Generally, this function is called only if a notification activity has 'Expanded Roles' checked in its properties page. If Expanded Roles is not checked, then the Cancel( ) function is called instead. See: Voting Activity.

Arguments (input)	gidThe notification group id.
cancel_comment	An optional comment on the cancellation.