Step by Step SAP NW BPM Scenario

Download as pdf or txt
Download as pdf or txt
You are on page 1of 94

WWW.INTEGRATIONSRINI.

COM
Contents
Install Java: ................................................................................................................................... 4
NWDS Installation File: ................................................................................................................. 5
ECLIPSE INI: ................................................................................................................................ 5
Default Workspace:....................................................................................................................... 7
ECLIPSE / NWDS Version Check: ............................................................................................. 10
Configure JDK in NWDS: ............................................................................................................ 12
Configure SAP Java Server in NWDS: ....................................................................................... 14
Configure Enterprise Service Browser in NWDS: ....................................................................... 17
SIMPLE FILE TO FILE INTERFACE USING BPM ..................................................................... 19
Change Perspective: ................................................................................................................... 26
Import Service Interface:...................................................................................................... 36
Undeploy BPM from NWDS ........................................................................................................ 79
Understanding BPM Message Flow: ........................................................................................... 87
How the message send out? ............................................................................................... 91

WWW.INTEGRATIONSRINI.COM
SAP PO Courses:

COURSE NAME COURSE LINK


Beginner: Complete Basics of https://techiediploma.link/po-course-nw-
book
SAP PO (Process
Orchestration)
SAP PI / SAP PO: Interface
Development with Standard
Adapter
SAP EDI : SAP PO Interface
Development with AS2 B2B
ADDON
Complete SAP PO REST
Adapter Configuration with API
Basics
SAP PO: Java Mapping
Training with 10 Programs
SAP PO: Custom Adapter
Module Training with 8
Programs
Basics in Cloud Computing
with SAP Cloud Platform
Learn SAP PO REST, JSON and
API Basics

WWW.INTEGRATIONSRINI.COM
STEP BY STEP SAP NW BPM
SCENARIO
This guide will help to walk thru the steps required to setup the local machine with the required
software and create a simple end to end FTP scenario using SAP NW BPM.

Install Java:
It is recommended to install 1.8 JDK to work with SAP NW BPM. Below is the link of JAVA SDK
1.8 u111 - windows 64 bit installation file.

Download Jdk-8u111-windows-x64.exe:
https://www.oracle.com/java/technologies/javase-jdk8-downloads.html

Verify:

After installation verify the java version in the command prompt:

> java -version

WWW.INTEGRATIONSRINI.COM
NWDS Installation File:
Next we need to install the NWDS software to create Java mapping, Adapter modules and SAP
NW BPM, iFlows.

You can download the right version of SAP NWDS from here:

SP05 Patch 3 for NW DEVELOPER STUDIO 7.50


https://www.integrationsrini.com/sap-po/nwds/download-nwds-and-setup-guide/

In future when SAP PO is upgraded to new patch or if SAP recommends to use another NWDS then
make you we uninstall this NWDS and align with the new NWDS patch.

Note that older version of NWDS might have BPM deployment issues in incompatible with the SAP PO
patches.

ECLIPSE INI:
You will find the eclipse.ini file in the eclipse installation folder.

Rename the eclipse.ini file to eclipse.old.ini and then copy the updated eclipse.ini file.

WWW.INTEGRATIONSRINI.COM
eclipse.old.ini file is for reference and will not be used for eclipse tool. Only the eclipse.ini file will
be used during the startup of the application.

Eclipse.ini:

-startup
plugins/org.eclipse.equinox.launcher_1.3.100.v20150511-1540.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.300.v20150602-1417
-product
org.eclipse.epp.package.jee.product
--launcher.defaultAction
openFile
--launcher.XXMaxPermSize
256M
-vm
C:/Program Files/Java/jdk1.8.0_111/bin/javaw.exe
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
--launcher.defaultAction
openFile
--launcher.appendVmargs
-startup

WWW.INTEGRATIONSRINI.COM
C:\IT_CodeRepo\ProgramFiles\NWDS\eclipse\plugins\org.eclipse.equinox.launcher_1.3.1
00.v20150511-1540.jar
--launcher.library
C:\IT_CodeRepo\ProgramFiles\NWDS\eclipse\plugins\org.eclipse.equinox.launcher.win32
.win32.x86_64_1.1.300.v20150602-1417
-vmargs
-Dosgi.requiredJavaVersion=1.7
-Xms256m
-Xmx1024m

Download the file from here:


https://www.integrationsrini.com/sap-po/nwds/download-nwds-and-setup-guide/

Default Workspace:
When you open the eclipse it will ask for the workspace to create. You can free to choose any
location it is not mandatory to select any specific location.

But my preference is to store it right above the eclipse folder so that when i have different
version of eclipse all my workspace are under it. Easy for me to reference in future.

C:\IT_CodeRepo\ProgramFiles\NWDS

Workspace path: C:\IT_CodeRepo\ProgramFiles\NWDS\workspace


Eclipse Path: C:\IT_CodeRepo\ProgramFiles\NWDS\eclipse\eclipse.exe

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Eclipse Path:

WWW.INTEGRATIONSRINI.COM
ECLIPSE / NWDS Version Check:
Kindly check you have installed the right Eclipse / NWDS version to make sure no deployment /
development issues in future.

Help -> About Eclipse

Eclipse Java EE IDE for Web Developers.

Version: Mars.1 Release (4.5.1)

WWW.INTEGRATIONSRINI.COM
Build id: 20150924-1200

WWW.INTEGRATIONSRINI.COM
Configure JDK in NWDS:
You need to map the JDK 1.8 with the NWDS to make sure all the development compilation is
happening with the required Java SDK.

Go to:
Java -> Installed JREs

Click on Add Button to add the JDK.

WWW.INTEGRATIONSRINI.COM
Java Home Path: C:\Program Files\Java\jdk1.8.0_111

Make sure you give the JDK path not the JRE path.

Click Directory to locate the path or just copy and paste the Java JDK path. After you paste it
will load up all the libraries required work with JDK.

Make sure the JDK is selected and default in bold.

WWW.INTEGRATIONSRINI.COM
Configure SAP Java Server in NWDS:
After you have set the default JDK from your computer in NWDS then we need to add SAP AS
Java server details with the host and port number.

WWW.INTEGRATIONSRINI.COM
Again open the preferences:

Open the SAP AS Java and Click on “Add” button.

Host Name: chqmdd01.ca-tor.celestica.com

WWW.INTEGRATIONSRINI.COM
Instance Number: 74

Make sure the checkbox Automatically detect local System at startup is selected.

WWW.INTEGRATIONSRINI.COM
Configure Enterprise Service Browser in NWDS:
This configuration will help us to connect to XSB and import the components like interfaces,
operation mapping from any PO system. So it is important to point to the right system to make
sure we pull the data from right system.

Open Preferences:

ESR System: XSB


ESR Host: chqmdd01.ca-tor.celestica.com
ESR Http Port: 57400

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
SIMPLE FILE TO FILE INTERFACE USING BPM
Let’s build a simple File to File Interface using the following components of SAP PO:

● ICO Configurations
● SAP NW BPM using the NWDS Editor
● Raise Exception in BPM
● Send Notification from BPM
● Deploy & UnDeploy BPM from NWDS Editor
● Monitoring of Process & Messages
● Import Interfaces, Mappings in BPM
● Download Payload
● Message Log

WWW.INTEGRATIONSRINI.COM
Interface Flow:
● Pick file from a FTP Location using the FTP Sender channel.
● Send File to BPM using the SOAP Receiver Channel.
● No Mapping or transformation in the ICO scenario.
● Once the message is received in BPM it is transformed using the operation mapping.
● If the message is failed then email notification is send and then BPM is cancelled.
● If the message is passed then the transformed message is sent to ICO.
● ICO Scenario has the BPM SOAP Sender to receive the message.
● Once the message is inside the ICO then the message is sent to FTP receiver to place it
on the FTP location.

WWW.INTEGRATIONSRINI.COM
ESR Objects Location:

WWW.INTEGRATIONSRINI.COM
ID Object’s Location:

WWW.INTEGRATIONSRINI.COM
First Flow:

FTP SENDER -> BPM SOAP RECEIVER

ICO:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Second Flow:

SAP NW BPM

Steps to create the BPM:

Launch NWDS and select the workspace where you wish to save the components.

Change Perspective:
You need to change the perspective of the editor to see the BPM related components and
options.

Goto Windows -> Perspective -> Open Perspective -> Other

WWW.INTEGRATIONSRINI.COM
Select Process Development Option:

WWW.INTEGRATIONSRINI.COM
You should able to see the Process Development View as below image:

WWW.INTEGRATIONSRINI.COM
Create New Project:

WWW.INTEGRATIONSRINI.COM
Select Process Composer Development Component:

WWW.INTEGRATIONSRINI.COM
Select the default option:

WWW.INTEGRATIONSRINI.COM
Remember the Process Component name should be less than 9 characters as per SAP
recommendation.

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Click Finish and then Process Component will be created.

WWW.INTEGRATIONSRINI.COM
IF YOU DON’T SEE THIS VIEW THEN CHECK THE PERSPECTIVE. IT
SHOULD BE “PROCESS DEVELOPMENT”.

WWW.INTEGRATIONSRINI.COM
Import Service Interface:

WWW.INTEGRATIONSRINI.COM
Connect to ESR:

If you unable to see the connection with ESR then check the Enterprise Service Browser
connection we discussed above.

WWW.INTEGRATIONSRINI.COM
Select the Sender Interface to Import:

WWW.INTEGRATIONSRINI.COM
Give name to the package and make sure your current project is selected.

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
After the Import is completed make sure the interface is imported correctly with the following
settings.

WWW.INTEGRATIONSRINI.COM
Import Receiver Interface:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Select the Receiver Interface and Press Next

Enter New name for the package and select the correct project by default.

WWW.INTEGRATIONSRINI.COM
You should both the Interface Sender and Receiver imported into the Component.

WWW.INTEGRATIONSRINI.COM
Import Operation Mapping:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
You should see all the components, WSDL are properly imported.

WWW.INTEGRATIONSRINI.COM
Also look at the Problems console tab to see any issues.

WWW.INTEGRATIONSRINI.COM
Create New Start Message:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Develop Process:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Select the startMsg that was created earlier as the start of the message to this BPM

Click finish to create the process. You should now see this. Remember the perspective if you
are in the right view.

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Click on Start and then Click on Automated.

Delete the connection from Start to End and then Click on the new Automated Object.

WWW.INTEGRATIONSRINI.COM
Select the Mapping then click on new

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Creating Send Receiver Interface:

WWW.INTEGRATIONSRINI.COM
Click on Service Reference:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Change the WS to XI and add the Business Component of the ICO Configuration. This is like
telling BPM after you get message send to this Sender.

WWW.INTEGRATIONSRINI.COM
This is the final view of the BPM:

WWW.INTEGRATIONSRINI.COM
DEPLOY BPM:

Right Click on the project and then select the Development Component and Select Build.

WWW.INTEGRATIONSRINI.COM
Right side corner you will see the Build Status.

Switch the console view to Deployment view:

WWW.INTEGRATIONSRINI.COM
After the Build is completed then select the Deploy option as below:

WWW.INTEGRATIONSRINI.COM
Wait for the deployment to be completed:

All the deployment issues will be shown in the deployment console logs.

WWW.INTEGRATIONSRINI.COM
Execute the Scenario End to End:

WWW.INTEGRATIONSRINI.COM
PIMON: http://chqmdd01.ca-tor.celestica.com:57400/pimon

WWW.INTEGRATIONSRINI.COM
Final Flow:

BPM SOAP SENDER -> FTP RECEIVER

ICO:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
FINAL STATE:

WWW.INTEGRATIONSRINI.COM
Undeploy BPM from NWDS
If you wish to undeploy BPM from PO system then you can use NWDS to undeploy BPM and
recreate with the same name.

Remember after undeploy it might difficult to rollback the BPM, so be careful to use this option.

Also when you deploy BPM you get different versions of the BPM which you can switch back
and forth in NWA. Will show this option in next section.

Lets undeploy the BPM we have created.

Select Deployment from the list and press okay:

WWW.INTEGRATIONSRINI.COM
Observe the things that are highlighted. You should be in the deployment view and also you
should see the System on the left hand side.

WWW.INTEGRATIONSRINI.COM
Now Click on the arrow on XSB and this will load all the components in the systems.

This will take some time to load all the components in PO system.

After some time this should load all the components and then locate our BPM demo_bpm.

WWW.INTEGRATIONSRINI.COM
Add the component to undeployment list:

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Once the component is added then click on “Start” to delete the component.

Click ok to start…

This should start undeploying the BPM.

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
Understanding BPM Message Flow:
This is a small section where I want to focus on how the messages flow inside the BPM. Why do
we need to create Data Objects and why it need to be mapped every time to the activities?

You will find yourself doing this small mapping every time in BPM? Why?

Data Objects are temporary variables that holds the data during the each step processing in
BPM. When your process steps moves from one activity to another we save the data inside this
data objects then refer back to in each activity.

It is like holding data in variable and then assign it back to that activity.

tempVariable = <Input Stream of Data>;


activityVariable = tempVaraible;
<Activity Completed and converted activityVariable to newActivityVariable>
NewtempVariable = NewactivityVariable;

Let’s do it step by step:

WWW.INTEGRATIONSRINI.COM
Now Start Step copies the data to Container Variable which can be used else where.

WWW.INTEGRATIONSRINI.COM
Pass the Container variable to Activity Input Mapping.

Assign the Activity output variable back to the container, so that we use this data to send
outside of BPM using the send step.

WWW.INTEGRATIONSRINI.COM
Send message outside from BPM:

WWW.INTEGRATIONSRINI.COM
How the message send out?
In the Send step, we refer to this SI_AA_RECEIVER_INTERFACE which has this service
references.

Here we point our service interface to the Type = XI and then points to the Party and Business
component.

So when the message is sent to XI it will look for ICO which has the same sender party and
component in sender.

WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM
WWW.INTEGRATIONSRINI.COM

You might also like