Documentos de Académico
Documentos de Profesional
Documentos de Cultura
How to Create PL/SQL Web Service Providers Using Oracle Retail SOA Enabler and Oracle Retail Artifact Generator June 2010
direction. It is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracles products remains at the sole discretion of Oracle.
Contents
Preface ......................................................................................................................................1 Support Notice .................................................................................................................................. 1 Using this Document........................................................................................................................ 1 Reference Documents....................................................................................................................... 1 Introduction ..............................................................................................................................2 Tool Overview and Relationship ............................................................................................3 Artifact Generator Inputs and Outputs ......................................................................................... 4 Inputs............................................................................................................................................... 4 Outputs............................................................................................................................................ 4 RSE Inputs and Outputs .................................................................................................................. 4 Inputs............................................................................................................................................... 4 Outputs (a .zip file)........................................................................................................................ 4 PL/SQL Web Service Provider Use Case Approaches.........................................................5 Current Version Use Case New Service ..................................................................................... 5 Scenario ........................................................................................................................................... 5 Approach......................................................................................................................................... 5 Back Version Use Case New Service........................................................................................... 7 Scenario ........................................................................................................................................... 7 Approach......................................................................................................................................... 7 Current Version Use Case Extend Existing Web Service Provider Use Case ....................... 8 Scenario ........................................................................................................................................... 8 Approach......................................................................................................................................... 9
Preface
This document discusses how to create PL/SQL Web service providers using Oracle Retail SOA Enabler and Oracle Retail Artifact Generator. Before attempting to download, install, and configure the required tools for this process, understand the information in this Preface, especially the following Support Notice.
Support Notice
The customization and extension of Oracle Retail base products and messages, and the integrations created by these tools are not supported by Oracle Retail, including My Oracle Support. This white paper aims to mitigate the risks of unsupported customization by providing guidance and references for how to attempt to customize safely and effectively. The tools and approaches described in this document are complex and require a high level of skill and knowledge of the product. Any issues that may arise with custom flows, custom APIs, or customized message families are the responsibility of the customer and not Oracle Retail. The Retail SOA Enabler (RSE) tool and the Artifact Generator (AG) tool require the 13.1.x GA business objects. The tool support does not extend to the use of the output beyond the normal support that any tool has; it must conform to its own specifications and documentation.
Download, install, and configure the Service-Oriented Architecture Enabler Tool and the Functional Artifact Generator. Search My Oracle Support for any patches pertaining to both tools.
Note: It is likely that patches exist for these tools.
3.
Carefully read the documentation for each tool. The process included in this document does not replicate existing information about the tools; rather it refers to specific sections within respective documents.
Reference Documents
See the following documentation for supporting information. Oracle Retail Service-Oriented Architecture Enabler Tool Guide Oracle Retail Functional Artifact Guide Oracle Retail Functional Artifact Generator Guide Oracle Fusion Reference Architecture (Overview) Oracle Practitioner Guide Software Engineering in an SOA Environment Oracle Retail Merchandising System documentation
How to Create PL/SQL Web Service Providers Using Oracle Retail SOA Enabler and Oracle Retail Artifact Generator 1
Introduction
The Retail Service Oriented Architecture Enabler (RSE) tool is used to create the following: Web service provider end-points Consumer clients for Web service providers Templates for the PL/SQL APIs and Java EE APIs that interface with them.
The RSE tool is designed to provide a standards-based way to consistently develop Web services for PL/SQL and Java EE applications that allows exposure to their business logic. Development is focused on the business logic code, not the Web service infrastructure. The tool produces design time and run time artifacts. RSE works in conjunction with another Oracle Retail tool, the Retail Functional Artifact Generator (AG). The AG is a collection of tools designed to create the various artifacts used within the Oracle Retail messaging infrastructure from an XML schema (XSD). These XSDs are called Business Objects. They represent the functional definition and technical structure of a Retail Business Entity.
Note: See Reference Documents.
The purpose of this document is to discuss how the PL/SQL features of the RSE and Artifact Generator tools can be used to create new Web service providers to: support new functionality in a PL/SQL application. customize and extend an existing PL/SQL Web service provider.
2 Oracle Retail
Guide and the Oracle Retail Functional Artifact Generator Guide for installation and configuration instructions The AG is designed to allow customers to create extensions to base objects using the specified hooks, or to create entirely custom objects that meet Oracle Retail standards. The tools enforce these standards.
Note: See the Oracle Retail Functional Artifact Guide for standards.
For the creation of a Web service provider, the RSE tool expects as one of its inputs one of the outputs of the AG tool to design time artifacts. There is a run-time relationship as well, as shown in the diagram below, which illustrates the relationship for a PL/SQL Web Service Provider.
Retail Artifact Generator
Base XSDs Extof XSDs
custom-retailpublic-payloadxml-samples.zip
<service>.zip file
WSDL
Service Def
UDDI Registry
<service>.ear Run Time
Infrastructure Service (UDDI PUB) Retail SOA Enabler Retail Artifact Generator custom-retailpublic-payloadjava-beans.jar
<ServiceName>Provi derImplBody.sql
custom-retailpublic-payloaddatabase-objecttypes.zip
Design Time
<ServiceName>Provid erImplSpec.sql
retail-publicpayload-javabeans.jar
Service Def
PL/SQL App
Oracle Corporation
How to Create PL/SQL Web Service Providers Using Oracle Retail SOA Enabler and Oracle Retail Artifact Generator 3
Outputs
The following are AG outputs: custom-retail-public-payload-java-beans.jar custom-retail-public-payload-database-object-types.zip