MDM Web Services

SAP NetWeaver Master Data
Management 7.1
Web Service Enhancements
Applies to:
SAP NetWeaver Master Data Management 7.1,
Enhancement Package 1 for SAP NetWeaver Composition Environment 7.1
For more information, visit the Master Data Management homepage.
Summary
This tutorial shows you how to create a Web service provider that reads data from an MDM product
repository. The service provider will be generated with the new MDM Web Services Generator.
Furthermore you will learn how to consume this service in a Visual Composer user interface (Enhancement
Package 1 for SAP NetWeaver CE 7.1).
Author:
Matthias Kretschmer
Company: SAP AG
Created on: 25 January 2009
Author Bio
Matthias Kretschmer joined SAP in September 2001 as a BA Student (Information
Technology). During his studies Matthias had the opportunity to gain an insight into several
departments within SAP, e.g. Mobile Infrastructure, Technology Consulting and MaxDB.
Matthias successfully completed his studies in September 2004. From 01.10.2004 until
31.07.2006 Matthias worked in the SAP NetWeaver ESI F XPI department (XI Runtime,
Monitoring) as a software developer (Java, ABAP). Until November 2008 he worked as a
product specialist for the SAP NetWeaver Demo Team within SAP NetWeaver Product
Management. Here he was mainly responsible for Composition and Process Integration
topics. At the moment Matthias works as a solution manager for SAP NetWeaver Master
Data Management.
SAP DEVELOPER NETWORK | sdn.sap.com

2008 SAP AG
BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

1
SAP NetWeaver Master Data Management 7.1 Web Service Enhancements
Table of Contents
Introduction .........................................................................................................................................................3
MDM Web Service Generator Definition......................................................................................................3
Web Service Generator Deployment ...........................................................................................................3
Visual Composer Definition..........................................................................................................................3
Visual Composer Use Cases .......................................................................................................................3
Tutorial Structure ................................................................................................................................................4
Summary.........................................................................................................................................................4
Loading and Checking the MDM Repository ..................................................................................................4
Generating and Deploying the Web Service Provider ....................................................................................4
Testing the Web Service in Web Services Navigator .....................................................................................4
Service Consumption in a Visual Composer User Interface (EHP1 for SAP NW CE 7.1) .............................4
Prerequisite: Loading and Checking the MDM Repository.................................................................................5
Generating and Deploying the Web Service Provider........................................................................................8
Testing the Web Service in Web Services Navigator.......................................................................................15
Service Consumption in a Visual Composer User Interface (EHP1 for SAP NW CE 7.1)..............................19
Copyright...........................................................................................................................................................37

2009 SAP AG

2
Introduction
MDM Web Service Generator Definition
The Web services Generator is a tool that generates MDM schema specific Web services to Create, Read,
Update, and Delete (CRUD) records.
At design time, the user can define tables, fields and security settings. The generated Web services are
deployed on a Java Application Server.
The Web services Generator has the following benefits:
Simple to use
No development skills are needed
Generates Web services that:
y Are more business oriented due to semantic data descriptions which makes it easier to develop
application programs and to maintain the consistency of data when it is updated
y Ensure development of a Web service (WS) client is easy
y Can be used by BPM tools such as Guided Procedures, NW BPM (Galaxy) and so on
Web Service Generator Deployment
Here you find more information about how to install and deploy the MDM Web service Generator:
http://help.sap.com/saphelp_nwmdm71/helpdata/en/49/06eac7dc78132ee10000000a421937/frameset.htm
Visual Composer Definition
The Visual Composer is a Web-based visual modeling development environment that enables business
process experts and developers to quickly create and adapt model-based transactional and analytical
applications, without coding. Visual Composer minimizes the effort and time required to create an
application, resulting in faster go-live decision making.
Here you find more information about the Visual Composer:
http://help.sap.com/saphelp_nwce10/helpdata/en/73/c3b80ef576461db7da38e637be694a/frameset.htm
https://www.sdn.sap.com/irj/sdn/nw-development?rid=/webcontent/uuid/00d8109f-9a49-2a10-eba3dbb93e43a5c0
Visual Composer Use Cases
The Visual Composer is generally available as part of SAP NetWeaver Composition Environment.
Typical Visual Composer Use Cases are:
Creation of composite views, which can be used as standalone applications or as part of larger composite
applications
Simulation and prototyping of applications
Creation of portal content (model, deploy and maintain worksets, roles, pages and iViews)
Voice applications
BI planning (BI-IP) applications
Dashboards
Here you find more information about the current application development lifecycle and how you can improve
it by prototyping the application without writing a single line of code.
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/b075f4e9-855a-2a10-4e86-a8e099b39442
https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/docs/library/uuid/506b057f-e4e2-2a10-48b2-d9b39afa9c6a

2009 SAP AG

3
Tutorial Structure
Summary
This tutorial shows you how to create a Web service provider that reads data from a MDM product
repository. The service provider will be generated with the new MDM Web services Generator.
Furthermore you will learn how to consume this service in a Visual Composer user interface (Enhancement
Package 1 for SAP NetWeaver CE 7.1).
Loading and Checking the MDM Repository
In this task you will load and check the corresponding MDM repository which is the basis for the Web service
provider. The MDM repository can be found here.
Generating and Deploying the Web Service Provider
In this task you will generate the Web service provider with the MDM Web services Generator and deploy it.
Testing the Web Service in Web Services Navigator
In this task you will test the new Web service in Web services Navigator.
Service Consumption in a Visual Composer User Interface (EHP1 for SAP NW CE 7.1)
In this task you will learn how to consume the MDM Web service in a Visual Composer user interface.

2009 SAP AG

4
Prerequisite: Loading and Checking the MDM Repository

In this task you will load and check the corresponding MDM repository which is the basis for the Web service
provider. The MDM repository can be found here.
1) Logon to the MDM server
by using remote desktop
connection.
2) Open the SAP MDM

Console.
3) Mount the MDM server.

Right click on SAP MDM
Servers to open the
context menu. Choose
Mount MDM Server. In the
pop-up window that
appears select localhost
and click on OK.

2009 SAP AG

5
4) Connect to the Product

repository. Right click on
Product and choose
Connect to Repository. In
the pop-up window that
appears enter Admin as
user and click on OK.
5) Load the Product

repository. Right click on
Product and choose Load
Repository -> Immediate.

2009 SAP AG

6
6) After the repository was

loaded (indicated by the
green arrow) you should
have a look at the
structure/fields of the
Products main table.
7) Now it is time to analyze

the records. To do so open
the SAP MDM Data
Manager.
8) On the logon screen

choose or enter the
following values:
Repository = Product
Language = English [US]
User = Admin
Then click on OK.
9) In the SAP MDM Data

Manager select the record
which has the MDM
Product ID 3 and check its
values.
Now all work is done on the
MDM server.
The next steps take place
in the MDM Web services
Generator where your
service is to be generated.

2009 SAP AG

7
Generating and Deploying the Web Service Provider

In this task you will generate the Web service provider with the MDM Web services Generator and deploy it.
1) Enter the URL
http://<host>:<port>/web
dynpro/dispatcher/sap.co
m/tc~mdm~ws~generator
~ui/WSGenerator in your
browser to launch the MDM
Web services Generator.
2) On the initial screen of the

MDM Web services
Generator you can
maintain your projects. The
first step for generating
Web services is
to create such a new
project by pressing the
New button.

2009 SAP AG

8
3) Enter the name of the

project MDMProductWS
Press Enter.
4) Choose your project and

click on Edit.

2009 SAP AG

9
5) The MDM Web services

Generator is a wizard
based tool. In the first step
enter as MDM Server
name the value you have
used in TASK 1 step 1.
Press Log on. (Hint:
Please leave the password
field empty.)

2009 SAP AG

10
6) After the Generator has

established a connection to
the MDM Server select as
Repository name Product
and as User name Admin.
Click Next.
7) In the next wizard step all

data tables that can be
accessed by Web services
are listed. As we want to
read product data, select
the MDM_PRODUCTS
table and choose the
service operation Retrieve.
Click Next.

2009 SAP AG

11
8) In the Configure Fields

step the user selects for
each table the fields that
should be exposed in the
Web service.
At first click on the None
button to remove all
selected fields.
9) Now select from the

Available Fields table the
following fields:
MDM_MDM_PRODUCT_I
D
PRODUCT_CODE
MDM_PRODUCT_NUMBE
R
MDM_DESCRIPTION
MDM_CLASS_HIERARCH
Y
Click on the Add button.
10) Click Next.

2009 SAP AG

12
11) In the Generate step enter

the name of the Web
service QueryProduct_In.
Press Save.
12) To generate the Web

service click on the
Generate button. After the
success message is
displayed click Next.

2009 SAP AG

13
13) In the Deploy step you

have to specify the
following deployment
parameters:
Host = <host>
Port = <port>
User = Administrator
Password = training
Click Save and then
Deploy.
After the success message
is displayed click Log Off.
!!!Attention: If the
deployment fails please
retry until you get the
success message.
14) Choose Yes.

2009 SAP AG

14
Testing the Web Service in Web Services Navigator

In this task you will test the new Web service in Web services Navigator.
1) Enter the URL http://
<host>:<port>
in your browser to launch
the start page of the
Application Server Java.
Then click on Web
services Navigator and
enter the user name and
password.

2009 SAP AG

15
2) Select your Web service

QueryProduct_In from the
list.
3) In this screen click on the

WSDL URL link to view
the WSDL document.
4) From the pop-up window

copy the WSDL URL. Later
on it is needed for creating
a logical destination.
Close the window.

2009 SAP AG

16
5) Click on the Test link.
6) Select the
retrieveMDM_PRODUCTS
operation.

2009 SAP AG

17
7) Now you have to specify

the parameters for the Web
service as follows:
internalID = SKIP
keyMapping = SKIP
displayFields = not
skipped
mDM_MDM_PRODUCT_I
D=3
resultDefinition = SKIP
dataLang = English [US]
repositoryName =
Product
serverName = was
provided in TASK 1 step 1
to you
Then click on the Send
button.
8) Now your screen should
look like the screenshot to
the right. The Web service
was executed successfully
and shows the result.

2009 SAP AG

18
Service Consumption in a Visual Composer User Interface

(EHP1 for SAP NW CE 7.1)
In this task you will learn how to consume the MDM Web service in a Visual Composer user interface.
1) Before you start with the
VC you have to create a
logical destination for the
MDM Web service.
Launch the SAP
NetWeaver Administrator
(NWA) by entering the URL
http://<host>:<port>/nwa
in your browser.
2) In the NWA go to SOA

Management -> Technical
Configuration ->
Destination Template
Management.

2009 SAP AG

19
3) Create a new destination

by clicking on the New
button.
4) On the next screen specify

the parameters for the
destination as follows:
Destination Type = WSDL
Destination Name =
QueryProduct_In_Dest
URL = here you have to
enter the WSDL URL
copied in TASK 3 step 4
Click Next.

2009 SAP AG

20
5) In the Security step click

on the Next button.
6) Click Finish.

2009 SAP AG

21
7) Have a look at the list and

check that the destination
was created.
8) Now launch the SAP

NetWeaver Visual
Composer (VC) by
entering the URL
http://<host>:<port>/VC in
your browser.

2009 SAP AG

22
9) At first a VC model needs

to be created. To do so
click on Model and select
New.
10) In the Create New Model

dialog box choose the
Composite View model
type.
In the Name field enter the
name MDMProducts for
the model.
Click on the New button to
create a development
component to store the
model. Name it mdm_ws
Click OK.

2009 SAP AG

23
11) Add the MDM Web service

to your model by first
clicking on the Search
button in the task panel
toolbar.
In the Search in dropdown
list, choose the
QueryProduct_In_Dest
(Web service) as the
source of the data.
In the Search for field,
enter * to get all the Web
service operations.
In the Type field, make
sure that WSDL is
selected.
Click Search. The search
results appear.
Finally drag the service
operation onto the Design
board.
12) Now the service input fields

need to be defined. To do
so select/check the criteria
node from In Ports.
13) Select the node query from

In Ports and deselect all
its fields.

2009 SAP AG

24
14) Select/Check the

reposInfo node from In
Ports.
15) To define the service

output fields select/check
the
Response node from Out
Ports.
Click OK.
16) Now add an input form to

the service. Drag out from
the query input port, and
select Form View from the
context menu.

2009 SAP AG

25
17) Close the Define Data popup window.
18) Drag out from the output

port of the form, and select
Table View from the
context menu.

2009 SAP AG

26
19) In the Define Data dialog

box select the criteria
node and click Close.
20) Connect the output port of

the form with the reposInfo
input port of the service.
21) Right click on the newly

created connection and
select Configure from the
context menu.
In the Configure panel
select the Event name
submit.

2009 SAP AG

27
22) Right click on the

connection again and
select Map Data from the
context menu.
In the Map Data dialog box
select the connection and
assign the following values
to the following fields:
dataLang = English [US]
repositoryName =
Product
serverName = was
provided in TASK 1 step 1
to you
Then click on the Close
button.
23) To add an output form for

the service drag out from
the output port of the
service and select Form
View from the context
menu.
Close the Define Data
window.

2009 SAP AG

28
24) Drag out from the output

port of the form, and select
Table View from the
context menu.
25) In the Define Data pop-up

window select the node
mDM_PRODUCTS.
Click Close.
26) Now we want to arrange

the model layout.
Click on the Layout button
at the bottom of the Design
board.

2009 SAP AG

29
27) At first change the

position/sequence of the
forms. Drag the criteria
form/table onto the s1
(Submit button) form.
28) Select/Mark the s1 from.

In the Configure Form
View deselect the Show
title property.
29) Decrease the height of the

s1 form.

2009 SAP AG

30
30) Select the criteria table on

the Layout board and click
the Configure button in the
task panel toolbar. If
necessary select the Show
toolbar checkbox and
choose to display the
toolbar at the top of the
table. To add a button to
the table drag a Button
control from the Compose
task panel to the toolbar.
31) Right click on the newly

added button and choose
Configure from the context
menu.

2009 SAP AG

31
32) In the Text field of the

Configure task panel
change the button text to
Insert Line.
To define an Action for
that button click on ...
33) In the Define Action dialog

box add an Insert Row
action by clicking the Add
Action (+) button and
choosing More -> Insert
Row from the list. Click
Close.
34) Change the Title of the

Response form to
Response.

2009 SAP AG

32

criteria table to Request.

mDM_PRODUCTS table to
Products.
37) Remove the second Mdm

Mdm Product Id input field
from the Products table.
To do so right click on that
field and choose Delete
from the context menu.

2009 SAP AG

33
38) Rename the other labels,

names, and titles. In the
end your screen should
look similar to the
screenshot to the right.
39) Deploy the application by

clicking the Deploy button
in the task panel toolbar
and clicking the Deploy
button in the Deploy task
panel.

2009 SAP AG

34
40) Click on the MDMProducts

link (Html) in the Results
area of the Deploy task
panel to run the
application.
41) In the application click on

the Insert Line button.
42) Enter the MDM Product Id

3 in the newly inserted line.

2009 SAP AG

35
43) Click on the Submit button

and check the
results/response. The
output you will retrieve
should look like the one on
the figure (HT-1036).

2009 SAP AG

36
Copyright
2009 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, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries,
zSeries, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere,
Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of
IBM Corporation.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe 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 Wide Web Consortium, Massachusetts
Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by
Netscape.
MaxDB is a trademark of MySQL AB, Sweden.
SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, 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 in several other countries all over the world. All
other product and service names mentioned are the trademarks of their 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 such products and services, if any. Nothing herein should be construed as constituting an
additional warranty.
These materials are provided as is without a warranty of any kind, either express or implied, including but not limited to, the implied
warranties of merchantability, fitness for a particular purpose, or non-infringement.
SAP shall not be liable for damages of any kind including without limitation direct, special, indirect, or consequential damages that may
result from the use of these materials.
SAP does not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these
materials. SAP has no control over the information that you may access through the use of hot links contained in these materials and
does not endorse your use of third party web pages nor provide any warranty whatsoever relating to third party web pages.
Any software coding and/or code lines/strings (Code) included in this documentation are only examples and are not intended to be
used in a productive system environment. The Code is only intended better explain and visualize the syntax and phrasing rules of
certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors
or damages caused by the usage of the Code, except if such damages were caused by SAP intentionally or grossly negligent.

2009 SAP AG

37

MDM Web Services

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

MDM Web Services

Hochgeladen von

Copyright:

Verfügbare Formate

SAP NetWeaver Master Data

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

Prerequisite: Loading and Checking the MDM Repository

2) Open the SAP MDM

3) Mount the MDM server.

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

4) Connect to the Product

5) Load the Product

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

6) After the repository was

7) Now it is time to analyze

8) On the logon screen

9) In the SAP MDM Data

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

Generating and Deploying the Web Service Provider

2) On the initial screen of the

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

3) Enter the name of the

4) Choose your project and

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

5) The MDM Web services

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

6) After the Generator has

7) In the next wizard step all

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

8) In the Configure Fields

9) Now select from the

10) Click Next.

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

11) In the Generate step enter

12) To generate the Web

SAP DEVELOPER NETWORK | sdn.sap.com

BUSINESS PROCESS EXPERT COMMUNITY | bpx.sap.com

SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

13) In the Deploy step you

14) Choose Yes.

SAP DEVELOPER NETWORK | sdn.sap.com