uCosminexus Service Platform, Reception and Adapter Definition Guide

[Contents][Glossary][Index][Back][Next]

Appendix D.1 About the sample

Note
The explanation below assumes that you are executing sample business processes in the operation and execution environment (test environment) within the development environment.

The sample business processes used throughout this process use a file adapter and DB adapter to store data read from a file in the database, and to write data found in the database to a file. Different business processes are used to read and write data to and from each file format.

Organization of this subsection
(1) Storing data read from a file in the database
(2) Writing database search results to a file
(3) List of sample business processes
(4) Prerequisites for sample business processes

(1) Storing data read from a file in the database

The following figure shows an overview of the process:

Figure D-1 Sample business process overview (storing data read from a file in the database)

[Figure]

First, a file adapter is used to read data from a file transferred by FTP or other means from an existing system. This data is then stored in the database through a DB adapter. In this scenario, the business process is triggered by file transfer.

The files in the sample business process cover the definitions in the business process and execution of the business process (service requester).

(2) Writing database search results to a file

The following figure shows an overview of the process:

Figure D-2 Sample business process overview (writing database search results to a file)

[Figure]

The service requester that executes the business process provides database search criteria. Based on this criteria, the data in the tables is acquired through the DB adapter. The acquired data is then written to a file using a file adapter.

The files in the sample business process cover the definitions in the business process and execution of the business process (service requester).

(3) List of sample business processes

The following table lists the provided samples:

Table D-1 List of sample business processes

Sample business process Description Directory#1
Sample for reading XML data Reads data from a file in XML format and stores it in the database. read_xml
Sample for reading CSV data Reads data from a file in CSV format and stores it in the database. read_csv
Sample for reading fixed-length data#2 Reads data from a file in fixed-length format and stores it in the database. read_fix
Sample for writing XML data Writes database search results to a file in XML format. write_xml
Sample for writing CSV data Writes database search results to a file in CSV format. write_csv
Sample for writing length tag data#3 Writes database search results to a file in length tag data format. write_len

#1
The directory in which the files used by the sample business process are stored. These directories are located under service-platform-installation-directory\CSC\custom-adapter\File\sample.

#2
Because this sample can be used with the same setup as the sample for reading CSV data, it is not described in this manual.

#3
Because this sample business process can be used with the same setup as the sample business process for writing CSV data, it is not described in this manual.

(4) Prerequisites for sample business processes

The required knowledge for using sample business processes and the prerequisites for the system environment are as follows:

Required knowledge
You must have the following knowledge to work with sample business processes:
  • Knowledge of building SOA-based systems using Service Platform (Service Architect and Service Platform)
  • Fundamental knowledge of SQL and relational databases

Required environment
The following products must have been installed and set up:
  • Service Architect
  • Service Platform
  • HiRDB SQL Executer

The instructions in this appendix assume an environment that was built using the HCSC Easy Setup function. For details on the HCSC Easy Setup function, see 2.4 Easy Setup of the Test Environment in the manual Service Platform Basic Development Guide.

When using the HCSC Easy Setup function, be sure to select V7 compatible name in the HCSC Easy Setup window (Server Name tab).