Previous	Next		Contents	Index	Glossary

procedure FORWARD

(nid in number,

 new_role in varchar2,

 forward_comment in varchar2 default null);

Java Syntax

public static boolean forward

    (WFContext wCtx,

     BigDecimal nid,

     String newRole

     String comment)

Description

This procedure delegates a notification to a new role to perform work, even though the original role recipient still maintains ownership of the notification activity. Also implicitly calls the Callback function specified in the Send or SendGroup function with FORWARD mode. A comment can be supplied to explain why the forward is taking place. Existing notification attributes (including due date) are not refreshed or otherwise changed. The Delegate feature in the Notification System calls this procedure. Note that when you forward a notification, the forward is recorded in the USER_COMMENT field of the notification.

Arguments (input)

wCtx	Workflow context information. Required for the Java method only. See: Oracle Workflow Context.
nid	The notification ID.
new_role or newRole	The role name of the person the note is reassigned to.
forward_comment or comment	An optional forwarding comment.

Example

The following code excerpt shows an example of how to call forward() in a Java program. The example code is from the WFTest.java program.

// forward to MBEECH

System.out.println("Delegate Test");

count = WFNotificationAPI.workCount(ctx, "MBEECH");

System.out.println("There are " + count + 

    " open notification(s) for" + " MBEECH");

System.out.println("Delegate nid " + myNid + 

    " from BLEWIS to MBEECH");

WFNotificationAPI.forward(ctx, myNid, "MBEECH",

    "Matt, Please handle.");

count = WFNotificationAPI.workCount(ctx, "MBEECH");

System.out.println("There are " + count + 

    " open notification(s) for" + 

    " MBEECH after Delegate.");