Monitoring Deployed Human Workflows in the Service Engine

Managing Human Workflow Service Components and Engines 21-7 4. Perform fault recovery through either of the following methods:

a. In the Error Message column, click a specific message to display complete

fault details, including the fault ID, fault time, fault location, fault type, and error message text. If the fault is recoverable, a Recover Now button is displayed that you can click to recover from the fault. Clicking this button invokes the human workflow audit trail page for the instance. The audit trail page has a link to Oracle BPM Worklist called Go to Worklist Application, where you can go to recover from the fault. The Oracle BPM Worklist link does not take you directly to the fault; you must manually locate the fault.

b. In the Recovery column, click a fault that is marked as recoverable to invoke

the human workflow audit trail page for the instance. The audit trail page provides the same link to Oracle BPM Worklist called Go to Worklist Application . 5. Perform the following additional monitoring tasks from within the faults table:

a. Click the Show only recoverable faults checkbox to display only faults from

which you can recover.

b. From the Fault Type list, select to display all faults, system faults, business

faults, or OWSM faults in the faults table. Click the Help icon for a description of these fault types.

c. From the View list, select Columns Fault ID to display the fault IDs for each

error message. The fault ID is automatically generated and uniquely identifies a fault. The fault ID is also displayed when you click an error message.

d. In the Component Instance ID column, click a specific service component ID

to access task details about the instance for example, the current state of a task. Note that rejected messages do not have a component instance ID.

e. In the Logs column, click a specific log to access the Log Messages page with

filtered messages specific to that instance.

21.5 Managing Outgoing Notifications and Incoming Email Notifications

You can manage incoming and outgoing notifications through email in human workflow, including testing messages, resending messages, and identifying messages as spam. Incoming and outgoing notifications are sent to and from human workflow. Incoming notifications are responses to actionable notifications. For example, an outgoing notification is sent to the manager of an employee requesting vacation leave. The manager approves the request by clicking the Approve link in the actionable notification email. This action sends an incoming notification to human workflow for possible additional processing. To manage outgoing notifications and incoming email notifications: 1. Access this page through one of the following options:

2. Click Notification Management.

From the SOA Infrastructure Menu... From the SOA Folder in the Navigator... 1. Select Service Engines Human Workflow . 1. Right-click soa-infra. 2. Select Service Engines Human Workflow . 21-8 Oracle Fusion Middleware Administrators Guide for Oracle SOA Suite and Oracle BPM Suite The upper part of the Notification Management page displays the following details: ■ A utility for searching for a specific message by specifying criteria and clicking Search . You must expand the Search icon to display this utility. ■ Outgoing notifications, including the source ID, the source type for example, if a notification is sent by a BPEL service component, the type is BPEL, the channel used for example, email, SMS, instant messenger, or voice, the address of the message recipient, the message status for example, error, send, retry, sent, and the time at which the message was sent. The lower part of the Notification Management page displays the following details: ■ A utility for searching for a specific message by specifying criteria and clicking Search . You must expand the Search icon to display this utility. ■ Incoming notifications, including the message ID, the channel used same types as for outgoing notifications, the address of the message sender, the address of the message recipient, the message status replied email notification, unsolicited email, unknown email content, response not processed, and response processed, a link to the content of the message, and the time at which the message was received. 3. Perform the following actions on outgoing notifications. Managing Human Workflow Service Components and Engines 21-9 If outgoing notifications are sent to an incorrect address of a message recipient, they are displayed as errors in the Recipient column. You can correct the recipients address and resend the notification.

4. In the Recipient column, click the email address and correct the address.

5. Perform the following actions on incoming notifications. For more information about notifications, see Oracle Fusion Middleware Developers Guide for Oracle SOA Suite.

21.6 Moving Human Workflow Data from a Test to a Production Environment

You can migrate Human Workflow user metadata, such as views, mapped attribute previously known as flex field mappings, and vacation rules, from a test environment to a production environment using the Human Workflow User Config Data Migrator. The Data Migrator is available as an ant target that can be executed at the command line. You specify the input parameters for the migration of data in a properties file, migration.properties. For example, assume you have two SOA servers installed: ■ SOAServer_A Action Description Send Test Notification Test that outgoing messages are arriving at the correct destination. This ensures that the destination is reachable and messages are arriving. Selecting this option invokes a dialog for specifying the following destination details: ■ Destination address ■ Delivery channel for example, email ■ Message subject and content Resend Select specific outgoing notification messages in the table and click Resend to resend. Use this option if you believe that messages are not arriving at their correct destination. For example, you may have incorrectly configured a recipient address. After correcting the address, click Resend to test the delivery. Resend All Similar Notifications Resend all error notification messages having the same recipient address as the selected one. View Bad Addresses Click to display a list of bad or invalid addresses. The addresses are automatically removed from the bad address list after one hour. If you do not want to wait an hour, you can explicitly select and delete them. Delete icon Click to delete a selected message. Action Description Mark as Spam Mark the message senders address of the selected notification as spam. This action prevents incoming notifications from the same sender address from being delivered again. No Spam Mark incoming messages as not being spam. This action enables new messages from the senders address to be delivered again. Delete icon Click to delete a selected message.