Skip Headers
Oracle® Application Server Developer's Guide for Microsoft Office Interoperability
10g Release 3 (10.1.3.1.0)

Part Number B28947-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

7 Delivering Business Activity Monitoring Alerts and Reports to Microsoft Outlook

This chapter demonstrates how to use Oracle Business Activity Monitoring to send alerts and reports to your Microsoft Outlook e-mail client.

This chapter contains the following sections:

7.1 Overview

In today's enterprise, there is a real need to streamline and automate enterprise business processes, especially those requiring human participation. By sending workflow alerts and notifications in e-mail, you draw attention to the events that triggered them, thus increasing the likelihood that those events are addressed swiftly and accurately.

Oracle Business Activity Monitoring provides real-time visibility into enterprise operations, which enables business users to cut costs and improve processes while business events, such as a drop in inventory levels, occur. The Oracle Business Activity Monitoring architecture utilizes messaging, data integration, advanced data caching, analytics monitoring, alerting, and reporting technology to deliver critical information within seconds of an event or change in status.

You can create alerts that are triggered by specific events and conditions. These alerts can, in turn, automatically send reports to specific users. Alerts can be sent when data changes in a report, or you can use alerts to send a report to users daily or at set intervals. As a result of events and conditions, your alerts can send reports to Oracle Business Activity Monitoring users through e-mail. In this chapter, the focus is on sending alerts and reports to a Microsoft Outlook e-mail client.

Instead of having business users constantly monitor their business processes or activities for changes, you can create solutions to send alerts from Oracle Business Activity Monitoring directly into their Microsoft Outlook e-mail clients. These alerts can be regular links that open in a browser, or embedded in documents sent as e-mail attachments.

7.2 Prerequisites

To perform the steps outlined in this chapter, install the following software:

In addition, you must make sure that the From address is configured. To do this, perform the following steps:

  1. Start Oracle Business Activity Monitoring Administrator.

  2. From the drop-down list, choose Message Center management.

  3. Click Edit.

  4. Enter appropriate values in the Server Name, Server Port, and Email Account for Alerting fields.

  5. Click Save.

  6. Restart the Oracle Business Activity Monitoring Event Engine:

    1. In the Control Panel, click Administrative Tools, then Services.

    2. Right-click the Oracle BAM Event Engine Service, and choose Restart from the popup menu.

  7. Click Continue.

7.3 Step-by-Step Procedures

Oracle Business Activity Monitoring lets you create the following solutions for sending alerts and reports to Microsoft Outlook e-mail clients:

7.3.1 Sending E-Mail Alerts with Links

Oracle Business Activity Monitoring enables business executives and operations managers to improve their decision-making process by providing a real-time view of the business events occurring in their enterprise, then enabling them to use the derived intelligence to analyze and improve the efficiency of their business processes. For example, enterprises that run distributed global supply chains with just-in-time inventory practices must continually monitor their inventory levels and correlate them to the bills of material and replenishment requests they have sent to their suppliers and logistics partners. Failure to do so jeopardizes their ability to maintain a balanced flow of parts and inventory throughout their entire supply chain. With Oracle Business Activity Monitoring, as soon as the inventory level on a particular item drops below a certain level, the operations manager receives an alert. This alert can include a link to a Web-based user interface through which the alert recipient can reorder the relevant item.

Suppose a salesperson for a music retailer wants to receive an e-mail alert (shown in Figure 7-1) when the sales of any cassette or CD reach a certain level. The e-mail must contain a link to a report that shows the breakdown of sales for that particular cassette or CD.

Figure 7-1 E-Mail Alert for Media Sales

E-mail Alert for Media Sales
Description of "Figure 7-1 E-Mail Alert for Media Sales"

To configure Oracle Business Activity Monitoring to send an e-mail alert with a link, perform the steps in the following sections:

7.3.1.1 Creating a Report

To create a report in Oracle Business Activity Monitoring, perform the following steps:

  1. Start Oracle Business Activity Monitoring Active Studio.

  2. Click CREATE A NEW REPORT.

  3. Click the Tiled Report option with a title and four tiles (see Figure 7-2).

    Figure 7-2 Selecting a Tiled Report

    Description of Figure 7-2 follows
    Description of "Figure 7-2 Selecting a Tiled Report"

  4. Click Click to add a report title at the top of the page, and add the report title Media Sales Report.

  5. In the top left tile, click the Bar Chart icon (see Figure 7-3).

    Figure 7-3 Selecting the Type of Chart for a Tile in a Report

    Description of Figure 7-3 follows
    Description of "Figure 7-3 Selecting the Type of Chart for a Tile in a Report"

  6. In the Data Objects section, double-click Samples.

  7. Select Media Sales, and then click Next.

  8. In the Group By list, select the Record Label check box.

  9. In the Chart Values list, select the Costs check box.

  10. In the Summary Function(s) list, select the Sum check box (see Figure 7-4).

    Figure 7-4 Choosing Data Fields

    Description of Figure 7-4 follows
    Description of "Figure 7-4 Choosing Data Fields"

  11. Click Next.

  12. Click the Change View Properties icon.

  13. In the View Title field, type Sales by Record Label.

  14. Click OK.

  15. In the top right tile, click the Pie Chart icon.

  16. In the Data Objects section, double-click Samples.

  17. Select Media Sales, and then click Next.

  18. In the Group By list, select the Category check box.

  19. In the Chart Values list, select the Costs check box.

  20. In the Summary Function(s) list, select the Sum check box.

  21. Click Next

  22. Click the Change View Properties icon.

  23. In the View Title field, type Sales by Category.

  24. Click the Data Labels tab.

  25. Select the Percent and Series Name check boxes.

  26. Click OK.

  27. In the bottom left tile, click the Line Chart icon.

  28. In the Data Objects section, double-click Samples.

  29. Select Media Sales, and then click Next.

  30. In the Group By list, select the Quarter check box.

  31. In the Chart Values list, select the Costs check box.

  32. In the Summary Function(s) list, select the Sum check box.

  33. Click Next.

  34. Click the Change View Properties icon.

  35. In the View Title field, type Sales by Quarter.

  36. Click OK.

  37. In the bottom right tile, click the Streaming List icon.

  38. In the Data Objects section, double-click Samples.

  39. Select Media Sales, and then click Next.

  40. Select all the check boxes: Category, Costs, Media Format, Quarter, Record Label, Sales, and Year.

  41. Click Next.

  42. Click the Change View Properties icon.

  43. In the View Title field, enter Detailed Sales Summary.

  44. Click OK.

  45. In the Actions pane, click Save Report.

  46. Select the My Reports folder in Save in.

  47. In the Report Name field, enter Media Sales Report.

  48. Click OK.

  49. Start Oracle Business Activity Monitoring Active Viewer.

  50. Click Select Report.

  51. Select Media Sales Report, and then click OK.

    You should see the Media Sales Report as shown in Figure 7-5.

    Figure 7-5 Media Sales Report

    Description of Figure 7-5 follows
    Description of "Figure 7-5 Media Sales Report"

7.3.1.2 Creating an Alert Rule

To create alert rules in Oracle Business Activity Monitoring, perform the following steps:

  1. Start Oracle Business Activity Monitoring Active Studio.

  2. Click the Alerts tab.

  3. Click CREATE A NEW ALERT.

  4. Click CREATE A RULE.

  5. In the Rule Name field, type CD Sales.

  6. From the Select an Event list, select When a data field in a data object meets specified conditions.

  7. Click Next.

  8. From the Select an Action list, select Send a message via email.

  9. In the Rule Expression section, click this data field has a condition of x to display the Alert Rule Editor.

  10. In the Data Objects section, select Media Sales.

  11. Click the Row Filter tab.

  12. Click add new entry.

  13. From the field list, choose Sales.

  14. From the Comparison list, choose is equal to.

  15. From the next list, select Value.

  16. In the Value field, type 1111. This reflects the number of CDs or cassettes that must be sold in order to trigger the alert.

  17. Click add entry (see Figure 7-6).

    Figure 7-6 Specifying a Filter for the Alert

    Specifying a Filter for the Alert
    Description of "Figure 7-6 Specifying a Filter for the Alert"

  18. Click OK.

  19. In the Rule Expression section, click create message to display the Alert Message dialog box.

  20. In the Subject field, type New media sold. Sale price:.

  21. Alerts can include the data that triggered the alert in the first place.

    From the list on the left, select Sales, then click Insert into subject.

  22. In the Message Text field, enter Check it out:.

  23. From the list on the right, select the Media Sales Report that you created in Section 7.3.1.1, "Creating a Report".

  24. From the list on the left, select Send Report Link, then click Insert into text (see Figure 7-7).

    Figure 7-7 Specifying the Alert Message

    Description of Figure 7-7 follows
    Description of "Figure 7-7 Specifying the Alert Message"

  25. Click OK.

  26. In the row for the action, click select user to display the Select Names dialog box.

  27. Select the user to whom you want to send the alert (see Figure 7-8). For the purposes of this exercise, send the alert to yourself.


    Note:

    You can use Oracle Business Activity Monitoring Administrator to manage users and specify their e-mail addresses. For information about how to do this, refer to Oracle BAM Administrator's Guide.

    It is also possible to configure Oracle Business Activity Monitoring to be provisioned with the user information stored in your corporate directory, for example Oracle Internet Directory.


    Figure 7-8 Specifying Alert Recipients

    Specifying Alert Recipients
    Description of "Figure 7-8 Specifying Alert Recipients"

  28. Click OK.

  29. Click OK to close the Rule Creation and Edit dialog box.

An alert will now be sent to your e-mail client when sales of any CD or cassette reach 1111.

7.3.1.3 Verifying That the Alert Is Working

As a developer, you typically want to test the alert without having to wait until the alert condition is satisfied. If you have administrative privileges, you can use Oracle Business Activity Monitoring Architect to manipulate the underlying data to trigger the alert. To do this, perform the following steps:

  1. Start Oracle Business Activity Monitoring Architect.

  2. In the Folders pane, click Samples.

  3. In the Data Objects pane, click Media Sales.

  4. Click Contents in the list of links at the top of the right pane.

  5. In the top row, make a note of the current value for the Sales column.

  6. Click Edit Contents.

  7. In the top row, click Edit.

  8. Change the value in the Sales column to 1111 (see Figure 7-9).

    Figure 7-9 Triggering the Alert

    Triggering the Alert
    Description of "Figure 7-9 Triggering the Alert"

  9. Click Update.

  10. In the Folders pane, click System, then click Alerts.

  11. In the Data Objects pane, click History.

  12. Click Contents in the list of links at the top of the right pane.

  13. If necessary, scroll down to the end of the table. You should see that an alert has been sent to your e-mail account (see Figure 7-10).

    Figure 7-10 Alert History

    Alert History
    Description of "Figure 7-10 Alert History"

  14. Check your e-mail client to make sure that you received the alert.

  15. Open the message and click the link to view the report.

  16. As soon as you have verified that the alert is working, remember to use Oracle Business Activity Monitoring Architect to reset any changes you made to the Media Sales data.

7.3.2 Sending Reports as E-Mail Attachments

Suppose that, instead of sending an alert, you want to e-mail a daily report that contains a snapshot of data from data objects in the Active Data Cache, as shown in Figure 7-5. Oracle Business Activity Monitoring enables you to e-mail such a report as an attachment in the .MHT format. Because .MHT files can be opened in either Microsoft Internet Explorer or Microsoft Word, the data can be reviewed even when the recipient is not connected to the Internet.

To configure Oracle Business Activity Monitoring to send reports to e-mail addresses, perform the steps in the following sections:

7.3.2.1 E-Mailing the Report

To e-mail a report to one or more Oracle Business Activity Monitoring users, perform the following steps:

  1. Start Oracle Business Activity Monitoring Active Studio.

  2. Click the My Reports tab.

  3. Double-click the report that you created in Section 7.3.1.1, "Creating a Report".

  4. In the Actions pane, click Email, and then click Report page.

    The E-mail Report dialog box is displayed.

  5. In the To, CC, and BCC fields, specify Oracle Business Activity Monitoring user names. You can send e-mail only to users of Oracle Business Activity Monitoring. Include yourself as one of the recipients.

  6. In the Subject field, type Can you believe this?.

  7. In the Message field, type Check out the attached report. (see Figure 7-11).

    Figure 7-11 Specifying Details for E-Mailing a Report

    Description of Figure 7-11 follows
    Description of "Figure 7-11 Specifying Details for E-Mailing a Report"

  8. Click Send.


    Tip:

    If you receive an error at this point, make sure that you have configured the From address as specified in Section 7.2, "Prerequisites".

7.3.2.2 Verifying That the Report Was Sent

To verify that the report was sent, perform the following steps:

  1. Check your e-mail client to make sure that you received the message.

  2. Open the message and download the attached .MHT file to your local file system.

  3. Open the downloaded file in Microsoft Internet Explorer or Microsoft Word and view the report.

7.4 Related Documentation