Previous	Next		Contents	Index	Glossary

• Monitor.redirectToGuestAdvUrl( ) - Redirects to the Administrator Monitor with guest access.

• Monitor.redirectToGuestSimpleUrl( ) - Redirects to the Self-Service Monitor with guest access.

• Monitor.getGuestAdvanceUrl( ) - Returns a URL for guest access to the Administrator Monitor, in a form that can be used within an Oracle Applications 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.getGuestSimpleUrl( ) - Returns a URL for guest access to the Self-Service Monitor, in a form that can be used within an Oracle Applications 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.

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

• adminMode - Specify 'Y' to grant administrator privileges to the user accessing the Status Monitor, 'N' to withhold administrator privileges from the user, or 'U' to check whether the user belongs to the workflow administrator role specified in the Workflow Configuration page and grant administrator privileges accordingly. The default is 'N'.

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

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

• DIAGRAM - Status Diagram page

• RESPONSES - Participant Responses page

The default is HISTORY.

• 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.

Example

The following code excerpt shows an example of how to provide guest access to the Status Monitor in Java code. This example calls the getGuestAdvanceUrl() method in the oracle.apps.fnd.wf.monitor.webui.Monitor class.

/*****************************************************************

**

** Guest Access

**

** Assumes all method calls are made from within an Oracle  

** Applications Framework page.

**

*****************************************************************/

...

import oracle.apps.fnd.wf.monitor.webui.Monitor;

...

  // This example assumes we want to set the destination link on 

  // an OA text bean.Following the link will take the user to the 

  // advanced monitor on the "Activity History" page. 

  public void processRequest(OAPageContext pageContext, 

                             OAWebBean webBean)

  {

    super.processRequest(pageContext, webBean);

    ...

    String itemType = [ however this value is obtained in page ];

      String itemKey = [ however this value is obtained in page ];

      String firstPage = "HISTORY";

      String returnToLabel = "Return to Application XYZ";

      // Set to "U" to have Monitor code figure out if the current

      // user should have Workflow Administrator privileges based 

      // on the Administrator role designation in Workflow.

      String adminMode = "U"; 



      // Will add a parameter "retainAM=Y" to the resulting url

      // so the developer doesn't have to do this manually if he 

      // wants to retain the calling Application Module when the 

      // user navigates to the Status Monitor.



      boolean retainCallingAM = true; 

    String url = null;

    try

    {

      url = Monitor.getGuestAdvanceUrl(pageContext, itemType, 

                                  itemKey, adminMode, firstPage,

                                  returnToLabel, retainCallingAM);

    }

    catch (MonitorURLException me)

    {

      // Handle not being able to obtain a valid redirectUrl for 

      // the parameters.

    } 

    // Set the url string on the web bean.

    OAStaticStyledTextBean monitorLink = 

      (OAStaticStyledTextBean)findIndexedChildRecursive

      ("AdvancedMonitorLink");

    monitorLink.setDestination(url);



    ... 

    

  } // end processRequest()