Web Service Tool

Published on February 2017 | Categories: Documents | Downloads: 33 | Comments: 0 | Views: 205
of 23
Download PDF   Embed   Report

Comments

Content

SOA
SAP CRM 7.0

SAP CRM Web Service Tool: Intro and Enhancements

1

Objectives

At the end of this unit, you will be able to explain the
concept of the SAP CRM Web Service Tool

© SAP 2008 / Page 2

2

Web Service Tool – SAP CRM7.0

Why does the Web Service Tool
matter for SAP CRM customers?
„

To survive in a very competitive
market, CRM companies need to
innovate more freqently today

„

Flexible service provisioning and
management is required to enable
those innovations on top of a CRM
system

„

SAP CRM Web Service Tool
enables customer to model
services in a flexible and fast way

© SAP 2008 / Page 3

Why is the Web Service Tool (WST) particularly important for SAP CRM customers?
One of the major characteristics that differentiates the SAP CRM domain from other
classical domains like ERP or SCM, is that the competition is higher and that the market
rules and models change very frequently. Thus, companies that want to succeed
have to inovate and adapt their business models frequently.
To ensure that the IT department can support those changes, a flexible and open
architecture is requres that enables the adaption of the IT process to the new business
processes. The best way to do this is a service-oriented-architecture based on
Web services.
The SAP CRM Web Service Tool allows you to model those Web services in a very
easy and efficient way and, therfore, helps you to provide the IT architecture that is
required to support flexible business processes and models.

3

Agenda

1.
2.
3.
4.

Introduction
Details
Enhancements in SAP CRM 7.0
Selected Showcases and Further Information

© SAP 2008 / Page 4

The following presentation is comprised of four main areas:
In the introduction you will get a quick overview of the Web Service Tool.
In the Details you will learn about the characteristics and features of the Web Service
Tool.
Under Enhancements you will learn about the newly introduced Web Service Tool
features with SAP CRM 7.0.
In the Showcases section you will get to see three examples of where the Web Service
Tool was used to build new innovative processes on top.

4

Web Service Tool – SAP CRM7.0
Key Features
SAP CRM Web Service Tool provides customer and partners the flexibility to
model their individual services without the need of any additional coding
„

User friendly workbench to model Web services based on SAP CRM Business
Object Layer in only four steps

„

Comfortable modeling environment that takes care of any code generation

„

Embedded in SAP NetWeaver Web Service infrastructure

„

Allows the modeling of most important service operations, such as read, create
and query

„

Complies with the international W3C standard on web services

© SAP 2008 / Page 5

The Web Service Tool in a Nutshell:
The Web Service Tool was first introduced with SAP CRM 2006s, when SAP realized
that there is a special demand for Web services in the CRM domain. The Web
Service Tool allows you to model your individual services on the fly, by following a
user friendly four-step wizard that leads you through the process. The tool is
embedded in SAP Netweaver and the service modelling process does not require any
further coding from your side. You only need to choose the respective objects and
attributes and the tool creates the Web service automatically for you.
One Key benefit is that by using the Web Service Tool, you can reduce the time, effort,
and required programming knowledge to build new Web services significanlty. Thus,
you can shorten you project timeframe and can go live quicker with your innovative
processes.

5

Web Service Tool – SAP CRM7.0
Key Benefits

Flexibility

„

Define services for your exact needs

„

Simple 4 Step wizard for quick
service definition and provision

„

Model-driven workbench - no need
for additional coding

„

Flexible service management

„

Integrated into the SAP NetWeaver®

„

Use and build service templates

Innovation

Speed

© SAP 2008 / Page 6

The key benefits of using the Web Service Tool for you are the following::
You have more flexibility for your processes, since you can model the required
underlying Web service interfaces as you need them, individually and independently.
The Web Service Tool also helps you to innovate business processes, since you can
easily model the service interfaces that you require in a very lean and fast way. Your
innovative business ideas can be supported by IT in a much faster way.
Using the Web Service Tool allows you to build your individual services within
minutes or hours – not days or weeks as when you build them in the traditional way.

6

Web Service Tool – SAP CRM 7.0
Screenshot: Selection of Required Service Attributes

© SAP 2008 / Page 7

This screenshot shows step 2 of the Web Service Tool wizard. After choosing the
respective business object for the web service in step one, you can select all needed
attributes for your service interface in step two. On the left you can see the available
relations of the CRM BOL architecture and on the right side the respective attributes
that are available. Step two of the wizard represents the heart of the tool – where
you can easly define the interface of the later Web service by simply selecting the
fields that you require. In the following wizard steps three and four, you maintain the
attributes, rename them, give default values, and, finally, activate and test your service.

7

Agenda

1.
2.
3.
4.

Introduction
Details
Enhancements in SAP CRM 7.0
Selected Showcases and Further Information

© SAP 2008 / Page 8

We‘ll now take a look at the Web Service Tool in further detail.

8

SAP CRM Web Services Tool:
Technical Overview

1. Service Object Modeling

„

Wizard-based service object
definition based on SAP CRM BOL

„

Function module creation for each
service operation

„

Web service creation with SAP
NetWeaver’s service environment

2. Function Module Creation

3. Web Service Creation

© SAP 2008 / Page 9

From a technical point of view, the Web Service Tool is based on the SAP CRM
Business Object Layer (BOL), like the SAP CRM User Interface, and uses the same
structures. The difference is that the output is not a user interface, but a Web service
interface with the required attributes.
With the Web service wizard tool you first model your services by choosing the
needed attributes from a maximum list of attributes from the BOL. Then, the tool
generates the needed coding in the background, and, finally, the standard SAP
NetWeaver service environment is levaraged to create the respective Web
service.
One of the key benefits is that you model the interface, and then all necessary coding is
done by the tool in the background automatically. This saves you a lot of time and
allows even non-developers to build additional service interfaces that contain
exactly the fields they require.

9

SAP CRM Web Services Tool
Web Service Tool: General Overview
Model-Driven
Service Definition

Based on SAP CRM
Business Object Layer

Embedded into
SAP NetWeaver

„

User-friendly definition
process

„

Coding-free service
modeling

„

„

Only four steps to define
a service

„

Customer BOL objects
can be leveraged

Service objects are
transformed into function
modules

„

Web services built on top

„

Allows rapid service
deployment

„

Reuse of given service
definitions

„

„

Usage of compound
services

„

Main objects will
be enabled

SAP NetWeaver Web
Service infrastructure is
leveraged

© SAP 2008 / Page 10

One main goal of building the tool was that it should be very user friendly and hide the
technical complexity that you normally face if you build a Web service. The tool
allows fast and flexible service creation but also offers comfortable service
management. In only four steps you can model a service and you can also reuse given
service definitions by copying and enhancing them. Thus, you can model your best
practice services and use them as templates for further more special services.
All customer-specific BOL objects can be enabled for the tool, since the tool is built on
the SAP CRM standard BOL model. With SAP CRM 7.0, all fields that you add to the
BOL object by using the SAP CRM Extensibility tool are also automatically
available in the Web Service Tool.
Since the Web Service Tool levarages the standard SAP NetWeaver Web service
environment it, therefore, also benefits from all future NetWeaver enhancements in
this area. So far we have enabled all main SAP CRM business objects for the tool –
you can easily enable further objects by following our guidelines.

10

SAP CRM Web Services Tool
Basic Characteristics

Supported Methods

Service Characteristics

Tool Characteristics

„

Basic queries

„

Stateless services

„

Wizard-based

„

Read operations

„

Synchronous services

„

Based on CRM’s BOL

„

Create operations

„

„

Security settings

„

Change operations

Limited to one given
BOL object, also
component sets

„

Default values

„

Access to Web Service
Definition Language
(WSDL) file

„

Test environment

„

Services follow the
World Wide Web
Consortium (W3C)
standards
(e.g., XML and SOAP)

© SAP 2008 / Page 11

With the Web Service Tool you can model the standard Web service methods or
operations to read, create, change, and also make basic queries.
All services that are built with the tool are stateless and syncronous, and are limited
to one BOL object, including the component sets for the creation of compound
services.
The services follow the international W3C standard, World Wide Web consortium,
and can be consumed by any application that follows this standard.
Besides the simple creation wizard, the tool also allows the user to change service
attribute names, to give default values to service attributes, and to exclude attribude
fields from the Web Service Definition Language file.
Standard Web Service Tools provided by NetWeaver, such as the NetWeaver
Navigator for easy Web service testing, can be accessed directly from step 4 of
the Wizard.
The following features within the Web service tool that allow you to maintain and
manage your Web services include:
• Default values
• Ability to change attribute names
• Copy functionality
• Service characteristics
11

Default values:
You can set default values for the Web service attributes that you select when creating
a Web service. You use these default values to limit the Web service consumer’s
options. For instance, if you have a service provider who uses one of your Web services
to create leads in your SAP CRM system, then you can set a default value that allows
the service provider to create leads only for a certain category. The default values also
can help hide system-specific data from service consumers. For example, you can set
mandatory fields as defaults and exclude them from the Web Service Definition
Language (WSDL) file to reduce the complexity of your service interface.
Ability to change attribute names.
With the Web service tool, you can change the given technical attribute names as
needed. Replacing the attribute names with your company-specific terminology allows
you to create Web services interfaces that fit your common company language and
therefore helps to reduce the complexity of the service interfaces. For example, you
could change the House Number attribute to Street Address. This is also useful if you
want to translate the attributes to another language.
Copy functionality.
The copy functionality of the Web service tool allows you to copy and then change
service-design objects easily by adding attributes, for instance, or by changing the Web
service security settings based on the planned usage of the service. This guarantees
reusability and extensibility of services. For example, you can define your own best
practice Web services, which your decentralized IT departments can adapt to countryspecific needs by copying them and enhancing them as required.
Service characteristics. The created Web services comply with the World Wide Web
Consortium (W3C) standard. Therefore, all service-oriented architecture applications
should be able to use them. The Web service tool allows you to create standard service
operations, such as read, create, or query services for SAP CRM’s main business
objects. The provided services are stateless and synchronous. The standard SAP
NetWeaver Web services environment, such as the WSDL provisioning and testing
environment, handles the security and user authorizations.

12

Service Definition Has Never Been Easier
Model-Driven Definition of Web Services Without any Extra Coding

„

Select respective business objects

„

Select all needed attributes

„

Maintain selected attributes

„

Generate modeled Web service

„

Test your new Web service

© SAP 2008 / Page 13

To model a Web service with the Web service tool you have to follow the four steps in
the wizard.
In Step 1 you enter the basic data of your service, such as the name, the used
business object, and the root object, for example, the account or the contact object for a
business partner-based Web service. Then you assign your Web service to a SAP
Business Object (ARIS).
In Step2 you select all the attributes you need for your service from the so called
BOL Tree.
In Step3 you have the option to maintain your attributes, for instance you can
change the name of an attribute field or give a default value.
Finally, in Step 4, you activate your service. Then the system creates the respective
coding in the backgroung and triggers the Web service creation by using the standard
NetWeaver API. Now, your service is ready for consumption and you can use the
standard NetWeaver WebService environment to test it.

13

Web Service Creation in SAP CRM
Four Step Wizard for Faster and Easier Service Creation

© SAP 2008 / Page 14

We will now take a detailed look into each of the four wizard steps.
In wizard Step1, you select the underlying objects (components) and needed
operations for your service, give a name to it and assign it to a business object
(ARIS object). Furthermore, you can select a query object and can choose a component
set for the read service. A component set allows you to build a read service that
contains information from more than one BOL object,for instance if you want to read the
detailed data of a service order including the address details of the assigned customer.
In wizard Step two, you select the attributes that you want to use in your service.
First select the respective relation in the left side of the split screen, then select the
needed attributes from the right side. If you switch to expert mode you also get helpful
information on the availabilty of relations for the different service types and the
mandatory attributes.
In wizard Step 3, you maintain your attributes. You can rename them, assign
default values and exclude them from the Web Service Definition Language (WSDL)
file, for instance if you want to set a value as given. That is to say, if you set a default
and exclude the field, the default will always be taken into consideration and the
consumer can not change it. You also can export the service structure to an excel
sheet, as a basis for your individual documentation.
In wizard Step 4, you check and activate your service. After the activation, you can
see all required technical details if you have switched on the expert mode. From wizard
screen four you can also easily extract the WSDL file or test the service.
When you have finalized your test, you can set the status of the service to „productive“
to protect it. Then it can not be changed anymore, only deleted, if set back to not
productive, or copied.
14

Status and Lifecycle Management of a
Service Object
Service object states
Draft
Activated
Productive
Not productive

Service objects can have four
different states. Depending on
the status of the object, you can
edit or change it.
To test or consume a service,
you must activate it.
Further changes to the object
are permitted as long as it
has not been set to productive.

Status: Draft
„

Initial and edit status
„ All kinds of changes are permitted
„ Objects are saved and can be enhanced later on

Status: Active
„

Web service created and available for testing and
WSDL export
„ Object changes are permitted by setting the status
back to draft (edit mode)
„ Web services and WSDL are overwritten
automatically during next activation

Status: Productive
„
„

Status indicates active use of service interface
Object cannot be changed, but it can be copied

Status: Not productive
„
„

Status indicates that service is not used
Object can be set back to productive, deleted,
copied

© SAP 2008 / Page 15

So what does the lifecycle management of the service look like ?
Service objects can have four different states. Depending on the status of the objects,
you can edit, delete or change objects.
The initial status is draft. In this status you can change your service, delete it, or copy it.
After you have finished the definition process, you activate it. Then the status switches
to activated. Now the service is available and the WSDL can be generated and tested.
Whenever you want to change the service definition, for instance by adding further
attributes, you can set it back to draft.
After you have successfully tested your service, you can set it to productive to prevent
anybody making further changes. A service with the status productive can not be
changed or deleted any more, but you can copy it and change the copy.
The last status is “not productive”. If a service has this status, it can be deleted again,
but not changed!

15

Agenda

1.
2.
3.
4.

Introduction
Details
Enhancements in SAP CRM 7.0
Selected Showcases and further Information

© SAP 2008 / Page 16

We will now take a look at Enhancements of the Web Service Tool in SAP CRM 7.0.

16

Web Service Tool Enhancements
Enhancements With CRM7.0

Enhanced Usability

„

Advanced Search & Additional
Search Attributes

New Functionality

„

Business Objects Assignement to
Service Objects

„

Example Service Objects that can
be used as templates and copied

„

Long text for Attribute Names

„

CRM via E-Mail can levarage Web
Service Tool infrastructure

© SAP 2008 / Page 17

With SAP CRM 7.0 SAP invested in several significant enhancements for the WST in
the area of usability and functionality:
To improve the usabiltiy of the general service management, the advanced serach
concept got introduced that allows a more powerfull filtering and searching for your
services. You can now also assign a SAP Business Object (ARIS) to your individual
services and you can filter on those objects.
With SAP CRM 7.0 SAP also will provide best practice services for selected object so called Level One Services that you can easily copy and enhance/change to your
individual needs. Those services also contain the attribute names that SAP generally
uses for the eSOA data types (Local and global data types)
With SAP CRM 7.0 SAP ships a new tool, CRM via E-Mail, that allows you to send
Interactive Forms by Adobe (XML extract) directly to the backend to create buisness
documents – such as a lead or a customer visit report. You can levarage the WST to
provide the needed interfaces. (SAP does not guarantee the stability of the interfaces)
With CRM7.0 SAP ships the new Extensibility tool that allows you to easily extend
business objects. Those extenstions will be available immediately in the WST. You
can for instance add an additional field to a business partner and then use this field
immediatly in your web service.

17

Agenda

1.
2.
3.
4.

Introduction
Details
Enhancements in SAP CRM 7.0
Selected Showcases and further Information

© SAP 2008 / Page 18

In the following slides we will get to see three examples of where the Web Service
Tool was used to build new innovative processes on top.

18

Web Service Tool Showcase
Selected Examples and Usecases *

Template Integration
„

Leveraging CRM Web
Service Tool to integrate
MS Word documents and
Adobe Forms (Standard)

Widgets *
„

Leveraging CRM Web
Services Tool to connect
Widgets to the CRM
system *

Mobile Applications *
„

Leveraging CRM Web
Services Tool to connect
Mobile Applications to
the CRM system *

* Usecases are not part of SAP CRM 7.0 but could be built on project basis
© SAP 2008 / Page 19

The Web services you create with the Web Service Tool can be consumed by all kind
of applications and development frameworks that follow the internationl W3C
standard for Web services. To name some examples you can consume them with most
Microsoft applications such as MS Word or MS Excel, with most Adobe
applications, and most SAP development frameworks.
With SAP CRM 2007 SAP delivers the document template integration toolset as part
of the standard delivery. This is based on the Web service tool to connect to the CRM
backend.
On a project base, you can also develop Widgets or mobile applications that
consume Web serivces provided by the Web Service Tool, for example a Widget that
displays your open documents such as leads or opporunities. The shown i-Phone
application was built internaly as a prototype within a very short timeframe. It consumes
services from the CRM Demo System and allows the user to search and read, change
and create leads, opportunities, activites, accounts, and contacts.

19

Need Further Info on the Web Service Tool?
Please Check Following CRMExpert Editions

„

March07 Edition for a general
overview on functions and features

„

August07 Edition to get
technical background information

„

March08 Edition to learn how to
set up a lean offline scenario

„

CRMExpertOnline.com

© SAP 2008 / Page 20

If you are interested in reading more about the CRM Web Service Tool, please have a
look at the following articles that were published by Wellesley Information Services in
the CRMexpert issus. Please have a look at www.CRMexpertOnline.com and see the
following slide for detials.

20

Web Service Tool Articles
Published in CRMexpert (Wellesley Information Services)
Create Web Services Quickly
with the New Web Service Tool

SAP CRM Web Services Tool:
A Technical Look

Help Your Field Teams with
Lean Offline Scenarios

„

„

„

Gain some tips for using
Web services in this
technical look at the Web
services tool and
understand the
underlying technology

Gain insight into how you
can build lean offline
scenarios to support your
mobile workforce –
based on service
provided by the Web
Service Tool

March 08 Edition

August 07 Edition

March 07 Edition

Learn about the web
service tool, its features
and find out how to use
the creation wizard
included with it

See CRMExpertOnline.com/ Wispubs.com for details
© SAP 2008 / Page 21

The following three articles were published in 2007 and 2008:
Create Web Services Quickly with the New Web Service Tool: This article
introduces the Web Service Tool, the related business benefits, and how you can create
your individual services.
SAP CRM Web Services Tool - A Technical Look: This article gives a good overview
on the Web Service Tool from a technical point of view. In addition, the reader also
learns about the general CRM architecture.
Help Your Field Teams with Lean Offline Scenarios: This article introduces a lean
offline scenario that is built on the standard SAP CRM 2007 product, combining the
Web Service Tool, Groupware integration, and the Document Template Designer.

21

Further Information – SAP CRM

„

SAP CRM - Roll-Out Map
https://portal.wdf.sap.corp/go/crm-rollout-map

„

SAP CRM - Ramp-Up Knowledge Transfer (RKT)
http://service.sap.com/rkt-crm

„

SAP CRM – Demo Portal
http://crmportal.wdf.sap.corp:1080

„

SAP CRM – WiKi
https://wiki.wdf.sap.corp/display/SAPCRMHub/Home

„

SAP CRM - Help Portal
http://help.sap.com/crm

„

SAP Public Web
http://www.sap.com/crm

© SAP 2008 / Page 22

22

Copyright 2008 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.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, SAP Business ByDesign, ByDesign, PartnerEdge 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 and associated logos displayed
are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.
The information in this document is proprietary to SAP. This document is a preliminary version and not subject to your license agreement or any other agreement with SAP. This document
contains only intended strategies, developments, and functionalities of the SAP® product and is not intended to be binding upon SAP to any particular course of business, product strategy,
and/or development. SAP assumes no responsibility for errors or omissions in this document. SAP does not warrant the accuracy or completeness of the information, text, graphics, links, or
other items contained within this material. This document is provided 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 have no liability for damages of any kind including without limitation direct, special, indirect, or consequential damages that may result from the use of these materials. This limitation
shall not apply in cases of intent or gross negligence.
The statutory liability for personal injury and defective products is not affected. 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

Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem Zweck und in welcher Form auch immer, ohne die ausdrückliche schriftliche Genehmigung durch
SAP AG nicht gestattet. In dieser Publikation enthaltene Informationen können ohne vorherige Ankündigung geändert werden.
Einige von der SAP AG und deren Vertriebspartnern vertriebene Softwareprodukte können Softwarekomponenten umfassen, die Eigentum anderer Softwarehersteller sind.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, SAP Business ByDesign, ByDesign, PartnerEdge und andere in diesem Dokument erwähnte SAP-Produkte und Services sowie die
dazugehörigen Logos sind Marken oder eingetragene Marken der SAP AG in Deutschland und in mehreren anderen Ländern weltweit. Alle anderen in diesem Dokument erwähnten Namen
von Produkten und Services sowie die damit verbundenen Firmenlogos sind Marken der jeweiligen Unternehmen. Die Angaben im Text sind unverbindlich und dienen lediglich zu
Informationszwecken. Produkte können länderspezifische Unterschiede aufweisen.
Die in diesem Dokument enthaltenen Informationen sind Eigentum von SAP. Dieses Dokument ist eine Vorabversion und unterliegt nicht Ihrer Lizenzvereinbarung oder einer anderen
Vereinbarung mit SAP. Dieses Dokument enthält nur vorgesehene Strategien, Entwicklungen und Funktionen des SAP®-Produkts und ist für SAP nicht bindend, einen bestimmten
Geschäftsweg, eine Produktstrategie bzw. -entwicklung einzuschlagen. SAP übernimmt keine Verantwortung für Fehler oder Auslassungen in diesen Materialien. SAP garantiert nicht die
Richtigkeit oder Vollständigkeit der Informationen, Texte, Grafiken, Links oder anderer in diesen Materialien enthaltenen Elemente. Diese Publikation wird ohne jegliche Gewähr, weder
ausdrücklich noch stillschweigend, bereitgestellt. Dies gilt u. a., aber nicht ausschließlich, hinsichtlich der Gewährleistung der Marktgängigkeit und der Eignung für einen bestimmten Zweck
sowie für die Gewährleistung der Nichtverletzung geltenden Rechts.
SAP übernimmt keine Haftung für Schäden jeglicher Art, einschließlich und ohne Einschränkung für direkte, spezielle, indirekte oder Folgeschäden im Zusammenhang mit der Verwendung
dieser Unterlagen. Diese Einschränkung gilt nicht bei Vorsatz oder grober Fahrlässigkeit.
Die gesetzliche Haftung bei Personenschäden oder die Produkthaftung bleibt unberührt. Die Informationen, auf die Sie möglicherweise über die in diesem Material enthaltenen Hotlinks
zugreifen, unterliegen nicht dem Einfluss von SAP, und SAP unterstützt nicht die Nutzung von Internetseiten Dritter durch Sie und gibt keinerlei Gewährleistungen oder Zusagen über
Internetseiten Dritter ab.
Alle Rechte vorbehalten.

© SAP 2008 / Page 23

23

Sponsor Documents

Or use your account on DocShare.tips

Hide

Forgot your password?

Or register your new account on DocShare.tips

Hide

Lost your password? Please enter your email address. You will receive a link to create a new password.

Back to log-in

Close