Practices for Lesson 10 Practices Overview
Practice 10-2: Configure Human Workflow Notification Services Overview
You configure the Human Workflow Notification Service properties through Oracle Fusion Middleware Control Console to support email notification and restart the SOA server.
Because the classroom configuration provides an email server you only configure email notification services that require you to configure properties for the installed email driver component.
Assumptions
You have configured the user and group information in the Embedded LDAP server, and have restarted Oracle WebLogic Server.
Tasks
1. To configure the Human Workflow Notification Server properties, perform the following steps:
a. In a Web browser window, if required, enter the URL http://localhost:7001/em and login as the weblogic user with password welcome1.
b. On the Oracle Fusion Middleware Control Console home page, expand the SOA folder in the Farm navigation frame, right-click soa-infra (soa_server1), and select SOA Administration > Workflow Notification Properties.
c. On the SOA Infrastructure > Workflow Notification Properties page, enter the values specified in the following table and click Apply.
Field Value
Notification Mode ALL
Email: From Address [email protected] Email: Actionable Address [email protected] Email: Reply To Address [email protected]
For example:
Oracle University and (Oracle Corporation) use only.
d. On the Confirmation window, click Yes.
e. On the SOA Infrastructure > Workflow Notification Properties page, verify you get a confirmation that the changes have been applied and observe the information indicating that you must restart the SOA server.
Note: However, first configure the email driver properties as described in the next task before you restart the SOA managed server.
2. To configure the Email Driver properties, perform the following steps:
a. On the SOA Infrastructure > Workflow Notification Properties page, click the “Go to the Messaging Driver page” link. For example:
Oracle University and (Oracle Corporation) use only.
c. On the usermessagingdriver-email > Email Driver Properties page, in the Common Configuration section, set the following field and their values:
− Sender Addresses: [email protected]
− Default Sender Address: [email protected] For example:
d. On the same usermessagingdriver-email > Email Driver Properties page, in the Driver-Specific Configuration section, configure the email driver properties, and click Apply (at the top of the page) only after setting all the driver properties. For example:
Note: To set the email driver properties you need to scroll down in the Driver-Specific Configuration section to set some of the field values listed in the following table (as some of the fields listed may already have the correct value):
Field Value
MailAccessProtocol POP3
OutgoingMailServer soa11g.example.com OutgoingMailServerPort 25
Oracle University and (Oracle Corporation) use only.
IncomingMailServer soa11g.example.com IncomingMailServerPort 110
IncomingMailIDs [email protected] IncomingUserIDs workflow.action
IncomingUserPasswords Type of Password: Indirect Password, Create New User
Indirect Username/Key: workflow.action Password: welcome1
Note: The password value displays asterisks when entered.
For example: The following images show the driver property settings for this course.
Note: The SMTP Server does not require authentication to send messages. This may be different in your environment.
Oracle University and (Oracle Corporation) use only.
Note: To receive incoming messages password authentication is required.
e. On the usermessagingdriver-email page, observe the confirmation message that changes have been applied.
f. On the Oracle Fusion Middleware Control Console, click the Log Out link, and close the Web browser page. For example:
3. To restart Oracle SOA managed server, perform the following steps:
a. In a Command Prompt Window enter the following commands:
D:\> cd D:\Oracle\fmw\11.1.1.3\user_projects\domains\soa_doma in\bin
D:\> stopManagedWebLogic.cmd soa_server1
Note: You do not need to restart the (Oracle WebLogic Server) Admin Server instance.
Close the command window used to run the soa_server1 managed server instance if it is not closed when the managed server is stopped.
b. In the same Command Prompt window used to stop the SOA managed server, enter the following command to start the SOA managed server again:
D:\> start startManagedWebLogic.cmd soa_server1
c. Wait for the SOA managed server to be up and running, which may take two to five minutes. For example when you see the following line displayed in the SOA manager server command window:
INFO: FabricProviderServlet.stateChanged SOA Platform is running
Oracle University and (Oracle Corporation) use only.
Note: You can minimize the various Command Prompt windows, such as those running the Admin and SOA servers, and optionally close the window used to restart the SOA managed server.
4. To verify that the Human Workflow Notification Services have been configure correctly, you use the Notification Management page of the Human Wokflow Engine to send a test email to the weblogic user’s email address, by performing the following steps:
a. In a Web browser window, access (or refresh) the Oracle Fusion Middleware Control Console login page (URL http://localhost:7001/em) and login with the username weblogic and password welcome1.
b. On the Farm navigation frame, expand the SOA node, right-click soa-infra (soa_server1) and select Service Engines > Human Workflow.
c. On the Human Workflow Engine (Service Engine) page, click the Notification Management tab, and then click Send Test Notification.
Oracle University and (Oracle Corporation) use only.
e. In the Send Test Notification dialog box, after clicking Send, observe the Response information message, such as SENT (if successful). Click Cancel to dismiss or close the Send Test Notification dialog box.
f. On the Human Workflow Engine (Service Engine) > Notification Management tab page, click the refresh icon to update the page.
Note: The reason you refresh the Notification Management tab page is to view the Outgoing Notifications for messages communicated through different Workflow Notification Service channels, in this case email.
g. On the Human Workflow Engine (Service Engine) > Notification Management tab page, scroll down and view the entries in the table in the Outgoing Notifications section. The
top-most message represents the test notification just sent. For example:
Oracle University and (Oracle Corporation) use only.
Note: If you click the Sent link for the entry, a Status Description dialog box containing a success message is displayed. For example:
Additional Note: You can track all notification messages for all channels in the Notification Management tab page in the Human Workflow Engine (Service Engine) pages. The following image shows two sections for monitoring:
− Outgoing Notifications: messages sent from processes within the SOA server to external sources
− Incoming Notifications: message received from external sources for processing within SOA processes or Human Workflow engines.
5. To confirm receipt of the test message and view the email message sent by the Human Workflow Notification Service to the weblogic email account, perform the following steps:
a. Start Mozilla Thunderbird using the desktop icon.
Note: If Mozilla thunderbird is already running, focus on its application window.
b. On the Mozilla Thunderbird application window, if needed, click the
[email protected] account name in the Inbox folder. The “Notify test” message should appear in the message list frame. Click the email message with the Subject “Notify test” to view the body in the Message Pane below the message. For example:
Oracle University and (Oracle Corporation) use only.
Note: If the “Notify test” message does not appear, click Get Mail in the Mozilla Thunderbird toolbar. The weblogic user Inbox may contain additional email
messages from BPMN application that you may have executed in earlier practices of this course. The “Subject,” “From,” and “Date” columns have been resized for visual clarity in this document.