ccBPM to BPM en 7.3

NetWeaver BPM for System-toSystem Message Orchestration (Including Migration of ccBPM to NW BPM)

Applies to: SAP NetWeaver Process Orchestration 7.31

Summary With the introduction of NetWeaver Process Orchestration 7.31, where NetWeaver PI AEX, NetWeaver BPM and NetWeaver BRM can be installed in the same instance, many users are asking about the migration of ccBPM to NetWeaver BPM or, just simply, how to develop a stateful system-centric message orchestration business process using NetWeaver Process Orchestration 7.31, instead of using ccBPM. This article describes the basics of stateful system-to-system message orchestration using NetWeaver BPM. A simple use-case scenario will be used to demonstrate the design and configuration r equirement of integrating NetWeaver PI and NetWeaver BPM to cover similar use cases as ccBPM.

Author:

William Li

Company: SAP Labs LLC Created on: May 30, 2012

Author Bio William Li is a member of the SAP NetWeaver Orchestration and Integration Team in SAP NetWeaver Solution Management. He has been with SAP SAP since 1998 - originally as a SAP America consultant, as a developer at SAPLabs and t hen as a SAP NetWearver RIG m ember focused on Process Integration. He joined SAP NetWeaver Solution Management in April of 2010. 2010.

SAP DEVELOPER NETWORK | sdn.sap.com © 2012 SAP AG

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com 1

NetWeaver BPM for System-to-System Message Orchestration (Including Migration of ccBPM to NW BPM)

Table of contents Abstract ................ ................................. ................. .................. .................. ................. ................. .................. ................. .................. ... 3 Differences between ccBPM and NetWeaver BPM............................................................................................ 4 ccBPM to NetWeaver BPM ............................................................................................................................. 5 Recommendations during Development ............................................................................................................ 5 NetWeaver BPM Design and Configuration ....................................................................................................... 6 NetWeaver PI Interfaces ................................................................................................................................. 6 NetWeaver PI Scenarios (Integrated Configurations) ..................................................................................... 6 Required receiver configuration for NW PI



Required sender configuration for NW BPM

NW BPM ................. ................. .................. ................. ............ 7



NW PI ................ ................................. ................. .................. ................. ............... 7

NetWeaver BPM Design for Outbound Messages from NW PI to NW BPM .................................................. 7 NetWeaver BPM Design for Inbound Messages from NW BPM to NW PI .................. ................. .................. 8 NetWeaver BPM Design for evaluating conditions (if-then-else) .................................................................... 9 Step-by-Step Procedure ................................................................................................................................... 10 Start NWDS – NWDS – Composite Designer ................ ................................. ................. .................. ................. .................. ................. ....... 11 Import all the service interfaces between NW BPM and NW PI ............................... ................. .................. . 16 Create local variable ..................................................................................................................................... 24 Model the Process ........................................................................................................................................ 29 Configure the Start Event................................ .............................................. ............................ ............................ ............................ ............................. ............................. ............................ ...................... ........30 Create and Configure “Send PO Request” Event .............. ............................ ............................ ............................ ............................. ............................. ........................... ................. ....33 Create and Configure “Wait for PO Response” Event............ Event .......................... ............................. ............................. ............................ ............................ ........................... .............36 Create and Configure Gateway to Check for PO Error ................................ .............................................. ............................ ............................ ............................ .................... ......40 Configure “Write PO Error File” Activity Activity............. ........................... ............................. ............................. ............................ ............................ ............................ ............................ .................... ......43 Configure “Get Customer Info” Activity ............. ........................... ............................. ............................. ............................ ............................ ............................ ............................ .................... ......45 Create and Configure Gateway to Check for Customer Info Error ...................... .................................... ............................ ............................ ........................... .............46 Configure the “Write CustInfo Error File” Activity ............ .......................... ............................. ............................. ............................ ............................ ............................ .................... ......49 Configure the “Write PO CustInfo File” Activity ............. ........................... ............................ ............................ ............................. ............................. ............................ ...................... ........50 Delete the Previously Created “dummy” Service Groups............ Groups .......................... ............................ ............................ ............................. ............................. ...................... ........51

Deploy the NW BPM Process ....................................................................................................................... 53 Running the Scenario.................................................................................................................................... 54 Additional Information ................................ ................. .................. ................. ................. .................. ................ 55 Enterprise Service Repository Content ......................................................................................................... 55 Integration Directory Content ........................................................................................................................ 65 Copyright........................................................................................................................................................... 73




Abstract With SAP NetWeaver Process Orchestration 7.31 (PRO 7.31), using a java-only installation, NetWeaver PI (AEX), NetWeaver BPM and NetWeaver BRM can be installed in the same SID. Without the ABAP stack, ccBPM is no longer available. NW PI will continue to be supported on the dual stack (and thus ccBPM could continue to be used for these use cases) but the direction forward is to support these scenarios with NW Process Orchestration. NW BPM is now the platform to develop stateful message orchestration between systems. Prior to PRO 7.31, the WS adapter was used for integration between NW PI and NW BPM. However, the WS adapter is an ABAP adapter, which is no longer available in a java-only installation. Instead, the XI proxy is used by AEX. The XI proxy not only provides reliable messaging as in the WS adapter, but it is also much more performance oriented. Since NW PI 7.11, the XI proxy is implemented through the SOAP adapter. This article goes through the basic configuration requirement for NW PI and NW BPM in stateful systemcentric message orchestrations. (There is no user-interaction, only system messaging is involved). A typical ccBPM scenario will be used as a comparison to what is needed during the migration to NW NW BPM. The focus of the article is on the configuration of NW BPM, along with the NW PI requirement during interface design and communication channel configuration. Prior knowledge of ccBPM is not required for this article. Since this article is on NW BPM development, it is assumed that the reader is familiar with NW PI development. NW PI development will not be covered in this article. Some details of the contents of the Enterprise Service Repository (ESR) and the Integration Directory (ID) are included in section 6 (Additional Information). For this article, the scenario is as follow:




The business process contains the following steps: 1. 2. 3. 4. 5. 6. 7.

A message containing purchase order information is sent to NW BPM. NW BPM sends the message to a backend ERP system to create a purchase purchase order via NW PI. ERP sends the result of the PO creation back to NW BPM. NW BPM checks the result to determine if the PO creation was successful. If PO creation is successful, then proceed to retrieve customer customer information from a database via NW PI. If not, then issue an error message to an error file. NW BPM checks the result of the customer information retrieval. If the customer exists, then proceed to combine the PO information with customer information and writes them out to a file. If customer does not exist, then write out the information to an error error file.

The basic areas of interest are: 1. 2. 3. 4. 5. 6.

Asynchronous messaging between between NW PI and NW BPM, with correlation. Synchronous messaging between NW PI and NW BPM. Leverage of NW PI as as the ESB mediation and and integration abstraction layer between the stateful NW NW BPM layer and heterogeneous backend applications. Condition evaluation of data data contents to determine next processing step (if-then-else). Mapping and merging of messages. Stateful orchestration of multiple heterogeneous backend systems.

IMPORTANT:

It is extremely important that the Process Orchestration (or NW BPM) release matches that of the NWDS release. If the NWDS release is newer than that of Process Orchestration (or NW BPM), then there will an error during the deployment process from NWDS to the JEE server.

The NWDS can be downloaded from the following link: (Authorization is required for access.) https://nwds.sap.com/swdc/downloads/updates/netweaver/nwds/nw/731/

Differences between ccBPM and NetWeaver BPM ccBPM is based on the BPEL (http://en.wikipedia.org/wiki/BPEL http://en.wikipedia.org/wiki/BPEL)) standard. NetWeaver BPM is based on the BPMN (http://en.wikipedia.org/wiki/BPMN http://en.wikipedia.org/wiki/BPMN)) standard. SAP is a member of the BPMN standard and actively contributes to it in addition to fulfill the commitment to support it internally through its different solutions (including NW BPM and others). Unfortunately these two standards are so different, no automated migrations can be provided. The main radical different can be attributes to BPEL is based on a block structured graph types while BPMN is more flexible and does not follow a block structure flow type. When comparing ccBPM and NW BPM, we see the following:    

 

No need for Abstract Interfaces in NW BPM No need for Operations Mapping in NW BPM All integrations between NW PI and NW BPM will be using the XI-protocol via the SOAP adapter Receiver (or inbound) interfaces from NW PI to NW BPM will have to be defined as XI30-compatible in NW PI NW BPM can interact with single- and/or dual-stack NW PI systems NW BPM will use a standards based graphical notation: BPMN




ccBPM to NetWeaver BPM Below is a ccBPM design for the sample scenario and the equivalent NetWeaver BPM design:

Recommendations during Development Since we are using AEX as we want to leverage the unified solution on the Java Stack, we must use Integrated Configuration; Receiver Determination is no longer available. During the integration development for NW BPM and NW PI, I found the following to be very useful and helped minimize confusion and errors. These practices are most likely already being used by NW PI developers, but they still warrant mentioning again: 

Include service interface properties in the name of the service interfaces: Whether the interface is synchronous or asynchronous o Whether the interface is inbound or outbound o For example: CreatePO_ Async Async _ Out Out The interfaces will have to be imported into NW BPM. Knowing the properties of the interface by just looking at the name will help minimize mistakes and save time.



Include SOAP adapter properties in the name of the SOAP communication channels: Whether the communication channel is a sender or receiver o Whether the communication channel is based on XI30-compatible or SOAP 1.1 protocol o For example: S _SOAP_ XI30 XI30




XI-protocol is used for integration between NW PI and NW BPM. However, SOAP with XI 3.0 protocol cannot be tested using standard tools, e.g. soapUI. Since we want to test all the configurations first in NW PI before we use them in NW BPM, we must also configure standard SOAP communication channels for testing purposes. When we are ready to use them with NW BPM, we can just simply change the Integrated Configuration to use the SOAP communication channel with XI30 protocol. Having this property in the name will help to minimize mistakes and save time, and for us to move between testing and using it in NW BPM. Note: It is important to test test all the Integrated Configurations Configurations first before using them in in NW BPM.

NetWeaver BPM Design and Configuration NetWeaver PI Interfaces The scenario mentioned before will interact with NW PI to send and receive data. The following is a list of all the interfaces that will drive collaboration between NW and NW PI and the direction in which the data will flow from one solution to the other one: 1. 2. 3. 4. 5. 6.

Start Message: NW PI  NW BPM (async) Send PO: NW BPM  NW PI (async) Return PO number: NW PI  NW BPM (async) Get Customer Info: NW BPM  NW PI (sync) Write result: NW BPM  NW PI (async) Write error: NW BPM  NW PI (async)

NetWeaver PI Scenarios (Integrated Configurations) 1.

Start Message:

2.

Send PO Request:

3.

Return PO Number:

4.

Retrieve Customer Information:




5.

Write Result/Error:

Required receiver configuration for NW PI

NW BPM

During the inbound service interface design and receiver adapter configuration, we must use the XI 3.0 protocol:

 

In ESR, Receiver Receiver (inbound) Service Service Interface: Stateless (XI30-Compatible) In ID, SOAP Receiver Communication Channel: Message Protocol: XI 3.0 o Target URL: http://localhost:50000/MessagingSystem/receive/JPR/XI o Authentication: Use logon data to non-SAP system o

Required sender configuration for NW BPM

NW PI

During the sender adapter configuration, we must use the XI 3.0 3.0 protocol: (there is no need to use the XI30Compatible interface)



In ID, SOAP Sender Sender Communication Channel: Message Protocol: XI 3.0 3.0

NetWeaver BPM Design for Outbound Messages from NW PI to NW BPM For our sample scenario, there are two activities where NW BPM will receive messages from NW PI. These 2 icons denote message exchange entities in the BPMN standard. They can be used to receive, send or wait for events from and to other systems. More information can also be found on the BPMN 2.0 standard specification to which NW BPM adheres to. These two entities are described below:




Start Event (soapUI



NW PI



NW BPM)

Event based on Intermediate Message (RFC



NW PI  NW BPM)

The tasks required for these two activities in NW BPM are: (property configuration)   

 

Define Event Trigger: a trigger must be created in NW NW BPM to wait for a specific message from NW PI. Assign service interface and operation for the trigger: assign the interface and operations for the trigger. This defines the interface interface which NW BPM is waiting on. Create local variables based on the data type of the service interface: local variables must be created to hold the data elements when the message interface is received. The local variables are imported into NW BPM. Create output mapping from service interface to local variable: Create the mapping from the received message to the local variable. Create Correlation Condition for Intermediate Message (based on a field in the inbound interface and a local variable): create the correlation to determine which message will will be assigned to which NW BPM process when there are multiple concurrent processes in progress.

NetWeaver BPM Design for Inbound Messages from NW BPM to NW PI For our sample scenario, the following are the activities where NW BPM will send messages to NW PI. These complement the previously introduced icons for exchanging messages before:

Automated Activity (Asynchronous message: NW BPM

Automated Activity (Synchronous message: NW BPM



NW PI  RFC)



NW PI  JDBC)




NW PI  File)




NW PI  File)

The tasks for these activities in NW BPM are: (property configuration)  





Assign service interface and operation for the activity: this defines what interface is to be sent to NW PI Assign XI-protocol and sender component name to Service Reference: Set the protocol to XI, which which is expected by NW PI and also set the sender component name, which is the NW BPM systems. This is to determine which Integrated Configuration in NW PI is to be used, based on sender system, interface name and namespace. Create local variables based on the data type of the service interface (for both request and response): create the local variable which will be used when sending the message (for asynchronous and synchronous interfaces) and receiving the response (for synchronous interface). Create input (request) mapping from local variable to request service: create the mapping between the local variable and the request message type.



NetWeaver BPM for System-to-System Message Orchestration (Including Migration of ccBPM to NW BPM) 

Create output (response) mapping from service interface to local variable: create the mapping between the response message type and the local variable in a synchronous interface.

NetWeaver BPM Design for evaluating conditions (if-then-else) The following is a list of the available branching icons in the BPMN notation knows as gateways. These two will be used in this exercise to define different branching points that an instance in the business process can follow based on context.

Gateway – Gateway – Exclusive Choice

Gateway – Gateway – Exclusive Choice

The only task involved is to create the Condition Evaluation using the GUI tool. The expressions follow the XPath standard to access information in XML documents. In addition, it is possible to leverage other components like BRM to make more complex analysis on the business process instance content and determine the branch in the process to take. The graphical drag and drop XPath expression editor is shown below:




Step-by-Step Procedure The following are the general guideline I followed during the design and configuration of stateful systemcentric messaging and orchestration between NW PI and NW BPM: (Please note, for this document, my definition of a scenario is an end-to-end message going through NW PI between a sender system and and a receiver system. So for this exercise, we have have 5 scenarios.) 1.

2. 3.

4.

From the requirement, design and construct all the NW PI objects in the Enterprise Service Repository (ESR) and the Integration Directory (ID). These include mainly the following: a. Interface design in the ESR. b. Integrated Configuration Configuration creation in ID for each end-to-end scenario. scenario. c. Communication channel configurations. (For the SOAP adapter, configure 2 for each communication channel that integrates with NW BPM. One with SOAP 1.1 protocol and one with XI30 protocol. The SOAP 1.1 protocol is for testing purposes. The XI30 protocol is for runtime with NW BPM.) Document each NW PI scenario as as in section 4.2. This will be extremely helpful during the NW BPM development phase. Test each NW PI scenario, using the communication channel with SOAP 1.1 protocol. We will not not be able to test the “Start Message”, as as it is SOAP-to-SOAP in NW BPM, and NW BPM does not exist yet. For testing, I use soapUI. The “WSNavigator” in the SAP JEE can also also be used. But, soapUI allows me to save my web service and data for testing. soapUI can be freely obtained from http://soapui.org . After successful testing, change the relevant SOAP communication channels channels from using using SOAP 1.1 to XI30. Please note, these are the SOAP SOAP communication channels that connect between NW PI and NW BPM.

After the completion of the above, we are now ready to develop the NW BPM process. For the steps below, we will assume all the NW PI artifacts in the ESR and ID are complete and ready to go. We will focus only on the NW BPM tool. It is extremely important to highlight that this is in line with traditional SOA practices where the appropriate services are exposed for consumption by other composite entities. In our case, this will be NW BPM. This exercise follows this methodology. First, we identify the services that are needed. Then they are provisioned and fulfilled. Lastly, we are ready to create the higher abstraction orchestration layer that can create other value added services on top of these more granular services.

In NW BPM, I normally follow the high-level steps below: 1.

2.

3.

4. 5.

Import all the NW PI-NW BPM interfaces into NW BPM. This is where the diagrams in section 4.2 become extremely useful. By looking at the diagrams we can can see immediately the relevant interfaces. These interfaces will be used by NW BPM to send/receive messages to/from NW PI. Create all the local variables which which will be used to hold the information to integrate between NW BPM and NW PI, including the correlation variable. In this scenario, the correlation will be based on the order number. If there are any other local variables, we should also create them, e.g. we may use a counter in our business process. Design the flow of of the process. In this exercise, the NW BPM artifacts are: a. Start Event: already exist b. Automated Activity: to send message from NW BPM to NW NW PI c. Event based based on intermediate message: to wait for message from NW PI d. Exclusive Choice Gateway: to evaluate the content of of messages to determine next step Configure the properties of each NW BPM artifact. If we need to include additional steps in the business process, e.g. add another scenario, we should still follow the same steps here and edit the NW BPM appropriately.




Step

Description

Screenshot

Start NWDS – Composite Designer 1

For NW BPM, we need to use the Composite Designer. After launching NWDS, open perspective: Windows  Open Perspective  Other…

2

Select Composite Designer Click: OK




3

Create a new product: Menu: File Product

4



New 

Provide a product name: System_Centric_Demo Click: Next




5

Create a new software component to contain all the development artifacts. Click: New Software Component…

6

In the New Software Component dialog Component dialog box, enter a name in upper-case: Enter name: SYSTEM_CENTRIC_SC Click: Finish




7

You are now back on the New Product dialog Product dialog box. Uncheck all the Software Component and select the one we just created: SYSTEM_CENTRIC_SC Click: Next

8

Retain the default settings. Click: Finish




9

On the right-hand side of NWDS, the Composite Designer will open up. In the future, to open up the same window, you can double-click on the product name on the left-hand side: System_centric_Demo

10

11

From the palette on the far right, drag-n-drop the Process icon to the Process area.

In the New Process dialog box: 1. Enter a process name: System_Centric_Process 2. Check: Create a pool with the following name and lanes: 3. Enter a pool name: System_Centric_Pool 4. Enter a lane name: System_Centric_Lane 5. Click: Finish




12

A new process will be created.

13

Double-click on the newly created process. A new process modeler will open up.

Import all the service interfaces between NW BPM and NW PI 14

When we examine the scenarios in section 4.2, we will need to import the following service interfaces:     


StartMsg_Async_In orders_Async_Out po_Async_In GetCustInfo_Sync_Out CustPO_Async_Out



15

In the Composite Explorer, on the left side, expand the nodes as shown. Right-click on Service Interfaces. Select: Import WSDL…

16

In the Import Wizard, Import Wizard, make sure Enterprise Service Repository is Repository is selected. Click: Next




17

Enter valid authorization to access the Enterprise Service Repository. Click: OK

18

Select: StartMsg_Async_In Click: Next




19

The wizard expects to assign a service reference to the imported interface even though it doesn’t make any sense for inbound interfaces. Unfortunately, the wizard cannot distinguish between inbound or outbound interfaces. Select the option: Create new Enter name: dummy1 (We will delete this later.) Click: Finish




20

Import orders_Async_Out , using the same steps as before. Since this is an outbound interface, we will have to provide a service reference. Select the option: Create New Enter name: SG_PO_Request Enter description: SG_PO_Request Click: Finish




21

Import po_Async_In Import po_Async_In,, using the same steps as before. This is another inbound interface, therefore, we will have to provide another bogus name. Select the option: Create new Enter name: dummy2 (We will delete this later.) Click: Finish




22

Import GetCustInfo_Sync_Out , using the same steps as before. Select the option: Create New Enter name: SG_Get_Customer_Info Enter description: SG_Get_Customer_Info Click: Finish




23

Import CustPO_Async_Out , using the same steps as before. Select the option: Create New Enter name: SG_PO_CustInfo Enter description: SG_PO_CustInfo Click: Finish




24

After completing the im ports of the service interfaces, we should have the 5 interfaces displayed.

Create local variable 25

Create orderNumber, which will be used for correlation. Drag-n-drop Data Object to Object to the canvas of the process modeler.




26

Rename the variable to: orderNumber

Information: Click on orderNumber to orderNumber to select it. In the Properties tab below the modeler, select Data Type. Type. The sting data sting data type is the default. This is what we want. However, if we have an integer variable, e.g. counter, we can define it as integer here.

Local variables based on the service interface.

After receiving a message, the content of that message will need to be put into a local variable so that we can use it during the business process, e.g. evaluating the content to determine next steps (if-thenelse) or select the data to send to another system (retrieving or updating information on another system). When sending a message, we will need to populate the outbound interface with contents of local variables. During this process, we we can




also populate the outbound interface from contents of multiple local variables. In our example, we will need the local variables based on the following interfaces: 









StartMsg_Async_In: StartMsg_Async_In : this is the interface which which triggers the business process. It contains the PO create information. From the ESR, the data type is DT_orders. DT_orders. Orders_Async_Out : this contains the the PO create information. From the ESR, the data type is DT_orders. DT_orders. po_Async_In: po_Async_In: this contains the PO number and any messages associated with the PO creation. From the ESR, the data type is DT_po_number . GetCustInfo_Sync_Out : this contains the request and response messages to retrieve customer information from a database. database. We don’t need a local variable for the request message, because we can get that from DT_orders, DT_orders, which contains the customer number. However, we will need the response message containing the retrieved customer information. From the ESR, the data type for the response message is DT_CustResp. DT_CustResp. CustPO_Async_Out : this contains the PO and customer information which we will use to write write out to files. The same interface is used for successful and error information. The content of the outbound interface can come from DT_po_number and DT_CustResp. DT_CustResp . Therefore, we don’t have any need of of any local variables from this interface.

In summary, we will need the following data types as local variable:   


DT_orders DT_po_number DT_CustResp



27

Expand the Composite Explorer as shown. All the data types from the import of the service interfaces are available to us.

28

Drag-n-drop the data type DT_orders to the canvas of the process modeler.




29

Rename the data object to orders. orders.

30

Repeat the steps for DT_po_number . Rename the object to po_number .




31

Repeat the steps again for DT_CustResp. DT_CustResp. Rename the data object to CustResp. CustResp.

Model the Process 32

We can reformat the pool by right-click on the title bar and select Format Pool . The pool is now reformatted with room for us to continue the design. We can select the connector line between Start and Start and End and press the Delete button on the keyboard. We can also drag-n-drop the End toward End toward the bottom of the canvas to give us more room to work.




Configure the Start Event 33

34

Click on the Start event Start event in the process modeler to select it.

In the Property tab Property tab below, click on Event Trigger . We will configure the trigger to start the business process.

35

On the dropdown, select: New…




36

Enter the trigger name: TG_StartMsg Click: Next

37

In the Service dropdown, select: StartMsg_Async_in This is the inbound message to start the business process. The Operations is automatically selected. Click: Finish

38

We will now need to populate the received message to a local variable so we can use it later in the process. We will also need need to populate the local variable, orderNumber, which is used as the correlation id for the process. In Properties, Properties, click: Output




Mapping

39

Select record , under MT_orders in the left side. Drag-n-drop it to record under orders under orders,, on the right side.

40

Set the local variable which is used as the correlation id, orderNumber . Select orderNumber , under MT_orders/record on MT_orders/record on the left side. Drag-n-drop it to orderNumber on orderNumber on the right side.

41

Save the process modeler. Since the process is incomplete, we will see errors flagged.




Create and Configure “Send PO Request” Event 42

Create the next step in the process, which is to send a PO create request. Move the mouse over the Start event. Start event. A context menu will appear, select Activity select Activity and drag-n-drop to a location below the Start event. Start event.

43

A selection menu will pop up. Select: Automated




44

Rename the activity to “Send “ Send PO Request ”. ”. Click on the activity to select it.

45

46

In the Properties tab below, click on Interface. Interface.

In the Service Interface dropdown, select the interface: orders_Async_Out




47

Click on Service Reference. A Service References tab will appear on top.

48

49

In the Type dropdown, select XI . This is the protocol we will use to send the message to NW PI.

For the Sender Component under Custom under Custom Properties, Properties, enter: BPM_Sys This is the sender system name in NW PI for NW BPM. This sender system name is used in the Integrated Configuration in NW PI.

50

Save the Service References and close the tab. You should be back to the process modeler.




51

We will now need to map the request message with the right data. In Properties tab, select: Input Mapping

52

The local variable, orders, orders, contains the data we need for the request. So, we will need to map orders to the Message Type, MT_orders of the request interface. Select record , under orders under orders,, on the left side. Drag-n-drop it to record under MT_orders under MT_orders on the right side.

Create and Configure Configure “Wait for PO Response” Event 53

Create next step in the process, which is to wait for the PO create response. Since this is asynchronous, we will also need to include the correlation condition. Select “Send “Send PO Request ” ” event, a context menu will appear. Select: Event




54

Select: Intermediate Message

W

55

56

Rename the event to “Wait “ Wait for PO Response”. Response”.

We need to define the event trigger on what type message it is waiting for. In Properties, Properties, click: Event Trigger




57

Create a new trigger. In the Trigger dropdown, Trigger dropdown, select: New…

58

In the New Message Trigger dialog box, enter name: TG_PO_Response Click: Next

59

In the Service dropdown, select: po_Async_In Click: Finish This is the inbound interface from NW PI to NW BPM.




60

Send the response information to a local variable. Select: Output Mapping Drag-n-drop MT_po on the left side to po_number to po_number on on the right side.

61

Set the correlation condition so that the response will be sent to the right process when there are many concurrent processes running. Select: Correlation Condition Delete the true, in the definition box. We will define our own condition.

62

On the right side, under “Rules and Functions” Functions ” String , look for string-equal for string-equal and double-click on it. It should appear on the definition workspace box to the left.




63

The correlation will compare the orderNumber that is used to start the process and the order_number in the PO response message. If the condition is true, then the process will be used. After the “string-equal “string-equal ”, ”, enter a “( “( “. “. On the right side, under Context  L M Local ocal  MT_po, T_po, double-click on order_number . (this is the PO response message sent to NW PI) Enter a Enter a “,” after it.

64

Under Context Under Context  G Global lobal , double-click on orderNumber . It should appear on the left side in definition box. Enter “ )” )” to complete condition expression.

Create and Configure Gateway to Check for PO Error 65

The next step is to create conditional check on whether the PO response is valid. An invalid response will have “ERROR” as the PO number. Select “Wait “Wait for PO Response”. From the context menu, select: Gateway




66

67

68

Select: Exclusive Choice

Rename it to: “PO Error?” Error?”

Before we can specify the conditions, we have to have the activities defined. Create 2 Automated Activities: Select the “PO Error?” Gateway. In the context menu, select: Activities




69

70

Select: Automated

Rename it to: Write Error File Drag it to the right side of the Gateway. Change the “ Alternative Alternative 1” 1” lable to “Yes “Yes”. ”.

71

Repeat the step to create another automated activity. Rename it to: Get Cust Info Drag it to the left side of the Gateway. Change the “ Alternative Alternative 2 ” label to “No “No”. ”. Information: Information: We can have as many of this as we want. And, we can provide a condition to each one.




72

Let’s evaluate the condition for the path to take. Select the Gateway “PO “ PO Error?”. Error?”. In the properties tab below, select: Condition Evaluation With the “Yes” role selected, click: Edit…

73

74

Similar to steps 62-64, define the Condition Expression.

Check the “Default “Default ”, ”, in the “Default Gate” Gate” column, for the “No “No”” role

Configure “Write PO Error File” Activity 75

Select the activity: “Write Error File” File” In the Properties tab, select: Interface. For the Service Interface dropdown, select: CustPO_Async_Out Click: Service Reference




76

Follow similar steps 47-50, in the Service Reference Properties tab: In the Type dropdown, select: XI For the Sender Component , enter: BPM_Sys Save and close the Service References. References.

77

78

For input mapping, assign to fields as shown. Since we have not retrieved the customer info, there is fields to be assigned from it.

We can now connect the “Write Error File” File” activity to the End event. End event. Select: Write Error File In the context menu, select the Connections icon, and drag it to the End event. End event.




Configure “Get Customer Info” Activity 79

Follow similar steps from the one above, select the “Get “ Get Cust Info” Info” activity. In the Properties tab, click: Interface In the Service Interface dropdown, select: GetCustInfo_Sync_Out Click: Service Reference

80

Similar to steps 47-50, in the Properties tab of Service of Service References: References: For the Type dropdown, select: XI For the Sender Component, enter: BPM_Sys Save and close Service References. References.




81

We need to map the request message to retrieve the customer info. For the Input Mapping , map custNo to cust_number as cust_number as shown.

82

We also need to map the response message containing the customer info. For the Output Mapping , map MT_CustResp to CustResp as shown.

Create and Configure Gateway to Check for Customer Info Error 83

The next step is to create conditional check on whether the Customer Info response is valid. An invalid response will have “ERROR” as the customer number. Select “Get “Get Cust Info”. From the context menu, select: Gateway




84

From the context menu, select: Exclusive Choice

85

Rename it to: ”CustInfo Error?” Error?”




86

Follow similar steps 68-74, create 2 automated activities to write the error file and to write a good file, and configure the Gateway condition evaluation. We should end up with a completed process.




Configure the “Write CustInfo Error File” Activity 87

We need to configure the properties for “Write “Write CustInfo Error File”. File”. Select: for “Write CustInfo Error File” File”

88

For Service Interface, select: CustPO_Async_Out There is no need the configure Service Reference, since it has been done in a previous step (Write (Write PO Error File), File), which used the same Service Interface.

89

Provide the input mapping. In this mapping, the input or source came from multiple data variables. This is the equivalent of NW PI’s PI’s multimultimapping used in ccBPM.




Configure the “Write PO CustInfo File” Activity 90

We need to configure the properties for “Write “Write PO CustInfo File”. File”. Select: for “Write PO CustInfo File” File”

91

92

For Service Interface, select: CustPO_Async_Out

Provide the input mapping. This mapping is the same as the one above.




Delete the Previously Created “dummy” Service Groups 93

For the inbound interfaces, we create a couple of dummy Service Groups, dummy1 and dummy2. We need to delete them. Navigate in the Composite Explore to the Service Group as indicated.

94

Right-click on: dummy1 Select: Delete Repeat for dummy2 for dummy2 .




95

95

The result should as shown.

Save the product.

The NW BPM process is now complete. As you notice on the title bar, there is a warning, which informs us that an administrator needs to be assigned to the pool. There is no need to do so, since this is a system-centric process, with no userinteractions.




Deploy the NW BPM Process 93

Right-click on the product “System_Centric_Demo System_Centric_Demo”” Select: Deploy

94

Click: Build and Deploy When CAF Project Generation is complete, click: OK

95

Wait until the deployment is complete, which you can see in the Infrastructure Console. Console.




Running the Scenario When running the test, we can see the messages going through NW PI.

The start message from soapUI contain the order information.

With a successful message, we have the result with the PO number and customer information.




When we provide an invalid vendor id, then we get an error message.

With an invalid customer id, we get a different error message. The PO number was return, but the customer number has an error.

Additional Information For this article, the NW PI designs and configurations in the ESR and ID are assumed and done beforehand. Only the NW BPM development steps are detailed. For FYI purposes, without going into the step-by-step procedures, the ESR and ID artifacts used in this article is listed below. Enterprise Service Repository Content Each Scenario is contained in its own folder, along with the RFCs used:.




Folder: CreatePO Sends an asynchronous order message to an RFC to create a PO on the ERP system.

Interface details




Folder: GetCustInfo Sends a synchronous message with customer number to retrieve customer information from a SQL table using the JDBC adapter.

Interface details










Folder: GetPONumber Receive an asynchronous message containing the PO number from ERP after PO creation.




Interface details Please note the Interface Pattern is XI30-Compatible. This is required for using the XI30 proxy protocol with NW BPM.

Folder: StartMsg The is the asynchronous message containing order information sent from soapUI to NW BPM to initiate the process.




Interface details Please note the inbound asynchronous message’s Interface Pattern is XI30Compatible. Both inbound and outbound interfaces use the same Message Type.




Folder: WriteResult Used to write both successful and error messages.




Interface details Both inbound and outbound interfaces use the same Message Type.




Integration Directory Content The Integration Directory configurations were done with Integrated Configuration. This is because because the NW PI system is a Java-only installation. NW BPM will work just as well with with a dual-stack installation. The same configurations in NW BPM can be used. The only requirement is the XI30 protocol for the SOAP communication channel.




Integration Directory content consists of the configuration for 5 integration scenarios, which are outlined in section 4.2.

For the adapters, I will display only the relevant SOAP communication channels for NW BPM. Please note that they are all using




Integrated Configuration: StartMsg




Integrated Configuration: Send PO request to ERP




Integrated Configuration: Retrieve customer information from database




Integrated Configuration: ERP sends PO number and status to NW BPM.




Integrated Configuration: Send customer information and PO number to file (this is used for both successful and failed messages)







Copyright © Copyright 2012 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered registered trademarks of Adobe Systems Systems Incorporated in the United States and/or other countries. Oracle is a registered trademark of Oracle Corporation. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc. HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World W ide Web Consortium, Massachusetts Institute of Technology. Java is a registered trademark of Sun Microsystems, Microsystems, Inc. JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects S.A. in the United States and in other countries. Business Objects is an SAP company. All other product and service names names mentioned are the trademarks trademarks of their respective respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying accompanying such products and services, if any. Nothin g herein should be construed as constituting an additional warranty.



ccBPM to BPM en 7.3

Recommend Documents