Standard Status Monitor access provides loosely coupled access from an Oracle Application Framework-based Web page or Oracle E-Business Suite form, to a Status Monitor page within the full Oracle Workflow application. In this mode, the specified Status Monitor page is displayed with the full Oracle Workflow menu, allowing users to navigate out of the Status Monitor and perform other tasks within Oracle Workflow. Locator links, also known as breadcrumbs, let users navigate from the Status Monitor back to the calling application.

With standard access, users are fully authenticated. Only users with workflow administrator privileges, as specified in the Workflow Configuration page, can view workflows owned by others and perform administrative operations in the Status Monitor. See: Setting Global User Preferences.

When you provide standard access to the Status Monitor from your application, you can optionally specify a workflow item type and item key to query and specify which page you want to initially display.

• If you specify both the item type and item key for a workflow, that workflow is automatically queried in the Status Monitor. You can choose to initially display the workflow in the main Workflows search page, the Activity History page in the Administrator Monitor or Notification History page in the Self-Service Monitor, the Status Diagram page, or the Monitor Responses page. If you provide an item type and item key but do not specify an initial page, the workflow is initially displayed in the Activity History page in the Administrator Monitor or Notification History page in the Self-Service Monitor.

  Note: The specified workflow is only displayed if the user owns that workflow or has workflow administrator privileges to view workflows owned by others. If the user does not have the necessary privileges to view the workflow, an error message is displayed. In this case the user can optionally select another Workflow top level menu item.

• If you specify only a workflow item type, the main Workflows search page is displayed, and workflows of the specified type that were started within the last two weeks are automatically queried.

• If you do not specify a workflow item type, the main Workflows search page is displayed. No automatic query is performed.

Oracle Workflow provides Java methods to redirect to the Status Monitor with standard access or to obtain URLs for standard access to the Status Monitor. These methods are defined in the Java class called oracle.apps.fnd.wf.monitor.webui.Monitor.

• Monitor.redirectToAdvanceUrl( ) - Redirects to the Administrator Monitor with standard access.

• Monitor.redirectToSimpleUrl( ) - Redirects to the Self-Service Monitor with standard access.

• Monitor.getAdvanceUrl( ) - Returns a URL for standard access to the Administrator Monitor, in a form that can be used within an Oracle Application Framework application page. For example, you can set this URL as a destination link on an OAWebBean. The URL is returned in the following format:

  /OA_HTML/OA.jsp?OAFunc=[parameters...]
  

• Monitor.getSimpleUrl( ) - Returns a URL for standard access to the Self-Service Monitor, in a form that can be used within an Oracle Application Framework application page. For example, you can set this URL as a destination link on an OAWebBean. The URL is returned in the following format:

  /OA_HTML/OA.jsp?OAFunc=[parameters...]
  

When calling these methods, you must provide the following parameters to indicate how you want to display the Status Monitor:

• pageContext - The OAPageContext of the calling page.

• itemType - The internal name of a workflow item type to automatically query in the Status Monitor (optional).

• itemKey - An item key to automatically query in the Status Monitor (optional).

• firstPage - The Status Monitor page that you want to initially display (optional).

  • MAIN - Main Workflows search page

  • HISTORY - Activity History page in the Administrator Monitor or Notification History page in the Self-Service Monitor

  • DIAGRAM - Status Diagram page

  • RESPONSES - Monitor Responses page

  Note: For access to the HISTORY, DIAGRAM, or RESPONSES pages, you must specify an item type and item key.

• retainCallingAM - Specify true or false to indicate whether the OAApplicationModule of the calling page should be retained while working in the Status Monitor. If you specify true, retainAM=Y is appended to the Status Monitor URL; if you specify false, retainAM=N is appended to the URL. The default is true.

All method calls for standard access should be made from within an Oracle Application Framework-based Web page.

You can provide standard access from an Oracle E-Business Suite application to the Status Monitor by using self-service functions. You can call these functions from an Oracle E-Business Suite form, or add the menus that contain the functions to another menu associated with another responsibility.

The following table lists the functions that provide standard access to the Status Monitor. These functions do not require any parameters.

Standard Access Functions

You can call the function FND_FUNCTION.EXECUTE to execute a standard access function. See: FND_FUNCTION.EXECUTE.

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

FND_FUNCTION.EXECUTE(FUNCTION_NAME => 'WF_STATUS_MONITOR'); 

See: Overview of Form Development Steps and Menus Window.

Menu Setup

If you use a standard access function within your responsibility, you must add the menu containing that function to the top-level menu for your responsibility. The WF_STATUS_MONITOR function is seeded on the Workflow Administrator Application (WF_ADMINISTRATOR_APPLICATION) menu, and the WF_SS_STATUS_MONITOR function is seeded on the Workflow Self-Service Application (WF_SELF_SERVICE_APPLICATION) menu.

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

Migrating to Standard Access Functions

If your application used self-service functions to provide access to the previous version of the Workflow Monitor, you can migrate to the new Status Monitor by replacing the functions you previously called with the appropriate new functions. The following table shows the correspondence between functions for the previous Workflow Monitor and the standard access functions for the new Status Monitor.

Migrating to Standard Access Functions