Previous	Next		Contents	Index	Glossary

The following table lists the functions that provide guest access to the Status Monitor.

Function	Description
WF_G_ACTIVITIES	Displays the Activity History page for the specified workflow in the administrator version of the Status Monitor.
WF_G_DIAGRAM	Displays the Status Diagram page for the specified workflow in the administrator version of the Status Monitor.
WF_SSG_ACTIVITIES	Displays the Notification History page for the specified workflow in the self-service version of the Status Monitor.
WF_SSG_DIAGRAM	Displays the Status Diagram page for the specified workflow in the self-service version of the Status Monitor.

When you call one of the guest access functions, you must pass the function the following parameters:

• itemType - A valid workflow item type, determined by your application. The item type and item key together identify the workflow process to display. You must specify the same item type as you used to obtain the encrypted access key. You should use the ICX_CALL.Encrypt() function to encrypt this value.

• itemKey - A valid item key, determined by your application. The item type and item key together identify the workflow process to display. You must specify the same item key as you used to obtain the encrypted access key. You should use the ICX_CALL.Encrypt() API to encrypt this value.

• wm - The encrypted administrator mode that determines whether the user should have privileges to perform administrative operations in the Status Monitor. Call the PL/SQL function WF_FWKMON.GetEncryptedAdminMode() to obtain the encrypted value for the administrator mode you want, either Y or N. You must specify the same administrator mode value to encrypt as you used to obtain the encrypted access key. See: GetEncryptedAdminMode, Oracle Workflow API Reference.

• wa - An encrypted access key for a specified item type, item key, and administrator mode combination. Call the PL/SQL function WF_FWKMON.GetEncryptedAccessKey() to obtain this value for the item type, item key, and administrator mode you want. See: GetEncryptedAccessKey, Oracle Workflow API Reference.

Note: Because users are authenticated in guest access, you can call the PL/SQL function WF_FWKMON.IsMonitorAdministrator() to determine whether a the user has administrator privileges based on the workflow administrator setting in the Workflow Configuration page. If you use this function, you should use its result when obtaining both the encrypted access key and the encrypted administrator mode, in order to avoid a discrepancy between these two values. See: IsMonitorAdministrator, Oracle Workflow API Reference.

You can also choose to grant or withhold administrator privileges in the Status Monitor by specifying the administrator mode as Y or N, respectively, regardless of the workflow administrator setting in the Workflow Configuration page.

• retainAM - Specify Y or N to indicate whether the OAApplicationModule of the calling page should be retained while working in the Status Monitor.

• fExt - An external flag used within Oracle Workflow. Set this parameter to X.

Note: When you call FND_FUNCTION.EXECUTE, you should use the WFA_HTML.conv_special_url_chars() API to convert any special characters in the parameters you pass to the Status Monitor.

The following code example demonstrates how to execute the WF_G_ACTIVITIES function using FND_FUNCTION.EXECUTE.

itemType := icx_call.encrypt('<your_item_type>'); 



itemKey := icx_call.encrypt('<your_item_key>'); 



adminMode := wf_fwkmon.isMonitorAdministrator('<user_name>');



wm := wf_fwkmon.getEncryptedAdminMode(adminMode); 



wa := wf_fwkmon.getEncryptedAccessKey('<your_item_type>', 

     '<your_item_key>', adminMode); 



FND_FUNCTION.EXECUTE( 

   FUNCTION_NAME => 'WF_G_ACTIVITIES', 

   OPEN_FLAG => 'Y', 

   SESSION_FLAG => 'Y', 

   OTHER_PARAMS =>

     'itemType='||(wfa_html.conv_special_url_chars(itemType))

     ||'&'||'itemKey='||(wfa_html.conv_special_url_chars(itemKey))

     ||'&'||'wm='||(wfa_html.conv_special_url_chars(wm))

     ||'&'||'wa='||(wfa_html.conv_special_url_chars(wa))

     ||'&'||'retainAM=Y'

     ||'&'||'fExt=X'

   ); 

See Also

Menus Window, Oracle Applications Developer's Guide

Menu Setup

Note: You cannot add the Status Monitor functions to your menu directly. To include these functions, you must add the Oracle Workflow menu that contains the function you want.

The Workflow Guest Monitor Application menu is seeded on the Workflow Administrator (New) menu (FND_WFADMIN_NEW) associated with the Workflow Administrator Web (New) responsibility. Similarly, the Workflow Guest Self-Service Monitor Application menu is seeded on the Workflow User (New) menu (FND_WFUSER_NEW) associated with the Workflow User Web (New) responsibility.

Migrating to Guest Access Functions

Previous Function	New Function
FND_WFMON_ADV	WF_G_ACTIVITIES
FND_WFMON_DIAGRAM	WF_G_DIAGRAM or WF_SSG_DIAGRAM
FND_FNDWFIAS (if called with the ITEM_TYPE, ITEM_KEY, ADMIN_MODE, and ACCESS_KEY parameters)	WF_SSG_ACTIVITIES

See Also