Skip Headers

Oracle Workflow User's Guide
Release 2.6.4
Part Number B15854-02
Go to Table of Contents
Contents
Go to previous page
Previous
Go to next page
Next

Viewing Notifications and Processing Responses

Overview of Notification Handling

Oracle Workflow sends a notification to a role when the Workflow Engine executes a notification activity in a workflow process. The notification activity may designate the role as being responsible for performing some human action or may simply relay process-related information to the role. To successfully deliver a notification to a role, the role must be defined in the Oracle Workflow directory service.

As a member of a role, you can view a notification using any one of three interfaces depending on your role's notification preference setting in the Oracle Workflow directory service. You can receive an e-mail for each individual notification, receive a single e-mail summarizing all your notifications or query the Workflow Notifications Web page for your notifications. If you choose to receive e-mail, you can also choose the format in which you want to receive the e-mail messages. See: Setting Up an Oracle Workflow Directory Service, Oracle Workflow Administrator's Guide, Setting User Preferences, and Preferences, Oracle Applications User's Guide.

Each notification message can include context-sensitive information about the process and directions on how to respond to the notification, if a response is required. The message can also include pointers to Web URLs and references to Oracle Applications forms that allow the user to get additional information related to the notification.

Oracle Workflow sends your notifications in the language specified in your user preferences, if that language is set up in your installation. See: Setting Up Additional Languages, Oracle Workflow Administrator's Guide.

Note: In Oracle Applications, you can select a session-level language in the login window, which overrides your user-level language preference for that session. However, Oracle Workflow still uses your user-level language preference to determine the language in which e-mail notifications are sent. You can use the Preferences page to set your user-level language preference, which is also stored in the ICX: Language profile option. See: Preferences, Oracle Applications User's Guide.

In some cases, such as if you are away on vacation, you will not be able to view or respond to your notifications in a timely manner. Rather than create a bottleneck in a workflow process, you can take advantage of vacation rules, also known as routing rules or automatic notification processing rules, to direct Oracle Workflow to automatically manage the notifications for you.

Electronic Signatures

In Oracle Applications, notifications can require that your response be signed by a password-based or certificate-based electronic signature.

To set up for certificate-based digital signatures:

  1. Obtain an X.509 certificate and private key from a certificate authority. The certificate and key should be provided in a PKCS 12 file with an extension of .p12 or .pfx .

  2. Obtain the certificate authority's root certificate and any intermediate certificates required for your type of certificate. Also, for each root and intermediate certificate, obtain a URL specifying the location from which the corresponding Certificate Revocation List (CRL) can be downloaded.

    If your system administrator has already obtained and installed the root certificate for your certificate authority and the intermediate certificates for your type of certificate, you can skip this step.

  3. Load the file containing your personal certificate and key onto the file system of your client PC, and import the certificate into your browser. For detailed instructions, please refer to the online help for your browser. In some cases the certificate authority may automatically import the certificate into your browser when you obtain the certificate.

  4. Use the certificate management functions in your browser or operating system to export your personal certficate in the DER encoded binary X.509 format. The certificate should be exported as a file with an extension of .cer.

  5. Give your system administrator the exported file for your personal certificate, as well as the root certificate for your certificate authority and the intermediate certificates for your type of certificate, if necessary. The system administrator must load these certificates into Oracle Applications before you can use your personal certificate to sign Oracle Workflow notifications. See: Loading Certificates for Digital Signatures, Oracle Workflow Administrator's Guide.

Note: Electronic signatures are currently supported only for the version of Oracle Workflow embedded in Oracle Applications.

Reviewing Notifications via Electronic Mail

You can have your workflow notifications delivered to you as e-mail messages if your notification preference is set to 'Plain text mail', 'HTML mail with attachments', 'HTML mail', or 'Plain text mail with attachments' in the User Preferences web page and your workflow administrator sets up a notification mailer to run.

If your e-mail reader can only support plain text messages with no attachments, set your notification preference to 'Plain text mail'.

If your e-mail reader can interpret and display HTML-formatting in the body of a message, select 'HTML mail with attachments' or 'HTML mail' as your notification preference. HTML mail can include images and provide direct links to supporting information sources that you may need access to to complete a notification. If you choose 'HTML mail with attachments', the e-mail messages include links to the Notification Detail page as standard attachments. If you choose 'HTML mail', the e-mail messages do not include these standard attachments. If custom attachments have been defined for individual notifications in a process, however, those attachments will still be included.

An HTML-formatted notification can also include an option for you to request more information about the notification from another user before you respond, if the notification is defined to allow such requests. See: #HIDE_MOREINFO Attribute, Oracle Workflow Developer's Guide.

If your e-mail reader can only display plain text in the body of a message, but can also display attachments to the message, set your notification preference to 'Plain text mail with Attachments'.

An e-mail notification that requires a response maintains an 'Open' status until you respond to the notification. For e-mail notifications that do not require a response, such as FYI (For Your Information) notifications, your workflow administrator determines how the notification status is updated when setting up a notification mailer. Depending on the setup configuration, either Oracle Workflow automatically updates the status of FYI notifications to 'Closed' after sending you the notifications by e-mail, or those notifications maintain an 'Open' status until you manually close them in the Worklist Web page.

Once you read an FYI message, you can delete it from your inbox. However, if the notification mailers for your organization are set up to keep FYI notifications open after sending them by e-mail, you must also use the Worklist to manually close the notification, even if you have already deleted the notification message from your e-mail inbox.

There are two response methods for plain text e-mail notifications: templated response or direct response. Your workflow administrator determines the response method for your organization when setting up a notification mailer. For the templated response method, you reply using the template of response prompts provided in the notification and enter your response values between the quotes following each prompt. For the direct response method, you enter your response values directly as the first lines of your reply.

Both templated and direct response e-mail notifications are based on standard message templates defined in Oracle Workflow Builder. Both describe the syntax the reply should follow and list the information needed to confirm the notification. See: Modifying Your Message Templates, Oracle Workflow Administrator's Guide.

When you respond to a notification by e-mail, your reply message must include the notification ID (NID) and access key from the original notification message. Notification mailers can process your response properly only if you include the correct NID and access key combination in your response. You can ensure that your reply contains the NID and access key either by including the entire original message in your reply or by using a response template that includes the NID line.

Note: The notification access key is a distinct random key generated by the Notification System for each NID. The access key serves as a password that allows only users who actually received the notification containing the key to respond to that notification.

The format of the NID line is as follows:

 NID[9999/999999@XXXXXX]

Some mail clients, notably early releases of Microsoft Outlook Express, may not copy the NID line properly in a reply message. When responding to a notification, you should verify that the NID line is included in full and contains the prefix NID and all the details between the square brackets.

To Respond to a Plain Text E-mail Notification Using Templated Response

  1. Your plain text e-mail notification includes information that is helpful for you to respond to the notification. Depending on the notification, the information may appear as references to other sources or as attachments. Some attachments, depending on their content may only be viewable if you display your notification using the Notification web pages. See: Viewing Notifications from a Web Browser.

  2. To respond to your notification, use the Reply command in your mail application to reply to the original e-mail notification.

  3. Include the response template from the original notification in your reply. In addition to the response prompts, the response template includes the special notification ID and access key that a notification mailer requires to identify the notification you are responding to. If your mail application includes an editable copy of the original message when it generates the reply message, you can use that copy to enter your response values. Otherwise, copy and paste from the original message to obtain a copy of the response template that you can edit.

  4. Follow the response template instructions and insert your response values between the quotes (" ") following each response prompt. The Notification System interprets your response values literally, so a value in uppercase is interpreted differently from the same value in lowercase.

    Note: When you are using the two double quotes to delimit your response, you can validly use a single quote character within your response value. For example, a response to a Comment prompt could be entered as follows:

     Comment: "This proposal isn't acceptable."

    However, you cannot validly use another double quote character within your response value in the default format. If you want to use the double quote character (") within your response value, you can optionally enter your response in one of the following alternate formats. You can use different formats for different responses within the same response message.

  5. When you are satisfied with your response, use the Send command of the mail application to send your reply.

    Note: If you send an invalid response, the Notification System sends you an "invalid response" message. If you respond to a notification that has been canceled, you get a message informing you that the notification was canceled. Similarly, if you respond to a notification that was already previously responded to, you get a message informing you that the notification is closed.

  6. If another user sent you this notification with a request for more information, include the response template in your reply and insert the information you want to provide between the quotes (" ") following the response prompt. When you are satisfied with your response, use the Send command of the mail application to send your reply.

  7. If this notification requires a password-based signature or certificate-based digital signature in your response, you cannot respond to the notification through e-mail. In this case the notification informs you that an electronic signature is required and directs you to access the online version of the notification instead. Navigate to the Notification Details web page to submit your response. See: To View the Details of a Notification.

    Note: Electronic signatures are currently supported only for the version of Oracle Workflow embedded in Oracle Applications.

  8. If this notification includes sensitive content that cannot be sent in e-mail for security reasons, the notification e-mail message directs you to access the online version of the notification instead. Navigate to the Notification Details page to view the content of the notification and submit your response. See: To View the Details of a Notification.

To Respond to a Plain Text E-mail Notification Using Direct Response

  1. Your plain text e-mail notification includes information that is helpful for you to respond to the notification. Depending on the notification, the information may appear as references to other sources or as attachments. Some attachments, depending on their content may only be viewable if you display your notification using the Notification web pages. See: Viewing Notifications from a Web Browser.

  2. To respond to your notification, use the Reply command in your mail application to reply to the original e-mail notification.

  3. Include the text of the original notification message in your reply. This text contains the special notification ID and access key that a notification mailer requires to identify the notification you are responding to.

  4. Follow the syntax instructions in the notification message carefully when formatting your reply. The response values must be within the first lines of your reply, where each line represents a separate response value.

    If a response value requires more than one line, then the entire response value must be enclosed in double quotes (" "). Everything enclosed in the double quotes is counted as one line.

    The Notification System interprets your response values literally, so a value in uppercase is interpreted differently from the same value in lowercase.

    If a response prompt provides a default response value, you can accept the default value by leaving the appropriate response line blank.

  5. When you are satisfied with your response, use the Send command of the mail application to send your reply.

    Note: If you send an invalid response, the Notification System sends you an "invalid response" message. If you respond to a notification that has been canceled, you get a message informing you that the notification was canceled. Similarly, if you respond to a notification that was already previously responded to, you get a message informing you that the notification is closed.

  6. If this notification requires a password-based signature or certificate-based digital signature in your response, you cannot respond to the notification through e-mail. In this case the notification informs you that an electronic signature is required and directs you to access the online version of the notification instead. Navigate to the Notification Details web page to submit your response. See: To View the Details of a Notification.

    Note: Electronic signatures are currently supported only for the version of Oracle Workflow embedded in Oracle Applications.

  7. If this notification includes sensitive content that cannot be sent in e-mail for security reasons, the notification e-mail message directs you to access the online version of the notification instead. Navigate to the Notification Details page to view the content of the notification and submit your response. See: To View the Details of a Notification.

Example: Direct Response Instructions

Following is a set of response instructions and examples of three possible responses.

Response Instructions
Enter the Action on line 1. Do you approve? Value must be one of the following (default is "Reject"):
Approve
Reject
 
Enter the Review Comments on line 2. Value must be 2000 bytes or less.
 
Enter the Required Date on line 3. If there is no required date, leave this blank. Value must be a date in the form "DD-MON-YYYY".
 
Enter the Maximum Amount on line 4. This is the maximum approved amount. Value must be a number. Default is 1500.
Valid Response A - Approve
Approve
Let me know if this item meets expectations.
01-JAN-1998
1000.00
Valid Response B - Reject
Reject
Too expensive.
 
 

Note: The blank lines in this response indicate acceptance of the default values for those response values.

Valid Response C - Reject
Reject
"This item is too expensive. Please find a replacement that is of lower cost, or else
include additional justification for why this item should be approved."
01-JAN-1998
1000.00

To Respond to an HTML E-mail Notification

  1. Your HTML-formatted e-mail notification includes information that is helpful for you to respond to the notification. Depending on the notification, the information may appear as links to other sources or as attachments.

    HTML E-mail Notification

    the picture is described in the document text

    Attention: If your notification preference is 'HTML Mail with attachments', an HTML-formatted e-mail notification always includes one standard attachment. The attachment is called Notification Detail Link and it provides a direct link to your notification in the Notification Details web page.

    Note that your Web browser must support JavaScript and Frames to open this attachment. When you open the Notification Detail Link attachment, it automatically attempts to establish a web session with your web server. In doing so, it authenticates your access, verifies that your notification is still open, and displays a message if the notification is already closed.

    Depending on the configuration of your Oracle Workflow installation, if you are not already logged in, you may be prompted to log in before you can access the Notification Details page. Otherwise, if your configuration allows, you can access the Notification Details page for this notification directly, but you cannot access any other Oracle Workflow features unless you are logged in. See: Responses through the Notification Detail Link Attachment, Oracle Workflow Administrator's Guide.

    You can respond directly to your notification from the Notification Details page, bypassing the need to process your response through a notification mailer. If you decide to respond from the Notification Details page, skip the remaining steps. See: To View the Details of a Notification or To View the Details of a Notification (for Oracle Applications).

    If your notification preference is 'HTML mail', then your HTML-formatted e-mail notification does not include this standard attachment. However, if custom attachments have been defined for this individual notification in its workflow process, those attachments will still be included.

  2. When you are done reviewing all the information for the notification, click on one of the response links shown at the end of the notification.

    Note: If your workflow administrator has configured the notification mailer that sent this message to use the standard Workflow Open Mail for Outlook Express message template, or if this notification is defined to use that template, then a link called "Click here to respond" will appear in place of the links for individual responses. The "Click here to respond" link provides access to your notification in the Notification Details web page.

    Note that your Web browser must support JavaScript and Frames to open this link. When you choose the "Click here to respond" link, it automatically attempts to establish a web session with your web server. In doing so, it authenticates your access, verifies that your notification is still open, and displays a message if the notification is already closed. If you are disconnected from your network, however, you will not be able to use the link.

    Once you have accessed the Notification Details page, you can respond directly to your notification from this page. In this case, you should skip the remaining steps.

  3. Each response link automatically generates a plain text e-mail reply. The reply contains the correct Reply To: e-mail address as well as a response template in the message body. The response template consists of the required notification ID and access key that identify the notification you are responding to and a response prompt edited with your selected response.

    Attention: Do not include any HTML-formatting in the e-mail response.

  4. Depending on the notification, the auto-generated e-mail response template may also prompt you for other information in addition to your selected response. Supply responses by editing the response value text between the quotes (' ') following each response prompt.

    Note: Response templates generated from a response link in an HTML-formatted e-mail notification provide single quotes to enclose your response values, rather than the double quotes provided in plain text response templates. This use of single quotes accommodates e-mail applications that cannot process double quotes in the <A HREF="mailto:"> tag for the link but can accept single quotes.

    Depending on how your mail application displays these characters, the two single quote characters (' ')following a response prompt may visually resemble one double quote character ("). Ensure that you insert your response between the the two quotes, rather than after them.

    When you are using the two single quotes to delimit your response, you can validly use a double quote character within your response value. For example, a response to a Comment prompt could be entered as follows:

     Comment: 'The "Equipment" proposal is approved.'

    However, you cannot validly use another single quote character within your response value in the default format. If you want to use the single quote character (') as an apostrophe within your response value, you can optionally enter your response in one of the following alternate formats. You can use different formats for different responses within the same response message.

  5. When you are satisfied with your response, use the Send command of the mail application to send your reply.

    Note: If you send an invalid response, the Notification System sends you an "invalid response" message. If you respond to a notification that has been canceled, you get a message informing you that the notification was canceled. Similarly, if you respond to a notification that was already previously responded to, you get a message informing you that the notification is closed.

  6. In addition to the response links, an HTML-formatted notification can also include a Request Information link. Choose this link if you want to request more information about the notification from another user before you respond to the notification.

    The Request Information link automatically generates a plain text e-mail reply. The reply contains the correct Reply To: e-mail address as well as a request template in the message body. The request template contains the required notification ID and access key that identify the notification you are responding to. It also contains a prompt for you to enter the user from whom you want to request information, along with a list of users who have previously participated in the workflow process, and a prompt for you to enter the question you want to ask that user. When you are satisfied with your request, use the Send command of the mail application to send your reply.

    Attention: Your workflow may include special logic to restrict requesting more information on notifications. If so, the Request Information link is not displayed in the e-mail notification. See: #HIDE_MOREINFO Attribute, Oracle Workflow Developer's Guide.

  7. If another user sent you this notification with a request for more information, click the response link and enter the information you want to provide between the quotes (' ') following the response prompt. When you are satisfied with your response, use the Send command of the mail application to send your reply.

  8. If this notification requires a password-based signature or certificate-based digital signature in your response, you cannot respond to the notification through e-mail. In this case the notification informs you that an electronic signature is required and directs you to access the online version of the notification instead. Navigate to the Notification Details web page to submit your response. See: To View the Details of a Notification.

    Note: Electronic signatures are currently supported only for the version of Oracle Workflow embedded in Oracle Applications.

  9. If this notification includes sensitive content that cannot be sent in e-mail for security reasons, the notification e-mail message directs you to access the online version of the notification instead. Navigate to the Notification Details page to view the content of the notification and submit your response. See: To View the Details of a Notification.

To Respond to a Plain Text E-mail Notification with an HTML Attachment

  1. Your plain text e-mail notification with attachments includes information that is helpful for you to respond to the notification. Depending on the notification, the information may appear inline in the message body, as links to other reference sources or as attachments to the message. In addition, the notification always includes at least two attachments:

  2. When you are done reviewing all the information for the notification, you can respond to the notification in one of three ways:

  3. If this notification requires a password-based signature or certificate-based digital signature in your response, you cannot respond to the notification through e-mail. In this case the notification informs you that an electronic signature is required and directs you to access the online version of the notification instead. Navigate to the Notification Details web page to submit your response. See: To View the Details of a Notification.

    Note: Electronic signatures are currently supported only for the version of Oracle Workflow embedded in Oracle Applications.

  4. If this notification includes sensitive content that cannot be sent in e-mail for security reasons, the notification e-mail message directs you to access the online version of the notification instead. Navigate to the Notification Details page to view the content of the notification and submit your response. See: To View the Details of a Notification.

To Reassign a Notification to Another User

Use the "Forward" feature in your mail reader to forward or reassign an e-mail notification to another user. Do not use the "Reassign" button on the HTML attachment.

Attention: When you forward a notification to another user via e-mail, you are simply asking that user to respond to the notification on your behalf. Note that you still maintain ownership of the notification. If you want to transfer the notification and ownership of the notification to another user, you can only do so from the Notifications web pages. See: Viewing Notifications from a Web Browser.

Related Topics

Setting Up Notification Mailers, Oracle Workflow Administrator's Guide

Plain Text E-mail, Oracle Workflow Administrator's Guide

HTML-Formatted E-mail, Oracle Workflow Administrator's Guide

Plain Text E-mail with an HTML Attachment, Oracle Workflow Administrator's Guide

Reviewing a Summary of Your Notifications via Electronic Mail

You can have a summary of your workflow notifications delivered to you as a single e-mail message if your notification preference is set to 'Plain text summary mail' in the User Preferences web page, or, for Oracle Applications only, if your notification preference is set to 'HTML summary mail'. You can receive a plain text e-mail notification summary using any e-mail reader. To receive an HTML e-mail notification summary, you must be using Oracle Workflow embedded in Oracle Applications, and your e-mail reader must be able to interpret and display HTML formatting in the body of a message. Your workflow administrator determines how frequently summary notifications are sent when setting up a notification mailer. See: Setting Up Notification Mailers, Oracle Workflow Administrator's Guide.

In standalone Oracle Workflow, the plain text e-mail notification summary is based on the Workflow Summary Mail template defined in the System: Mailer item type. The standard summary identifies the recipient, notification ID, subject, priority and due date of each notification. It also indicates that if you wish to view the details of a notification or respond to or close the notification, you should use the Worklist Web page.

In Oracle Applications, the plain text and HTML-formatted versions of the e-mail notification summary are based on the Workflow Summary Mail (HTML) template defined in the System: Mailer item type. The standard summary identifies the priority, from role, workflow type, subject, sent date, and due date of each notification. To view the details of a notification or respond to or close the notification, you should use the Worklist Web pages. In the HTML-formatted version of the summary, you can select a subject link to navigate directly to the Notification Details page for that notification. The HTML-formatted summary also includes a link to the Worklist page, from which you can access all your notifications.

Note: Depending on the configuration of your Oracle Workflow installation, if you are not already logged in, you may be prompted to log in before you can access the Worklist or Notification Details pages. Otherwise, if your configuration allows, you can access the Notification Details page for a notification directly, but you cannot access any other Oracle Workflow features unless you are logged in. See: Responses through the Notification Detail Link Attachment, Oracle Workflow Administrator's Guide.

Related Topics

Viewing Notifications from a Web Browser for Standalone Oracle Workflow

Viewing Notifications from a Web Browser for Oracle Applications

Workflow Summary Mail Message, Oracle Workflow Administrator's Guide

Workflow Summary Mail (HTML) Message, Oracle Workflow Administrator's Guide

Viewing Notifications from a Web Browser for Standalone Oracle Workflow

You can use any Web browser that supports JavaScript and Frames to view and respond to your notifications in the Notifications Web page.

Note: For information about the Worklist pages in Oracle Applications, see: Viewing Notifications from a Web Browser for Oracle Applications.

To Access Notifications from a Web Browser

  1. You can access your worklist in one of several ways.

  2. If you are accessing any of the Oracle Workflow URLs for the first time in your web browser session, you will be prompted for a valid username and password to log on.

  3. Enter your username and password.

  4. Choose OK. If you have made an error, you can clear the values and start over.

    If you used the wfa_html.worklist URL, skip to the Notification Worklist section.

To Find Notifications

  1. The Find Notifications window lets you enter search criteria to locate specific notifications. If you are logged on to the current session as a regular workflow user, you can specify criteria to search for any notification(s) you own. The search criteria are:

    Find Notifications Page for Users

    the picture is described in the document text

  2. As a user with workflow administrator privileges, you can also search for notifications that you do not own. See: Setting Global User Preferences, Oracle Workflow Administrator's Guide.

    Find Notifications Page for Administrators

    the picture is described in the document text

    In addition to being able to specify any of the standard search criteria listed above except for "Notifications Delegated to", you also have the following criteria options:

    Note: To identify notifications where the original owner delegated the work to another role (without transferring ownership), specify different roles in the Owner and To fields. This combination of criteria is equivalent to selecting the "Notifications Delegated to" criterion in the standard Find Notifications screen.

  3. Choose the Find button to open the Worklist window.

To View Notifications from the Worklist

  1. The Notifications Worklist either displays the notifications that match your search criteria if you navigated from the Find Notifications page, or lists all your open notifications if you navigated directly to this page.

    Worklist

    the picture is described in the document text

    The Worklist displays the following information for each notification:

  2. Click on any column heading to sort your notifications by that column in ascending order.

  3. A Find icon in the toolbar lets you navigate back to the Find Notifications screen at any time so you can use search criteria to reduce the Worklist to a smaller subset of notifications.

  4. The Worklist lets you simultaneously close multiple FYI-type notifications that do not require a response. Simply check Select for the each FYI-type notification you wish to close, and then choose Close.

  5. You can also collectively reassign a group of notifications. Check Select for the notifications you wish to reassign, then choose Reassign... A Reassign page appears that lets you specify to whom and how you wish to reassign the notification(s). See: To Reassign a Notification to Another User.

  6. You can navigate to the full details of any notification and act on the notification by clicking on the notification's Subject link.

To View the Details of a Notification

  1. In the Detail Notification page, the full details of the notification appear in the upper frame, and the response section of the notification appears in the lower frame. You can scroll through or resize these frames.

  2. The upper frame may include inline images as well as links embedded in the message body to additional information sources for the notification. A reference URL link opens another Web browser window and connects to a specified URL.

  3. The upper frame may also include attachment icons that appear after the message body. These icons also link to additional information sources for the notification. A notification can include the following types of attachment links:

  4. The Response section may look as follows:

    Note: You can click on any response prompt to display more information about the response attribute.

  5. Once you submit your response, the Detail Notification page returns you to the Worklist, where the notification you just responded to now displays a status of Closed.

    Note: If you revisit a Closed notification, the Response section indicates that the Response has been submitted and displays the values that were submitted as the response.

  6. A Find icon in the toolbar of the Detail Notification page lets you navigate back to the Find Notifications screen at any time to search for and display other notifications.

To Reassign a Notification to Another User

  1. You can reassign a notification in one of two ways:

    Attention: Your workflow may include a special #HIDE_REASSIGN attribute to restrict reassignment of notifications. If so, the Reassign button may not be displayed in the Response frame, and you should not reassign the notification. See: #HIDE_REASSIGN Attribute, Oracle Workflow Developer's Guide.

  2. In the Reassign page that appears, a summary of the selected notification(s) appear towards the bottom of the screen.

    Note: If you clicked on the Reassign button in the Response frame of a specific notification, you do not see a summary of selected notifications.

  3. In the 'Reassign to' field, click on the up-arrow icon to display a window that lets you search for a list of roles to choose from. See: Using a List of Values.

  4. After choosing a role, specify how you wish to reassign the notification. Select 'Delegate Authority for Responding to Notifications' if you want to give someone else authority to respond to the notification on your behalf. With this option, Oracle Workflow maintains that you own the notification. Or select 'Transfer Ownership of Notifications', if you want to give someone else complete ownership and responsibility of the notification.

  5. Enter any comments you want to pass along to the new role. Choose Reassign. Once the notification is reassigned, the web browser returns you to your Worklist page, where the reassigned notification is no longer in your worklist.

    Attention: Your workflow may include special logic called a post-notification function to verify that the role that you attempt to delegate or transfer a notification to is legitimate or to restrict reassignment of notifications altogether. If so, you may get a warning message to that effect when you attempt to reassign a notification. See: Post-Notification Functions, Oracle Workflow API Reference.

  6. A Find icon in the toolbar of the Reassign page lets you navigate back to the Find Notifications screen at any time to search for and display other notifications.

Using a List of Values

  1. For a field that supports a list of values, click on the field's up-arrow icon to display a list of values window.

  2. In the Find field, enter search criteria and choose the Find button to retrieve a subset of values that match your criteria. You can also choose the Clear button to clear the Find field. If you do not specify any search criteria and simply choose Find, you retrieve the complete list of values.

  3. Click on a value from the list to select that value and close the list of values window. The value you select populates the original field.

Defining Rules for Automatic Notification Processing for Standalone Oracle Workflow

Use Oracle Workflow Automatic Notification Processing to automatically forward your notifications to another role or respond to incoming notifications with a predefined response when you are not available to manage your notifications directly, such as when you are on vacation.

The Automatic Notification Processing web page lets you define the rules for automatic notification processing. Each rule is specific to a role and can apply to any or all messages of a specific item type and/or message name. A rule can result in one of three actions: reassigning the notification to another user, responding to or closing the notification, or simply delivering the notification to the original recipient with no further action.

Each time the Notification System sends or reassigns a notification to a role, Oracle Workflow tests the notification against that role's list of rules for the most specific match based on the criteria in the order listed below:

ROLE = <role> and:

  1. MESSAGE_TYPE = <type> and MESSAGE_NAME = <name>

  2. MESSAGE_TYPE = <type> and MESSAGE_NAME is null

  3. MESSAGE_TYPE is null and MESSAGE_NAME is null

As soon as it finds a match, Oracle Workflow applies the rule and discontinues any further rule matching.

If a rule reassigns a notification, Oracle Workflow performs rule matching again against the new recipient role's list of rules. Oracle Workflow maintains a count of the number of times it forwards a notification to detect perpetual forwarding cycles. If a notification is automatically forwarded more than ten times, Oracle Workflow assumes a forwarding cycle has occurred and ceases executing any further forwarding rules, marking the notification as being in error.

Note: For information about the vacation rule pages for Oracle Workflow embedded in Oracle Applications, see: To View and Maintain Vacation Rules.

To Define a Rule for Automatic Notification Processing

  1. Use a web browser to connect to one of two URLs.

    To display the list of routing rules for your current role, enter:

     <webagent>/wf_route.list[?user=<rolename>]

    This URL can include an optional argument, as denoted by the square brackets []. You should omit the square brackets to pass the optional argument.

    Replace the bracketed italicized text in the above URL as follows:

    If you have workflow administrator privileges, you can display a web page that lets you find the routing rules for a specified role. Enter:

     <webagent>/wf_route.find

    Enter the user ID of a role and choose Find.

    Notification Rules Page (Find)

    the picture is described in the document text

    Attention: Both of these URLs access secured pages, so if you have not yet logged on as valid user in the current web session, you will be prompted to do so before the page appears.

    Note: You can also access the Notification Rules web page from the Oracle Workflow home page. See: Accessing the Oracle Workflow Home Page.

  2. The Notification Rules page for the role appears, listing all existing rules for the current role. Choose Create Rule.

    Notification Rules Page (List)

    the picture is described in the document text

  3. In the Item Type poplist field, select the item type to which this rule applies or select <All> if you want this rule to apply to notifications associated with any item type.

    Create New Rule Page (Item Type)

    the picture is described in the document text

  4. Choose Next to proceed or choose Cancel if you want to cancel this rule and return to the previous page.

  5. If you selected <All> as the item type to apply the rule to, then skip to step 8. If you selected a specific item type, then proceed to the next step to choose a notification from that item type to which you want your rule to apply.

  6. In the Notification field, select the notification message to which this rule applies or select <All> if you want this rule to apply to all notifications in the item type.

    Create New Rule Page (Notification)

    the picture is described in the document text

  7. Choose Next to proceed or choose Cancel if you want to cancel this rule and return to the previous page.

  8. The final Create New Rule page appears. The fields in this page vary depending on the item type(s) and notification(s) that you are creating this rule for. For example, if your rule pertains to all item types, you can automatically reassign all the notifications to another user, but you cannot define an automatic response to all the notifications since different notifications have different response attributes.

  9. Enter values in the Start Date and End Date fields to specify the period that this rule should be active. Specify the date using the default date format of your database and specify a time using the format HH24:MI:SS if your default date format does not have a time component.

    If you leave Start Date blank, the rule is effective immediately. If you leave End Date blank, the rule is effective indefinitely.

    Warning: Since you can define different rules for the same notification(s) to be effective at different times, the Automatic Notification Processing web page does not prevent you from defining multiple rules for the same notification(s). You should be careful to ensure that rules for the same notification(s) do not overlap in their effective dates. If multiple rules are effective for the same notification, Oracle Workflow picks one rule at random to apply.

  10. In the "Comments to include in notification" field, enter any text that you want to append to the notification when the rule is applied. The comments appear in a special "Prior comments" field when the notification is reassigned or automatically responded to.

  11. Choose the action that you want this rule to perform:

  12. If your rule action is "Reassign to", click on the up-arrow icon to display a window that lets you search for a role to reassign to. See: Using a List of Values.

  13. After choosing a role, specify how you wish to reassign the notifications. Select 'Delegate Authority for Responding to Notifications' if you want to give the new role authority to respond to the notification on your behalf. With this option, Oracle Workflow maintains that you still own the notifications, but the recipient role of the notifications is now the role that you are reassigning your notifications to. Select 'Transfer Ownership of Notifications', if you want to give the new role complete ownership and responsibility of the notification.

    Attention: Your workflow administrator may implement special logic to verify that the role that you attempt to delegate or transfer the notifications to is legitimate or to restrict reassignment of notifications altogether. If so, you may get a warning message to that effect when you attempt to create a reassigning rule.

  14. If your rule action is "Respond", set the values that you want to automatically respond with.

  15. Choose OK to save this rule and return to the Notification Rules page to display an updated list of your role's routing rules. You can also choose Cancel at any time if you want to cancel this rule and return to the previous page.

To Update or Delete an Automatic Notification Processing Rule

  1. Connect to the URL for the Automatic Notification Processing web page:

     <webagent>/wf_route.list

    <webagent> represents the base URL of the web agent configured for Oracle Workflow in your Web server. See: Setting Global User Preferences, Oracle Workflow Administrator's Guide.

  2. The Automatic Notification Processing page for the role appears. In the "Result of Applying Rule" column, click on the rule you wish to update.

  3. In the Modify Rule page make your changes to the rule and choose OK to save your changes.

    You can also choose Cancel to undo your changes and go back to the previous page.

  4. To delete a rule, in the "Delete Rule" column, choose 'X' for the rule you wish to delete.

Viewing Notifications from a Web Browser for Oracle Applications

The Worklist pages let you view and respond to your notifications using a Web browser. The Advanced Worklist provides an overview of your notifications, from which you can drill down to view an individual notification in the Notification Details page. You can also reassign notifications to another user, request more information about a notification from another user, respond to requests for information, and define vacation rules to handle notifications automatically in your absence.

Oracle Workflow also provides the Personal Worklist, which includes additional options to specify what notifications to display in your Worklist and what information to display for those notifications. Before you can use the Personal Worklist, your system administrator must give you access to it.

Note: For information about the Worklist pages in standalone Oracle Workflow, see: Viewing Notifications from a Web Browser for Standalone Oracle Workflow.

From Role

Some Worklist pages include a From column that shows the role from which the notification was sent.

Worklist Access

The Advanced Worklist also lets you grant access to your worklist to another user. That user can then act as your proxy to handle the notifications in your list on your behalf. You can either grant a user access for a specific period or allow the user's access to continue indefinitely.

The worklist access feature lets you allow another user to handle your notifications without giving that user access to any other privileges or responsibilities that you have in Oracle Applications. However, note that a user who has access to your worklist can view all the details of your notifications and take most actions that you can take on the notifications. Ensure that you take all necessary security considerations into account when you choose to grant worklist access to another user.

If another user has granted you access to his or her worklist, you can switch the Advanced Worklist to display that user's notifications instead of your own. When viewing another user's worklist, you can perform the following actions:

However, if the user whose worklist you are accessing has a notification sent from you, you can only view that notification and cannot take any action on it. For example, you cannot respond to a notification that you reassigned to the other user, nor to a notification marked as being sent from you by special logic in the workflow, such as an expense report that you submitted to the other user for approval.

You cannot define vacation rules for the user whose worklist you are viewing. You also cannot grant access to that user's worklist to anyone else.

Note: To respond to a notification that requires a digital signature, you must be logged in as the intended recipient. You cannot respond to a notification that requires a digital signature when you are accessing another user's worklist, because in this case the user responding will not match the intended recipient, so authorization will fail. However, with worklist access, you can reassign the notification to yourself so that you can access the notification through your own worklist and respond directly.

To View Notifications from the Advanced Worklist

  1. Use a web browser to navigate to the Advanced Worklist, using a responsibility and navigation path specified by your system administrator. See: Oracle Workflow User Navigation Paths.

  2. To specify which notifications to display in the Worklist, select the type of notifications you want from the View pull-down menu and select Go. You can choose to view:

  3. The Advanced Worklist shows the following information for each notification:

    Select a column heading to sort the list by that column. By default, the list is sorted by sent date from most recent to oldest, and then by subject in alphabetical order.

  4. To collectively reassign a group of notifications, select the notifications you want and select the Reassign button, the Delegate button, or the Transfer button.

    See: To Reassign a Notification to Another User and Setting the WF: Notification Reassign Mode Profile Option, Oracle Workflow Administrator's Guide.

    Note: Your workflow may include special logic to restrict reassignment of notifications. If any of the notifications that you selected are restricted in this way, Oracle Workflow displays an error message when you select the Reassign, Delegate, or Transfer button. In this case you should deselect the restricted notifications before performing the reassignment. See: #HIDE_REASSIGN Attribute, Oracle Workflow Developer's Guide.

  5. You can navigate to the full details of any notification and act on the notification by clicking on the notification's Subject link or by selecting the notification and then choosing Open.

  6. To define vacation rules, select the Vacation Rules link. See: To View and Maintain Vacation Rules.

  7. To grant access to your worklist to another user, select the Worklist Access link. See: To Grant Access to Your Worklist.

  8. To view another user's worklist, select the Switch User button. The Switch User page displays the user whose worklist you were previously viewing and the list of users whose worklists you can access. Select the user whose worklist you want to view.

    Note: If a user has an e-mail address defined in Oracle Applications, you can select the address link in the Email column to send e-mail to that user.

    When you view a worklist other than your own, the Advanced Worklist page displays the name of the user to whom the worklist belongs. You can view and act on that user's notifications. However, you cannot define vacation rules for that user or grant access to that user's worklist to anyone else. The Vacation Rules link and the Worklist Access link apply only to your own worklist, even if you are viewing another user's notifications.

To View the Details of a Notification

  1. Navigate to the Notification Details page.

    If you are viewing a notification from another user's worklist, the Notification Details page displays the name of that user.

  2. The notification header shows general identifying information and may also include additional header attributes that display key information about the notification. See: Header Attributes, Oracle Workflow Developer's Guide.

    In Oracle Applications, non-structured data such as images, spreadsheets, or video can be linked to structured application data, including Oracle Workflow notifications. If a notification includes such Oracle Applications attachments, the notification header displays an Attachment(s) heading with links to the attachments. Select a link to view the attached data. See: Attachments, Oracle Applications User's Guide and Attachments Table, Oracle Self-Service Web Applications online help.

    A notification may also include a message body, a related applications section, and a response section.

  3. The message body displays the information of which you are being notified. The message body may include inline images as well as embedded links to additional information sources pertinent to the notification. A reference URL link connects to a specified URL, either in the same web browser window or in a new window, depending on the notification.

  4. The related applications section may include attachment icons. These icons link to additional information sources for the notification. There are three types of attachment links:

  5. If you want to view your next notification in the Notification Details page after responding to this notification, select the Display Next Notification After My Response check box. Otherwise, Oracle Workflow displays the Worklist after you respond to a notification.

  6. Use the Response section to act on the notification.

  7. If this notification requires a password-based electronic signature, a confirmation page appears after you submit your response. This page displays notification header information and the response values that you entered to let you review the response you are signing. To affix your electronic signature to your response, enter your Oracle Applications user name and password and select the Submit button. This electronic signature is analogous to your written signature. See: #WF_SIG_POLICY Attribute, Oracle Workflow Developer's Guide.

    Note: If your site has implemented single sign-on through Oracle Internet Directory and your single sign-on password is different than your Oracle Application Object Library password, you must use your Oracle Application Object Library password to sign notifications. See: Electronic Signatures.

  8. If this notification requires a certificate-based digital signature, a confirmation page appears after you submit your response. This page displays notification header information and the response values that you entered to let you review the response you are signing. Choose the Sign button and use your Web browser to enter your X.509 certificate as your signature. For detailed instructions, please refer to the online help for your Web browser. If you have multiple certificates installed, ensure that you enter a certificate that is assigned to the Oracle Applications user name with which you logged in. See: Electronic Signatures and #WF_SIG_POLICY Attribute, Oracle Workflow Developer's Guide.

To Reassign a Notification to Another User

  1. Navigate to the Reassign Notifications page by one of the following methods.

    Attention: Your workflow may include special logic to restrict reassignment of notifications. If so, the Reassign button, Delegate button, or Transfer button may not be displayed in the Response section of the Notification Details page, and you should not reassign the notification. Also, if any of the notifications that you selected in the Advanced Worklist are restricted in this way, Oracle Workflow displays an error message when you select the Reassign, Delegate, or Transfer button. In this case you should deselect the restricted notifications before performing the reassignment. See: #HIDE_REASSIGN Attribute, Oracle Workflow Developer's Guide.

  2. If you are reassigning more than one notification, you can choose a subject link in the list of selected notifications to review the details of an individual notification.

  3. In the Assignee fields, select the type of user or role to which you want to reassign the notification. Then select the user or role you want within that type.

    Note: The assignee types correspond to the originating system partitions in the Oracle Workflow directory service. See: Setting Up a Directory Service for Oracle Workflow Embedded in Oracle Applications, Oracle Workflow Administrator's Guide.

    Attention: Your workflow may include special logic to restrict the users to whom you can reassign the notification. If so, only users who are valid for reassignment appear in the list of values. See: #WF_REASSIGN_LOV Attribute, Oracle Workflow Developer's Guide.

  4. If you have access either to delegate or transfer notifications, select the option you want to specify how you want to reassign the notification.

    Note: If you only have access to delegate notifications, Oracle Workflow automatically uses the delegate option when you reassign notifications. Similarly, if you only have access to transfer notifications, Oracle Workflow automatically uses the transfer option when you reassign notifications.

    See: Setting the WF: Notification Reassign Mode Profile Option, Oracle Workflow Administrator's Guide.

  5. Enter any comments you want to send with the notification to the new user. If you are reassigning more than one notification, your comments will be included with each notification.

    Attention: Your workflow may include special logic to verify that the role that you attempt to delegate or transfer a notification to is legitimate or to restrict reassignment of notifications altogether. If so, you may get a warning message to that effect when you attempt to reassign a notification. See: Post-Notification Functions, Oracle Workflow API Reference.

To Request More Information From Another User

  1. Navigate to the Request More Information page.

  2. Use the Request More Information From option to specify the user or role from whom you want to request information.

  3. Enter details about what information you are requesting in the Information Requested field.

  4. Select the Submit button to send your request to the specified user. You can also select the Cancel button to return to the previous page without sending your request.

  5. After you request more information for a notification, that notification does not appear in your Worklist as an open notification until the user you specified responds to your request. However, you can still review the notification while your request is pending, by choosing to view Notifications From Me in your Worklist and then opening the Notification Details page for the notification you want.

To Grant Access to Your Worklist

  1. Navigate to the Worklist Access page by navigating to the Advanced Worklist and selecting the Worklist Access link.

    The start and end dates for each user determine the access period when the user can view and act on your worklist. The user's active or inactive status depends on whether the current date is within the access period.

    Note: If a user has an e-mail address defined in Oracle Applications, you can select the link in the User Name column to send e-mail to that user.

  2. To grant access to another user, choose the Grant Worklist Access button.

  3. To update the start and end dates of a user's access period, select the Update icon for that user and enter your changes.

  4. To delete a user from the list, select the Delete icon for that user. The user will no longer have access to your worklist, even if the user's access status was previously Active.

    Note: When you delete a user, the record of the user's access no longer appears in your Worklist Access page. If you want to keep this record for reference, you can simply set the end date to end the user's access, rather than deleting the user.

Related Topics

Viewing Notifications from the Personal Worklist

Vacation Rules for Oracle Applications

Use vacation rules to handle your notifications automatically when you are not available to manage your notifications directly, such as when you are on vacation. You can define rules to perform the following actions automatically when a notification arrives:

Use the Vacation Rules page to define your rules for automatic notification processing. Your workflow administrator can also define rules for you. See: Defining Vacation Rules for Users, Oracle Workflow Administrator's Guide.

A vacation rule can apply to messages of all item types, to all messages belonging to a specific item type, or to a specific type of message belonging to a specific item type. Each time a notification is sent to you, Oracle Workflow tests the notification against your vacation rules. First Oracle Workflow checks whether you have any active rules for that specific message type. If not, it checks whether you have any active rules for that specific item type. Finally, it checks whether you have any active rules for messages of all item types. As soon as it finds a match, Oracle Workflow applies the rule and discontinues any further rule matching.

If a rule reassigns a notification, Oracle Workflow performs rule matching again against the new recipient's list of rules. Oracle Workflow maintains a count of the number of times it forwards a notification to detect perpetual forwarding cycles. If a notification is automatically forwarded more than ten times, Oracle Workflow assumes that a forwarding cycle has occurred and ceases executing any further forwarding rules, marking the notification as being in error.

To View and Maintain Vacation Rules

  1. Navigate to the Vacation Rules page by navigating to your Worklist and selecting the Vacation Rules link.

    The list of your vacation rules includes rules that you defined yourself as well as any rules defined for you by an administrator. A rule's active or inactive status depends on whether the current date falls within the rule's effective dates.

  2. To update a rule, select the Update icon for that rule. See: To Create or Update a Vacation Rule.

  3. To delete a rule, select the Delete icon for that rule.

  4. To create a new rule, select the Create Rule button. See: To Create or Update a Vacation Rule.

To Create or Update a Vacation Rule

  1. Navigate to the Vacation Rules page and choose to create or update a rule.

  2. In the Vacation Rule: Item Type page, select the item type to which this rule applies.

    See: Setting Up Vacation Rule Options, Oracle Workflow Administrator's Guide.

  3. Choose the Next button to proceed.

  4. In the Vacation Rule: Notification page, select the notification message to which this rule applies or select All if you want this rule to apply to all notifications in the selected item type.

  5. Choose the Next button.

  6. If you choose to update a rule from the Vacation Rules page, choose All in the Vacation Rule: Item Type page, or choose a notification in the Vacation Rule: Notification page, the Vacation Rule: Response page appears. The fields in this page vary depending on the item type(s) and notification(s) to which this rule applies. For example, if your rule applies to all item types, you can automatically reassign all the notifications to another user, but you cannot define an automatic response to all the notifications since different notifications may have different response attributes.

  7. Enter values in the Start Date and End Date fields to specify the period that this rule should be active. If you leave the Start Date blank, the rule is effective immediately. If you leave the End Date blank, the rule is effective indefinitely.

    Attention: Since you can define different rules for the same notification(s) to be effective at different times, Oracle Workflow allows you to define multiple rules for the same notification(s). You should be careful to ensure that rules for the same notification(s) do not overlap in their effective dates. If multiple rules are effective for the same notification, Oracle Workflow picks one rule at random to apply.

  8. In the Message field, enter any text that you want to append to the notification when the rule is applied. The comments appear in a special comments field when the notification is reassigned or automatically responded to.

  9. Choose the action that you want this rule to perform:

  10. If your rule action is "Reassign", select the type of user or role to which you want to reassign the notifications. Then select the user or role you want within that type.

    Note: The assignee types correspond to the originating system partitions in the Oracle Workflow directory service. See: Setting Up a Directory Service for Oracle Workflow Embedded in Oracle Applications, Oracle Workflow Administrator's Guide.

    Then specify how you want to reassign the notifications.

    Attention: Your workflow administrator may implement special logic to verify that the role that you attempt to delegate or transfer the notifications to is legitimate or to restrict reassignment of notifications altogether. If so, you may get a warning message to that effect when you attempt to create a reassigning rule.

  11. If your rule action is "Respond", set the values that you want to automatically respond with.

Viewing Notifications from the Personal Worklist

Note: The Personal Worklist is currently available only for the version of Oracle Workflow embedded in Oracle Applications. Before you can access the Personal Worklist, your system administrator must add it to the menu for an Oracle Applications responsibility that is assigned to you. See: Adding Worklist Functions to User Responsibilities, Oracle Workflow Administrator's Guide.

The Personal Worklist lets you choose which notifications to display in your Worklist and what information to display for those notifications. In addition to the preconfigured worklist viewing options provided by Oracle Workflow, you can create personal worklist views by defining a set of filtering criteria that determine what types of notifications and what notification properties are included in the display. Alternatively, you can perform one-time searches to locate notifications you want to view. You can also save the search criteria as a personal worklist view to repeat the same search later.

When viewing notifications from the Personal Worklist, you can respond to your notifications, reassign notifications to another user, request more information about a notification from another user, respond to requests for information, and define vacation rules to handle notifications automatically in your absence.

To View Notifications from the Personal Worklist

  1. Use a web browser to navigate to the Personal Worklist, using a responsibility and navigation path specified by your system administrator.

  2. To perform a one-time search to locate notifications that match your criteria, select the Simple Search button. From the Simple Search page, you can also navigate to the Advanced Search page. See: To Perform a Simple Search for Notifications.

  3. To specify which notifications to display in the Worklist, select the type of notifications you want from the View pull-down menu and select Go. Oracle Workflow provides the following preconfigured views:

    You can also create your own personalized views to display notifications that match criteria that you specify. To maintain your personalized views, select the Personalize button. See: To View and Maintain Personal Worklist Views.

    The views that are available may also depend on the responsibility through which you access the Personal Worklist.

  4. The Personal Worklist shows the following information for each notification:

    Select the From, To, Type, Subject, Sent, Due, or Status column heading to sort the list by that column. By default, the list is sorted by sent date from most recent to oldest, and then by subject in alphabetical order.

  5. To collectively reassign a group of notifications, select the notifications you want and select the Reassign button. See: To Reassign a Notification to Another User.

    Note: Your workflow may include special logic to restrict reassignment of notifications. If any of the notifications that you selected are restricted in this way, Oracle Workflow displays an error message when you select the Reassign button. In this case you should deselect the restricted notifications before performing the reassignment. See: #HIDE_REASSIGN Attribute, Oracle Workflow Developer's Guide.

  6. You can navigate to the full details of any notification and act on the notification by clicking on the notification's Subject link or by selecting the notification and then choosing Open. See: To View the Details of a Notification.

  7. To define vacation rules, select the Vacation Rules link. See: To View and Maintain Vacation Rules.

To Perform a Simple Search for Notifications

  1. Navigate to the Simple Search page.

  2. To locate specific notifications, enter your search criteria. The search options are:

  3. Select the Go button to perform your search.

  4. The Simple Search page displays the notifications that match your search criteria. For each notification, the list displays the following information:

    Select the From, Type, Subject, Sent, Due, or Status column heading to sort the list by that column. By default, the list is sorted by sent date from most recent to oldest and then by subject in alphabetical order.

  5. To collectively reassign a group of notifications, select the notifications you want and select the Reassign button. See: To Reassign a Notification to Another User.

  6. You can navigate to the full details of any notification and act on the notification by clicking on the notification's Subject link or by selecting the notification and then choosing Open. See: To View the Details of a Notification.

  7. To define vacation rules, select the Vacation Rules link. See: To View and Maintain Vacation Rules.

  8. To save your current search criteria as a personalized view for the worklist, select the Save Search button. See: To Create or Update a Personal Worklist View.

  9. You can also select the Advanced Search button to perform a search with more complex criteria, or select the Worklist Views button to navigate back to the Worklist. See: To Perform an Advanced Search for Notifications.

To Perform an Advanced Search for Notifications

  1. Navigate to the Advanced Search page.

  2. Specify how you want to apply search criteria to locate specific notifications.

  3. Enter the search criteria you want to use to locate notifications. The following search options are displayed by default:

    To display additional search options, select the notification property you want from the Add Column pull-down menu and select the Add button.

    Note: You can choose to display more than one search option of the same type if you want to apply several search criteria to the same notification property. For example, if you want to search for notifications that were sent between two particular dates, you can display two Sent search options. Set one option to search for all notifications sent after the first date, and set the other option to search for all notifications sent before the second date. If you choose "Search results where each must contain all values entered", then the search will display notifications that match both search criteria, with sent dates falling in between the two dates that you specified.

  4. For each search option, select a filter operator and then enter a filter value to specify the notifications you want to display.

    For the is filter operator, you should enter a complete filter value that you want to match. For the other filter operators, you can enter a partial value, unless you are using the Sent, Due, and Closed search options, which always require a complete date in the date format you chose in your Oracle E-Business Suite general preferences. The filter value fields for all search options are case insensitive.

    If you leave the filter operator and filter value blank for a search option, that option will not be included in the search.

    Note: The greater than, less than, after, and before filter operators are not inclusive. For example, a search on the Sent option with the after operator displays only notifications sent after the date you specify, not notifications sent on that date itself.

    Note: If your installation of Oracle Workflow is set up in a language other than English, the Advanced Search page uses translated versions of the notification status, notification priority, yes, and no values. In this case you should enter the translated values for the Status, Priority, Response Required, FYI, and From Me search options.

  5. Select the Go button to perform your search. You can also select the Clear button to clear the search option fields and remove any additional search options you added, so that you can enter new search criteria.

  6. The Advanced Search page displays the notifications that match your search criteria. For each notification, the list displays the following information:

    Select the From, Type, Subject, Sent, Due, or Status column heading to sort the list by that column. By default, the list is sorted by sent date from most recent to oldest and then by subject in alphabetical order.

  7. To collectively reassign a group of notifications, select the notifications you want and select the Reassign button. See: To Reassign a Notification to Another User.

  8. You can navigate to the full details of any notification and act on the notification by clicking on the notification's Subject link or by selecting the notification and then choosing Open. See: To View the Details of a Notification.

  9. To define vacation rules, select the Vacation Rules link. See: To View and Maintain Vacation Rules.

  10. To save your current search criteria as a personalized view for the worklist, select the Save Search button. See: To Create or Update a Personal Worklist View.

  11. You can also select the Simple Search button to perform a search with less complex criteria, or select the Worklist Views button to navigate back to the Worklist. See: To Perform a Simple Search for Notifications.

To View and Maintain Personal Worklist Views

  1. Navigate to the Personalize Views page.

    The Personalize Views page displays all existing views for the role you are logged in as, including both preconfigured views provided by Oracle Workflow and your personalized views. For each view, the list displays the view name, description, whether the view appears as a choice in the View menu in the Personal Worklist, and whether the view is set as your default view.

  2. In the Display View column for a personalized view, select Yes to include the view in the View menu in the Personal Worklist, or select No to exclude the view from the View menu. Then choose the Apply button to save your changes.

    Note: The preconfigured views provided by Oracle Workflow always appear in the View menu. You cannot change this setting for those views.

  3. To update a view, select the icon in the Update column for that view. See: To Create or Update a Personal Worklist View.

    Note: You can only update personal views that you created. You cannot update the preconfigured views provided by Oracle Workflow.

  4. To delete a view, select the icon in the Delete column for that view.

    Note: You can only delete personal views that you created. You cannot delete the preconfigured views provided by Oracle Workflow.

  5. To create a view that is a duplicate of an existing view, select the existing view that you want to copy and select the Duplicate button. See: To Create or Update a Personal Worklist View.

  6. To create a new view, select the Create View button. See: To Create or Update a Personal Worklist View.

To Create or Update a Personal Worklist View

  1. Navigate to the Create View page, the Duplicate View page, or the Update View page by one of the following methods.

    The Create View page, the Duplicate View page, and the Update View page are identical, except that the fields in the Duplicate View and Update View pages are populated with previously defined information for the selected view. Additionally, if you navigate to the Create View page by saving a simple or advanced search, some fields in the Create View page are populated with your search criteria.

  2. In the General Properties region, enter a display name to identify your personalized view.

    In the Duplicate View page, the view name defaults to Duplicate of [original view name]. You can optionally enter a different name.

  3. Select the number of notification rows you want to display in the view.

  4. If you want to make this view your default view, check the Set as Default check box. Only one view can be set as the default at any time, so if you check Set as Default for the current view, this option is automatically deselected for any view you previously set as the default.

    Note: Although you cannot update any settings for the preconfigured views provided by Oracle Workflow, if you want to use a preconfigured view as your default view, you can create a duplicate of the preconfigured view and check Set as Default for the duplicate view. The preconfigured Open Notifications view is used as the default view if no other default is set.

  5. Enter an optional description for the view.

  6. In the Column Properties region, specify the notification property columns you want to display in the view and the order in which to display them. The Columns Displayed list shows the columns that are currently set to display, while the Available Columns list shows the columns that are not currently set to display but that you can choose to add.

  7. If you want to change the display names for the notification property columns in the view, select the Rename Columns/Totaling button. In the Rename Columns/Totaling page, enter the new name for each column and select the Apply button.

  8. In the Sort Settings region, you can specify up to three levels of sorting for the notifications in the view. For each level of sorting, select the notification property column by which you want to sort and specify whether to sort in ascending or descending order.

  9. In the Search Query to Filter Data in your Table region, specify how you want to apply search criteria to locate specific notifications to display in the view.

  10. Enter the search criteria you want to use to locate notifications to display in the view.

    To display additional search options, select the notification property you want from the Add Column pull-down menu and select the Add button.

    Note: You can choose to display more than one search option of the same type if you want to apply several search criteria to the same notification property. For example, if you want to search for notifications that were sent between two particular dates, you can display two Sent search options. Set one option to search for all notifications sent after the first date, and set the other option to search for all notifications sent before the second date. If you choose "Search results where each must contain all values entered", then the search will display notifications that match both search criteria, with sent dates falling in between the two dates that you specified.

  11. For each search option, select a filter operator and then enter a filter value to specify the notifications you want to display.

    For the is filter operator, you should enter a complete filter value that you want to match. For the other filter operators, you can enter a partial value, unless you are using the Sent, Due, and Closed search options, which always require a complete date in the date format you chose in your Oracle E-Business Suite general preferences. The filter value fields for all search options are case insensitive.

    If you leave the filter operator and filter value blank for a search option, that option will not be included in the search.

    Note: The greater than, less than, after, and before filter operators are not inclusive. For example, a search on the Sent option with the after operator displays only notifications sent after the date you specify, not notifications sent on that date itself.

    Note: If your installation of Oracle Workflow is set up in a language other than English, the personal worklist views use translated versions of the notification status, notification priority, yes, and no values. In this case you should enter the translated values for the Status, Priority, Response Required, FYI, and From Me search options.

  12. Select the Apply button to save the view and return to the Personalize Views page, or select the Apply and View Results button to save the view and display it immediately in the Personal Worklist.

    You can also select the Cancel button to return to the Personalize Views page without saving the view. Alternatively, you can select the Revert button to clear any changes you made to the view settings. In the Create View page, the settings revert to the default values, while in the Update View or Duplicate View page, the settings revert to the previously saved values for the existing view you are updating or duplicating.

Related Topics

Viewing Notifications from a Web Browser for Oracle Applications