Oracle Workflow Guide
Release 2.6.2

Part Number A95265-03
  Go to previous page Go to next page       Go To Table Of Contents Go To Index Go To Table Of Contents

                     Contents  Index  Glossary Master Index Feedback
 

Forward

PL/SQL Syntax

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.");
 
         Previous  Next          Contents  Index  Glossary


Oracle
Copyright © 1996, 2002 Oracle Corporation.

All Rights Reserved.