Skip to Content

Introduction

Release 10.0 of SAP Sourcing/CLM – generally available (GA) since 7-Nov-2014 – provides a new Web Service Framework (WSF) for the development of custom RESTful style web services that leverage the existing SAP Sourcing/CLM Scripting and Query framework.

Now custom integrations can be more easily developed where SAP Sourcing/CLM can be a provider of RESTful style web services.

WSF Features

  • High-Level Summary

    • SAP Sourcing/CLM can now be a provider of custom inbound REST query/update web services using the existing SAP Sourcing/CLM Explicitly Called Script feature

    • SAP Sourcing/CLM can now be a provider of custom inbound REST query web services using the existing SAP Sourcing/CLM Report’s Query Definition feature (SAP delivered Query Definitions or custom Query Definitions)

    • Enablement of these new web services can be done through simple run-time configuration.  There is no requirement to deploy custom .jar files that require shutting down the SAP Sourcing/CLM application server.
    • Logging of these custom RESTful web service requests and responses is provided in a new Web Service Request object – that includes detail information about the request as well as both the request and response XML or JSON payload files.  These logging objects are available to view through a System Administration User Interface.  You do not need to get the actual SAP Sourcing/CLM logs to see this information

    • In addition, an SAP delivered standard RESTful web service is provided for SAP Sourcing/CLM User Account maintenance and queries.  This new web service can be used for User Account synchronization between Identity Management servers and/or NetWeaver servers

  • Authentication
    • Directory Configuration Settings provider authentication support:
      • Basic Authentication (User Name & Password)
        • Local (non-Production only), LDAP, and NetWeaver UME
      • SSO using SAP NetWeaver Assertion Tickets
        • NetWeaver UME

    • OAuth 1.0a (“3 legged”) RESTful provider authentication support
      • OAuth is an open standard protocol that is secure, flexible, and extensible
      • User Name & Password do not need to be provided to the client consuming application

  • Security
    • New Web Service Security Profiles
      • Web Service User & Web Service Admin standard Security Profiles delivered
      • User permission required to execute an inbound web service
      • Access Right permissions also required for new web service Configuration Objects

    • Script-based Web Service
      • Document Authorizer Framework IAPIs available for Scripts
      • The “Collaborator model” security is available and is based on the authenticated web service User Session context

    • Query-based Web Service
      • Report & Query Definition “Access List” security supported

    • The OAuth protocol is considered very secure

    • Configurable Throttling Model provided to protect server resources

  • Reference sample Scripts and Schema Files (.xsd files) provided to support custom development of Script-based web services:

    • Sample scripts provided to perform CRUD-like operations (e.g., Create Read, Update…) on CLM Master Agreements, and Souring RFxs and Projects
      • Sample scripts and XML Schema Files (.xsd files) can help “jump start” development of custom integrations
      • For example, custom SRM integration web services could be developed to create an SAP Sourcing Project or RFx from the SRM Sourcing Cockpit or to create an SAP CLM Agreement from an SRM Central Contract from the provided sample scripts and XML Schema Files

    • XML Schema Files (.xsd files) are used to automatically create XML Request and Response java proxy stub classes for the Explicitly Called Scripts used to provision a web service
      • After the XML Schema file is uploaded and saved via the new Web Service Definition UI, you can immediately view the JavaDocs that are automatically generated at run-time
      • The Request and Response java proxy stub classes are immediately available to the SAP Sourcing/CLM Script environment for Script BeanShell coding

    • New Scripting IAPIs provided to support Script-based web services development:
      • New “Adapter” IAPIs for unmarshalling/marshaling XML > Java > XML
        • Provided for the complex SAP Sourcing/CLM Data Types
      • New IAPIs to support CRUD (e.g., Create Read, Update…) operations – e.g., to handle checking document access rights on edit and find, clearing and setting document edit information on edit and release, and releasing memory appropriately.

The reference/sample scripts plus the new IAPIs plus the new Web Services Guide for SAP Sourcing 10.0 – now available on SAP Service Marketplace SAP Sourcing/CLM 10.0On-Premise – can help illustrate a best practices and efficient approach to developing custom script-based web services.  In addition, please note that there is also a new Web Service Cookbook and Troubleshooting Guide 10.0 that should be read if you intend to use the new Web Service Framework script-based or query-based custom web services feature in SAP Sourcing/CLM Release 10.0.

You can get both of these documents now at SAP Service Marketplace:

samp 1.png

/wp-content/uploads/2014/12/samp2_597970.png

/wp-content/uploads/2014/12/samp3_597986.png

If you are interested in learning more detail about the above SAP Sourcing/CLM Release 10.0 Web Service Framework new features, please check out the recent SCN webinar presentation slides which have additional content and screen shots at the following link:

http://scn.sap.com/docs/DOC-55313

To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

Leave a Reply