uCosminexus Service Platform Basic Development Guide

uCosminexus Service Platform

Basic Development Guide

3020-3-Y43-40(E)

Contents

Notices

Preface

1. Overview of System Development Based on SOA

1.1 Flow from Development up to Actual Operation

1.2 Relationship Between the Overall System and the Development Environment

2. Before Developing a System

2.1 Setup for Using the Development Environment

2.1.1 Prerequisites

2.1.2 Installation

2.1.3 Environment Setup

2.1.4 Creating embedded database

2.1.5 Uninstalling

2.2 Selecting the configuration format and the SOAP modes

2.2.1 Usage existence of database and Reliable Messaging

2.2.2 SOAP mode to be used

2.2.3 SOAP mode settings

2.3 Development Work Flow

2.4 Easy Setup of the Test Environment

2.4.1 Environment that can be Built with the HCSC Easy Setup Functionality

2.4.2 Executing HCSC easy setup functionality

2.4.3 Operating the test environment set up with HCSC easy setup functionality

2.4.4 Customizing a Test Environment

2.4.5 Checking the SOAP modes

2.5 Operating an embedded database set up with the HCSC Easy Setup functionality

2.5.1 Checking unused RD area

2.5.2 Deleting the execution history of process instances

2.5.3 Releasing empty pages and empty segments

2.6 Types of Available Service Components and Their Application Scopes

2.6.1 Applicability of the service components that use Web service

2.6.2 Application Scopes of Service Components That Use SessionBean

2.6.3 Application Scopes of Service Components That Use the Local Queue of Cosminexus RM

2.6.4 Application Scopes of Service Components That Use a Database Queue

2.6.5 Scoping of XML schema

2.7 Expanding code conversion

2.7.1 Creating character code conversion UOC

2.7.2 Embedding the user mapping table

3. Managing Project and Managing Repository

3.1 Managing a Project

3.1.1 Creating a Project

3.1.2 Setting up Properties

3.1.3 Exporting/Importing a Project

3.1.4 Deleting a Project

3.1.5 Changing SOAP modes

3.1.6 Notes at the time of development

3.2 Managing a Repository

3.2.1 Setting Up a Repository

3.2.2 Exporting a Repository

3.2.3 Importing a Repository

3.3 Output of design information

3.3.1 Information that can be output as design information

3.3.2 Items to be checked before output

3.3.3 How to output the design information

3.3.4 Notes on outputting design information

3.4 Notes regarding Eclipse

4. Creating Message Formats

4.1 Message Formats and Data Transformations

4.2 Message Format Types

4.3 Creating Message Formats (XML Format Definition File)

4.3.1 Creating a Message

4.3.2 Creating a Service Component Message (for Web Services)

4.3.3 Creating a Service Component Message (for SessionBean)

4.3.4 Creating a Service Component Message (for MDB (WS-R or Database Queue))

4.4 Creating Message Formats (Binary Format Definition File)

4.4.1 Data types and character code types in the binary format definition file

4.4.2 Creating a New Binary Format Definition File

4.4.3 Defining Elements (for Non-CSV Format)

4.4.4 Defining Elements (for CSV Format)

4.4.5 Editing a Binary Format Definition File

4.4.6 Validating a Binary Format Definition File

4.4.7 Notes regarding binary format definition

4.5 Generating the binary format definition file from COBOL Library Text File

4.5.1 Description format of COBOL Library Text File that can be transformed

4.5.2 Support to data type of COBOL Library Text File and binary format definition file

4.5.3 Method of generating the binary format definition file

4.6 Generating an XML schema file from the binary format definition file

4.7 Changing the message formats

5. Defining Business Processes

5.1 Definition Work Flow

5.2 Adding Business Processes

5.2.1 Adding New Business Processes

5.2.2 Using an Already Defined Business Process to Add Business Processes

5.3 Defining Business Process Contents

5.4 Deploying and Linking Activities

5.4.1 Deploying Activities

5.4.2 Linking Activities

5.4.3 Defining Fault Handling

5.5 Defining Variables and Correlation Sets

5.5.1 Defining Variables

5.5.2 Defining Correlation Sets

5.6 Defining Activities

5.6.1 Start Activity

5.6.2 Receive Activity

5.6.3 Reply Activity

5.6.4 Service Invocation Activity

5.6.5 Invoke Java Activity

5.6.6 Data Transformation Activity

5.6.7 Assign Activity

5.6.8 Empty Activity

5.6.9 Throw Activity

5.6.10 Standby Activity

5.6.11 Validate activity

5.6.12 Scope Activity

5.6.13 While Activity

5.6.14 Switch Activities

5.6.15 Flow Activities

5.6.16 End Activity

5.6.17 Sequence Activity

5.6.18 Specifying an XPath

5.7 Scheduling comments

5.8 Saving Business Processes

5.9 Editing Business Processes

5.9.1 Modifying the definition information for business processes and activities

5.9.2 Modifying Activity Names

5.9.3 Changing a Running Business Process Definition

5.9.4 Upgrading version of business processes

5.10 Validating Business Processes

5.10.1 Validation Contents

5.10.2 Validation Method

5.10.3 Displaying the Validation Contents

5.11 Deleting Business Processes

6. Defining Data Transformation

6.1 Files and Definitions Necessary for Data Transformation

6.2 Creating Message Format Definition Files

6.3 Defining Data Transformation

6.3.1 Procedure for Defining Data Transformation

6.3.2 Procedure for defining changed message formats

6.3.3 Points to be considered for data transformation definition

6.4 Mapping

6.4.1 Assigning Transformation-source Node Values Directly to Transformation-destination Nodes

6.4.2 Processing the Transformation-source Node Values and Mapping Them to the Transformation-destination Node

6.4.3 Specifying the Scope of Transformation-source and Destination Nodes and Mapping Automatically

6.4.4 Specifying a Target from the Element of the Transformation-destination Node and Mapping Automatically

6.4.5 Canceling Mapping

6.4.6 Mapping Source Display Format

6.4.7 Making Mapping Lines and Functions Easier to View

6.4.8 Restricting mapping range

6.4.9 Determining Similarities during Automatic Mapping

6.4.10 Notes on Mapping

6.5 Using Functions to Process Values

6.5.1 Concatenating Multiple Strings

6.5.2 Extracting a Substring from a String

6.5.3 Assigning a String Character Count

6.5.4 Verifying That the Specified String Is Present or That the String Begins with the Specified String

6.5.5 Removing Spaces from a String

6.5.6 Converting the Number Format

6.5.7 Computing Numbers

6.5.8 Rounding Decimal Digits

6.5.9 Summing Up the Node Numbers of Multiple Node Sets

6.5.10 Using NOT operation

6.5.11 Using logical operation

6.5.12 Using shift operation

6.5.13 Assigning a Node Count

6.5.14 Assigning a Node Name

6.5.15 Verifying That a Node Exists

6.5.16 Mapping Looping

6.5.17 Outputting Different Values According to Conditions

6.5.18 Assigning a Specified Value

6.5.19 Converting a Value with the Conversion Table

6.5.20 Performing basic number transformation

6.5.21 Assigning a Value to a Transformation-source Node Value

6.5.22 Doubling a Transformation-source Node Value

6.5.23 Invoke a Java program created by the user

6.6 Specifying Looping

6.6.1 Mapping Using the Loop Settings Dialog Box

6.6.2 Synthesizing Loops

6.6.3 Mapping Looping Dependent Targets

6.6.4 Checking Looping Dependent Targets

6.6.5 Changing Looping Dependent Targets

6.6.6 Displaying the Path of a Transformation-source Node for Which a Looping Dependent Target Is Specified

6.6.7 Relating repeat process of each element by setting up the linkage path

6.7 Specifying Node Conditions

6.8 Copying Mapping Definitions

6.8.1 Flow of copying mapping definitions

6.8.2 Saving mapping definitions

6.8.3 Registering mapping definitions

6.8.4 Copying mapping definitions

6.8.5 Determining similarities

6.8.6 Notes on copying mapping definitions

6.9 Creating Java programs to be used in the custom function

6.9.1 Creating the Transformation Function Definition File

6.9.2 Creating the Java form file

6.9.3 Referring to external jar from transformation function

6.9.4 Coding, building and debugging Java programs

6.9.5 Packaging Java programs

6.10 Mapping Conditions

6.10.1 Mapping Targets and Non--Mapping Targets

6.10.2 Correspondences Between Nodes and Functions That Can Be Mapped

6.10.3 Number of Mapping Lines That Can Be Connected

6.11 Editing function name directly

6.11.1 Method of editing function name

6.11.2 Displaying function name after edition

6.12 Importing mapping definition using Excel

6.12.1 Creating table format XML file

6.12.2 Setting up the mapping definition

6.12.3 Importing mapping definition

6.12.4 Points to be considered when using mapping definition using Excel

6.13 Definition details of table format XML schema definition file

6.13.1 Namespaces (namespace information)

6.13.2 CopyObjects (mapping to transformation destination node)

6.13.3 ConcatenateObjects (Concatenate function)

6.13.4 SubstringObjects (Acquire substring function)

6.13.5 LengthObjects (Acquire string length function)

6.13.6 ContainObjects(Check string function)

6.13.7 TrimObjects (Trim node function)

6.13.8 FormatObjects(Convert number format function)

6.13.9 CalculateObjects(Perform node operation function)

6.13.10 RoundObjects(Round node function)

6.13.11 SumObjects(Sum up nodes function)

6.13.12 NotObjects(NOT operation function)

6.13.13 BitOpObjects(Logical operation function)

6.13.14 ShiftObjects(Shift operation function)

6.13.15 NameObjects(Acquire node name function)

6.13.16 CountObjects(Acquire node count function)

6.13.17 ExistObjects(Check node function)

6.13.18 LoopObjects(Repeat function)

6.13.19 ChooseObjects(Select function)

6.13.20 ReplaceObjects(Replace value function)

6.13.21 RadixObjects(radix conversion function)

6.13.22 CustomObjects(Custom function)

6.13.23 ConstantObjects(Set constant function)

6.13.24 Objects for which you can define the same Name element in multiple rows

6.14 Namespace prefix option

6.14.1 Setting up default value of namespace prefix option

7. Packaging HCSC Components and Defining Deployment

7.1 Packaging and Defining Deployment

7.2 Packaging

7.3 Defining Deployment of HCSC Components

7.3.1 Clusters (or Single HCSC Servers) to Which HCSC Components Can Be Deployed

7.3.2 Adding HCSC Components to a Cluster

7.3.3 Deleting HCSC Components from a Cluster

7.4 Referencing HCSC Component Information

7.4.1 HCSC Component Information That Can Be Referenced

7.4.2 Displaying HCSC Component Information

7.4.3 Updating the HCSC Component List

7.5 Batch execution of processes for deploying HCSC components on the HCSC Server and then starting

7.5.1 Flow of processes from deploying to starting HCSC components

7.5.2 How to deploy HCSC components in the HCSC server and start them

7.6 Batch execution of processes for stopping HCSC components and deleting them from the HCSC server

7.6.1 Flow of processes from stopping to deleting HCSC Components

7.6.2 How to stop HCSC components and delete them from the HCSC server

8. Creating Service Requesters

8.1 Overview of Creating Service Requesters

8.2 Service Requester That Sends Requests to a Standard Synchronous Reception (Web Services) (SOAP communication infrastructure)

8.2.1 Procedure for Creating a Service Requester (Standard Synchronous Reception (Web Services)) (SOAP communication infrastructure)

8.2.2 Acquiring the WSDL

8.2.3 Creating Stubs

8.2.4 Generating Objects

8.2.5 Specifying Parameters

8.2.6 Creating Request Messages

8.2.7 Acquiring Response Messages

8.2.8 Acquiring Error Information

8.2.9 Creating a service requester that sends a request for business process re-execution (Web Services and SOAP communication infrastructure)

8.2.10 Creating a service requester that sends a request for the operating status of service adapter from an application (Web Services and SOAP communication infrastructure)

8.3 Creating a service requester using standard synchronous reception (Web Services) (JAX-WS engine)

8.3.1 Procedure for creating a service requester (Standard synchronous reception (Web Service)) (JAX-WS engine)

8.3.2 Acquiring WSDL

8.3.3 Creating service classes

8.3.4 Generating objects

8.3.5 Specifying parameters

8.3.6 Creating request messages

8.3.7 Acquiring response messages

8.3.8 Acquiring error information

8.3.9 Creating a service requester requesting re-execution of a business process (Web service and JAX-WS engine)

8.3.10 Creating service requester for requesting confirmation of operation status of service adapter (Web Service and JAX-WS engine)

8.4 Service Requester That Sends Requests to a Standard Synchronous Reception (SessionBean)(JAX-WS engine)

8.4.1 Procedure for Creating a Service Requester (Standard Synchronous Reception (SessionBean))

8.4.2 Acquiring Stubs

8.4.3 Creating Instances

8.4.4 Specifying Parameters

8.4.5 Creating Request Messages

8.4.6 Acquiring Response Messages

8.4.7 Acquiring Error Information

8.4.8 Creating a Service Requester That Sends a Request for Business Process Re-execution (SessionBean)

8.5 Service Requester That Sends Requests to a Standard Asynchronous Reception (MDB (WS-R))

8.5.1 Procedure for Creating a Service Requester (Standard Asynchronous Reception (MDB (WS-R))

8.5.2 Creating a Transmission Queue

8.5.3 Creating JMS Messages

8.5.4 Specifying Parameters

8.5.5 Creating Request Messages

8.5.6 Sending JMS Messages

8.5.7 Setting Up a Response Queue

8.5.8 Extracting Responses

8.5.9 Acquiring Response Messages

8.6 Service Requester That Sends Requests to a Standard Asynchronous Reception (MDB (database queue))

8.6.1 Service Requester (Standard Asynchronous Reception (MDB (Database Queue))) Creation Procedure

8.6.2 Creating a Shared Transmission Queue (JMS)

8.6.3 Creating JMS Messages (JMS)

8.6.4 Creating Binary Data (TP1/EE or JMS)

8.6.5 Specifying Parameters (TP1/EE or JMS)

8.6.6 Creating Request Messages (TP1/EE or JMS)

8.6.7 Specifying Binary Data in the Shared Receive Queue (TP1/EE)

8.6.8 Sending JMS Messages (JMS)

8.6.9 Setting Up a Response Queue (TP1/EE or JMS)

8.6.10 Extracting Responses (TP1/EE or JMS)

8.6.11 Acquiring Response Messages (TP1/EE or JMS)

8.7 Service Requester That Sends Requests to a User-defined Reception (Web Services)

8.7.1 Procedure (SOAP communication infrastructure)for creating a service requester (User-defined reception (Web Service))

8.7.2 Editing a WSDL

8.7.3 Creating Stubs

8.7.4 Generating Objects

8.7.5 Acquiring Response Messages

8.7.6 Acquiring Error Information

8.7.7 Procedure for creating a service requester (User-defined Reception (Web Service)) (JAX-WS engine)

9. Debugging Business Processes

9.1 Flow of Debugging

9.2 Preparing for Debugging of Business Processes

9.2.1 Setting Breakpoints

9.2.2 Setting Service Emulation

9.3 Starting debugging of business processes

9.4 Sending requests

9.5 Debugging Business Processes

9.5.1 Step-by-Step Execution and Restarting

9.5.2 Checking Variables and Correlation Sets

9.5.3 Updating Variables

9.5.4 Evaluating XPath

9.5.5 Automatic Service Emulation

9.5.6 Manual Service Emulation

9.6 Ending Debugging of Business Processes

Appendixes

A. Migrating from an Earlier Version

A.1 Versions Wherein Migration Is to Be Performed

A.2 Migrating from an Earlier Version

A.3 Migrating procedure when a repository is shared between development environment and operating environment in earlier version

B. Migrating from the Evaluation Version

C. System development using High Level Design Tools

C.1 Overview of system development using high level design tools

C.2 Procedure of system development using high level design tools

C.3 Prerequisites for using high level design tools

C.4 Troubleshooting when the high level design tools are used

D. Examples of System Development Using High Level Design Tools

D.1 Designing the business process overview

D.2 Reviewing the service overview interface

D.3 Detailing the business process

D.4 Output the business process

D.5 Reviewing the detailed interface of the service

D.6 Creating the service adapter

D.7 Importing the business process

D.8 Adding user-defined reception interfaces

D.9 Registering message schemas

D.10 Adding the message transformation and system exception processing

E. Support Range of BPEL Used by Linking with an High Level Design Tool

E.1 Importing business process definitions for BPEL1.1

E.2 Importing a business process definition of BPEL2.0

F. Inheriting HTTP header and Cookie information in which service adapter is used

G. Emulating the Service Requester

G.1 Flow of service requester emulation

G.2 How to emulate the service requester

H. Component common UOC

H.1 Property file of component common UOC class

H.2 Method for specifying the component common UOC class

H.3 API for UOC class

H.4 API for message acquisition

H.5 Method of specifying jar file of UOC class

H.6 Notes

I. Character code conversion using character code conversion UOC

I.1 Developing jar file of character code conversion UOC

I.2 Settings for using the character code conversion UOC

I.3 CSCOwnCodeConverter interface

I.4 CSCOwnCodeReader interface

I.5 CSCOwnCodeReaderContext interface

J. Examples of transforming the format of data acquired by using the database adapter

J.1 Examples

J.2 Format transformation methods

K. Auto mapping of data acquired by DB adapter

L. Customizing WSDL using the external binding file

M. Changing IBM kanji code character set

M.1 Procedure for changing the character set of IBM kanji code

N. Glossary

Index