BPM 11 Samples

interestsauceInternet and Web Development

Oct 31, 2013 (3 years and 10 months ago)

101 views

Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
1

of
14


BPM 11
g

Samples


<Email to start a p
rocess
s
ample
>



Last Updated:

1
-
Nov
-
13

Version:

1.0

Status:

DRAFT
















Copyright


2013

Oracle Corporation

All Rights Reserved



Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
2

of
14

1.

Document Control



1.1

Change Record


Date

Author

Version

Change
Reference





31
-
Ja
n
-
1
3

Anirban Dey

1.0

First
draft for internal access to the samples





















Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
3

of
14

Contents

1.

Document Control
................................
................................
................................
..
2

1.1

Change Record

................................
................................
................................
................................
......
2

2.

Environment Requirements

................................
................................
..................
5

3.

Installation and Configuration

................................
................................
.............
6

3.1

Configurat ion of the UMS Adapter and email server for implementing the email event.

.......
6

3.2

Deplo
ying the BPM and Task Form Projects

................................
................................
..................
7

4.

Samples Overview

................................
................................
................................
..
8

5.

Running the Samples

................................
................................
...........................
14

Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
4

of
14

Introduction

In the enterprise world, Email is the main communication option between Business to Business and it is very important to
have
this along with other messaging channels like SMS, IM and Voice integrated with the BPM suite.

Oracle BPM11g includes Message
Events

that can
trigger the
BPMN
process instance upon arrival of a message
.

Message is a
special type of data and is used to

show data exchanges in the context of process interactions. The message can originate from
various sources like e
-
mail, another BPMN process, Adapter event etc.

This document describes a
n initial (small)
set of samples provided
to illustr
ate use of those
Message Events to start a BPMN
process.

The samples can be

deployed and run on an 11.1.1.7

environment.


Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
5

of
14

2.

Environment Requirements

The samples req
uire JDeveloper version 11.1.1.7

with the SOA Composite
Editor
and BPM Studio extensions installed. A
standalo
n
e server with BPM Suite 11.1.1.7

and a domain configured with BPM Suite
is required for deployment and running the
samples.

To implement the e
-
mail message event, the UMS Adapter needs to be configured along with the e
-
mail server.

The UMS
Adapter will wr
ap User Messaging Service allowing business workflow to subscribe to different delivery channels as Email, SMS
and IM

etc.
UMS (User Messaging Service) is a Fusion Middleware component, which provides services to send/receive
notifications/alerts through v
arious messaging channels as Email, SMS, IM, and Voice
.
The UMS Adapter will act as a proxy
between SOA Suite and the external world and will be capable of acting as a Provider or as a Consumer
.




Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
6

of
14

3.

Installation and Configuration

The samples are provided as

a
zipped
JDeveloper
application. The application ca
n be unzipped into any location where the path
name does not include spaces.

To open the application, use the “Application Open” menu and locate the file:

EmailProcessSampleApplicati on
.jws
.

The
application contains 2

projects:



E
mailProcessSampleProject
-
BPM project that inc
ludes processes a
nd human tasks and
Email event



EmailProcess
UI


Task form
project
for the human

task used in the samples.

3.1

Configuration of the UMS Adapter and email server for
implementing the email event.



Log into the Enterprise Manager
. Click on the User Messaging Service in the left navigation.




Right click on the usermessagingdriver
-
email and configure the email driver properties accordingly:

Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
7

of
14



3.2

Deploying the BPM and Task
Form Projects

From the Application Navigator deploy the BPM and the Task Form Projects.



Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
8

of
14

4.

Samples Overview

A simple BPM process is provided to illustrate features

and usage of the BPM11g
Email message events
:





Configuring the UMS Adapter Service

:

-
Navigate to the BPM project Navigator

Business Catalog

References

Right click on it to configure the UMS
Adapter



Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
9

of
14

-

Now provide the service name


-

JNDI name automatically gets populated


-

Select the Inbound Receive Notification as the operation type:

Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
10

of
14


-

Select the Inbound Operation mode (here it is selected as listener)


-
Select

the type of notification the BPMN process will receive and the email
endpoint configuration.

Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
11

of
14


-
Select the schema element that defines the message.

UMS Adapter will use a predefi
ned Message Schema to represent
the message
.


-
If user opts for the option Message is String Type, wizard will add an element of type xsd: string (payload definition) to
the static schema
.

Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
12

of
14





Configuring the e
-
mail message event
:

The E
-
Mail Message Event is always associated with the operation of a service
interface. The following steps illustrate the configuration of
an

E
-
Mail Message
Event in BPM Studio.

-

Right
-
click on Email Message Start Event and choose Properties. This brings
up the properties wizard. Go to the
Implementation tab.

-

Select the “Use Interface” option from the message exchange type dropdown and then
next to the Reference field,
browse
and select
the recently created “Inbound Email Service”
.


Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
13

of
14

-

Use the Data Associati
ons section to map the incoming message to process data objects. This completes the
config

of the Message Start Event.


Oracle Confidential. For authorized use only. Do not distribute to third parties



Page
14

of
14

5.

Running the Samples



Inside BPM Workspace, log in as
swim lane role
process owner, user id “weblogic”.



The BPMN process is started by
the email message.



Click on the task.The system launches a Task UI. Fill the details of the order. Click on
the submit button.



The system sends the e
-
mail to the recipient.