Вы находитесь на странице: 1из 40

Oracle Workflow Administrator's Guide

Page 1 of 40

Skip Headers
Oracle Workflow Administrator's Guide "elease /0./ &art 1um*er #/0234536

Contents &revious 1e,t

Monitoring Workflow Processes


This chapter discusses how to monitor an instance of a workflow process. This chapter covers the following topics: Accessing the Administrator Monitor Viewing Workflows in the Status Monitor Viewing Child Workflows Viewing Activit Histor Viewing a Status !iagram Viewing "esponses Viewing Workflow !etails Viewing #rror $nformation for a Workflow Assigning Speciali%ed Workflow Monitoring &rivileges &roviding Access to the Status Monitor from Applications Testing Status Monitor Access Testing Standard Access Testing 'uest Access Status Monitor &ortlets

Accessing the Administrator Monitor


The Administrator Monitor lets ou view and administer runtime workflows. (ou can use the monitor to review the activities performed for a workflow) check the status of the workflow * viewing the status diagram) review notifications sent * the workflow and participant responses) and review details a*out the workflow definition and attri*utes. $f ou have workflow administrator privileges) ou can also perform administrative actions within the monitor to control the processing performed for a workflow or handle an error. +or e,ample) ou can update workflow attri*utes) suspend and resume a workflow) cancel a workflow) or rewind the workflow to an earlier activit stage. (ou can also skip or retr an individual activit within a workflow) reassign a notification activit ) or suspend and resume a process activit . Workflow administrator privileges are assigned in the Workflow Configuration page. See: Setting 'lo*al -ser &references. Note: $f ou intervene in a workflow process with an administrative operation such as skipping) retr ing) or reassigning an activiti ) then .racle Workflow updates the audit trail for the process to show that ou performed that operation.

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 2 of 40

Oracle Workflow also allows users to be assigned specialized workflow monitoring privileges with restricted access to workflow data. If you have specialized workflow monitoring privileges, you can only view workflows and perform administrative actions to which you have been granted access. For example, you may only have access to monitor workflows belonging to particular item types, and you may be able to suspend and rewind workflows but not to skip activities. ee! "ssigning pecialized Workflow #onitoring $rivileges. If you only have specialized workflow monitoring privileges, you cannot perform any actions on workflows that you own yourself, irrespective of any permissions granted to you. Only users with full workflow administrator privileges assigned in the Workflow %onfiguration page can perform administrative actions on workflows that they own themselves. Note: If you have full workflow administrator privileges assigned in the Workflow %onfiguration page, then those privileges override any specialized workflow monitoring privileges assigned to you. &hat is, if you have full workflow administrator privileges, you can access all workflows, irrespective of any restrictions defined for any specialized privileges. 'ou can also use the Oracle Workflow #anager component of Oracle "pplications #anager as an additional administration tool to review and manage work items. ee! Oracle Workflow #anager Overview. 'ou can use the (etry )rrored Workflow "ctivities concurrent program to retry multiple errored activities for a particular item type at once. ee! (etry )rrored Workflow "ctivities *F+,WF()&-. "dditionally, Oracle Workflow provides a view called WF.I&)#."%&I/I&'. &"&0 ) ./ that lets you programmatically access workflow status information. ee! Oracle Workflow /iews, Oracle Workflow "$I (eference. 1. /iewing Workflows in the tatus #onitor 2. /iewing %hild Workflows 3. /iewing "ctivity 4istory 5. /iewing a tatus ,iagram 6. /iewing (esponses 7. /iewing Workflow ,etails 8. /iewing )rror Information for a Workflow

Viewing Workflows in the Status Monitor


When you access the tatus #onitor, you can search for the workflows you want to review.

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page ' of 40

Note: If you have full workflow administrator privileges, you can search for workflows owned by any user. If you only have specialized workflow monitoring privileges, you can only search for workflows to which you have been granted access. If you do not have workflow administrator privileges, you can only search for workflows that you own. To Search for Workflows in the Status Monitor 1. Use a Web browser to navigate to the administrator Status onitor, using a responsibility and navigation path specified by your system administrator. See! "racle Workflow #dministrator $avigation %aths. &. In the Workflows page, search for the workflows you want to review. 'he search criteria are! Workflow 'ype ( Select the workflow item type you want to review. 'he display name for the workflow type you select populates the Workflow 'ype field, and the internal name for the workflow type you select populates the 'ype Internal $ame field. 'ype Internal $ame ( )nter the internal name of the workflow type you want to review, if you want to enter the internal name directly instead of selecting a value. Workflow "wned *y ( If you have workflow administrator privileges, select the user who owns the workflows you want to review. Note: If an administrator has configured restrictions for the user list of values, then only the values to which you have access appear in the list. See! +onfiguring the "racle Workflow User ,ist of -alues. If you do not have workflow administrator privileges, you can only search for workflows that you own. In this case, "racle Workflow displays your name as a non( editable value in the Workflow "wned *y field. Item .ey ( )nter the item key that uni/uely identifies the workflow you want to review. 0ou can enter a partial value to search for workflows whose item keys begin with that value. User .ey ( )nter the user key that identifies the workflow you want to review. 0ou can enter a partial value to search for workflows whose user keys begin with that value. Workflow Status ( +hoose the status of the workflows you want to review, or choose #ny Status to display workflows in any status. In %rocess ( Workflows that do not have an end date 1including errored workflows2 +omplete ( Workflows that have an end date

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 4 of 40

Error - Workflows that do not have an end date and have at least one errored activity Workflow Started - Choose Today, This Week (last seven days), Last 2 Weeks (last fourteen days), Last 3 !ays, Last " !ays, or #ny Ti$e to s%ecify the start date of the workflows you want to review& #ll the start date ran'es include the current date( for e)a$%le, Last 2 Weeks includes today as well as the %revious thirteen days& Note: *ou $ust enter at least one of the followin' criteria when you search in order to li$it the si+e of the results list& Workflow Ty%e Ty%e ,nternal -a$e Workflow .wned /y Workflow Started - ,f you search only 0y this o%tion, you $ust select a s%ecific start date ran'e& *ou cannot use Workflow Started with the #ny Ti$e value as your only search o%tion& *ou can also enter the followin' additional search criteria to search for workflows 0y activity characteristics& #ctivity Status - Select an activity status to dis%lay workflows with one or $ore activities in that status, or select #ny Status to dis%lay workflows with activities in any status& *ou can choose the followin' statuses1 #ctive Co$%lete !eferred Error -otified Sus%ended Waitin' Waitin' for 2es%onse 3ro$ - Enter a role to dis%lay workflows with activities that are waitin' for a res%onse fro$ the s%ecified reci%ient& Note: ,f an ad$inistrator has confi'ured restrictions for the user list of values, then only the values to which you have access a%%ear in the list& See1 Confi'urin' the .racle Workflow 4ser List of 5alues&

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page ) of 40

!ays Without 6ro'ress - Enter a nu$0er of days to dis%lay in-%rocess workflows with activities that have not %ro'ressed in the s%ecified ti$e& 3& The results re'ion dis%lays the workflows that $atch your search criteria& Note: ,f you only have s%eciali+ed workflow $onitorin' %rivile'es, the results re'ion dis%lays only workflows to which you have 0een 'ranted access& To view the error details for an errored workflow, select the error icon or the error link in the Status colu$n& To send e-$ail to the owner of a workflow, select the user link in the .wned /y colu$n& To view child workflows for a workflow, select the child icon in the Child Workflows colu$n& 7& 4se the $onitor 0uttons to drill down to additional infor$ation for a workflow& To review the activities e)ecuted within a workflow, select the workflow and select the #ctivity 8istory 0utton& To view the status dia'ra$ for a workflow, select the workflow and select the Status !ia'ra$ 0utton& To review notifications sent 0y a workflow and %artici%ant res%onses, select the workflow and select the 6artici%ant 2es%onses 0utton& To view details for a workflow, includin' the workflow ty%e definition and current workflow attri0ute values, select the workflow and select the Workflow !etails 0utton& Related Topics #ccessin' the #d$inistrator 9onitor

Viewing Child Workflows


The Child Workflows %a'e shows the workflows that are desi'nated as children of a %articular workflow& The %a'e identifies the %arent workflow 0y its workflow ty%e internal na$e and ite$ key, as well as 0y its user key, if it has one& To view the error details for an errored child workflow, select the error icon or the error link in the Status colu$n& To send e-$ail to the owner of a child workflow, select the user link in the .wned /y colu$n&

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 6 of 40

Use the monitor buttons to drill down to additional information for a child workflow. To review the activities executed within a workflow, select the workflow and select the Activity History button. To view the status diagram for a workflow, select the workflow and select the Status Diagram button. To review notifications sent by a workflow and artici ant res onses, select the workflow and select the !artici ant "es onses button. To view details for a workflow, select the workflow and select the #orkflow Details button. Related Topics Accessing the Administrator $onitor

Viewing Activity History


The Activity History age shows information about the activities executed for a workflow. The age identifies the dis layed workflow by its workflow ty e internal name and item key, as well as by its user key, if it has one. %ext, a hierarchical grid dis lays the rocess hierarchy formed by the selected workflow and any child workflows associated with it. To view the activity history for a workflow in the hierarchy, select the workflow rocess name link in the !rocess %ame column. To send e&mail to the owner of a workflow, select the user link in the 'wned (y column. S ecify the activity ty e and activity status of the activities you want to view. All activity ty es and statuses are selected by default. To search for s ecific activities, deselect any activity ty es and statuses you do not want to view. At least one activity ty e and one activity status must be selected for a search to be erformed. To view details about the definition and current status of an activity, select the activity name link in the Activity column. To view the %otification Details age for a notification activity, select the details icon in the %otification column. To send e&mail to the erformer of a notification, select the user link in the !erformer column. )f you have the a ro riate workflow administrator rivileges, you can use the activity

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page % of 40

administration icons to perform administrative operations on notification or process activities that are not yet complete. To reassign a notification activity that is not yet complete, select the reassign icon. See: To Reassign a Notification to Another User, Oracle Workflo User!s "#ide. Note: The reassign icon appears only for notification activities that are not yet complete. Additionally, yo# cannot reassign a notification from the Stat#s $onitor if the %&pand Roles option is selected for the notification or if it is a voting notification that tallies the recipients! responses. See: 'oting Activity, Oracle Workflo (eveloper!s "#ide. To s#spend a process activity that is not yet complete, select the s#spend icon in the S#spend)Res#me col#mn. All f#rther processing for the process is s#spended #ntil the process is res#med. Note: *f yo# s#spend the root process for a are s#spended as ell. orkflo , all s#+processes for the orkflo

Note: The s#spend icon appears only for process activities that are not yet complete. To res#me a s#spended process activity, select the res#me icon in the S#spend)Res#me col#mn. ,rocessing for the process is res#med and any activities that ere transitioned to hile the process as s#spended are no e&ec#ted. Note: *f yo# res#me the root process for a are res#med as ell. orkflo , all s#+processes for the orkflo

Note: The res#me icon appears only for process activities that are s#spended. *f yo# have the appropriate orkflo administrator privileges, yo# can #se the activity administration +#ttons to perform administrative operations on any activities that are not yet complete. To skip an activity and force the orkflo to transition to the ne&t activity, select the activity and select the Skip +#tton. *n the Skip page, enter the res#lt val#e to assign to the activity if re-#ired. Note: .o# cannot skip a s#spended process activity. .o# m#st res#me the process +efore yo# can skip it. To retry an activity, select the activity and select the Retry +#tton. Note: .o# cannot retry a s#spended process activity. .o# m#st res#me the process +efore yo# can retry it. Note: .o# can also #se the Retry %rrored Workflo Activities conc#rrent program to retry m#ltiple errored activities for a partic#lar item type at once. See: Retry %rrored Workflo Activities /0N(W0R%T1.

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page $ of 40

If you have the appropriate workflow administrator privileges and you are viewing a workflow that is not yet complete, you can use the workflow administration buttons to perform administrative operations on the workflow. To view the status diagram for the workflow, select the View Diagram button. To change the values of any item attributes, select the Update Attributes button. In the Update orkflow Attributes page, enter the new values you want. Note: !ou cannot update attributes of type event. "owever, you can select the event message link to view the event message details. To rewind the workflow to an earlier activity stage, select the #ewind button. In the #ewind page, select the activity you want from the list of activities that the orkflow $ngine has reached. %racle orkflow stops processing at the current activity and resumes processing at the specified activity. Note: !ou cannot rewind a suspended workflow. !ou must resume the workflow before you can rewind it. To suspend the workflow, select the &uspend orkflow button. All further processing for the workflow is suspended until the process is resumed, and all subprocesses are suspended as well. To resume the workflow if it is suspended, select the #esume orkflow button. 'rocessing for the workflow is resumed, and all subprocesses are resumed as well. Any activities that were transitioned to while the workflow was suspended are now e(ecuted. To cancel the workflow, select the )ancel orkflow button. In the )ancel page, select Apply. The orkflow $ngine sets the status of the workflow to *+%#)$, and all processing for the workflow is canceled and cannot be restarted. Related Topics Accessing the Administrator ,onitor

Viewing a Status Diagram


The &tatus Diagram page shows the process diagram for a workflow, including graphical cues about the status of the workflow and its activities. The page identifies the displayed workflow by its workflow type internal name and item key, as well as by its user key, if it has one. The )urrent &tatus region displays the process title, diagram, and detail tabs for the workflow. -eneath the detail tabs, the administration buttons appear. Process Title

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page ' of 40

The process title appears in the upper left of the Current Status region and displays the workflow process name, type, and user key. If no user key has been set, then the item key is displayed instead. If you drill down into a subprocess in the process diagram, the process title displays the subprocess name. Process Diagram Window The process diagram window is a scrolling canvas that displays the diagram of the workflow process or subprocess currently listed in the process title. This diagram is identical to the diagram created in Oracle Workflow uilder. !ote, however, that you cannot use the Workflow "onitor to edit this diagram. The process diagram window provides graphical cues about the status of the process and its activities. #n activity icon may be highlighted with a colored bo$ to indicate that it is in an %interesting% state. The following table shows what state each color indicates. Activity States in the Process Diagram Color of Box State +ed -reen 2ellow 4none5 ,rror Possible Status Code ,++O+

#ctive.In /rogress #CTI0,, !OTI1I,(, (,1,++,( Suspended !ormal S3S/,!( CO"/6,T,, W#ITI!-, !366

#ny transition &arrow' that has been traversed appears as a thick green line, while an untraversed transition appears as a thin black line. Click an activity icon in the diagram to select it and update the detail tab window to display information about the activity. Click any empty space in the diagram to deselect the currently selected activity icon and to refresh the detail tab window to display information about the current process as a whole. (ouble)click an activity icon that represents a subprocess to drill down to the diagram for the subprocess. This action automatically updates the process title to reflect the name of the subprocess and updates the detail tab window to display information about the subprocess as a whole. #lternatively, you can select the subprocess activity and choose *oom In to drill down to the diagram for the subprocess. Choose *oom Out to navigate back to the higher level process. Detail Tab Window

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 10 of 40

The detail tab window, which appears below the process diagram, is a vertically scrollable display area that provides information about a selected process or activity. The information appears as follows for each tab. Definition Tab Current 6ocation ) /rocess display name.activity display name Item Type ) Workflow type display name #ctivity !ame ) #ctivity display name (escription ) #ctivity description #ctivity Type ) /rocess, !otice, ,vent, or 1unction +esult Type ) +esult type display name Usage Tab Current 6ocation ) /rocess display name.activity display name Start.,nd ) !o, Start, or ,nd /erformer ) +ole name or item attribute internal name Timeout ) Timeout value in minutes or item attribute internal name Status Tab Current 6ocation ) /rocess display name.activity display name Status ) #ctivity status +esult ) #ctivity result egin (ate ) (ate activity begins ,nd (ate ) (ate activity ends (ue (ate ) (ate activity is due to time out #ssigned 3ser ) +ole name or item attribute internal name ,rror "essage ) ,rror message &shown only if activity status is 7,rror7' Notification Tab

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 11 of 40

Current Location - Process display name/activity display name Recipient - Recipient of notification Note: If the selected activity is a notification activity where Expand Roles is selected, but no response is re uired, then the recipient shown is simply the role, rather than the individual users in the role! "tatus - #otification status $e%in &ate - &ate notification is delivered End &ate - &ate notification is closed &ue &ate - &ate activity is due to time out Administration Buttons If you have the appropriate wor'flow administrator privile%es and you are viewin% a wor'flow that is not yet complete, you can use the administration buttons to perform administrative operations on the wor'flow! (o chan%e the values of any item attributes, select the )pdate *ttributes button! In the )pdate +or'flow *ttributes pa%e, enter the new values you want! Note: ,ou cannot update attributes of type event! -owever, you can select the event messa%e lin' to view the event messa%e details! (o rewind the wor'flow to an earlier activity sta%e, select the Rewind button! In the Rewind pa%e, select the activity you want from the list of activities that the +or'flow En%ine has reached! .racle +or'flow stops processin% at the current activity and resumes processin% at the specified activity! Note: ,ou cannot rewind a suspended wor'flow! ,ou must resume the wor'flow before you can rewind it! (o suspend the wor'flow, select the "uspend +or'flow button! *ll further processin% for the wor'flow is suspended until the process is resumed, and all subprocesses are suspended as well! (o resume the wor'flow if it is suspended, select the Resume +or'flow button! Processin% for the wor'flow is resumed, and all subprocesses are resumed as well! *ny activities that were transitioned to while the wor'flow was suspended are now executed! (o cancel the wor'flow, select the Cancel +or'flow button! In the Cancel pa%e, select *pply! (he +or'flow En%ine sets the status of the wor'flow to /0.RCE, and all processin% for the wor'flow is canceled and cannot be restarted!

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 12 of 40

Related Topics Accessing the Administrator Monitor

Viewing Responses
The Monitor Responses page shows information about notifications sent by a workflow and responses from workflow participants. For example, you can use this page to view individual responses to a voting activity. The page identifies the displayed workflow by its workflow type internal name and item key, as well as by its user key, if it has one. ext, a hierarchical grid displays the process hierarchy formed by the selected workflow and any child workflows associated with it. To view the notifications for a workflow in the hierarchy, select the workflow process name link in the !rocess ame column. To send e"mail to the owner of a workflow, select the user link in the #wned $y column. %pecify the type and status of the notifications you want to view. %elect the Response otifications option to view response"re&uired notifications, the F'( otifications option to view information"only )F'(* notifications, or both. %elect the +losed otifications option to view only closed notifications of the selected type. ,eselect this option to view both open and closed notifications. Then review the notification list. To view and respond to a notification in the otification ,etails page, select the sub-ect link in the otification %ub-ect column. The otification ,etails page includes the same options that are displayed when accessed through a user.s worklist, allowing you to take any action that is available for the notification. %ee/ To 0iew the ,etails of a otification, #racle 1orkflow 2ser.s 3uide. To send e"mail to the recipient of a notification, select the user link in the Recipient column. To view details about a notification and the recipient.s response, select the details icon in the 0iew Response ,etails column. Viewing Notification Response Details The otification Response ,etails page displays the following details about the selected response/ otification %ub-ect " The sub-ect line of the notification.

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 1' of 40

Respondent - The user who responded to the notification. To send e-mail to the respondent, select the user link. Original Recipient - The user to whom the notification was originally sent. If the original recipient is different than the respondent, then the original recipient reassigned responsibility for replying to the respondent. To send e-mail to the original recipient, select the user link. Notification Sent - The date and time when the notification was sent. Response Recei ed - The date and time when the response was recei ed. Response - The response alue that is the result of the notification. The Signature !etails region specifies whether the notification re"uired an electronic signature, and if so, the signature type, either a password-based signature or a certificate-based digital signature. #or a notification that re"uired a signature, the region also displays the following information$ Signature I! - The numerical identifier for the signature re"uest. This information is shown only for certificate-based signatures. Signature - The te%t string representing the signature created using the signer&s certificate. This information is shown only for certificate-based signatures. 'ctual Signer - The user who submitted the signature. (reation !ate - The date when the re"uest for a signature was created. Signed !ate - The date when the user submitted the signature. The 'dditional Response Information region lists any further response alues re"uested in the notification in addition to the result response. Note: #or information-only notifications or open response-re"uired notifications, the Notification Response !etails page only shows details about the outbound notification. Related Topics 'ccessing the 'dministrator )onitor *+#,SI-,.O/I(0 'ttribute, Oracle +orkflow !e eloper&s -uide Re iewing 1lectronic Signature !etails

Viewing Workflow Details

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 14 of 40

The +orkflow !etails page shows information about a selected workflow. The page identifies the displayed workflow by its workflow type internal name and item key, as well as by its user key, if it has one. Ne%t, a hierarchical grid displays the process hierarchy formed by the selected workflow and any child workflows associated with it. To iew the details for a workflow in the hierarchy, select the workflow process name link in the .rocess Name column. To send e-mail to the owner of a workflow, select the user link in the Owned 2y column. The +orkflow !efinition region displays the following information about the workflow type$ Internal Name - The workflow type internal name. !escription - The workflow type description. .ersistence Type - The persistence type, either .ermanent if the runtime status information is maintained indefinitely until it is specifically purged, or Temporary if the runtime status information is maintained for a specified number of days after the workflow completion date before it can be purged. .ersistence !ays - If the persistence type is Temporary, the number of days from the time a workflow of this workflow type completes before its status audit trail can be purged. Selector - The selector3callback function that determines which process acti ity to run for the workflow type in a particular situation. The +orkflow 'ttributes region lists the names and alues of the item attributes for the workflow. #or an attribute of type e ent, select the e ent message link to iew the e ent message details. If you ha e the appropriate workflow administrator pri ileges and you are iewing a workflow that is not yet complete, you can use the administration buttons to perform administrati e operations on the workflow. To iew the status diagram for the workflow, select the 4iew !iagram button. To change the alues of any item attributes, select the 5pdate 'ttributes button. In the 5pdate +orkflow 'ttributes page, enter the new alues you want. Note: 0ou cannot update attributes of type e ent. 6owe er, you can select the e ent message link to iew the e ent message details. To rewind the workflow to an earlier acti ity stage, select the Rewind button. In the Rewind page, select the acti ity you want from the list of acti ities that the +orkflow

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 1) of 40

1ngine has reached. Oracle +orkflow stops processing at the current acti ity and resumes processing at the specified acti ity. Note: 0ou cannot rewind a suspended workflow. 0ou must resume the workflow before you can rewind it. To suspend the workflow, select the Suspend +orkflow button. 'll further processing for the workflow is suspended until the process is resumed, and all subprocesses are suspended as well. To resume the workflow if it is suspended, select the Resume +orkflow button. .rocessing for the workflow is resumed, and all subprocesses are resumed as well. 'ny acti ities that were transitioned to while the workflow was suspended are now e%ecuted. To cancel the workflow, select the (ancel +orkflow button. In the (ancel page, select 'pply. The +orkflow 1ngine sets the status of the workflow to *#OR(1, and all processing for the workflow is canceled and cannot be restarted. Related Topics 'ccessing the 'dministrator )onitor

Viewing Error Information for a Workflow


The +orkflow 1rrors page shows error information for an errored workflow. The page identifies the displayed workflow by its workflow type internal name and item key, as well as by its user key, if it has one. The page displays the following error details$ #ailed 'cti ity - The name of the acti ity that encountered an error. 'cti ity Type - The acti ity type, either #unction, Notification, 1 ent, or .rocess. 1rror Name - The internal name of the error. 1rror )essage - The error message describing the error. 1rror Stack - (onte%t information to help you locate the source of the error. Note: If you na igated to the +orkflow 1rrors page from an error status link for a workflow, the page shows details for each errored acti ity within the workflow. If you na igated to the page from an error status link for a single errored acti ity, the page shows details for only that acti ity. To iew the status diagram for the workflow, select the 4iew !iagram button.

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 16 of 40

If the Workflow Errors page shows only one errored activity, and you have the appropriate workflow administrator privileges, you can use the activity administration buttons to respond to the error. To reassign an errored notification activity, select the Reassign button. See To Reassign a !otification to "nother #ser, $racle Workflow #ser%s &uide. Note: The Reassign button appears only for a notification activity. "dditionally, you cannot reassign a notification from the Status 'onitor if the E(pand Roles option is selected for the notification or if it is a voting notification that tallies the recipients% responses. See )oting "ctivity, $racle Workflow *eveloper%s &uide. To suspend an errored process activity, select the Suspend button. "ll further processing for the process is suspended until the process is resumed. Note: If you suspend the root process for a workflow, all subprocesses for the workflow are suspended as well. The Suspend button appears only for an errored process activity. To resume an errored process activity that is suspended, select the Resume button. +rocessing for the process is resumed and any activities that were transitioned to while the process was suspended are now e(ecuted. Note: If you resume the root process for a workflow, all subprocesses for the workflow are resumed as well. The Resume button appears only for an errored process activity that is suspended. To skip the errored activity and force the workflow to transition to the ne(t activity, select the Skip button. In the Skip page, enter the result value to assign to the activity if re,uired. Note: -ou cannot skip a suspended process activity. -ou must resume the process before you can skip it. To retry the errored activity, select the Retry button. Note: -ou cannot retry a suspended process activity. -ou must resume the process before you can retry it. Note: -ou can also use the Retry Errored Workflow "ctivities concurrent program to retry multiple errored activities for a particular item type at once. See Retry Errored Workflow "ctivities ./!*W/RET0. Related Topics "ccessing the "dministrator 'onitor

Assigning Specialized Workflow Monitoring Privileges

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 1% of 40

You can designate certain users as administrators only for particular types of workflows by assigning those users specialized workflow monitoring privileges with restricted access to workflow data. You can base the restrictions on a defined set of item types or on criteria specific to a particular functional area. Ensure that users who act as specialized workflow administrators have access to the administrator version of the Status Monitor, either through an Oracle orkflow responsibility or from another application. See! Oracle orkflow "dministrator #avigation $aths and $roviding "ccess to the Status Monitor from "pplications. You must also grant permissions to specialized workflow administrators to enable them to perform administrative actions within the Status Monitor for workflows to which they have access. %owever, note that users cannot perform any actions on workflows that they own themselves, irrespective of any permissions granted to them. Only users with full workflow administrator privileges assigned in the orkflow &onfiguration page can perform administrative actions on workflows that they own themselves. Note: 'f a user has full workflow administrator privileges assigned in the orkflow &onfiguration page, then those privileges override any specialized workflow monitoring privileges assigned to that user. (hat is, a user with full workflow administrator privileges can access all workflows, irrespective of any restrictions defined for any specialized privileges. See! Setting )lobal *ser $references. To Grant Restricted Access to Workflow Monitoring Data You can restrict access to workflow monitoring data based only on item types, only on functional criteria, or on both item types and functional criteria. %owever, because grants based on functional criteria depend on item attribute values, these grants are most effective when combined with grants for item types that share the same item attributes. +or more information about creating instance sets and grants, see! ,efining ,ata Security $olicies, Oracle E-.usiness Suite System "dministrator/s )uide - Security and "ssigning $ermissions to 0oles, Oracle E-.usiness Suite System "dministrator/s )uide - Security. 1. 'f you want to restrict access based on item types, perform the following steps. &reate an instance set on the ob2ect O03+4O 5'(EMS with a predicate that includes the parameters in which you will specify the item types you want. +or e6ample, the following e6cerpt shows a sample predicate for granting access to a single item type!
&TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER1

You can also grant access to multiple item types, up to a ma6imum of ten, which is the ma6imum number of parameters you can specify for a grant. +or e6ample, the following e6cerpt shows a sample predicate for granting access to ten item types!
&TABLE_ALIAS.ITEM_TYPE = &GRANT_ALIAS.PARAMETER1

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 1$ of 40

OR OR OR OR OR OR OR OR OR

&TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE &TABLE_ALIAS.ITEM_TYPE

= = = = = = = = =

&GRANT_ALIAS.PARAMETER2 &GRANT_ALIAS.PARAMETER3 &GRANT_ALIAS.PARAMETER4 &GRANT_ALIAS.PARAMETER5 &GRANT_ALIAS.PARAMETER6 &GRANT_ALIAS.PARAMETER7 &GRANT_ALIAS.PARAMETER8 &GRANT_ALIAS.PARAMETER9 &GRANT_ALIAS.PARAMETER10

The following excerpt shows another alternative for a sample predicate for granting access to ten item types:
&TABLE_ALIAS.ITEM_TYPE in &GRANT_ALIAS.PARAMETER1! &GRANT_ALIAS.PARAMETER2! &GRANT_ALIAS.PARAMETER3! &GRANT_ALIAS.PARAMETER4! &GRANT_ALIAS.PARAMETER5 &GRANT_ALIAS.PARAMETER6! &GRANT_ALIAS.PARAMETER7! &GRANT_ALIAS.PARAMETER8! &GRANT_ALIAS.PARAMETER9! &GRANT_ALIAS.PARAMETER10"

Create a grant using the instance set you created. First, specify appropriate security context information such as grantee and responsibility. Then specify the following data context information: Object !O"#F$O!%&T'() *ata Context Type &nstance )et &nstance )et The instance set you created on !O"#F$O!%&T'(). +arameter , through +arameter ,- The internal names of the item types to which you want to grant access, such as !F*'(O. .ou can specify one item type name in each parameter that is referenced in the predicate of your instance set, up to the maximum of ten. Note: .ou must explicitly reference each grant parameter you want to use in the predicate of your instance set. /ny grant parameters that are not referenced in the instance set predicate are ignored, even if you enter values in the parameter fields in the Create 0rant pages. )et: 1usiness wor2flow item permission set 3. &f you want to restrict access based on criteria specific to a particular functional area using item attributes, perform the following steps. Create an instance set on the object !O"#F$O!%&T'(%/TT"%4/$5') with a predicate that defines those criteria. For example, the following excerpt shows a

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 1' of 40

sample predicate defining criteria for HR data, using the CURRENT_PERSON_I item attri!ute"
&TABLE_ALIAS.NAME='CURRENT_PERSON_ID' and EXISTS (SELECT 'Y' FROM per_pe p!e_" #$ERE per% n_&d = &TABLE_ALIAS.TEXT_'ALUE AND TRUNC (SYSDATE( BET#EEN e""e)*&+e_%*ar*_da*e AND e""e)*&+e_end_da*e(

#s another e$ample, if the %or&flo%s for a particular organi'ation are mar&ed %ith an item attri!ute named OR(_I , the follo%ing e$cerpt sho%s a sample predicate that allo%s access onl) to %or&flo%s associated %ith the user*s current organi'ation conte$t+
&TABLE_ALIAS.NAME = 'OR,_ID' and &TABLE_ALIAS.TEXT_'ALUE = %-.%*r (%/%_) n*e0*('USEREN''1'CLIENT_INFO'(12123(

Create a grant using the instance set )ou created+ ,irst, specif) appropriate securit) conte$t information such as grantee and responsi!ilit)+ Then specif) the follo%ing data conte$t information" O!-ect . /OR0,1O/_ITE2_#TTR_3#1UES ata Conte$t T)pe . Instance Set Instance Set . The instance set )ou created on /OR0,1O/_ITE2_#TTR_3#1UES+ Set . 4usiness %or&flo% item attri!ute permission set To Grant Permissions for Administrative Actions within the Status Monitor If )ou %ant to assign a user pri5ileges for all administrati5e actions %ithin the Status 2onitor, assign that user the role /,_# 2IN_RO1E+ This role !) default is granted the seeded permission set 64usiness %or&flo% item permission set6 7/,_# 2IN_PSET8, %hich includes the permissions for all the administrati5e actions+ If )ou %ant to assign a user pri5ileges onl) for specific administrati5e actions, create a custom permission set %ith the permissions )ou %ant to assign, and grant that permission set to the user+ The follo%ing ta!le lists the permission names and codes that correspond to the administrati5e actions+ Permissions for Administrative Actions in the Status Monitor Action S&ip Permission Name S&ip /or&flo% #cti5it) Permission Code /,_S0IP

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 20 of 40

Retr) Re%ind

Retr) #cti5it) Re%ind /or&flo%

/,_RETR: /,_RE/IN /,_SUSPEN /,_C#NCE1

Suspend Suspend /or&flo% Cancel Update 2onitor Cancel /or&flo%

Update /or&flo% Item #ttri!utes /,_UP #TE_#TTR 2onitor ata /,_2ON_ #T#

See" #ssigning Permissions to Roles, Oracle E.4usiness Suite S)stem #dministrator*s (uide . Securit)+

Providing Access to the Status Monitor from Applications


#pplication de5elopers can pro5ide access to the administrator and self.ser5ice 5ersions of the Status 2onitor from %ithin an application+ The Status 2onitor supports the follo%ing access modes" Standard access . 1oosel) coupled access from an Oracle #pplication ,rame%or&.!ased /e! page to a Status 2onitor page %ithin the full Oracle /or&flo% application (uest access . Tightl) coupled access from an Oracle #pplication ,rame%or&.!ased /e! page to a freestanding Status 2onitor page for a particular %or&flo%, %ithout access to the rest of the Oracle /or&flo% application

Menu Setup
4efore )ou can add Status 2onitor access to )our application, )ou must set up the menu for the appropriate responsi!ilit) to include Status 2onitor functionalit) through Oracle /or&flo% menus+ ,or standard or guest access from an Oracle #pplication ,rame%or&.!ased /e! page or an Oracle E.4usiness Suite form, the menu for the responsi!ilit) through %hich users access that page or form must also include the menu for the Status 2onitor 5ersion and access mode )ou %ant+ Other%ise, users %ill encounter function securit) errors %hen na5igating to the Status 2onitor from )our page or form+ To a5oid these errors, add the appropriate Oracle /or&flo% menu to the top.le5el menu for )our responsi!ilit)+ The menus for the Status 2onitor are" /or&flo% #dministrator #pplication 7/,_# 2INISTR#TOR_#PP1IC#TION8 . Re9uired for standard access to the #dministrator 2onitor /or&flo% (uest 2onitor #pplication 7/,_(_2ONITOR_#PP1IC#TION8 . Re9uired for

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 21 of 40

guest access to the Administrator Monitor Workflow Self-Service Application (WF_SELF_SE !"#E_A$$L"#A%"&'( - e)uired for standard access to the Self-Service Monitor Workflow *uest Self-Service Monitor Application (WF_SS*_M&'"%& _A$$L"#A%"&'( e)uired for guest access to the Self-Service Monitor

Access through URLs


+ou can provide standard or guest access to the Status Monitor from an &racle Application Framework-,ased We, page- +ou can also provide guest access to the administrator version of the Status Monitor from &racle Workflow notifications or $L.S/L applications that can call a 0 L"n 1our application code2 call an A$" to o,tain or redirect to a 0 L for an &racle Workflow Status Monitor page- For standard and guest access2 &racle Workflow provides 3ava methods in the oracle-apps-fnd-wf-monitor-we,ui-Monitor class to o,tain or redirect to appropriate 0 LsFor guest access to the Administrator Monitor2 &racle Workflow also provides $L.S/L functions in the WF_M&'"%& package to o,tain appropriate 0 Ls- See4 Workflow Monitor A$"s2 &racle Workflow A$" eference5ispla1 the Status Monitor ,1 redirecting to the Status Monitor page 1ou want or using the 0 L 1ou o,tained in whatever wa1 is appropriate within 1our application code-

Access from Oracle E-Business Suite Forms


+ou can provide standard or guest access from an &racle E-6usiness Suite application to the Status Monitor ,1 using self-service functions- +ou can call these functions from an &racle E6usiness Suite form2 or add the menus that contain the functions to another menu associated with another responsi,ilit1- 0se the function F'5_F0'#%"&'-E7E#0%E to e8ecute a Status Monitor functionRelated Topics Accessing the Administrator Monitor Accessing the Self-Service Monitor2 &racle Workflow 0ser9s *uide &verview of Function Securit12 &racle E-6usiness Suite S1stem Administrator9s *uide - Securit1 &verview of Menus and Function Securit12 &racle E-6usiness Suite 5eveloper9s *uide &verview of Form 5evelopment Steps2 &racle E-6usiness Suite 5eveloper9s *uide Menus Window2 &racle E-6usiness Suite 5eveloper9s *uide

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 22 of 40

Standard Access Guest Access

Standard Access
Standard Status Monitor access provides loosely coupled access from an Oracle Application Framework-based Web page or Oracle E- usiness Suite form! to a Status Monitor page wit"in t"e full Oracle Workflow application# $n t"is mode! t"e specified Status Monitor page is displayed wit" t"e full Oracle Workflow menu! allowing users to navigate out of t"e Status Monitor and perform ot"er tasks wit"in Oracle Workflow# %ocator links! also known as breadcrumbs! let users navigate from t"e Status Monitor back to t"e calling application# Wit" standard access! users are fully aut"enticated# Only users wit" workflow administrator privileges! as specified in t"e Workflow &onfiguration page! can view workflows owned by ot"ers and perform administrative operations in t"e Status Monitor# See' Setting Global (ser )references# W"en you provide standard access to t"e Status Monitor from your application! you can optionally specify a workflow item type and item key to *uery and specify w"ic" page you want to initially display# $f you specify bot" t"e item type and item key for a workflow! t"at workflow is automatically *ueried in t"e Status Monitor# +ou can c"oose to initially display t"e workflow in t"e main Workflows searc" page! t"e Activity ,istory page in t"e Administrator Monitor or -otification ,istory page in t"e Self-Service Monitor! t"e Status .iagram page! or t"e Monitor /esponses page# $f you provide an item type and item key but do not specify an initial page! t"e workflow is initially displayed in t"e Activity ,istory page in t"e Administrator Monitor or -otification ,istory page in t"e Self-Service Monitor# Note: 0"e specified workflow is only displayed if t"e user owns t"at workflow or "as workflow administrator privileges to view workflows owned by ot"ers# $f t"e user does not "ave t"e necessary privileges to view t"e workflow! an error message is displayed# $n t"is case t"e user can optionally select anot"er Workflow tab# $f you specify only a workflow item type! t"e main Workflows searc" page is displayed! and workflows of t"e specified type t"at were started wit"in t"e last two weeks are automatically *ueried# $f you do not specify a workflow item type! t"e main Workflows searc" page is displayed# -o automatic *uery is performed#

Standard Access in Java


Oracle Workflow provides 1ava met"ods to redirect to t"e Status Monitor wit" standard access or to obtain (/%s for standard access to t"e Status Monitor# 0"ese met"ods are defined in t"e 1ava class called oracle#apps#fnd#wf#monitor#webui#Monitor#

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 2' of 40

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 !e used within an "racle Application #ramewor$ application page. #or e%ample &ou can set this URL as a destination lin$ on an "A'e!(ean. 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 !e used within an "racle Application #ramewor$ application page. #or e%ample &ou can set this URL as a destination lin$ on an "A'e!(ean. The URL is returned in the following format)
/OA_HTML/OA.jsp?OAFunc=[parameters...]

'hen calling these methods &ou must provide the following parameters to indicate how &ou want to displa& the Status Monitor) page*onte%t - The "A+age*onte%t of the calling page. itemT&pe - The internal name of a wor$flow item t&pe to automaticall& ,uer& in the Status Monitor (optional). item-e& - An item $e& to automaticall& ,uer& in the Status Monitor (optional). first+age - The Status Monitor page that &ou want to initiall& displa& (optional). MA./ - Main 'or$flows search page 0.ST"R1 - Activit& 0istor& page in the Administrator Monitor or /otification 0istor& page in the Self-Service Monitor 2.A3RAM - Status 2iagram page R4S+"/S4S - Monitor Responses page Note: #or access to the 0.ST"R1 2.A3RAM or R4S+"/S4S pages &ou must specif& an item t&pe and item $e&. retain*allingAM - Specif& true or false to indicate whether the "AApplicationModule of the calling page should !e retained while wor$ing in the Status Monitor. .f &ou specif& true retainAM51 is appended to the Status Monitor URL6 if &ou specif& false retainAM5/ is appended to the URL. The default is true.

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 24 of 40

All method calls for standard access should !e made from within an "racle Application #ramewor$-!ased 'e! page.

Standard Access from Oracle E-Business Suite Forms


1ou can provide standard access from an "racle 4-(usiness Suite application to the Status Monitor !& using self-service functions. 1ou can call these functions from an "racle 4-(usiness Suite form or add the menus that contain the functions to another menu associated with another responsi!ilit&. The following ta!le lists the functions that provide standard access to the Status Monitor. These functions do not re,uire an& parameters. Standard Access Functions Function '#7STATUS7M"/.T"R Description 2ispla&s the 'or$flows search page in the administrator version of the Status Monitor.

'#7SS7STATUS7M"/.T"R 2ispla&s the 'or$flows search page in the self-service version of the Status Monitor. 1ou can call the function #/27#U/*T."/.484*UT4 to e%ecute a standard access function. See) #/27#U/*T."/.484*UT4 "racle 4-(usiness Suite 2eveloper9s 3uide. The following code e%ample demonstrates how to e%ecute the '#7STATUS7M"/.T"R function using #/27#U/*T."/.484*UT4.
FND_FUNCTION.EXECUTE(FUNCTION_NAME => 'WF_STATUS_MONITOR');

See) "verview of #orm 2evelopment Steps "racle 4-(usiness Suite 2eveloper9s 3uide and Menus 'indow "racle 4-(usiness Suite 2eveloper9s 3uide.

Menu Setup
.f &ou use a standard access function within &our responsi!ilit& &ou must add the menu containing that function to the top-level menu for &our responsi!ilit&. The '#7STATUS7M"/.T"R function is seeded on the 'or$flow Administrator Application ('#7A2M./.STRAT"R7A++L.*AT."/) menu and the '#7SS7STATUS7M"/.T"R function is seeded on the 'or$flow Self-Service Application ('#7S4L#7S4R:.*47A++L.*AT."/) menu. Note: 1ou cannot add the Status Monitor functions to &our menu directl&. To include these functions &ou must add the "racle 'or$flow menu that contains the function &ou want. The 'or$flow Administrator Application menu is seeded on the 'or$flow Administrator (/ew) menu (#/27'#A2M./7/4') associated with the 'or$flow Administrator 'e! (/ew) responsi!ilit&. Similarl& the 'or$flow Self-Service Application menu is seeded on the 'or$flow

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 2) of 40

User (/ew) menu (#/27'#US4R7/4') associated with the 'or$flow User 'e! (/ew) responsi!ilit&.

Migrating to Standard Access Functions


.f &our application used self-service functions to provide access to the previous version of the 'or$flow Monitor &ou can migrate to the new Status Monitor !& replacing the functions &ou previousl& called with the appropriate new functions. The following ta!le shows the correspondence !etween functions for the previous 'or$flow Monitor and the standard access functions for the new Status Monitor. Migrating to Standard Access Functions Previous Function #/27#/2'#.AS (if called without an& parameters) Related Topics Migrating to 3uest Access #unctions New Function '#7STATUS7M"/.T"R or '#7SS7STATUS7M"/.T"R

Guest Access
3uest Status Monitor access provides tightl& coupled access from an "racle Application #ramewor$-!ased 'e! page or "racle 4-(usiness Suite form to a freestanding Status Monitor page for a particular wor$flow without access to the rest of the "racle 'or$flow application. .n this mode the specified Status Monitor page is displa&ed without the full "racle 'or$flow menu so that users cannot navigate out of the Status Monitor to other "racle 'or$flow pages. 3uest access lets users navigate among the top-level Status Monitor pages including the Activit& 0istor& page in the Administrator Monitor or /otification 0istor& page in the Self-Service Monitor Status 2iagram page Monitor Responses page and 'or$flow 2etails page. Users can also drill down from the top-level pages to related detail or action pages such as navigating from the /otification 0istor& page to the *ancel page. Additionall& locator lin$s also $nown as !readcrum!s let users navigate from the Status Monitor !ac$ to the calling application. 0owever users cannot navigate from the Status Monitor to other parts of "racle 'or$flow. 'ith guest access users are full& authenticated. 0owever in this mode &ou programmaticall& control which wor$flow process users can view and whether users can perform administrative operations in the Status Monitor rather than having these privileges controlled !& the wor$flow administrator setting in the 'or$flow *onfiguration page. 'hen &ou provide guest access to the Status Monitor from &our application &ou must specif& a wor$flow item t&pe and item $e& to automaticall& ,uer&. 3uest access does not include search capa!ilities so users can onl& view the wor$flow process &ou specif&. 1ou can choose to initiall& displa& the specified wor$flow in either the Activit& 0istor& page in the Administrator Monitor or

http //docs!oracle!com/cd/"1#$2$%01/doc!121/e12&0'/('1&'&#('1&40)!htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 26 of 40

Notification History page in the Self-Service Monitor, the Status Diagram page, or the Monitor Responses page. If you do not specify an initial page, the wor flow is initially displayed in the !ctivity History page in the !dministrator Monitor or Notification History page in the Self-Service Monitor. Note: "he wor flow is only displayed if the specified item type, item ey, and administrator mode are valid. #therwise, an error message is displayed. "he $or flow ta%s are not displayed, so the user cannot navigate to any other part of #racle $or flow. &ou must also set the administrator mode to determine whether to grant the user privileges to perform administrative operations within the Status Monitor. &ou can choose one of the following options' Never grant administrator privileges, regardless of whether the user %elongs to the wor flow administrator role specified in the $or flow (onfiguration page. "his option is the default if you do not specify an administrator mode. !lways grant administrator privileges, regardless of whether the user %elongs to the wor flow administrator role specified in the $or flow (onfiguration page. (hec whether the user %elongs to the wor flow administrator role specified in the $or flow (onfiguration page and grant administrator privileges accordingly.

Guest Access in Java


#racle $or flow provides )ava methods to o%tain *R+s for guest access to the Status Monitor. "hese methods are defined in the )ava class called oracle.apps.fnd.wf.monitor.we%ui.Monitor.

Monitor.redirect"o,uest!dv*rl- . - Redirects to the !dministrator Monitor with guest


access.

Monitor.redirect"o,uestSimple*rl- . - Redirects to the Self-Service Monitor with guest


access.

Monitor.get,uest!dvance*rl- . - Returns a *R+ for guest access to the !dministrator


Monitor, in a form that can %e used within an #racle !pplication /ramewor application page. /or e0ample, you can set this *R+ as a destination lin on an #!$e%1ean. "he *R+ is returned in the following format'
/OA_HTML/OA.jsp?OAFunc=[parameters...]

Monitor.get,uestSimple*rl- . - Returns a *R+ for guest access to the Self-Service


Monitor, in a form that can %e used within an #racle !pplication /ramewor application page. /or e0ample, you can set this *R+ as a destination lin on an #!$e%1ean. "he *R+ is returned in the following format'
/OA_HTML/OA.jsp?OAFunc=[parameters...]

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 2% of 40

When calling these methods, you must provide the following parameters to indicate how you want to display the Status Monitor: pageContext - The O !ageContext of the calling page" itemType - The internal name of a wor#flow item type to automatically $uery in the Status Monitor" item%ey - n item #ey to automatically $uery in the Status Monitor" adminMode - Specify &'& to grant administrator privileges to the user accessing the Status Monitor, &(& to withhold administrator privileges from the user, or &)& to chec# whether the user *elongs to the wor#flow administrator role specified in the Wor#flow Configuration page and grant administrator privileges accordingly" The default is &(&" first!age - The Status Monitor page that you want to initially display" +,STO-' - ctivity +istory page in the dministrator Monitor or (otification +istory page in the Self-Service Monitor ., /- M - Status .iagram page -0S!O(S0S - Monitor -esponses page The default is +,STO-'" retainCalling M - Specify true or false to indicate whether the O pplicationModule of the calling page should *e retained while wor#ing in the Status Monitor" ,f you specify true, retain M1' is appended to the Status Monitor )-23 if you specify false, retain M1( is appended to the )-2" The default is true" ll method calls for guest access should *e made from within an Oracle pplication 4ramewor#*ased We* page" Example The following code excerpt shows an example of how to provide guest access to the Status Monitor in 5ava code" This example calls the get/uest dvance)rl67 method in the oracle"apps"fnd"wf"monitor"we*ui"Monitor class"
/***************************************************************** ** ** Guest Access ** ** Assumes all method calls are made from within an Oracle ** Application Framework page. ** *****************************************************************/ ...

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 2$ of 40

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 Activit! "istor! page. public void process#e$uest%OA&age'ontext page'ontext( OA)eb*ean web*ean+ , super.process#e$uest%page'ontext( web*ean+; ... -tring -tring -tring -tring itemT!pe . / however this value is obtained in page 0; item1e! . / however this value is obtained in page 0; first&age . "2-TO#3 ; returnTo4abel . #eturn to Application 536 ;

// -et to 7 to have Monitor code figure out if the current // user should have )orkflow Administrator privileges based // on the Administrator role designation in )orkflow. -tring adminMode . // // // // 7 ;

)ill add a parameter retainAM.3 to the resulting url so the developer doesn8t have to do this manuall! if he wants to retain the calling Application Module when the user navigates to the -tatus Monitor.

boolean retain'allingAM . true; -tring url . null; tr! , url . Monitor.get9uestAdvance7rl%page'ontext( itemT!pe( item1e!( adminMode( first&age( returnTo4abel( retain'allingAM+; : catch %Monitor7#4;xception me+ , // "andle not being able to obtain a valid redirect7rl for // the parameters. : // -et the url string on the web bean. OA-tatic-t!ledText*ean monitor4ink . %OA-tatic-t!ledText*ean+find2ndexed'hild#ecursive % AdvancedMonitor4ink +; monitor4ink.set<estination%url+; ... : // end process#e$uest%+

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 2' of 40

Guest Access in PL/SQL


Oracle Workflow also provides PL/SQL functions to obtain URLs for guest access to the Ad inistrator !onitor" #hese functions are defined in the PL/SQL package called W$%!O&'#OR" See( Workflow !onitor AP's) Oracle Workflow AP' Reference"

W$%!O&'#OR"*etAdvanced+nvelopeURL, - . Returns a co plete URL for guest access to


the Activit/ 0istor/ page in the Ad inistrator !onitor"

W$%!O&'#OR"*et1iagra URL, - . Returns a co plete URL for guest access to the Status
1iagra page in the Ad inistrator !onitor"

W$%!O&'#OR"*et+nvelopeURL, - . Returns a co plete URL for guest access to the


!onitor Responses page in the Ad inistrator !onitor" When calling these ethods) /ou ust provide the following para eters to indicate how /ou want to displa/ the Status !onitor( 2%agent . #his para eter is no longer used" Set this para eter to null" 2%ite %t/pe . #he internal na e of a workflow ite Status !onitor" 2%ite %ke/ . An ite t/pe to auto aticall/ 3uer/ in the

ke/ to auto aticall/ 3uer/ in the Status !onitor"

2%ad in% ode . Specif/ 45+S4 to grant ad inistrator privileges to the user accessing the Status !onitor) or 4&O4 to withhold ad inistrator privileges fro the user" #he default is 4&O4" 5ou can use these URLs to provide access to the Ad inistrator !onitor fro a PL/SQL application) for e2a ple) or include a URL in a workflow notification essage to allow a user to access the Ad inistrator !onitor fro the notification" Note: 'n Oracle +.6usiness Suite) /ou can call the function $&1%U#'L'#'+S"OP+&%URL to open a Web browser and have it connect to a specified URL) such as a Status !onitor URL" See( $&1%U#'L'#'+S(Utilit/ Routine) Oracle +.6usiness Suite 1eveloper4s *uide"

Guest Access from Notifications


5ou can provide guest access to the Ad inistrator !onitor fro a workflow notification" #o do so) define a essage attribute of t/pe URL) and include or attach this attribute in the notification essage" Obtain a guest access URL using one of the W$%!O&'#OR PL/SQL functions) and set the value of the essage attribute to this URL" #he user who receives the notification can access the Ad inistrator !onitor b/ viewing the notification) either through the Worklist Web pages or through an e. ail application) and clicking the link in the essage" 'f users are not alread/ logged into Oracle +.6usiness Suite) the/ ust first log in before the/ can access the Ad inistrator !onitor fro the link" See( #o 1efine a !essage Attribute) Oracle

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page (0 of 40

Workflow Developer's Guide.

Guest Access from Oracle E-Business Suite Forms


You can provide guest access from an Oracle E-Business Suite application to t e Status !onitor "# using self-service functions. You can call t ese functions from an Oracle E-Business Suite form$ or add t e menus t at contain t e functions to anot er menu associated wit anot er responsi"ilit#. % e following ta"le lists t e functions t at provide guest access to t e Status !onitor. Guest Access Functions Function W3+G+')%(6(%(ES W3+G+D('G5'! Description Displa#s t e 'ctivit# 7istor# page for t e specified workflow in t e administrator version of t e Status !onitor. Displa#s t e Status Diagram page for t e specified workflow in t e administrator version of t e Status !onitor.

W3+SSG+')%(6(%(ES Displa#s t e 4otification 7istor# page for t e specified workflow in t e self-service version of t e Status !onitor. W3+SSG+D('G5'! Displa#s t e Status Diagram page for t e specified workflow in t e self-service version of t e Status !onitor.

W en #ou call one of t e guest access functions$ #ou must pass t e function t e following parameters& item%#pe - ' valid workflow item t#pe$ determined "# #our application. % e item t#pe and item ke# toget er identif# t e workflow process to displa#. You must specif# t e same item t#pe as #ou used to o"tain t e encr#pted access ke#. You s ould use t e ()*+)',,.Encr#pt-. function to encr#pt t is value. item/e# - ' valid item ke#$ determined "# #our application. % e item t#pe and item ke# toget er identif# t e workflow process to displa#. You must specif# t e same item ke# as #ou used to o"tain t e encr#pted access ke#. You s ould use t e ()*+)',,.Encr#pt-. '0( to encr#pt t is value. wm - % e encr#pted administrator mode t at determines w et er t e user s ould ave privileges to perform administrative operations in t e Status !onitor. )all t e 0,1S2, function W3+3W/!O4.GetEncr#pted'dmin!ode-. to o"tain t e encr#pted value for t e administrator mode #ou want$ eit er Y or 4. You must specif# t e same administrator mode value to encr#pt as #ou used to o"tain t e encr#pted access ke#. See& GetEncr#pted'dmin!ode$ Oracle Workflow '0( 5eference. wa - 'n encr#pted access ke# for a specified item t#pe$ item ke#$ and administrator mode com"ination. )all t e 0,1S2, function W3+3W/!O4.GetEncr#pted'ccess/e#-. to o"tain

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'0(/)(1'('$)(1'40*"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 31 of 40

this value for the item type, item key, and administrator mode you want. See: GetEncryptedAccessKey, Oracle Workflow A ! "eference. Note: #ecause users are authenticated in $uest access, you can call the %&S'% function W()(WK*O+.!s*onitorAdministrator,- to determine whether a the user has administrator privile$es .ased on the workflow administrator settin$ in the Workflow /onfi$uration pa$e. !f you use this function, you should use its result when o.tainin$ .oth the encrypted access key and the encrypted administrator mode, in order to avoid a discrepancy .etween these two values. See: !s*onitorAdministrator, Oracle Workflow A ! "eference. 0ou can also choose to $rant or withhold administrator privile$es in the Status *onitor .y specifyin$ the administrator mode as 0 or +, respectively, re$ardless of the workflow administrator settin$ in the Workflow /onfi$uration pa$e. retainA* 1 Specify 0 or + to indicate whether the OAApplication*odule of the callin$ pa$e should .e retained while workin$ in the Status *onitor. fE2t 1 An e2ternal fla$ used within Oracle Workflow. Set this parameter to 3. 0ou can call the function (+4)(5+/6!O+.E3E/56E to e2ecute a $uest access function specifyin$ your parameters. See: (+4)(5+/6!O+.E3E/56E, Oracle E1#usiness Suite 4eveloper7s Guide. Note: When you call (+4)(5+/6!O+.E3E/56E, you should use the W(A)86*%.conv)special)url)chars,- A ! to convert any special characters in the parameters you pass to the Status *onitor. 6he followin$ code e2ample demonstrates how to e2ecute the W()G)A/6!9!6!ES function usin$ (+4)(5+/6!O+.E3E/56E.
itemType := icx_call.encrypt('<your_item_type>'); itemKey := icx_call.encrypt('<your_item_key>'); adminMode := wf_fwkmon.isMonitorAdministrator('<user_name>'); wm := wf_fwkmon. et!ncryptedAdminMode(adminMode); wa := wf_fwkmon. et!ncryptedAccessKey('<your_item_type>'" '<your_item_key>'" adminMode); #$%_#&$'T()$.!*!'&T!( #&$'T()$_$AM! =+ ',#_-_A'T(.(T(!/'" )0!$_#1A- =+ '2'" /!//()$_#1A- =+ '2'" )T3!4_0A4AM/ =+ 'itemType='55(wfa_6tml.con7_special_8rl_c6ars(itemType)) 55'9'55'itemKey='55(wfa_6tml.con7_special_8rl_c6ars(itemKey)) 55'9'55'wm='55(wfa_6tml.con7_special_8rl_c6ars(wm)) 55'9'55'wa='55(wfa_6tml.con7_special_8rl_c6ars(wa))

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'03/(31'3'$(31'40)"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 32 of 40

55'9'55'retainAM=2' 55'9'55'f!xt=*' );

See: Overview of (orm 4evelopment Steps, Oracle E1#usiness Suite 4eveloper7s Guide and *enus Window, Oracle E1#usiness Suite 4eveloper7s Guide.

Menu Setup
!f you use a $uest access function within your responsi.ility, you must add the menu containin$ that function to the top1level menu for your responsi.ility. 6he W()G)A/6!9!6!ES and W()G)4!AG"A* functions are seeded on the Workflow Guest *onitor Application ,W()G)*O+!6O")A %!/A6!O+- menu, and the W()SSG)A/6!9!6!ES and W()SSG)4!AG"A* functions are seeded on the Workflow Guest Self1Service *onitor Application ,W()SSG)*O+!6O")A %!/A6!O+- menu. Note: 0ou cannot add the Status *onitor functions to your menu directly. 6o include these functions, you must add the Oracle Workflow menu that contains the function you want. 6he Workflow Guest *onitor Application menu is seeded on the Workflow Administrator ,+ewmenu ,(+4)W(A4*!+)+EW- associated with the Workflow Administrator We. ,+ewresponsi.ility. Similarly, the Workflow Guest Self1Service *onitor Application menu is seeded on the Workflow 5ser ,+ew- menu ,(+4)W(5SE")+EW- associated with the Workflow 5ser We. ,+ew- responsi.ility.

Migrating to Guest Access Functions


!f your application used self1service functions to provide access to the previous version of the Workflow *onitor, you can mi$rate to the new Status *onitor .y replacin$ the functions you previously called with the appropriate new functions. 6he followin$ ta.le shows the correspondence .etween functions for the previous Workflow *onitor and the $uest access functions for the new Status *onitor. Migrating to Guest Access Functions Previous Function (+4)W(*O+)A49 (+4)W(*O+)4!AG"A* (+4)(+4W(!AS ,if called with the !6E*)60 E, !6E*)KE0, A4*!+)*O4E, and A//ESS)KE0 parametersRelated Topics *i$ratin$ to Standard Access (unctions New Function W()G)A/6!9!6!ES W()G)4!AG"A* or W()SSG)4!AG"A* W()SSG)A/6!9!6!ES

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'03/(31'3'$(31'40)"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 33 of 40

Testing Status Monitor Access


You can use the Workflow Monitor Test Application to test the monitor access you want to provide from your application. The Programmatic Access page simulates calls to obtain U !s for navigating from an "racle Application #ramework$based Web page to a %tatus Monitor page or calls to redirect from an "racle Application #ramework$based Web page to a %tatus Monitor page. You can retrieve a test U ! or perform a trial redirection. The Programmatic Access page lets you test access to both the administrator and the self$service versions of the %tatus Monitor& using standard or guest access. The Advanced Worklist page is also included in the Workflow Monitor Test Application to let you test access from a workflow notification to the %tatus Monitor. You can test links from notifications to the administrator version of the %tatus Monitor& using guest access. 'n the Worklist& navigate to a notification that contains a link to the %tatus Monitor& and select that link to test the access it provides. %ee( To )iew *otifications from the Advanced Worklist& "racle Workflow User+s ,uide.

Menu Setup
The Workflow Monitor Test Application is available in "racle -$.usiness %uite& but it is not seeded on any "racle -$.usiness %uite menu. .efore you can use this module& your system administrator must add its menu to a top$level menu for a responsibility. The menu for the Workflow Monitor Test Application module is named Workflow Monitor Test Application /W#M"*0T-%T0APP!'1AT'"*2. #or e3ample& you can add this menu to the Workflow Administrator /*ew2 menu /#*40W#A4M'*0*-W2& which is associated with the Workflow Administrator Web /*ew2 responsibility& or to the Workflow User /*ew2 menu /#*40W#U%- 0*-W2& which is associated with the Workflow User Web /*ew2 responsibility. Additionally& when you navigate from the Workflow Monitor Test Application module to the %tatus Monitor using standard or guest access& you must perform the navigation from within a responsibility that also includes the menu for the %tatus Monitor version and access option you want to test. "therwise& you will encounter function security errors. To avoid these errors& ensure that the appropriate "racle Workflow menus are added to the same top$level menu as the W#M"*0T-%T0APP!'1AT'"* menu. The menus for the %tatus Monitor are( Workflow Administrator Application /W#0A4M'*'%T AT" 0APP!'1AT'"*2 $ e5uired for standard access to the Administrator Monitor Workflow ,uest Monitor Application /W#0,0M"*'T" 0APP!'1AT'"*2 $ e5uired for guest access to the Administrator Monitor Workflow %elf$%ervice Application /W#0%-!#0%- )'1-0APP!'1AT'"*2 $ e5uired for standard access to the %elf$%ervice Monitor Workflow ,uest %elf$%ervice Monitor Application /W#0%%,0M"*'T" 0APP!'1AT'"*2 $

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'03/(31'3'$(31'40)"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 34 of 40

Required for guest access to the Self-Service Monitor Note: The Workflow Administrator (New) menu includes the Workflow Administrator A lication and Workflow !uest Monitor A lication menus "# default$ Additionall#% the Workflow &ser (New) menu includes the Workflow Self-Service A lication and Workflow !uest Self-Service Monitor A lication menus "# default$ '$ Testing Standard Access ($ Testing !uest Access Related Topics Accessing the Administrator Monitor Accessing the Self-Service Monitor% )racle Workflow &ser*s !uide )verview of +unction Securit#% )racle ,--usiness Suite S#stem Administrator*s !uide - Securit# )verview of Menus and +unction Securit#% )racle ,--usiness Suite .evelo er*s !uide

Testing Standard Access


/ou can test standard access from an )racle A lication +ramework-"ased We" age to the Status Monitor in the 0rogrammatic Access age$ Standard access rovides loosel# cou led access to a Status Monitor age within the full )racle Workflow a lication$ To Test Standard Access '$ &se a We" "rowser to log on to a res onsi"ilit# s ecified "# #our s#stem administrator and choose the 0rogrammatic Access link$ ($ Select the Test 1Standard1 Access link$ 2$ 3n the Test 1Standard1 Access region% enter the test o tions #ou want$ ,ach o tion corres onds to a method arameter for the method in the oracle$a s$fnd$wf$monitor$we"ui$Monitor class that is "eing simulated$ See4 Standard Access in 5ava$ The test o tions include4 3tem T# e - ) tionall# enter the internal name of a workflow item t# e to automaticall# quer# in the Status Monitor$ 3tem 6e# - ) tionall# enter an item ke# to automaticall# quer# in the Status Monitor$

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'03/(31'3'$(31'40)"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 3) of 40

First Page - Specify the Status Monitor page that you want to initially display. MAIN - Main Workflows search page HIS !"# - Acti$ity History page in the Ad%inistrator Monitor or Notification History page in the Self-Ser$ice Monitor &IA'"AM - Status &iagra% page "(SP!NS(S - Monitor "esponses page Note: For access to the HIS !"#) &IA'"AM) or "(SP!NS(S pages) you %ust specify an ite% type and ite% key. If you specify an ite% type and ite% key *ut do not specify a first page) the First Page option defaults to HIS !"#. "etain +alling AM - Specify true or false to indicate whether to retain the calling application %odule when calling a 'et ,"- %ethod. If you enter true) retainAM.# is appended to the ,"-/ if you enter false) retainAM.N is appended to the ,"-. 0. Select the test action you want to perfor%. 'et Ad$anced Monitor ,"- - +orresponds to a call to the 1a$a %ethod Monitor.getAd$ance,rl2 3. his call returns a ,"- for the Ad%inistrator Monitor page specified *y the test options in the following for%at) suita*le for use within an !racle Application Fra%ework application page4
/OA_HTML/OA.jsp?OAFunc=[parameters...]

For e5a%ple) you can set this ,"- as a destination link on an !AWe*6ean using the call 7!AFra%ework6ean8.set&estination2String url3. he para%eter retainAM.# or retainAM.N is appended to the ,"- depending on the $alue you specified for the "etain +alling AM option. When you perfor% this action) !racle Workflow retrie$es a ,"- according to the test options using Monitor.getAd$ance,rl2 3 and displays that ,"- as a hyperlink in a te5t %essage *ean. o na$igate to the Status Monitor) select the link. 'et Si%ple Monitor ,"- - +orresponds to a call to the 1a$a %ethod Monitor.getSi%ple,rl2 3. his call returns a ,"- for the Self-Ser$ice Monitor page specified *y the test options in the following for%at) suita*le for use within an !racle Application Fra%ework application page4
/OA_HTML/OA.jsp?OAFunc=[parameters...]

For e5a%ple) you can set this ,"- as a destination link on an !AWe*6ean using the call 7!AFra%ework6ean8.set&estination2String url3.

htt !//docs"oracle"com/cd/#1$%2%&01/doc"121/e12'03/(31'3'$(31'40)"htm

1/1/2014

Oracle Workflow Administrator's Guide

Page 36 of 40

The parameter retainAM=Y or retainAM=N is appended to the URL depending on the value you specified for the Retain Calling AM option. hen you perform this action! "racle or#flo$ retrieves a URL according to the test options using Monitor.get%impleUrl& ' and displays that URL as a hyperlin# in a te(t message )ean. To navigate to the %tatus Monitor! select the lin#. Redirect to Advanced Monitor * Corresponds to a call to the +ava method Monitor.redirectToAdvanceUrl& '. hen you perform this action! "racle or#flo$ redirects you to the %tatus Monitor as specified )y the test options. Redirect to %imple Monitor * Corresponds to a call to the +ava method Monitor.redirectTo%impleUrl& '. hen you perform this action! "racle or#flo$ redirects you to the %tatus Monitor as specified )y the test options. ,. %elect the -erform .%tandard. Action )utton.

Testing Guest Access


You can test guest access from an "racle Application /rame$or#*)ased e) page to the %tatus Monitor in the -rogrammatic Access page. 0uest access provides tightly coupled access to a freestanding %tatus Monitor page for a particular $or#flo$! $ithout access to the rest of the "racle or#flo$ application. To Test Guest Access 1. Use a e) )ro$ser to log on to a responsi)ility specified )y your system administrator and choose the -rogrammatic Access lin#. 2. %elect the Test .0uest. Access lin#. 3. 4n the Test .0uest. Access region! enter the test options you $ant. 5ach option corresponds to a method parameter for the method in the oracle.apps.fnd.$f.monitor.$e)ui.Monitor class that is )eing simulated. %ee6 0uest Access in +ava. The test options include6 4tem Type * 5nter the internal name of the $or#flo$ item type to automatically 7uery in the %tatus Monitor. 4tem 8ey * 5nter the item #ey to automatically 7uery in the %tatus Monitor. /irst -age * %pecify the %tatus Monitor page that you $ant to initially display. 94%T"RY * Activity 9istory page in the Administrator Monitor or Notification 9istory page in the %elf*%ervice Monitor

tt!"//docs#oracle#com/cd/$1%&2&'01/doc#121/e12(03/)31(3(%)31(40*# tm

1/1/2014

Oracle Workflow Administrator's Guide

Page 3& of 40

DIAGRAM - Status Diagram page RESPONSES - Monitor Responses page If you leave the First Page fiel !lan"# this option efaults to $IS%OR&' Retain (alling AM - Spe)ify true or false to in i)ate *hether to retain the )alling appli)ation mo ule *hen )alling a Get +R, metho ' If you enter true# retainAM-& is appen e to the +R,. if you enter false# retainAM-N is appen e to the +R,' A ministrator Mo e - Spe)ify a value to in i)ate *hether the user shoul have privileges to perform a ministrative operations *hen a))essing the Status Monitor' & - %he user is grante a ministrator privileges# regar less of *hether the user !elongs to the *or"flo* a ministrator role or not' N - %he user is not grante a ministrator privileges# regar less of *hether the user !elongs to the *or"flo* a ministrator role or not' + - Ora)le /or"flo* )he)"s *hether the user !elongs to the *or"flo* a ministrator role as spe)ifie in the /or"flo* (onfiguration page an grants a ministrator privileges a))or ingly' If you leave the A ministrator Mo e fiel !lan"# this option efaults to N' 0' Sele)t the test a)tion you *ant to perform' Get A van)e Monitor +R, - (orrespon s to a )all to the 1ava metho

Monitor'getGuestA van)e+rl2 3' %his )all returns a +R, for the A ministrator Monitor
page spe)ifie !y the test options in the follo*ing format# suita!le for use *ithin an Ora)le Appli)ation Frame*or" appli)ation page4
/OA_HTML/OA.jsp?OAFunc=[parameters...]

For e5ample# you )an set this +R, as a estination lin" on an OA/e!6ean using the )all 7OAFrame*or"6ean8'setDestination2String url3' %he parameter retainAM-& or retainAM-N is appen e to the +R, epen ing on the value you spe)ifie for the Retain (alling AM option' /hen you perform this a)tion# Ora)le /or"flo* retrieves a +R, a))or ing to the test options using Monitor'getGuestA van)e+rl2 3 an isplays that +R, as a hyperlin" in a te5t message !ean' %o navigate to the Status Monitor# sele)t the lin"' Get Simple Monitor +R, - (orrespon s to a )all to the 1ava metho Monitor'getGuestSimple+rl2 3' %his )all returns a +R, for the Self-Servi)e Monitor page spe)ifie !y the test options in the follo*ing format# suita!le for use *ithin an Ora)le Appli)ation Frame*or" appli)ation page4

tt!"//docs#oracle#com/cd/$1%&2&'01/doc#121/e12(03/)31(3(%)31(40*# tm

1/1/2014

Oracle Workflow Administrator's Guide

Page 3% of 40

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

For e5ample# you )an set this +R, as a estination lin" on an OA/e!6ean using the )all 7OAFrame*or"6ean8'setDestination2String url3' %he parameter retainAM-& or retainAM-N is appen e to the +R, epen ing on the value you spe)ifie for the Retain (alling AM option' /hen you perform this a)tion# Ora)le /or"flo* retrieves a +R, a))or ing to the test options using Monitor'getGuestSimple+rl2 3 an isplays that +R, as a hyperlin" in a te5t message !ean' %o navigate to the Status Monitor# sele)t the lin"' Re ire)t to A van)e Monitor - (orrespon s to a )all to the 1ava metho Monitor're ire)t%oGuestA v+rl2 3' /hen you perform this a)tion# Ora)le /or"flo* re ire)ts you to the Status Monitor as spe)ifie !y the test options' Re ire)t to Simple Monitor - (orrespon s to a )all to the 1ava metho Monitor're ire)t%oGuestSimple+rl2 3' /hen you perform this a)tion# Ora)le /or"flo* re ire)ts you to the Status Monitor as spe)ifie !y the test options' 9' Sele)t the Perform :Guest: A)tion !utton'

Status Monitor Portlets


Ora)le /or"flo* provi es t*o Status Monitor portlets that you )an a to an Ora)le Portal page to vie* summaries of *or"flo* status information' %he Error /or"flo*s portlet provi es a ministrator information a!out errore *or"flo*s# *hile the /or"flo*s portlet provi es selfservi)e information a!out *or"flo*s o*ne !y a user'

Adding a Portlet to an Oracle Portal Page


6efore you )an a an Ora)le Appli)ation Frame*or" portlet to an Ora)le Portal page# your system a ministrator must assign you a responsi!ility that in)lu es the menu fun)tion for that portlet on its menu' %he Error /or"flo*s portlet is see e in the /or"flo* A ministrator /e! 2Ne*3 responsi!ility# an the /or"flo*s portlet is see e in the /or"flo* +ser /e! 2Ne*3 responsi!ility' %he system a ministrator may assign you either one of these responsi!ilities or another responsi!ility to *hi)h the appropriate portlet has !een a e ' After a responsi!ility that in)lu es an Ora)le /or"flo* portlet has !een assigne to you# you )an use Ora)le Portal to a that portlet to an Ora)le Portal page' In the Portlet Repository# sele)t Ora)le Appli)ation Frame*or" Provi er un er Other Provi ers to a))ess the Ora)le /or"flo* portlets' For more information# please refer to the Ora)le Portal online help# or see4 A ing a Portlet to a Page# Ora)le Appli)ation Server Portal %utorial'

Error Workflows Portlet

tt!"//docs#oracle#com/cd/$1%&2&'01/doc#121/e12(03/)31(3(%)31(40*# tm

1/1/2014

Oracle Workflow Administrator's Guide

Page 3( of 40

The Error Workflows portlet provides administrator information about errored workflows. The portlet displays all errored workflows started within the last week. If you have workflow administrator privileges, the list shows workflows owned by any user; if you do not have workflow administrator privileges, the list shows only workflows that you own. You can select the item key link in the Item ey column to view the activity history for a workflow in the !ctivity "istory page of the !dministrator #onitor.

Obtaining Access to the Error Workflows Portlet


The menu function for the Error Workflows portlet is W$%!&#I'%(T!T)(%*+,T-ET. This function is seeded on the Workflow !dministrator .'ew/ menu .$'&%W$!&#I'%'EW/, which is associated with the Workflow !dministrator Web .'ew/ responsibility. To give you access to the Error Workflows portlet, your system administrator must perform one of the following steps0 !ssign you the Workflow !dministrator Web .'ew/ responsibility !dd the $'&%W$!&#I'%'EW menu to the menu for another e1isting or custom responsibility and assign you that responsibility !dd the W$%!&#I'%(T!T)(%*+,T-ET function to another e1isting or custom menu, associate that menu with a responsibility, and assign you that responsibility

Workflows Portlet
The Workflows portlet provides self2service information about workflows that you own. The portlet displays all workflows owned by you that were started within the last two weeks. You can select the workflow identifier link in the Workflow column to view the notification history for a workflow in the 'otification "istory page of the (elf2(ervice #onitor. The workflow identifier is the user key if one is specified for the workflow, or the item key if no user key is specified.

Obtaining Access to the Workflows Portlet


The menu function for the Workflows portlet is W$%((%(T!T)(%*+,T-ET. This function is seeded on the Workflow )ser .'ew/ menu .$'&%W$)(E,%'EW/, which is associated with the Workflow )ser Web .'ew/ responsibility. To give you access to the Error Workflows portlet, your system administrator must perform one of the following steps0 !ssign you the Workflow )ser Web .'ew/ responsibility !dd the $'&%W$)(E,%'EW menu to the menu for another e1isting or custom responsibility and assign you that responsibility !dd the W$%((%(T!T)(%*+,T-ET function to another e1isting or custom menu, associate that menu with a responsibility, and assign you that responsibility

tt!"//docs#oracle#com/cd/$1%&2&'01/doc#121/e12(03/)31(3(%)31(40*# tm

1/1/2014

Oracle Workflow Administrator's Guide

Page 40 of 40

Contents | Previo s | !op of Page | "e#t

Copyright 2003, 2010, Oracle and/or its affiliates. All rights reserved.

tt!"//docs#oracle#com/cd/$1%&2&'01/doc#121/e12(03/)31(3(%)31(40*# tm

1/1/2014

Вам также может понравиться