Previous	Next		Contents	Index	Glossary

procedure TRANSFER

(nid in number,

 new_role in varchar2,

 forward_comment in varchar2 default null);

Java Syntax

public static boolean transfer

    (WFContext wCtx,

     BigDecimal nid,

     String newRole

     String comment)

Description

This procedure forwards a notification to a new role and transfers ownership of the notification to the new role. It also implicitly calls the Callback function specified in the Send or SendGroup function with TRANSFER mode. A comment can be supplied to explain why the forward is taking place. The Transfer feature in the Notification System calls this procedure. Note that when you transfer a notification, the transfer is recorded in the USER_COMMENT field of the notification.

Attention: Existing notification attributes (including due date) are not refreshed or otherwise changed except for ORIGINAL_RECIPIENT, which identifies the owner 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 transferred to.
forward_comment or comment	An optional comment to append to notification.

Example

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

// transfer to MBEECH

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

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

    " from BLEWIS to MBEECH");

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

    "Matt, You own it now.");

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

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

    " open notification(s) for" + 

    p" MBEECH after Transfer.");