SAP NetWeaver Master Data Management 7.1 Web Service Enhancements

Transcription

1 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 From until 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 AG 1

2 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 SAP AG 2

3 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: 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 Ensure development of a Web service (WS) client is easy 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: 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: dbb93e43a5c0 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 SAP AG 3

4 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 SAP AG 4

5 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 SAP AG 5

6 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 SAP AG 6

7 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 SAP AG 7

8 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 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 SAP AG 8

9 3) Enter the name of the project MDMProductWS Press Enter. 4) Choose your project and click on Edit SAP AG 9

10 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

11 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 SAP AG 11

12 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 SAP AG 12

13 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 SAP AG 13

14 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 SAP AG 14

15 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 <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 SAP AG 15

16 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 SAP AG 16

17 5) Click on the Test link. 6) Select the retrievemdm_products operation SAP AG 17

18 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 SAP AG 18

19 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 in your browser. 2) In the NWA go to SOA Management -> Technical Configuration -> Destination Template Management SAP AG 19

20 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 SAP AG 20

21 5) In the Security step click on the Next button. 6) Click Finish SAP AG 21

22 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 in your browser SAP AG 22

23 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 SAP AG 23

24 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 SAP AG 24

25 14) Select/Check the reposinfo node from In Ports. 15) To define the service output fields select/check the retrievemdm_products 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 SAP AG 25

26 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 SAP AG 26

27 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 SAP AG 27

28 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 SAP AG 28

29 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 SAP AG 29

30 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 SAP AG 30

31 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 SAP AG 31

32 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 retrievemdm_products Response form to Response SAP AG 32

33 35) Change the Title of the criteria table to Request. 36) Change the Title of the 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 SAP AG 33

34 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 SAP AG 34

35 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 SAP AG 35

36 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) SAP AG 36

37 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 SAP AG 37