Cosminexus V11 BPM/ESB基盤 サービスプラットフォーム ファーストステップガイド

手引・操作書

3021-3-J41-20

前書き

対象製品

マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」の前書きの対象製品の説明を参照してください。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，HiRDB，uCosminexusは，株式会社 日立製作所の商標または登録商標です。

Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。文中の社名，商品名等は各社の商標または登録商標である場合があります。

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

ランゲージパックの使用について

このマニュアルでは，Eclipse Babel Projectが提供するBABEL日本語ランゲージパックを適用したEclipseメニュー表記を使用しています。使用するランゲージパックのバージョンによっては，マニュアル内の表記と異なる場合があります。

発行

2021年 3月 3021-3-J41-20

著作権

All Rights Reserved. Copyright (C) 2020, 2021, Hitachi, Ltd.

変更内容

変更内容(3021-3-J41-20) uCosminexus Service Architect 11-10，uCosminexus Service Platform 11-10

追加・変更内容

変更個所

J2EEサーバの互換モードで，V9互換モードのほかに推奨モードを指定できるようにした。

1.2，3.4.1

HCSC-Definerの対応バージョンを11.1.0へ変更した。

3.3.2

サービスの配備と開始に関する手順を変更した。

4.1.2，6.2.3(2)，6.2.4，7.1.2

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルをお読みになる際の前提情報については，マニュアル「アプリケーションサーバ & BPM/ESB基盤 概説」のはじめにの説明を参照してください。

第1編　基本編

1　サンプルプログラムをご使用になる前に

この章では，このマニュアルの読み方，およびこのマニュアルで体験できる内容について説明します。

1.1　このマニュアルの読み方

このマニュアルは，実際にマシンを操作しながら，サービスプラットフォームの環境構築からサンプルプログラムを実行するまでの操作を体験するためのものです。

2章では，このマニュアルで紹介するサンプルプログラムの内容，およびサンプルプログラムの構成要素について説明しています。

3章では，サービスプラットフォームの開発・テスト環境を構築する手順について説明しています。

4章では，サンプルプログラムを実行するための準備について説明しています。

5章では，4章で準備したサンプルプログラムを実行するための手順を説明しています。

6章では，4章で使用したサンプルプログラムを，開発環境で作成する手順について説明しています。

7章では，3章および4章で準備したサービスプラットフォームの環境，およびサンプルプログラムの環境を削除する手順について説明しています。

それぞれの章は通読型となっていますので，マシンを操作しながら，順番に読み進めてください。

ポイント

画面や操作の説明で使用している記号について

マニュアルの画面や操作の説明で使用している記号を次に示します。

記号

意味

＜　　＞

＜＞内の名称がユーザの環境によって異なることを表します。

「　　」

入力値，可変値，またはメッセージなどのユーザが入力する内容を表します。

使用している構文要素記号について

マニュアルで使用している構文要素の種類と定義を次に示します。

種類

定義

英字

A〜Z　a〜z

英数字

A〜Z　a〜z　0〜9

文字列

任意の文字の配列

インストールディレクトリについて

サービスプラットフォームのデフォルトのインストールディレクトリは，「C:¥Program Files¥Hitachi¥Cosminexus」です。別のディレクトリにインストールする場合には，このマニュアルに記載されている「<サービスプラットフォームのインストールディレクトリ>」をご利用のディレクトリに読み替えてください。

Eclipseメニュー表記について

このマニュアルでは，Eclipse Babel Projectが提供するBABEL日本語ランゲージパックを前提としたEclipseメニュー表記を使用しています。

このため，使用するEclipseおよびランゲージパックのバージョンの差異によって，マニュアル内のメニュー表記が異なる場合があります。

1.2　このマニュアルで体験できること

このマニュアルでは，サンプルプログラムの環境設定および開発から実行までの操作を体験できます。なお，サンプルプログラムは，J2EEサーバのV9互換モードでしか使用できません。

それぞれの章で体験できることを次に示します。

3章で体験できること

サービスプラットフォームを使うための基本的な設定を体験できます。具体的には，製品のインストール，開発環境のセットアップ，およびテスト環境のセットアップです。この章で体験することは，一般的なシステム開発時の設定手順としても使用できます。

4章で体験できること

サンプルプログラムを動作させるための準備を体験できます。このマニュアルでは，サービスプラットフォームを利用したSOAPプロトコル連携のサンプルプログラムを紹介しています。この章では，サービスプラットフォームの要素（ビジネスプロセス・サービスアダプタ）の準備と，連携するSOAPサービスリクエスタ・サービス部品の準備を体験できます。

5章で体験できること

3章および4章で準備した環境を使用して，サンプルプログラムを実行する操作を体験できます。

6章で体験できること

手順どおりに操作を進めることで，サービスプラットフォームの開発環境を使用して，サンプルプログラムの開発から実行までの一連の流れを体験できます。

サンプルプログラムの開発の中では，ビジネスプロセス，サービスアダプタ，データ変換定義など，サービスプラットフォームを使用する上で基本的な機能の操作を体験できます。また，サービスプラットフォームが提供するデバッグ機能の操作を体験できます。

7章で体験できること

3章および4章で準備したプロジェクトの削除，テスト環境の停止，開発環境のアンセットアップ，および製品のアンインストールを体験できます。

2　サンプルプログラムの紹介

この章では，サンプルプログラムの概要について説明します。また，サンプルプログラムで学んでいただきたいこと，およびその目的についても説明します。

2.1　サービスプラットフォームを利用する一般的なシステム構成

サービスプラットフォームを利用する一般的なシステム構成について説明します。

サービスプラットフォームを利用する一般的なシステム構成を次の図に示します。HCSCコンポーネントはサービスリクエスタからの要求を受け取り，サービス部品を呼び出します。また，HCSCコンポーネントは，サービス部品の処理結果を利用し，サービスリクエスタへ応答を返します。

図2‒1　一般的なシステム構成

一般的なシステム構成要素が，それぞれどのような役割を果たしているのかを説明します。

サービスリクエスタ

サービスを呼び出すためのクライアントアプリケーションです。サービスプラットフォームを使用する場合，サービスリクエスタはHCSCサーバ上のHCSCコンポーネントへ要求（要求電文）を送ります。

HCSCコンポーネント

サービスリクエスタからの要求を受け取り，定義した業務の流れや条件に従って要求を受付，サービスを呼び出すためのものです。受付，ビジネスプロセス，サービスアダプタの総称です。

サービス部品

サービスプラットフォームで接続する連携先サービスのことです。

HCSCサーバ

ビジネスプロセスやサービスアダプタを管理するサーバ機能です。サービスプラットフォームの中にあります。

J2EEサーバ

J2EEアプリケーション（JSP，サーブレット，Enterprise Beanなどで構成されるアプリケーション）を実行するためのサーバ機能です。HCSCサーバを起動するのに必要です。

2.2　サンプルプログラムのシステム構成

サンプルプログラムのシステム構成について説明します。

サンプルプログラム名：商品手配サンプルプログラム

ビジネスプロセスからサービスアダプタを介して商品の在庫を引き当てたり，配送を手配したりするサービス部品を呼び出すサンプルプログラムです。このサンプルプログラムでは，実際の業務に近い内容での定義を習得することを目的にしています。

商品手配サンプルプログラムのシステム構成を次の図に示します。

図2‒2　商品手配サンプルプログラムのシステム構成

サンプルプログラムの構成要素が，それぞれどのような役割を果たしているのかを説明します。

サービスリクエスタ

ビジネスプロセスを呼び出すユーザ定義受付に対してサービスを呼び出す要求（要求電文）を送ります。このサンプルプログラムのサービスリクエスタは，JSP（JavaServer Pages）でWebページを生成し，SOAPプロトコルによって通信を行います。

ユーザ定義受付

サービスリクエスタからのサービス部品の要求電文を受け付け，ビジネスプロセスを呼び出すための機能（インターフェース）です。ユーザが任意のインターフェースを定義できます。このサンプルプログラムはユーザ定義受付のSOAP受付を使用します。

ビジネスプロセス

ビジネスプロセスは，複数のサービスの処理順序や処理条件などを定義し，一連の業務の流れとして定義したものです。このサンプルプログラムでは，サービス部品ごとに異なる電文フォーマットを変換したり，サービス部品からの応答によって処理を分岐したりしています。

サービスアダプタ

サービスアダプタは，ビジネスプロセスからの要求を受け付けて，サービス部品を呼び出すためのものです。このサンプルプログラムはSOAPプロトコルで通信を行うため，SOAPアダプタを使用します。

サービス部品

サービスアダプタから呼び出されるWebサービスです。SOAPプロトコルによって通信を行います。

注意事項

一般的なシステムの場合，サービスリクエスタ，サービス部品をデプロイ・実行するサーバとサービスプラットフォームのJ2EEサーバは異なる必要があります。

今回のサンプルプログラムでは便宜上，サービスリクエスタとサービス部品をサービスプラットフォームと同じJ2EEサーバ上でデプロイ・実行します。

2.3　サンプルプログラムの処理内容

サンプルプログラムを構成する各要素が，どのような処理を実行しているのかを説明します。

ここで紹介する商品手配のサンプルプログラムは，店舗の担当者が業務システムを使って商品の手配をする場合に，在庫引当や配送手配の処理をすることを想定しています。

商品手配サンプルプログラムの処理の詳細を次の図および表に示します。

図2‒3　商品手配サンプルプログラムの処理詳細

表2‒1　商品手配サンプルプログラムの処理内容

コンポーネント

形態

内容

サービスリクエスタ

JSP

サーブレット

入力画面を表示し，ProductStockビジネスプロセスを呼び出します。

在庫管理サービスを呼び出した結果を戻り値として取得し，出力画面に表示します。

配送受付サービスを呼び出した結果を戻り値として取得し，出力画面に表示します。

ProductStockビジネスプロセス

ビジネスプロセス

サービスリクエスタからの要求を受け取り，InventoryManagementアダプタを介して在庫管理サービスを呼び出します。

サービスリクエスタからの要求を受け取り，DeliveryReceiptアダプタを介して配送受付サービスを呼び出します。

在庫管理サービスを呼び出した結果をInventoryManagementアダプタを介して取得し，サービスリクエスタへ返します。

配送受付サービスを呼び出した結果をDeliveryReceiptアダプタを介して取得し，サービスリクエスタへ返します。

InventoryManagementアダプタ

サービスアダプタ

ProductStockビジネスプロセスからの要求を受け取り，在庫管理サービスを呼び出します。

在庫管理サービスの応答をProductStockビジネスプロセスへ返します。

DeliveryReceiptアダプタ

サービスアダプタ

ProductStockビジネスプロセスからの要求を受け取り，配送受付サービスを呼び出します。

配送受付サービスの応答をProductStockビジネスプロセスへ返します。

在庫管理サービス

サービス部品

ProductStockビジネスプロセスからの呼び出しに応答して商品の在庫を引き当て，ProductStockビジネスプロセスへ引当番号を返します。

配送受付サービス

サービス部品

ProductStockビジネスプロセスからの呼び出しに応答し，配送手配した結果の配送番号を返します。

3　サンプルプログラムの開発・テスト環境を構築する

この章では，サンプルプログラムの開発・テスト環境の構築について説明します。

3.1　サンプルプログラムの開発・テスト環境を構築する流れ

サンプルプログラムの開発・テスト環境を構築する手順を次の図に示します。

図3‒1　サンプルプログラムの開発・テスト環境を構築する手順

Service Architectのインストール

インストーラを使用して，Service Architectをインストールします。詳細については，「3.2　Service Architectのインストール」を参照してください。

Eclipseの準備

Eclipseをインストールして開発環境を構築します。Eclipseのインストールは，Service Architectが提供するEclipseセットアップ機能を利用します。詳細については，「3.3　Eclipseの準備」を参照してください。

テスト環境の構築

Service ArchitectのHCSC簡易セットアップ機能を利用し，テスト環境を構築します。詳細については，「3.4　テスト環境の構築」を参照してください。

開発環境とテスト環境の連動設定

テスト環境構築後のシステム構成を，開発環境に反映させる必要があります。詳細については，「3.5　開発環境とテスト環境の連動設定」を参照してください。

以降の節で，これらの手順について説明します。

3.2　Service Architectのインストール

Service Architectのインストール手順を次に示します。

注意事項

Service Architectをインストールする前に，すべてのWindowsアプリケーションを終了させておいてください。また，インストールは，Administrator権限が設定されたユーザが実施してください。

インストールCD-ROMを，CD-ROMドライブにセットします。

［日立総合インストーラ］ダイアログに，「選択されたソフトウェアをインストールします。」と表示されます。

［日立総合インストーラ］ダイアログが表示されない場合，エクスプローラを使用して，CD-ROMディレクトリの「HCD_INST.EXE」をダブルクリックしてください。

uCosminexus Service Architectを選択した状態で，［インストール実行］ボタンをクリックします。

［インストール処理開始の確認 − 日立総合インストーラ］ダイアログに，「インストールを開始します。よろしいですか？」と表示されます。

［OK］ボタンをクリックします。

［uCosminexus Service Architectセットアッププログラムへようこそ］ページが表示されます。

［次へ］ボタンをクリックします。

［インストール先の選択］ページが表示されます。

必要に応じてインストール先ディレクトリを選択して，［次へ］ボタンをクリックします。

ポイント

インストール先ディレクトリを指定する場合，半角英数字で50文字までのパス名を指定してください。

［機能の選択］ページが表示されます。

［標準 - このセットアップを推奨します。］の左にあるボタンをクリックします。

［ユーザ情報］ページが表示されます。

［ユーザ名］および［会社名］を入力して［次へ］ボタンをクリックします。

［プログラム フォルダの選択］ページが表示されます。

必要に応じてプログラムフォルダ名を変更して，［次へ］ボタンをクリックします。

［インストールの開始］ページが表示されます。

設定した内容を確認して，問題がなければ［次へ］ボタンをクリックします。

インストールが開始されます。インストールが完了すると，［セットアップの完了］ダイアログが表示されます。インストールは数分掛かる場合があります。

［完了］ボタンをクリックします。

OSを再起動するかどうかを確認する画面が表示されます。

［はい］ボタンをクリックします。

OSが再起動し，Service Architectのインストールが完了します。

これで，Service Architectはインストールされました。

3.3　Eclipseの準備

ここでは，Eclipseセットアップ機能を使用した開発環境の構築について説明します。また，JDKの確認やローカル変数情報の出力の設定も説明します。

3.3.1　Eclipseをインストールするための準備

Eclipseをインストールするための環境を準備します。Eclipseのアーカイブファイルを準備する手順を次に示します。

Eclipseのアーカイブファイルを入手します。

次に示すどれかのEclipseのアーカイブファイルをService Architectに同梱されている添付品またはEclipse.orgのダウンロードサイトから入手してください。

Eclipse IDE for Enterprise Java Developers 2019-09（eclipse-jee-2019-09-R-win32-x86_64.zip）

Eclipse IDE for Enterprise Java Developers 2019-12（eclipse-jee-2019-12-R-win32-x86_64.zip）

Eclipse IDE for Enterprise Java Developers 2020-03（eclipse-jee-2020-03-R-incubation-win32-x86_64.zip）

Eclipse IDE for Enterprise Java Developers 2020-06（eclipse-jee-2020-06-R-win32-x86_64.zip）

Eclipse IDE for Enterprise Java Developers 2020-09（eclipse-jee-2020-09-R-win32-x86_64.zip）

Eclipse IDE for Enterprise Java Developers 2020-12（eclipse-jee-2020-12-R-win32-x86_64.zip）

Eclipseのアーカイブファイルを格納します。

入手したEclipseのアーカイブファイルを次のディレクトリへ格納します。

<サービスプラットフォームのインストールディレクトリ>¥ADP¥archives

参考

添付品のEclipseランゲージパックをEclipseのアーカイブファイルと同じディレクトリに格納すると，Eclipseセットアップ時にEclipseを日本語化できます。

これで，Eclipseをインストールする準備ができました。

3.3.2　Eclipseセットアップ機能を使用した開発環境の構築

Eclipseセットアップ機能を使用して開発環境を構築します。開発環境を構築する手順を次に示します。この操作は，管理者または管理者特権で実行してください。

Windowsの［スタート］メニューから，［Cosminexus※］−［Eclipseセットアップ］を選択します。

Eclipseのアーカイブファイルを準備したかどうかを確認するダイアログが表示されます。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

確認ダイアログで，［了解］ボタンをクリックします。

［Eclipseのインストール］ページが表示されます。

［Eclipseのインストール］ページで，Eclipseのインストールディレクトリおよびアーカイブファイルディレクトリを指定して，［次へ］ボタンをクリックします。

［セットアップの確認］ページが表示されます。

［セットアップの確認］ページでセットアップ内容を確認して，［実行］ボタンをクリックします。

［進行状況］ページが表示され，セットアップが実行されます。セットアップが完了すると［セットアップの完了］ページが表示されます。

Eclipseセットアップは数分掛かる場合があります。

［セットアップの完了］ページで，［終了］ボタンをクリックします。

［セットアップ - Eclipseセットアップ］ダイアログが閉じて，Eclipseのセットアップが完了します。

デスクトップにEclipseのショートカットが生成されます。

これで，Eclipse環境が構築できました。

正しくセットアップされたことを確認します。この操作は，管理者または管理者特権で実行してください。

Eclipseを起動します。

Eclipseのメニューから，［ヘルプ］−［Eclipse IDEについて］−［インストール詳細］を選択し，［Eclipse IDEのインストール詳細］ダイアログを表示します。

HCSC-Definerのバージョン番号が「11.1.0」になっていることを確認します。

参考

セットアップログの確認方法

Eclipseセットアップ機能を実行したときのログは，Eclipseのセットアップログに出力されます。セットアップログの確認方法については，「付録B　Eclipseセットアップ機能実行時の情報の採取」を参照してください。

3.3.3　JDKの確認

Eclipse上で開発するときに使用するJDKがService Architectで提供されているJDKかどうかを確認します。確認手順を次に示します。

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインで［Java］−［インストール済みのJRE］を選択します。

右ペインに［インストール済みのJRE］ページが表示されます。

［インストール済みのJRE］がService Architectで提供されているJDKかどうかを確認します。

［ロケーション］に次のパスが表示されているかどうかを確認します。

<サービスプラットフォームのインストールディレクトリ>¥jdk

パスが表示されていない場合

［追加］ボタンをクリックします。［JREの型］ページが表示されます。

「標準VM」を選択し，［次へ］ボタンをクリックします。［JRE 定義］ページが表示されます。

［JREホーム］に「<サービスプラットフォームのインストールディレクトリ>¥jdk」を，［JRE名］に「jdk」を選択し，［終了］ボタンをクリックします。

設定後，［インストール済みのJRE］ページの［名前］にチェックを入れます。

パスが表示されている場合

［名前］にチェックが入っているかどうかを確認します。チェックが入っていない場合はチェックを入れてください。

特に，複数のJDKがインストールされている場合，<サービスプラットフォームのインストールディレクトリ>¥jdkにチェックが入っていないことがあります。チェックが入っていない場合は，チェックを入れてください。

［適用］ボタンまたは［適用して閉じる］ボタンをクリックします。

設定が保存されます。

3.3.4　ローカル変数情報の出力の設定

Eclipseのコンパイラーの設定によって，例外発生時にJ2EEアプリケーションが持つローカル変数の情報をスタックトレースに出力できます。

ローカル変数情報をスタックトレースに出力する場合のコンパイラーの設定手順を次に示します。

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインで［Java］−［コンパイラー］を選択します。

［コンパイラー］ページが表示されます。

次の項目を指定します。

項目名

設定値

クラス・ファイル生成

［生成されたクラス・ファイルに変数属性を追加（デバッガーによって使用される）］にチェックを入れます。

なお，それ以外の項目については，出力したい内容に合わせてチェックを入れてください。

必要に応じて，次の項目を指定してください。

項目名

設定値

JDK準拠

デフォルトの準拠設定の使用

コンパイラーに使用する設定を指定します。

チェックを入れる

［コンパイラー準拠レベル］で指定したレベルに沿った設定が適用されます。

チェックを入れない

次の項目を手動で指定します。

［生成された.classファイルの互換性］

［ソースの互換性］

［「assert」と呼ばれる識別子を許可しない］

［「enum」と呼ばれる識別子を許可しない］

［適用］ボタンまたは［適用して閉じる］ボタンをクリックします。

設定が保存されます。

3.4　テスト環境の構築

3.4.1　HCSC簡易セットアップ

テスト環境を構築するには，HCSC簡易セットアップ機能を使います。テスト環境の構築方法を次に示します。

Eclipseを起動している場合は，Eclipseを終了します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テスト環境セットアップ］を選択します。

HCSC簡易セットアップの画面の［メイン］ページが表示されます。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

［DBあり/RMなしモデル］ラジオボタンを選択します。

［V9互換モード］ラジオボタンを選択します。

［SOAP1.1/1.2併用モード］ラジオボタンを選択します。

［サーバ名称］タブをクリックします。

［サーバ名称］ページが表示されます。

［HCSC本番環境簡易セットアップ名称］ラジオボタンを選択します。

論理サーバおよびHCSCサーバの名称が次のように変更されます。

論理J2EE サーバ名称＝ J2EEServer

論理PRF 名称＝ PRF

クラスタ名称＝ Cluster

HCSC サーバ名称＝ HCSC

Manager 名称＝ Manager

［セットアップ］ボタンをクリックします。

テスト環境のセットアップが開始されます。セットアップの状況は，HCSC簡易セットアップ画面のコンソールに表示されます。コンソールに「HCSC簡易セットアップ機能のセットアップを終了します」と表示されたら，テスト環境のセットアップは正常に終了です。

注意事項

コンソールにエラーが表示され，テスト環境のセットアップが異常終了した場合，再セットアップする必要があります。異常終了したときに，HCSC簡易セットアップ画面の［セットアップ］ボタンが活性か，非活性かによって，再セットアップの手順が異なります。

［セットアップ］ボタンが活性の場合

［セットアップ］ボタンをクリックして，もう一度セットアップしてください。

［セットアップ］ボタンが非活性の場合

［アンセットアップ］ボタンをクリックして，アンセットアップします。そのあとで，もう一度セットアップしてください。

HCSC簡易セットアップ画面のメニューから［操作］−［終了］を選択し，HCSC簡易セットアップ画面を閉じます。

3.4.2　テスト環境の起動

構築したテスト環境を起動する方法を次に示します。

［スタート］メニューの［プログラム］から［HiRDBSingleServer_CS0］−［HiRDBコマンドプロンプト］を選択します。

HiRDBのコマンドプロンプトが開きます。

pdstartコマンドを実行し，テスト環境の組み込みデータベースを起動します。

pdstart

pdstartコマンドの実行後に出力される「KFPS05210-I HiRDB system initialization process complete」というメッセージは，組み込みデータベースが正常に起動したことを示します。

「KFPS01853-W Hostname=<ホスト名>, unable to execute pdstart command, unit state not OFFLINE」というメッセージが出力された場合は，すでに組み込みデータベースが起動していることを示します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テストサーバ起動］を選択して，テスト環境のPerformance Tracer，J2EEサーバ，および，標準受付とユーザ定義受付を含むHCSCサーバを起動します。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

注意事項

Service Architectの使用を終了する場合は，起動中のテスト環境を停止したあとにEclipseを終了します。テスト環境を停止する方法については，「7.2　テスト環境の停止」を参照してください。

3.5　開発環境とテスト環境の連動設定

3.5.1　開発環境のSOAPモードの設定

開発環境のSOAPモードは「3.4.1　HCSC簡易セットアップ」で設定したテスト環境のSOAPモードと一致させる必要があります。

開発環境のSOAPモードの設定方法を次に示します。

Eclipseのメニューから，［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

ダイアログ左側のツリービューで［HCSC-Definer］を選択します。

ダイアログ右側の［現在のSOAPモード］に使用しているSOAPモードが表示されます。現在のSOAPモードはSOAP1.1/1.2併用モードかどうかを確認してください。現在のSOAPモードがSOAP1.1モードの場合だけ以降の手順を実施してSOAPモードをSOAP1.1/1.2併用モードに設定してください。

Eclipseのメニューから［実行］−［外部ツール］−［外部ツールの構成］を選択します。

［外部ツール構成］ダイアログが表示されます。

左ペインの［プログラム］を右クリックし，［新規構成］を選択します。

［構成の作成、管理、および実行］ページが表示されます。

［メイン］タブを選択して，次の内容を入力します。

項目名

設定値

名前

任意の名称を指定します。

ここでは，「SOAPモードの設定」と指定します。

ロケーション

${env_var:COSMINEXUS_HOME}¥CSCTE¥bin¥cscsoapmode.bat

または［ファイル・システムの参照］ボタンから次のファイルを選択します。

<サービスプラットフォームのインストールディレクトリ>¥CSCTE¥bin¥cscsoapmode.bat

引数

both

［実行］ボタンをクリックします。

コマンドが登録，および実行され，コンソールビューに実行結果が表示されます。

Eclipseを再起動します。

3.5.2　HCSCTEプロジェクトの作成

開発環境でHCSCコンポーネントを作成・編集するためには，HCSCTEプロジェクトが必要となります。HCSCTEプロジェクトを作成する手順を次に示します。

注意事項

HCSCTEプロジェクトは，1つのプログラムにつき1つ作成してください。複数のプログラムを開発する場合，各プログラムのHCSCTEプロジェクトのワークスペースは分ける必要があります。同じワークスペースにHCSCTEプロジェクトを複数作成すると，プログラムが正しく動作しません。

メニューから［ファイル］−［新規］−［プロジェクト］を選択します。

［新規プロジェクト］ダイアログが表示されます。

［HCSCTEプロジェクト］を選択して，［次へ］ボタンをクリックします。

［HCSCTEプロジェクト］ダイアログ（HCSCTEプロジェクト新規作成のページ）が表示されます。

次の項目を設定して，［次へ］ボタンをクリックします。

プロジェクト名

任意の名称を指定します。ここでは「HCSCTE」とします。

デフォルト・ロケーションの使用

［デフォルト・ロケーションの使用］チェックボックスにチェックします。

［HCSCTEプロジェクト］ダイアログ（HCSCTEリポジトリ設定）が表示されます。

次の項目を設定して，［終了］ボタンをクリックします。

リポジトリディレクトリ

リポジトリ情報を格納する任意のディレクトリを指定します。ここでは，「C:¥work¥ProductStock¥repository」とします。リポジトリディレクトリを指定する場合は，次の点に注意してください。

リポジトリディレクトリのパスとプロジェクトのパスには，同じパスを指定しないでください。

パスは，絶対パスで指定してください。

パスの長さは，正規化された絶対パスでチェックされます。

ログインユーザ名

リポジトリログインに使用するユーザ名を指定します。ユーザ名に使用できる文字は半角英数字だけで，長さは1〜16文字になります。

「関連付けられたパースペクティブを開きますか？」というパースペクティブを切り替えるかどうかを確認するダイアログが表示された場合は，［はい］ボタンをクリックします。

HCSCTEのプロジェクトが作成され，HCSCTEのプロジェクトのパースペクティブが起動します。

3.5.3　テスト環境のシステム構成定義を開発環境に取り込むための設定

開発環境からテスト環境を操作するためには，テスト環境のリポジトリにあるシステム構成定義と開発環境のリポジトリにあるシステム構成定義を同一にする必要があります。

テスト環境のシステム構成定義を開発環境に取り込むための手順を次の図に示します。テスト環境の構築で作成されるシステム構成定義を含むリポジトリをエクスポートし，開発環境にインポートします。

(1)　テスト環境からのシステム構成定義のエクスポート

テスト環境のシステム構成定義を開発環境に取り込むため，テスト環境のリポジトリ情報をZIP形式のファイルとしてエクスポートします。エクスポートの手順を次に示します。

ポイント

システム構成定義にはHCSCコンポーネントの配備情報も含まれます。HCSCコンポーネントが配備されていない状態のテスト環境リポジトリを保存しておくため，テスト環境構築後に必ず1回のみ実行し，エクスポートしたファイルを退避しておいてください。

Eclipseのメニューから［ウィンドウ］−［パースペクティブを開く］−［その他］を選択します。

［パースペクティブを開く］ダイアログが表示されます。

［HCSCTE］を選択し，［開く］ボタンをクリックします。

［HCSCTE］パースペクティブが表示されます。

Eclipseのメニューから［実行］−［外部ツール］−［外部ツールの構成］を選択します。

［外部ツール構成］ダイアログが表示されます。

左ペインの［プログラム］を右クリックし，［新規構成］を選択します。

［構成の作成、管理、および実行］ページが表示されます。

［メイン］タブを選択して，次の内容を入力します。

項目名

設定値

名前

任意の名称を指定します。

ここでは，「システム構成定義の取得」と指定します。

ロケーション

${env_var:COSMINEXUS_HOME}¥CSC¥bin¥cscrepctl.bat

または［ファイル・システムの参照］ボタンから次のファイルを選択します。

<サービスプラットフォームのインストールディレクトリ>¥CSC¥bin¥cscrepctl.bat

作業ディレクトリー

引数で指定するファイルの出力先ディレクトリを任意で指定します。

引数

-export

<任意出力ファイル名>.zip

ここでは，「systemdef.zip」と指定します。

［実行］ボタンをクリックします。

コマンドが登録，および実行され，テスト環境のリポジトリ情報がZIP形式のファイルとして，指定した出力先ディレクトリにエクスポートされます。

(2)　開発環境へのシステム構成定義のインポート

エクスポートしたテスト環境のリポジトリ情報の中から，システム構成定義だけを開発環境のリポジトリにインポートします。インポートの手順を次に示します。

Eclipseのメニューから，［HCSC-Definer］−［定義情報管理］−［全定義情報インポート］を選択します。

リポジトリの上書きを確認するダイアログが表示されます。

［はい］ボタンをクリックします。

リポジトリ情報のZIPファイルを選択する［リポジトリインポート］ダイアログが表示されます。テスト環境からエクスポートした「systemdef.zip」のZIPファイルを指定します。

［開く］ボタンをクリックします。

インポート対象の定義情報を選択する［リポジトリインポート］ダイアログが表示されます。

［システム構成定義］のチェックボックスにチェックし，［OK］ボタンをクリックします。

テスト環境のシステム構成定義が取り込まれると，正常に完了したことを示すダイアログが表示されます。

［OK］ボタンをクリックします。

これで，サンプルプログラムの開発・テスト環境の構築ができました。

4　サンプルプログラムを実行する準備

この章では，サンプルプログラムを実行するための準備について説明します。

4.1　ビジネスプロセス・サービスアダプタを準備する

ビジネスプロセス・サービスアダプタはHCSCサーバ上で動作します。この節では，ビジネスプロセス・サービスアダプタの準備について説明します。

4.1.1　HCSCコンポーネントのインポート

サンプルプログラムで提供するHCSCコンポーネントをインポートします。HCSCコンポーネントは，リポジトリ情報（ZIPファイル）として提供されます。

［HCSC-Definer］−［定義情報管理］−［全定義情報インポート］を選択します。

リポジトリの上書きを確認するダイアログが表示されます。

［はい］ボタンをクリックします。

リポジトリ情報のZIPファイルを選択する［リポジトリインポート］ダイアログが表示されます。次のZIPファイルを選択してください。

<サービスプラットフォームのインストールディレクトリ>¥CSCTE¥Samples¥SOAP1.1_1.2mode¥ProductStock¥Repository¥ProductStock.zip

［開く］ボタンをクリックします。

インポート対象の定義情報を選択する［リポジトリインポート］ダイアログが表示されます。「3.5.3　テスト環境のシステム構成定義を開発環境に取り込むための設定」でテスト環境のシステム構成定義を開発環境に取り込んだため，リポジトリからは，サービス定義の情報のみ使います。そのため，［サービス定義］のチェックボックスのみをチェックして，［OK］ボタンをクリックします。

4.1.2　HCSCコンポーネントの配備と開始

HCSCコンポーネントをテスト環境に配備して，開始します。

ツリービューのサービス定義一覧で，サービス定義一覧またはHCSCコンポーネントを選択します。

選択したサービス定義一覧またはHCSCコンポーネントを右クリックして，［複数サービスをサーバに配備して開始］を選択します。

複数サービスをサーバに配備して開始ウィザードが表示されます。手順2に進んでください。

ログインしていない場合は，アカウント認証画面が表示されます。手順3を実施してください。

［ユーザID］に「admin」を，［パスワード］に「admin」を入力し，［OK］ボタンをクリックします。

サービス選択ページで配備および起動するサービスを選択します。

ここでは，すべてのサービスを選択してください。

［終了］ボタンをクリックします。

処理中であることを知らせるメッセージが表示されたあと，結果を知らせるメッセージが表示されます。

［OK］ボタンをクリックします。

これで配備と開始が完了しました。

4.1.3　HCSCコンポーネントの配備内容の確認

HCSCサーバに，HCSCコンポーネントが配備されていることと，起動していることを確認します。

メニューから［ウィンドウ］−［ビューの表示］−［その他］を選択します。

［ビューの表示］ダイアログが表示されます。

［ビューの表示］ダイアログで［HCSC-Manager］−［HCSC-Managerビュー］を選択し，［開く］ボタンをクリックします。

［HCSC-Manager］ビューが表示されます。

［HCSC-Manager］ビューの［HCSC-Manager(Logout)］を右クリックし，［ログイン］を選択します。

ログイン画面が表示されます。

［管理ユーザーID］に「admin」を，［パスワード］に「admin」を入力して，［OK］ボタンをクリックします。

HCSC-Managerへのログインが完了します。

HCSCコンポーネントが起動していることを確認します。

［HCSC-Manager］ビューの［HCSC-Manager(Login)］−［HCSC-Domain］−［Cluster(LBクラスタ)］−［HCSC[localhost:28099]］−［ProductStock］をダブルクリックして［基本情報］ページを表示させます。［稼働運用］タブをクリックして［稼働運用］ページを開きます。［稼働状態］が［開始状態］になっているかどうかを確認します。

上記と同じ手順で［DeliveryReceipt］アダプタと［InventoryManagement］アダプタの稼働状態を確認します。

［HCSC-Manager］ビューの［HCSC-Manager(Login)］を右クリックし，［ログアウト］を選択します。

HCSC-Managerからのログアウトを確認するメッセージが表示されます。

［OK］ボタンをクリックします。

HCSC-Managerからのログアウトが完了し，［HCSC-Manager(Logout)］と表示されます。

これで，ビジネスプロセス・サービスアダプタの準備ができました。

4.2　連携するSOAPサービスリクエスタ・サービス部品を準備する

連携するSOAPサービスリクエスタ・サービス部品はJ2EEサーバ上で動作します。この節では，Eclipseを使用してSOAPサービスリクエスタ・サービス部品をJ2EEサーバ上にデプロイし，実行する方法を説明します。

4.2.1　EclipseからJ2EEサーバを操作するための設定

(1)　Management Serverリモート管理機能へのログイン

Management Serverリモート管理機能へのログイン手順を次に示します。

Eclipseを起動します。

Eclipseのメニューから，［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインのツリービューで［サーバー］−［リモート管理］を選択します。

［リモート管理］ページが表示されます。

接続するManagement Serverのホスト（localhost）を選択し，［ログイン］ボタンをクリックします。

ログイン画面が表示されます。

［管理ユーザーID］に「admin」を，［パスワード］に「admin」を入力し，［OK］ボタンをクリックします。

Management Serverリモート管理機能に接続します。

［適用して閉じる］ボタンをクリックします。

(2)　サーバランタイムの作成

J2EEサーバを操作するために，サーバランタイムを作成します。サーバランタイムとはJ2EEサーバのインストール先などの環境情報です。作成手順を次に示します。

Eclipseのメニューから［ウィンドウ］−［設定］を選択します。

［設定］ダイアログが表示されます。

左ペインのツリービューから［サーバー］−［ランタイム環境］を選択します。

右ペインに［サーバー・ランタイム環境］ページが表示されます。

［追加］ボタンをクリックします。

［新規サーバー・ランタイム］ダイアログが表示されます。

ツリービューから［Cosminexus］−［Cosminexus J2EE V9互換モード］を選択します。

［次へ］ボタンをクリックします。

［J2EEサーバー・ランタイム］のダイアログが表示されます。

名前を「Cosminexus J2EE V9互換モード」に設定します。

注意事項

デフォルトで入力されている名前の末尾が空白である場合は，末尾の空白を削除してください。

［終了］ボタンをクリックします。

［サーバー・ランタイム環境］に「Cosminexus J2EE V9互換モード」が追加されたのを確認し，［適用して閉じる］ボタンをクリックします。

設定が保存されます。

(3)　J2EEサーバの選択

EclipseからJ2EEサーバを操作するための手順です。Eclipseから，ここで選択したJ2EEサーバの起動・停止を操作できます。また，J2EEアプリケーションのデプロイや起動・停止を操作できます。

設定手順を次に示します。

Eclipseのメニューから，［ファイル］−［新規］−［その他］を選択します。

［新規］ダイアログが表示されます。

［サーバー］−［サーバー］を選択して，［次へ］ボタンをクリックします。

［新規サーバー］ダイアログの［新規サーバーの定義］ページが表示されます。

次の項目を指定します。

項目名

設定値

サーバーのタイプを選択

［Cosminexus］−［J2EE サーバー V9互換モード］を選択します。

サーバー名

サーバ名は，［J2EE サーバー］ページの値が使用されるため，ここでは設定不要です。

サーバー・ランタイム環境

「Cosminexus J2EE V9互換モード」サーバランタイムを指定してください。

［次へ］ボタンをクリックします。

［J2EE サーバー］ページが表示されます。

リモート管理機能の接続ホストに，接続先のホストを選択します。接続ホストにログインしていない場合は［ログイン］ボタンをクリックします。

［管理ユーザーID］に「admin」を，［パスワード］に「admin」を入力し，［OK］ボタンをクリックします。

Management Serverリモート管理機能に接続します。接続先のJ2EEサーバが表示されます。

使用するJ2EEサーバ（J2EEServer）のチェックボックスにチェックを入れます。

［終了］ボタンをクリックします。

設定が保存されます。

4.2.2　Eclipseプロジェクトのインポート

連携するSOAPサービスリクエスタ・サービス部品はEclipseプロジェクトとしてインポートします。

Eclipseプロジェクトのインポート手順を説明します。

Eclipseのメニューから［ウィンドウ］−［パースペクティブを開く］−［その他］を選択します。

［パースペクティブを開く］ダイアログが表示されます。

［J2EE（デフォルト）］を選択し，［開く］ボタンをクリックします。

［J2EE］パースペクティブが表示されます。

メニューから［ファイル］−［インポート］を選択します。

選択画面が表示されます。

ツリービューから［一般］−［既存プロジェクトをワークスペースへ］を選択します。

［次へ］ボタンをクリックします。

プロジェクトのインポート画面が表示されます。

［ルート・ディレクトリーの選択］を選択し，［参照］ボタンをクリックします。

ファイルの参照画面が表示されます。

サンプルプログラムが格納されているディレクトリ（<サービスプラットフォームのインストールディレクトリ>CSCTE¥Samples¥SOAP1.1_1.2mode¥ProductStock）を選択し，［OK］ボタンをクリックします。

プロジェクトのインポート画面に戻ります。すべてのプロジェクトにチェックが入っていることを確認してください。

［プロジェクトをワークスペースにコピー］のチェックが入っていない場合は，チェックを入れます。

チェックを入れないと，サンプルプログラムが削除されるおそれがあります。必ずチェックを入れてください。

［終了］ボタンをクリックします。

パースペクティブに選択したプロジェクトがインポートされます。

注意事項1

インポート後にEclipseのプロジェクト・エクスプローラー上に［JSR-109 web services］プロジェクトが表示されることがあります。本サンプルプログラムでは使用しないため，次の手順で非表示にすることをお勧めします。

［プロジェクト・エクスプローラー］ビューのメニューを開き，［Filters and Customization］を選択します。

［Filters and Customization］ダイアログが表示されます。

［コンテンツ］タブを選択して，［JSR-109 web サービス・インデックス］のチェックを外します。

［JSR-109 web services］が非表示になります。

注意事項2

ArrangementClientWebプロジェクトのArrangementService.wsdlに警告が発生しますが，問題なくご利用いただけます。

4.2.3　Eclipseプロジェクトのデプロイ

Eclipseプロジェクトのデプロイの手順を説明します。

メニューから［ウィンドウ］−［パースペクティブを開く］−［その他］を選択します。

［パースペクティブを開く］ダイアログが表示されます。

［J2EE（デフォルト）］を選択し，［開く］ボタンをクリックします。

［J2EE］パースペクティブが表示されます。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［起動］を選択します。

「サーバー 'J2EEServer' が外部で実行中です。サーバー 'J2EEServer' を停止してください。」というエラーダイアログが表示されることがあります。この場合，［スタート］メニューの［プログラム］から［Cosminexus※］−［テストサーバ停止］を選択して，テスト環境のPerformance Tracer，J2EE サーバ，および，標準受付とユーザ定義受付を含むHCSC サーバを停止してください。そのあと，再度［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［起動］を選択します。

注※

プログラムフォルダ名を変更している場合，変更したプログラムフォルダから，選択してください。

ログイン画面が表示されます。

［管理ユーザーID］に「admin」を，［パスワード］に「admin」を入力し，［OK］ボタンをクリックします。

処理中であることを知らせるメッセージが表示されたあと，サーバが起動されます。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［追加と削除...］を選択します。

［追加と削除...］ダイアログが表示されます。

［使用可能］から［ArrangementClient］，［DeliveryService］および［InventoryManagementService］を選択し，［追加］ボタンをクリックします。

［ArrangementClient］，［DeliveryService］および［InventoryManagementService］が［使用可能］から［構成済み］へ移動します。

［終了］ボタンをクリックします。

処理終了後，［J2EE］パースペクティブに戻ります。［サーバー］ビューの［J2EEServer at localhost］の配下に［ArrangementClient］，［DeliveryService］および［InventoryManagementService］プロジェクトがあることを確認してください。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［停止］を選択します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テストサーバ起動］を選択して，テスト環境のPerformance Tracer，J2EEサーバ，および，標準受付とユーザ定義受付を含むHCSCサーバを起動します。

注※

プログラムフォルダ名を変更している場合，変更したプログラムフォルダから，選択してください。

これで，連携するSOAPサービスリクエスタ，サービス部品の準備ができました。

5　サンプルプログラムを実行する

この章では，サンプルプログラムの実行手順について説明します。

5.1　サンプルプログラムの実行

商品手配サンプルプログラムの動作手順を次に示します。

注意事項

サンプルプログラムを実行するときは，テスト環境が起動されている必要があります。テスト環境を起動する方法については，「3.4.2　テスト環境の起動」を参照してください。サンプルプログラムを実行しないときは，テスト環境を停止しておいてください。テスト環境を停止する方法については，「7.2　テスト環境の停止」を参照してください。

ブラウザから次に示すURLを入力します。

http://localhost/ArrangementClientWeb/index.html

商品手配サンプルプログラムが起動されます。

商品名と個数を選択します。

［Arrangement］ボタンをクリックします。

次のように表示されます。

正常に応答した場合（手配が完了した場合）

手配が完了したことを知らせるメッセージ，商品名，個数，および配送番号が表示されます。

正常に応答した場合（在庫がない場合）

在庫がないことを知らせるメッセージ，商品名，および個数が表示されます。

エラーが発生した場合

エラーの内容が表示されます。

5.2　商品在庫数の初期化方法

商品手配サンプルプログラムでの各商品の総在庫数は10個です。手配が完了すると，その個数分，在庫が減ります。在庫がなくなった場合は，J2EEサーバを再起動するか，またはEclipseプロジェクトをもう一度デプロイ（リデプロイ）してください。在庫数が10個に戻ります。J2EEサーバの再起動，およびEclipseプロジェクトをリデプロイする方法を次に示します。

J2EEサーバの再起動方法

Eclipseのメニューから［ウィンドウ］−［パースペクティブを開く］−［その他］を選択します。

［パースペクティブを開く］ダイアログが表示されます。

［J2EE（デフォルト）］を選択し，［開く］ボタンをクリックします。

［J2EE］パースペクティブが表示されます。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［起動］を選択します。

Eclipseプロジェクトのリデプロイ方法

Eclipseのメニューから［ウィンドウ］−［パースペクティブを開く］−［その他］を選択します。

［パースペクティブを開く］ダイアログが表示されます。

［J2EE（デフォルト）］を選択し，［開く］ボタンをクリックします。

［J2EE］パースペクティブが表示されます。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［追加と削除...］を選択します。

［追加と削除...］ダイアログが表示されます。

Eclipseプロジェクトをアンデプロイしたあと，デプロイします。アンデプロイの詳細については，「7.1.1(1)　Eclipseプロジェクトのアンデプロイ」を，デプロイの詳細については，「4.2.3　Eclipseプロジェクトのデプロイ」をそれぞれ参照してください。

第2編　開発編

6　システムの開発を体験する

この章では， 実際に用意されているサンプルプログラムを使って，サービスアダプタやビジネスプロセスを定義する方法について説明します。

6.1　商品手配システムの開発の手順

この章では，5章までで実行した製品が提供するサンプルのことを「サンプルプログラム」と呼び，この章で開発体験することで作成するものを「商品手配システム」と呼びます。商品手配システムの開発の手順を次の図に示します。

注意事項

下記の手順を行う前に，「3.2　Service Architectのインストール」と「3.3　Eclipseの準備」が実行済みである必要があります。

図6‒1　商品手配システムの開発の手順

テスト環境の構築

HCSC簡易セットアップ機能を使用してテスト環境を構築します。すでにテスト環境を構築している場合は，HCSC簡易セットアップの画面で一度アンセットアップしたあと，再度構築してください。詳細については，「3.4.1　HCSC簡易セットアップ」を参照してください。テスト環境の構築が終わりましたら，テスト環境を起動してください。詳細については，「3.4.2　テスト環境の起動」を参照してください。

開発環境とテスト環境の連動設定

開発環境のSOAPモードの設定とテスト環境のシステム構成定義を開発環境に取り込むための設定をします。詳細については，「3.5　開発環境とテスト環境の連動設定」を参照してください。

HCSCコンポーネントの作成

サービス部品を呼び出すサービスアダプタ，サービスアダプタを経由して複数のサービス部品を呼び出すビジネスプロセスなどのHCSCコンポーネントを作成します。詳細については，「6.2　商品手配システムの開発」を参照してください。また，作成したビジネスプロセスをデバッグする場合は，「6.3　ビジネスプロセスのデバッグ」を参照してください。

HCSCコンポーネントの配備と確認

HCSCコンポーネントをサーバに配備し，起動状態を確認します。詳細については，「4.1.2　HCSCコンポーネントの配備と開始」，「4.1.3　HCSCコンポーネントの配備内容の確認」を参照してください。

開発した商品手配システムを実行する準備

サンプルプログラムで提供するサービスリクエスタおよびサービス部品を利用することで，開発した商品手配システムの動作を確認できます。詳細については，「6.4　開発した商品手配システムを実行する準備」を参照してください。

以降の節で，これらの手順について説明します。

6.2　商品手配システムの開発

サンプルプログラムと同じ動作をする，商品手配システムを開発してみましょう。

商品手配システムでは，次に示す3つのコンポーネントを定義します。

InventoryManagementサービスアダプタ

DeliveryReceiptサービスアダプタ

ProductStockビジネスプロセス

6.2.1　InventoryManagementサービスアダプタの定義

InventoryManagementサービスアダプタは，在庫管理サービス用WSDL（InventoryManagementService.wsdl）を使用して定義します。InventoryManagementサービスアダプタを定義するときに設定する値を次の表に示します。

表6‒1　InventoryManagementサービスアダプタを定義するときに設定する値

項目名

設定する値

説明

サービス部品の種別

Webサービス

呼び出すサービス部品の種別に合わせて設定したサービスアダプタの種別です。サンプルプログラムのサービス部品はWebサービスのため，サービスアダプタの種別もWebサービスを設定します。

サービス名

InventoryManagement

サービスアダプタの名称を指定します。

WSDLファイル※

InventoryManagementService.wsdl

WSDLには，Webサービスがどのような機能を持ち，それを利用するためにはどのような要求をすればよいのか，などを記述する方法が定義されています。サービスアダプタは，在庫管理サービス用WSDL（InventoryManagementService.wsdl）を使用して作成します。

Portの指定

InventoryManager

InventoryManagementサービスアダプタのポートを指定します。

サービスID

InvAdp

InventoryManagementサービスアダプタのIDを指定します。

注※

各ファイルの格納場所については，「付録A　サンプルプログラムのファイルの構成」を参照してください。

InventoryManagementサービスアダプタの追加と定義手順を次に示します。

ツリービューの［サービス定義一覧］を選択し，右クリックして，［サービスアダプタ追加］を選択します。

追加するサービスアダプタから利用するサービス種別を設定するダイアログが表示されます。

ドロップダウンリストから「Webサービス」を選択して，［次へ］ボタンをクリックします。

SOAPアダプタの追加に必要な情報を入力するダイアログが表示されます。

サービス名に「InventoryManagement」を入力し，WSDLファイルには「InventoryManagementService.wsdl」を指定して，［次へ］ボタンをクリックします。

ポートを指定するダイアログが表示されます。

ドロップダウンリストからポート「InventoryManager」を選択して，［終了］ボタンをクリックします。

サービスアダプタ「InventoryManagementサービスアダプタ」が作成され，サービスアダプタ定義画面が表示されます。

サービスアダプタ定義（基本）画面で，サービスIDを「InvAdp」に変更します。

メニューから［ファイル］−［保管］を選択します。

6.2.2　DeliveryReceiptサービスアダプタの定義

DeliveryReceiptサービスアダプタは，配送受付サービス用WSDL（DeliveryService.wsdl）を使用して定義します。DeliveryReceiptサービスアダプタを定義するときに設定する値を次の表に示します。

表6‒2　DeliveryReceiptサービスアダプタを定義するときに設定する値

項目名

設定する値

説明

サービス部品の種別

Webサービス

呼び出すサービス部品の種別に合わせて設定したサービスアダプタの種別です。サンプルプログラムのサービス部品はWebサービスのため，サービスアダプタの種別もWebサービスを設定します。

サービス名

DeliveryReceipt

サービスアダプタの名称を指定します。

WSDLファイル※

DeliveryService.wsdl

WSDLには，Webサービスがどのような機能を持ち，それを利用するためにはどのような要求をすればよいのか，などを記述する方法が定義されています。DeliveryReceiptサービスアダプタは，配送受付サービス用WSDL（DeliveryService.wsdl）を使用して作成します。

Portの指定

Delivery

DeliveryReceiptサービスアダプタのポートを指定します。

サービスID

DelAdp

DeliveryReceiptサービスアダプタのIDを指定します。

注※

各ファイルの格納場所については，「付録A　サンプルプログラムのファイルの構成」を参照してください。

DeliveryReceiptサービスアダプタの追加と定義手順を次に示します。

ツリービューの［サービス定義一覧］を選択し，右クリックして，［サービスアダプタ追加］を選択します。

追加するサービスアダプタから利用するサービス種別を設定するダイアログが表示されます。

ドロップダウンリストから「Webサービス」を選択して，［次へ］ボタンをクリックします。

SOAPアダプタの追加に必要な情報を入力するダイアログが表示されます。

サービス名に「DeliveryReceipt」を入力し，WSDLファイルには「DeliveryService.wsdl」を指定して，［次へ］ボタンをクリックします。

ポートを指定するダイアログが表示されます。

ドロップダウンリストからポート「Delivery」を選択して，［終了］ボタンをクリックします。

サービスアダプタ「DeliveryReceiptサービスアダプタ」が作成され，サービスアダプタ定義画面が表示されます。

サービスアダプタ定義（基本）画面で，サービスIDを「DelAdp」に変更します。

メニューから［ファイル］−［保管］を選択します。

6.2.3　ProductStockビジネスプロセスの定義

商品手配システムのProductStockビジネスプロセスは，次のような処理を実現します。

ProductStockビジネスプロセスは，サービスリクエスタから入力された商品名と個数の情報を受け取ります。

InventoryManagementサービスアダプタを介して在庫管理サービスを呼び出します。

InventoryManagementサービスを呼び出した結果，在庫がない場合は，「*」（No Stock）をサービスリクエスタに返します。

在庫がある場合は，DeliveryReceiptサービスアダプタを介して配送受付サービスを呼び出し，配送番号を取得します。

サービスリクエスタに，取得した配送番号を返します。

また，商品手配システムのリクエスタにはサンプルプログラムと同じサービスリクエスタを使用します。そのため，ユーザ定義受付（SOAP受付）をビジネスプロセスに関連づけて定義して，サンプルプログラムと同様にSOAPプロトコルでリクエストを受付できるようにします。

商品手配システムのビジネスプロセスは，次の流れで定義します。

新規ビジネスプロセスを追加します。

ユーザ定義受付を追加します。

変数を設定します。

アクティビティを配置します。

アクティビティを定義します。

ビジネスプロセスの定義を終了します。

(1)　ビジネスプロセスの追加

ProductStockビジネスプロセスを追加するときに設定する値を次の表に示します。

表6‒3　ProductStockビジネスプロセスを追加するときに設定する値

項目名

設定する値

説明

ビジネスプロセス名

ProductStock

ビジネスプロセスの名称を指定します。

ステータスの永続化

yes

データベースに記録を残すかどうかを指定します。記録をとると，プロセスの進捗状況などを把握できます。この商品手配システムでは，データベースに記録を残すため，「yes」を選択します。

［BPELファイル］

チェックを外します

上流工程でツールを使って作成したBPELをインポートする場合は，チェックを入れます。インポートすると，ビジネスプロセスに必要なアクティビティが自動的に表示されます。この商品手配システムでは，インポートしないので，チェックを外します。

サービスID

ArrBP

ビジネスプロセスのIDを指定します。

ProductStockビジネスプロセスの追加手順を次に示します。

ツリービューの［サービス定義一覧］を選択し，右クリックして，［ビジネスプロセス追加］を選択します。

ビジネスプロセス定義を追加するためのダイアログが表示されます。

［ビジネスプロセス名］に「ProductStock」を入力し，［ステータスの永続化］で「yes」を選択します。［BPELファイル］の［インポートする］はチェックを外したままに設定してください。

［終了］ボタンをクリックします。

ビジネスプロセス「ProductStock」が作成され，ビジネスプロセス定義画面が表示されます。

ツリービューで「ProductStock」を選択します。

プロパティビューにProductStockのプロパティ一覧が表示されます。

プロパティビューで，サービスIDの値のセルをクリックします。

入力できる状態になります。

「ArrBP」に変更し，［Enter］キーを押します。

変更してよいかどうかを確認するメッセージが表示されるので，［OK］をクリックします。

(2)　ユーザ定義受付の追加

ユーザ定義受付では，サービスリクエスタとのインターフェースをあらかじめ決める必要があります。商品手配システムでは，WSDLファイルを利用してサービスリクエスタとユーザ定義受付とのインターフェースを定義します。ユーザ定義受付を追加するときに設定する値を次の表に示します。

表6‒4　ユーザ定義受付を追加するときに設定する値

項目名

設定する値

説明

受付種別

SOAP受付

受付種別を選択します。

受付名

サービス受付

ユーザ定義受付の名称を指定します。

WSDLファイル※

ArrangementService.wsdl

使用するWSDLファイル名を指定します。

ポート名

Arrangement

ポート名を指定します。

注※

各ファイルの格納場所については，「付録A　サンプルプログラムのファイルの構成」を参照してください。

ProductStockのユーザ定義受付の追加手順を次に示します。

ツリービューのサービス定義一覧からビジネスプロセス名［ProductStock］を選択し，右クリックして，［ユーザ定義受付（呼出先固定）追加］を選択します。

受付種別を選択するためのダイアログが表示されます。

［受付種別］のドロップダウンリストから，「SOAP受付」を選択します。

［次へ］ボタンをクリックします。

SOAP受付を追加するためのダイアログが表示されます。

受付名に「ServiceReceipt」を入力し，WSDLファイルに「ArrangementService.wsdl」を指定します。

［次へ］ボタンをクリックします。

ドロップダウンリストからポート「Arrangement」を選択して，［終了］ボタンをクリックします。

SOAP受付がビジネスプロセスに追加され，ユーザ定義受付定義画面が表示されます。

(3)　変数の設定

ビジネスプロセスでは，アクティビティを定義するときに変数を使用します。そのため，使用する変数をあらかじめ定義しておく必要があります。ProductStockビジネスプロセスで使用する変数を次の表に示します。

表6‒5　ProductStockビジネスプロセスで使用する変数

変数名

種別

InputData

XML

OutputData

XML

InventoryAllocationInputData

XML

InventoryAllocationOutputData

XML

DeliveryArrangementInputData

XML

DeliveryArrangementOutputData

XML

ProductStockビジネスプロセスで使用する変数の設定手順を次に示します。

ビジネスプロセス定義画面のキャンバス上の［変数・相関セット］アイコンをダブルクリックします。

［変数・相関セット一覧］ダイアログが表示されます。

［変数一覧］を選択します。変数名に「InputData」を入力し，種別は，ドロップダウンリストから「XML」を選択します。

［取込］ボタンをクリックします。

［電文フォーマットの取込］ダイアログが表示されます。

［受付名］を選択して，ドロップダウンリストから「ServiceReceipt」を選択します。

［オペレーション名］はドロップダウンリストから「arrangeItem」を，［電文種別］はドロップダウンリストから「要求電文（ボディ）」を選択します。［電文フォーマット］に「InputData」を入力します。

［OK］ボタンをクリックします。

［電文フォーマットの取込］ダイアログが閉じます。

［変数・相関セット一覧］ダイアログの［追加］ボタンをクリックします。

変数一覧に変数「InputData」が追加されます。

変数「OutputData」，「InventoryAllocationInputData」，「InventoryAllocationOutputData」，「DeliveryArrangementInputData」および「DeliveryArrangementOutputData」についても，手順2.〜7.と同様の手順で設定します。

設定値は次のとおりです。

［変数・相関セット一覧］ダイアログで設定する種別はすべて［XML］です。また，［電文フォーマットの取込］ダイアログでの設定値は次のとおりです。

項目名

変数名

OutputData

InventoryAllocationInputData

InventoryAllocationOutputData

DeliveryArrangementInputData

DeliveryArrangementOutputData

サービス/受付

受付名

サービス名

サービス名

サービス名

サービス名

サービス/受付の名称

ServiceReceipt

InventoryManagement

InventoryManagement

DeliveryReceipt

DeliveryReceipt

オペレーション名

arrangeItem

reserveItem

reserveItem

deliverItem

deliverItem

電文種別

応答電文（ボディ）

要求電文（ボディ）

応答電文（ボディ）

要求電文（ボディ）

応答電文（ボディ）

電文フォーマット

OutputData

InventoryAllocationInputData

InventoryAllocationOutputData

DeliveryArrangementInputData

DeliveryArrangementOutputData

［変数・相関セット一覧］ダイアログの［OK］ボタンをクリックします。

これで変数が設定できました。

(4)　アクティビティの配置

ProductStockビジネスプロセスに必要なアクティビティを次の表に示します。

表6‒6　ProductStockビジネスプロセスに必要なアクティビティ

設定する値

説明

受付アクティビティ

サービスリクエスタからの応答を受け付けます。

データ変換アクティビティ

入力時，出力時，在庫引当時，および配送手配時のデータを編集します。

サービス呼出アクティビティ

在庫管理サービスまたは配送受付サービスを呼び出します。

分岐開始アクティビティ

条件（在庫の有無）による処理をします。

応答アクティビティ

処理結果をサービスリクエスタへ返します。

分岐終了アクティビティ

条件（在庫の有無）による処理を終了します。

アクティビティの配置手順を次に示します。

パレットから［受付］をドラッグし，開始アクティビティの近くにドロップしてください。

開始アクティビティから受付アクティビティに連結されます。

手順1.と同様に，残りのアクティビティを配置・連結します。

次の図のフローになるよう，順番にパレットから連結元のアクティビティの近くにドロップしてください。

データ変換

サービス呼出

分岐開始

応答

分岐終了

ポイント

配置後に，分岐終了アクティビティを終了アクティビティの近くに移動することで，分岐終了アクティビティから終了アクティビティに連結できます。

アクティビティ配置時に連結できなかった場合は，次の手順で連結してください。

アクティビティを連結するために，パレットの［コネクション］をクリックします。

連結元である開始アクティビティをクリックします。

連結先である受付アクティビティをクリックします。

受付アクティビティから終了アクティビティまでを手順1.〜3.と同様の手順で1つずつ連結します。

(5)　アクティビティの定義

キャンバスへ配置した各アクティビティの内容を定義します。

(a)　受付アクティビティ

キャンバスの受付アクティビティ（受付1）をダブルクリックします。

［受付アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

Receive

アクティビティの名称を入力します。

オペレーション名

arrangeItem

サービスリクエスタから在庫管理サービスを呼び出すときに利用するオペレーションの名称を入力します。

ボディ割当変数

InputData

ビジネスプロセスの要求電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数

設定なし

ビジネスプロセスの要求電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

割当相関セット群

設定なし

相関セットグループをアクティビティに割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

通信モデル

同期

オペレーションの通信モデルを指定します。ProductStockは，各サービス部品の呼び出し結果から応答電文を作成するため，「同期」を設定します。

インスタンス生成

yes

要求電文を受け付けたときに，プロセスを初期化するかどうかを選択します。この商品手配システムでは，初期化するため「yes」を設定します。

［OK］ボタンをクリックします。

(b)　データ変換アクティビティ（在庫引当の前処理の場合）

キャンバスのデータ変換アクティビティ（データ変換1）をダブルクリックします。

［データ変換アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

StockAllocationPre-processing

アクティビティの名称を入力します。

変数（変換元変数）

InputData

データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。

変数（変換先変数）

InventoryAllocationInputData

データの変換先になる変数をドロップダウンリストから選択します。

データ変換定義

StockAllocationPre-processing

変数の変換に使うデータ変換定義ファイルの名称を入力します。

［OK］ボタンをクリックします。

キャンバスのデータ変換アクティビティを右クリックして，［マッピング定義起動］を選択します。

［ルート要素選択］ダイアログが表示されます。

変換元のスキーマ論理名「InputData」のルート要素をクリックして，ドロップダウンリストから「ars:arrangeItem」を選択します。

変換先のスキーマ論理名「InventoryAllocationInputData」のルート要素をクリックして，ドロップダウンリストから「ims:reserveItem」を選択します。

［OK］ボタンをクリックします。

データ変換定義画面が表示されます。

データ変換定義画面のパレットから［マッピング］を選択します。

マッピング元となる変換元ノードのノードアダプタをクリックします。

マッピング先となる変換先ノードのノードアダプタをクリックします。

マッピング線が設定されます。マッピング元のノードアダプタとマッピング先のノードアダプタとの対応は次のとおりです。

(c)　データ変換アクティビティ（在庫なしの場合）

キャンバスのデータ変換アクティビティ（データ変換2）をダブルクリックします。

［データ変換アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

NoStockArrangement

アクティビティの名称を入力します。

変数（変換元変数）

InventoryAllocationOutputData

データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。

変数（変換先変数）

OutputData

データの変換先になる変数をドロップダウンリストから選択します。

データ変換定義

NoStockArrangement

変数の変換に使うデータ変換定義ファイルの名称を入力します。

［OK］ボタンをクリックします。

キャンバスのデータ変換アクティビティを右クリックして，［マッピング定義起動］を選択します。

［ルート要素選択］ダイアログが表示されます。

変換元のスキーマ論理名「InventoryAllocationOutputData」のルート要素をクリックして，ドロップダウンリストから「ims:reserveItemResponse」を選択します。

変換先のスキーマ論理名「OutputData」のルート要素をクリックして，ドロップダウンリストから「ars:arrangeItemResponse」を選択します。

［OK］ボタンをクリックします。

データ変換定義画面が表示されます。

データ変換定義画面のパレットから［マッピング］を選択します。

マッピング元となる変換元ノードのノードアダプタをクリックします。

マッピング先となる変換先ノードのノードアダプタをクリックします。

マッピング線が設定されます。マッピング元のノードアダプタとマッピング先のノードアダプタとの対応は次のとおりです。

(d)　データ変換アクティビティ（配送手配の前処理の場合）

キャンバスのデータ変換アクティビティ（データ変換3）をダブルクリックします。

［データ変換アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

DeliveryArrangementPre-processing

アクティビティの名称を入力します。

変数（変換元変数）

InventoryAllocationOutputData

データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。

変数（変換先変数）

DeliveryArrangementInputData

データの変換先になる変数をドロップダウンリストから選択します。

データ変換定義

DeliveryArrangementPre-processing

変数の変換に使うデータ変換定義ファイルの名称を入力します。

［OK］ボタンをクリックします。

キャンバスのデータ変換アクティビティを右クリックして，［マッピング定義起動］を選択します。

［ルート要素選択］ダイアログが表示されます。

変換元のスキーマ論理名「InventoryAllocationOutputData」のルート要素をクリックして，ドロップダウンリストから「ims:reserveItemResponse」を選択します。

変換先のスキーマ論理名「DeliveryArrangementInputData」のルート要素をクリックして，ドロップダウンリストから「dls:deliverItem」を選択します。

［OK］ボタンをクリックします。

データ変換定義画面が表示されます。

データ変換定義画面のパレットから［マッピング］を選択します。

マッピング元となる変換元ノードのノードアダプタをクリックします。

マッピング先となる変換先ノードのノードアダプタをクリックします。

マッピング線が設定されます。マッピング元のノードアダプタとマッピング先のノードアダプタとの対応は次のとおりです。

(e)　データ変換アクティビティ（配送番号の設定の場合）

キャンバスのデータ変換アクティビティ（データ変換4）をダブルクリックします。

［データ変換アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

DeliveryNumberArrangement

アクティビティの名称を入力します。

変数（変換元変数）

DeliveryArrangementOutputData

データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。

変数（変換先変数）

OutputData

データの変換先になる変数をドロップダウンリストから選択します。

データ変換定義

DeliveryNumberArrangement

変数の変換に使うデータ変換定義ファイルの名称を入力します。

［OK］ボタンをクリックします。

キャンバスのデータ変換アクティビティを右クリックして，［マッピング定義起動］を選択します。

［ルート要素選択］ダイアログが表示されます。

変換元のスキーマ論理名「DeliveryArrangementOutputData」のルート要素をクリックして，ドロップダウンリストから「dls:deliverItemResponse」を選択します。

変換先のスキーマ論理名「OutputData」のルート要素をクリックして，ドロップダウンリストから「ars:arrangeItemResponse」を選択します。

［OK］ボタンをクリックします。

データ変換定義画面が表示されます。

データ変換定義画面のパレットから［マッピング］を選択します。

マッピング元となる変換元ノードのノードアダプタをクリックします。

マッピング先となる変換先ノードのノードアダプタをクリックします。

マッピング線が設定されます。マッピング元のノードアダプタとマッピング先のノードアダプタとの対応は次のとおりです。

(f)　サービス呼出アクティビティ（在庫を引き当てる場合）

キャンバスのサービス呼出アクティビティ（サービス呼出1）をダブルクリックします。

［サービス呼出アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

StockAllocation

アクティビティの名称を入力します。

サービス名

InventoryManagement

要求電文を送信して呼び出すサービス部品の名称をドロップダウンリストから選択します。

オペレーション名

reserveItem

［サービス名］で指定したサービス部品（在庫管理）のオペレーションのうち，実際に呼び出すオペレーションの名称を指定します。

通信モデル

同期

［オペレーション名］で指定したオペレーションに設定されている通信モデルが表示されます。

ボディ割当変数（要求電文）

InventoryAllocationInputData

在庫管理サービスを呼び出す要求電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数（要求電文）

設定なし

在庫管理サービスを呼び出す要求電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

ボディ割当変数（応答電文）

InventoryAllocationOutputData

同期オペレーションから受け取る応答電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数（応答電文）

設定なし

同期オペレーションから受け取る応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

割当相関セット群

設定なし

相関セットグループをアクティビティに割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

［OK］ボタンをクリックします。

(g)　サービス呼出アクティビティ（配送を手配する場合）

キャンバスのサービス呼出アクティビティ（サービス呼出2）をダブルクリックします。

［サービス呼出アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

DeliveryArrangement

アクティビティの名称を入力します。

サービス名

DeliveryReceipt

要求電文を送信して呼び出すサービス部品の名称をドロップダウンリストから選択します。

オペレーション名

deliverItem

［サービス名］で指定したサービス部品（配送手配）のオペレーションのうち，実際に呼び出すオペレーションの名称を指定します。

通信モデル

同期

［オペレーション名］で指定したオペレーションに設定されている通信モデルが表示されます。

ボディ割当変数（要求電文）

DeliveryArrangementInputData

配送手配サービスを呼び出す要求電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数（要求電文）

設定なし

配送手配サービスを呼び出す要求電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

ボディ割当変数（応答電文）

DeliveryArrangementOutputData

同期オペレーションから受け取る応答電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数（応答電文）

設定なし

同期オペレーションから受け取る応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

割当相関セット群

設定なし

相関セットグループをアクティビティに割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

［OK］ボタンをクリックします。

(h)　応答アクティビティ（在庫がない場合）

キャンバスの応答アクティビティ（応答1）をダブルクリックします。

［応答アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

Reply_NostockError

アクティビティの名称を入力します。

オペレーション名

arrangeItem

対応する受付アクティビティに指定したオペレーション名を入力します。

ボディ割当変数

OutputData

ビジネスプロセスの応答電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数

設定なし

ビジネスプロセスの応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

割当相関セット群

設定なし

相関セットグループをアクティビティに割り当てる場合に入力します。この商品手配システムでは使用しないため，設定しません。

フォルト名

設定なし

フォルト処理として応答アクティビティを定義して，サービスリクエスタにフォルトが発生したことを示す応答電文を送信する場合のフォルトの名称を入力します。この商品手配システムではフォルト処理を使用しないため，設定しません。

［OK］ボタンをクリックします。

(i)　応答アクティビティ（配送手配が成功した場合）

キャンバスの応答アクティビティ（応答2）をダブルクリックします。

［応答アクティビティ］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

アクティビティ名

Reply_ArrangementSuccess

アクティビティの名称を入力します。

オペレーション名

arrangeItem

対応する受付アクティビティに指定したオペレーション名を入力します。

ボディ割当変数

OutputData

ビジネスプロセスの応答電文のボディに割り当てる変数をドロップダウンリストから選択します。

ヘッダ割当変数

設定なし

ビジネスプロセスの応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

割当相関セット群

設定なし

相関セットグループをアクティビティに割り当てる場合に入力します。この商品手配システムでは使用しないため，設定しません。

フォルト名

設定なし

フォルト処理として応答アクティビティを定義して，サービスリクエスタにフォルトが発生したことを示す応答電文を送信する場合のフォルトの名称を入力します。この商品手配システムではフォルト処理を使用しないため，設定しません。

［OK］ボタンをクリックします。

(j)　分岐開始アクティビティ

キャンバスの分岐開始アクティビティ（分岐開始1）をダブルクリックします。

［分岐アクティビティ］ダイアログが表示されます。

アクティビティ名に「StockAllocationResultCheck」を入力します。

［遷移先］が［NoStockArrangement］の行をクリックし，［上へ］ボタンをクリックして，いちばん上の行に移動します。

いちばん上の行を選択し，［条件設定］ボタンをクリックします。

［条件設定］ダイアログが表示されます。

次の内容を入力します。

項目名

設定する値

説明

条件名

No Stock

在庫引当チェックの結果，在庫がない場合の条件を指定します。

変数

InventoryAllocationOutputData

条件式で使用する変数をドロップダウンリストから選択します。

条件式※

csc:getVariableData("InventoryAllocationOutputData", "/*[local-name()='reserveItemResponse' and namespace-uri()='http://sample/InventoryManagementService']/*[local-name()='ReservationNumber' and namespace-uri()='http://sample/InventoryManagementService']")="*"

在庫がない場合の条件式をXPath式で指定します。

注※

「条件式」の「設定する値」はテキストボックスの幅で折り返して表示されます。

［OK］ボタンをクリックします。

［分岐アクティビティ］ダイアログに戻ります。

［遷移先］が［DeliveryArrangementPre-processing］の［優先順位］をクリックし，ドロップダウンリストから「Default」を選択します。

「Default」を選択すると，条件の設定は不要になります。

［OK］ボタンをクリックします。

(k)　分岐終了アクティビティ

キャンバスの分岐終了アクティビティ（分岐終了1）をクリックします。

プロパティビューに，分岐終了アクティビティの内容が表示されます。

アクティビティ名に，「StockAllocationResultCheckEnd」を入力します。

すべてのアクティビティを定義したら，メニューから［ファイル］−［保管］を選択して，ビジネスプロセスの定義を終了します。

6.2.4　コンポーネントの検証とパッケージング

作成したコンポーネントは定義した内容が正しいかどうか検証してからパッケージングします。

ProductStockビジネスプロセスの検証とパッケージングの手順を次に示します。

ツリービューの［ProductStock］を選択し，右クリックして，［検証］を選択します。

検証結果がコンソールビューに表示されます。エラーが発生した場合は，メッセージに従って修正します。

ツリービューの［ProductStock］を選択し，右クリックして，［パッケージング］を選択します。

パッケージングの処理が開始されます。処理終了後，結果を知らせるメッセージが表示されます。

次のどちらかの操作を実行します。

パッケージングが成功した場合は，［OK］ボタンをクリックします。

パッケージングが失敗した場合は，メッセージに従って対処し，パッケージングを再実行します。

ツリービューの［DeliveryReceipt］サービスアダプタ，および［InventoryManagement］サービスアダプタに対して，1〜3の手順に従って，検証・パッケージングしてください。

6.3　ビジネスプロセスのデバッグ

「6.2.3　ProductStockビジネスプロセスの定義」で定義したビジネスプロセスをデバッグして，ビジネスプロセスの処理の流れを確認してみましょう。

ビジネスプロセスをデバッグするためには，サービスリクエスタが必要となります。今回は，サンプルプログラムで提供するサービスリクエスタを使用します。

「6.3.1　サンプルプログラムが提供するサービス部品を利用するデバッグ」では，サンプルプログラムが提供するサービス部品を利用するデバッグについて説明します。サービス部品を使用せずに，サービスのエミュレーションの機能を使ってデバッグする場合は，「6.3.2　サービスのエミュレーション機能を利用する場合」を参照してください。

6.3.1　サンプルプログラムが提供するサービス部品を利用するデバッグ

サンプルプログラムが提供するサービス部品を利用する場合，ビジネスプロセスのデバッグの流れを次に示します。

アクティビティにブレークポイントを設定します。

サービスリクエスタ・サービス部品をデプロイします。

HCSCサーバを起動します。

デバッガを起動します。

サービスリクエスタからリクエストを送信し，ビジネスプロセスの処理を開始します。

アクティビティごとにデバッグを実行します。

ビジネスプロセスのデバッグを終了します。

(1)　ブレークポイントの設定

ビジネスプロセスの処理を中断するアクティビティにブレークポイントを設定します。

ここでは，サービス呼出アクティビティ（StockAllocation）にブレークポイントを設定します。

ブレークポイントを設定する手順を次に示します。

ビジネスプロセス定義画面のキャンバスでサービス呼出アクティビティ（StockAllocation）を右クリックし，［ブレークポイントの追加］を選択します。

アクティビティにブレークポイントが追加されます。次の図のように，アクティビティの横にブレークポイントを表すチェックが付きます。

(2)　サービスリクエスタ・サービス部品のデプロイ

リクエストの送信およびサービス部品の呼び出しのために，商品手配サンプルプログラムのEclipseプロジェクトをインポートしたあと，サービスリクエスタ・サービス部品をJ2EEサーバにデプロイします。

サービスリクエスタ・サービス部品をデプロイする手順を次に示します。

HCSCサーバを停止します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テストサーバ停止］を選択して，テスト環境のPerformance Tracer，J2EEサーバ，および，標準受付とユーザ定義受付を含むHCSCサーバを停止します。

注※

プログラムフォルダ名を変更している場合，変更したプログラムフォルダから選択してください。

Eclipseのメニューから［ウィンドウ］−［パースペクティブを開く］−［その他］を選択します。

［パースペクティブを開く］ダイアログが表示されます。

［J2EE（デフォルト）］を選択し，［開く］ボタンをクリックします。

［J2EE］パースペクティブが表示されます。

メニューから［ファイル］−［インポート］を選択します。

選択画面が表示されます。

ツリービューから［一般］−［既存プロジェクトをワークスペースへ］を選択します。

［次へ］ボタンをクリックします。

プロジェクトのインポート画面が表示されます。

［ルート・ディレクトリーの選択］を選択し，［参照］ボタンをクリックします。

ファイルの参照画面が表示されます。

サンプルプログラムが格納されているディレクトリ（<サービスプラットフォームのインストールディレクトリ>CSCTE¥Samples¥SOAP1.1_1.2mode¥ProductStock）を選択し，［OK］ボタンをクリックします。

プロジェクトのインポート画面に戻ります。すべてのプロジェクトにチェックが入っていることを確認してください。

［プロジェクトをワークスペースにコピー］のチェックが入っていない場合は，チェックを入れます。

チェックを入れないと，サンプルプログラムが削除されるおそれがあります。必ずチェックを入れてください。

［終了］ボタンをクリックします。

パースペクティブに選択したプロジェクトがインポートされます。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［デバッグ］を選択します。

処理中であることを知らせるメッセージが表示されたあと，J2EEサーバが起動されます。J2EEサーバが表示されていない場合は，「4.2.1(3)　J2EEサーバの選択」を参照してください。

［サーバー］ビューの［J2EEServer at localhost］サーバを右クリックし，［追加と削除...］を選択します。

［追加と削除...］ダイアログが表示されます。

［使用可能］から［ArrangementClient］，［DeliveryService］，および［InventoryManagementService］を選択し，［追加］ボタンをクリックします。

［終了］ボタンをクリックします。

処理中であることを知らせるメッセージが表示されます。処理終了後，［J2EE］パースペクティブに戻ります。

設定が終わったら，［サーバー］ビューの［J2EEServer at localhost］の配下に［ArrangementClient］，［DeliveryService］，および［InventoryManagementService］プロジェクトがあることを確認してください。

(3)　HCSCサーバの起動

デバッガを起動する前に，HCSCサーバを起動します。

HCSCサーバを起動します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テストサーバ起動］を選択して，テスト環境のPerformance Tracer，J2EEサーバ，および，標準受付とユーザ定義受付を含むHCSCサーバを起動します。

注※

プログラムフォルダ名を変更している場合，変更したプログラムフォルダから，選択してください。

(4)　デバッガの起動

デバッガを起動する手順を次に示します。

Eclipseのメニューから［実行］−［デバッグの構成］を選択します。

［デバッグ構成］ダイアログが表示されます。

［デバッグ構成］ダイアログのメニューから［HCSC-BP］を右クリックし，［新規］を選択します。

［名前］に任意の名称を入力し，［デバッグ対象］は，ドロップダウンリストから「ProductStock」を選択します。

［デバッグ］ボタンをクリックします。

アカウント認証画面が表示されます。

［ユーザID］に「admin」，［パスワード］に「admin」を入力して，［OK］ボタンをクリックします。

処理中であることを知らせるメッセージが表示されます。2回目以降にデバッガを起動するときは，アカウント認証画面は表示されないで，すぐに処理が開始されます。

［OK］ボタンをクリックします。

デバッガが起動されます。

(5)　リクエストの送信

サービスリクエスタからリクエストを送信して，ビジネスプロセスの処理を開始します。

リクエストを送信する手順を次に示します。

ブラウザから次に示すURLを入力します。

http://localhost/ArrangementClientWeb/index.html

商品手配サンプルプログラムの実行画面が起動されます。

商品名と個数を選択します。

［Arrangement］ボタンをクリックします。

Eclipseにパースペクティブを切り替えるかどうかを確認するダイアログが表示されます。

［はい］ボタンをクリックします。

デバッグ情報や変数を表示するビューが開き，ビジネスプロセスの処理が開始されます。サービス呼出アクティビティ（StockAllocation）でビジネスプロセスの処理が中断されます。ビジネスプロセス定義画面のキャンバスのアクティビティに，次のように中断していることを表す色が付きます。

(6)　ビジネスプロセスのデバッグの実行

ビジネスプロセスの処理が中断している状態では，次に示す画面でデバッグを実行できます。

図6‒2　ビジネスプロセスのデバッグ画面

ビジネスプロセスのデバッグで実行できる項目を次の表に示します。

表6‒7　ビジネスプロセスのデバッグで実行できる項目

項目

説明

変数・相関セットの確認

ビジネスプロセスで現在使用している変数，および相関セットを確認できます。

変数の更新

ビジネスプロセスで現在使用している変数の値を更新できます。

ステップ実行および再開

［デバッグ］ビューでは次の操作を実行できます。これらの操作によって，アクティビティごとにデバッグを実行してください。

ステップイン（[図データ]）

次のアクティビティに進みます。分岐開始アクティビティで実行した場合は，分岐先で最初に処理されるアクティビティに進みます。

ステップオーバー（[図データ]）

分岐開始アクティビティで実行した場合は，分岐終了アクティビティまでをまとめて処理します。分岐開始アクティビティ以外で実行した場合は，ステップインと同じ動作になります。

ステップリターン（[図データ]）

スコープアクティビティおよび繰り返しアクティビティの内部のアクティビティで実行した場合は，所属するアクティビティの次のアクティビティまで処理します。

再開（[図データ]）

次にブレークポイントを設定しているアクティビティまで，ビジネスプロセスの処理を再開します。

サービスのエミュレーション

作成済みの応答電文を利用することで，サービスをエミュレーションできます。

サービスをエミュレーションする手順については，「6.3.2　サービスのエミュレーション機能を利用する場合」を参照してください。

(7)　ビジネスプロセスのデバッグの終了

ビジネスプロセスの処理の流れを確認したら，ビジネスプロセスのデバッグを終了します。

ビジネスプロセスのデバッグを終了する手順を次に示します。

［デバッグ］ビューで「ProductStock」を選択し，［終了］アイコンをクリックします。

ビジネスプロセスのデバッグが終了します。

6.3.2　サービスのエミュレーション機能を利用する場合

サービスのエミュレーション機能では，あらかじめサービスの応答電文を作成しておき，HCSC エミュレートビューに設定することで，実際のサービスを呼び出す代わりとすることができます。この機能によって，サービス呼出アクティビティに設定したサービス部品がなくても，ビジネスプロセスのデバッグ処理を進められます。

参考

cscgenbinaryコマンドでバイナリ電文を作成し，応答電文として使用できます。cscgenbinaryコマンドについては，マニュアル「サービスプラットフォーム リファレンス」の「cscgenbinary（バイナリフォーマット定義ファイルからバイナリ電文の生成）」を参照してください。

サービスのエミュレーションは，ビジネスプロセスの処理が中断しているときに設定できます。ここでは，「6.3.1(5)　リクエストの送信」までの手順を完了し，サービス呼出アクティビティ（StockAllocation）でビジネスプロセスの処理が中断しているものとして，「StockAllocation」サービスをエミュレーションする手順について説明します。

「StockAllocation」サービスをエミュレーションする手順を次に示します。

XMLファイルを作成します。

HCSC エミュレートビューを表示します。

作成したXMLファイルを利用してサービスのエミュレーションを実行します。

サービスのエミュレーションを実行する前に，デバッガを起動して，サービスリクエスタからリクエストを送信しておく必要があります。

(1)　XMLファイルの作成

サービスの応答として利用するXMLファイルを作成します。

XMLファイルを作成する手順を次に示します。

Eclipseのメニューから，［ファイル］−［新規］−［その他］を選択し，表示されるダイアログで［一般］−［ファイル］を選択します。

［新規ファイル］ダイアログが表示されます。

［新規ファイル］ダイアログでXMLファイルを保管するディレクトリを選択します。

［ファイル名］に任意のファイル名（拡張子：.xml）を入力します。

［終了］ボタンをクリックします。

XMLエディタが表示されます。

XMLエディタの［ソース］タブをクリックし，次のように入力します（△は半角の空白です）。

<?xml△version="1.0"△encoding="UTF-8"?><reserveItemResponse△xmlns="http://sample/InventoryManagementService"△><ReservationNumber>R00000001</ReservationNumber></reserveItemResponse>

メニューから［ファイル］−［保管］を選択します。

XMLファイルが保存されます。

(2)　HCSC エミュレートビューの表示

サービスのエミュレーションはHCSC エミュレートビューで実行できます。

HCSC エミュレートビューを表示する手順を次に示します。

Eclipseのメニューから，［ウィンドウ］−［ビューの表示］−［その他］を選択します。

［ビューの表示］ダイアログが表示されます。

［デバッグ］−［HCSC エミュレート］を選択し，［開く］ボタンをクリックします。

HCSC エミュレートビューが表示されます。

(3)　サービスのエミュレーションの実行

作成したXMLファイルを利用して，HCSC エミュレートビューでサービスのエミュレーションを実行します。

サービスのエミュレーションの実行手順を次に示します。

［デバッグ］ビューでStockAllocation（サービス呼出アクティビティ）を選択します。

HCSC エミュレートビューの［追加］ボタンをクリックします。

HCSC エミュレートビューのテーブルに行が追加されます。

応答種別のセルを選択し，通常応答を選択します。

応答電文のセルを選択し，［...］ボタンをクリックします。

［ファイル選択］ダイアログが表示されます。

作成したXMLファイルを選択し，［OK］ボタンをクリックします。

［ステップ実行］ボタンをクリックします。

サービス呼出アクティビティ（StockAllocation）からの応答がエミュレーションされます。

ビジネスプロセスの処理が分岐開始アクティビティ（StockAllocationResultCheck）に進みます。

以降のアクティビティへ進むには，［デバッグ］ビューを操作してください。詳細は，「6.3.1(6)　ビジネスプロセスのデバッグの実行」を参照してください。

6.4　開発した商品手配システムを実行する準備

サンプルプログラムで提供するサービスリクエスタおよびサービス部品を利用することで，開発した商品手配システムの動作を確認できます。

サンプルプログラムの動作を確認する場合は，「4.2　連携するSOAPサービスリクエスタ・サービス部品を準備する」の手順を実施したあと，「5.　サンプルプログラムを実行する」の手順に従ってサンプルプログラムを実行してください。

注意事項

サンプルプログラムで提供するサービスリクエスタおよびサービス部品を利用しない場合は，サービスリクエスタおよびサービス部品を作成して確認することもできます。サービスリクエスタの作成方法はマニュアル「サービスプラットフォーム 開発ガイド 基本開発編」を，サービス部品の作成方法はマニュアル「アプリケーションサーバ アプリケーション開発ガイド」を参照してください。

7　サンプルプログラムの環境を削除する

この章では，サンプルプログラムの環境の削除手順について説明します。

7.1　プロジェクトの削除

サンプルプログラムの削除の手順について説明します。なお，サンプルプログラムをすべて削除したあとに，同じサンプルプログラムを動かす場合は，「4.　サンプルプログラムを実行する準備」からやり直してください。

プロジェクトの削除の流れを次の図に示します。

図7‒1　プロジェクトの削除の流れ

それぞれの作業の概要を説明します。プロジェクトの削除を実施する前にEclipseを起動しておいてください。

Eclipseプロジェクトのアンデプロイと削除

「4.2.3　Eclipseプロジェクトのデプロイ」でデプロイしたEclipseプロジェクトをアンデプロイします。そのあと，「4.2.2　Eclipseプロジェクトのインポート」でインポートしたEclipseプロジェクトを削除します。詳細については，「7.1.1　Eclipseプロジェクトのアンデプロイと削除」を参照してください。

HCSCサーバへ配備した定義内容の削除

サンプルプログラムごとに，「4.1.2　HCSCコンポーネントの配備と開始」でHCSCサーバへ配備した定義内容を削除します。詳細については，「7.1.2　HCSCサーバへ配備した定義内容の削除」を参照してください。

以降の項では，この流れに沿ってプロジェクトを削除する手順を説明します。

7.1.1　Eclipseプロジェクトのアンデプロイと削除

Eclipseプロジェクトのアンデプロイと削除の手順を説明します。

(1)　Eclipseプロジェクトのアンデプロイ

Eclipseプロジェクトのアンデプロイの手順を次に示します。

注意事項

「3.5.2　HCSCTEプロジェクトの作成」で作成したプロジェクトは削除しないでください。

Eclipseのメニューから［ウィンドウ］−［パースペクティブを開く］−［その他］をクリックします。

［パースペクティブを開く］ダイアログが表示されます。

［J2EE（デフォルト）］を選択し，［開く］ボタンをクリックします。

［J2EE］パースペクティブが表示されます。

［サーバー］ビューの［J2EEServer at localhost］を右クリックし，［追加と削除...］を選択します。

［追加と削除...］ダイアログが表示されます。

［構成済み］から［ArrangementClient］，［DeliveryService］および［InventoryManagementService］を選択して，［除去］ボタンをクリックします。

［ArrangementClient］，［DeliveryService］および［InventoryManagementService］が［構成済み］から［使用可能］へ移動します。

［終了］ボタンをクリックします。

処理中であることを知らせるメッセージが表示されます。

処理終了後，［J2EE］パースペクティブに戻ります。［サーバー］ビューの［J2EEServer at localhost］の配下から［ArrangementClient］，［DeliveryService］および［InventoryManagementService］プロジェクトが削除されていることを確認してください。

(2)　Eclipseプロジェクトの削除

Eclipseプロジェクトの削除の手順を次に示します。

［プロジェクト・エクスプローラー］ビューから，インポートしたEclipseプロジェクトを選択します。

サンプルプログラムのEclipseプロジェクトについては，「4.2.2　Eclipseプロジェクトのインポート」を参照してください。

右クリックし，［削除］を選択します。

削除を確認する［リソースの削除］ダイアログが表示されます。

［ディスク上からプロジェクト・コンテンツを削除］チェックボックスにチェックし，［OK］ボタンをクリックします。

選択したEclipseプロジェクトが削除されます。

7.1.2　HCSCサーバへ配備した定義内容の削除

HCSCサーバ上に配備されたサービスアダプタを削除する手順を説明します。

HCSCTEツリービューのサービス定義一覧で，サービス定義一覧またはHCSCコンポーネントを選択します。

選択したサービス定義一覧またはHCSCコンポーネントを右クリックして，［全サービスを停止してサーバから削除］を選択します。

アカウント認証画面が表示されます。

［ユーザID］に「admin」を，［パスワード］に「admin」を入力し，［OK］ボタンをクリックします。

処理中であることを知らせるメッセージが表示されたあと，結果を知らせるメッセージが表示されます。これでHCSCサーバへ配備したHCSCコンポーネントの削除が完了しました。

HCSCTEプロジェクトから，定義を完全に削除するには，［HCSC-Definer］−［定義情報管理］−［定義情報初期化］を選択します。

初期化を確認するダイアログが表示されるので，［はい］ボタンをクリックします。これで定義が完全に削除されました。

7.2　テスト環境の停止

Service Architectの使用を終了する場合は，起動中のテスト環境を停止したあと，Eclipseを終了します。

テスト環境を停止する手順を次に示します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テストサーバ停止］を選択して，テスト環境のPerformance Tracer，J2EEサーバ，および，標準受付とユーザ定義受付を含むHCSCサーバを停止します。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

［スタート］メニューの［プログラム］から［HiRDBSingleServer_CS0］−［HiRDBコマンドプロンプト］を選択します。

HiRDBのコマンドプロンプトが開きます。

pdstopコマンドを実行し，テスト環境の組み込みデータベースを停止します。

pdstop

pdstopコマンドの実行後に出力される「KFPS01850-I HiRDB system terminated. mode = NORMAL」というメッセージは，組み込みデータベースが正常に停止したことを示します。

「KFPS01863-E Hostname=<ホスト名>, unable to execute pdstop command, unit state not ONLINE」というメッセージが出力された場合は，すでに組み込みデータベースが停止していることを示します。

注意事項

テスト環境を停止する前にEclipseを終了すると，テスト環境を終了するために，Eclipseの画面が消えたあともプロセスの終了処理が実施されます。そのため，次にEclipseを起動するときに，ほかのプロセスがHCSCTEテンポラリディレクトリを使用している旨のエラーメッセージが表示される場合があります。エラーメッセージが表示された場合の対処方法を次に示します。

Windowsのタスクマネージャを開きます。

プロセスの一覧から，Eclipseを動かしている「eclipse.exe」および「javaw.exe」のプロセスが消えるのを待ちます。

プロセスが消えたことを確認したら，Eclipseを起動します。

7.3　アンセットアップとアンインストール

ここでは，テスト環境のアンセットアップ，Eclipseのアンセットアップ，およびService Architectのアンインストールの手順について説明します。

7.3.1　テスト環境のアンセットアップ

テスト環境をアンセットアップするには，HCSC簡易セットアップ機能を使います。テスト環境のアンセットアップ方法を次に示します。

テスト環境を起動している場合は，テスト環境を停止します。また，Eclipseを起動している場合は，Eclipseを終了します。

［スタート］メニューの［プログラム］から［Cosminexus※］−［テスト環境セットアップ］を選択します。

HCSC簡易セットアップの画面の［メイン］ページが表示されます。

［アンセットアップ］ボタンをクリックします。

テスト環境のアンセットアップが開始され，しばらくすると完了します。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

7.3.2　Eclipseのアンセットアップ

Eclipseセットアップ機能で構築した環境は，Eclipseセットアップ機能でアンセットアップします。

Eclipseセットアップ機能を使用したアンセットアップを実施した場合に削除される項目を次に示します。

表7‒1　Eclipseセットアップ機能のアンセットアップで削除される項目

項目

削除の有無

Eclipse Platform

削除される※1

Eclipseのconfigurationフォルダ

（ユーザごとのフォルダ）

削除されない※2

Eclipseのワークスペース

削除されない

Eclipseのショートカット

削除される

注※1

ユーザが作成したファイルも含め，対象となるフォルダ内にあるすべてのデータが削除されます。

注※2

configurationフォルダおよびワークスペースは，Eclipseが生成します。このため，Eclipseセットアップ機能のアンセットアップを実施しても削除されません。削除したい場合は手動で削除してください。手動での削除は，「7.3.2(2)　手動でアンセットアップする場合」を参照してください。

なお，Eclipseセットアップ機能で構築した環境をアンセットアップする前に，Service Architectをアンインストールおよび再インストールした場合は，構築した環境を手動でアンセットアップしてください。手動でのアンセットアップは，「7.3.2(2)　手動でアンセットアップする場合」を参照してください。

注意事項

アンセットアップ実行前に，Eclipseを終了してください。Eclipse起動中にアンセットアップを実行すると，Eclipseのインストールディレクトリが削除されません。なお，アンセットアップ実行後にEclipseのインストールディレクトリが残っていた場合は，<Eclipseのインストールディレクトリ>¥eclipse以下のディレクトリおよびファイルを手動で削除してください。

(1)　Eclipseセットアップ機能を使用する場合

Eclipseセットアップ機能を使用したアンセットアップの手順を次に示します。

［スタート］メニューから，［プログラム］−［Cosminexus※］−［Eclipseアンセットアップ］を選択します。

Eclipseセットアップ機能が起動して，［アンセットアップ - Eclipseセットアップ］ダイアログの［アンセットアップの確認］ページが表示されます。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

［アンセットアップの内容］エリアに表示された内容を確認して，［実行］ボタンをクリックします。

［進行状況］ページが表示されます。

アンセットアップが終了すると，［アンセットアップの完了］ページが表示されます。

［終了］ボタンをクリックします。

［アンセットアップ - Eclipseセットアップ］ダイアログが閉じます。

注意事項

アンセットアップを実行すると，セットアップ実行時にデスクトップに追加した，eclipse.exeへのショートカットが削除されますが，画面には表示されたままで，削除されていないように見える場合があります。この場合には，デスクトップを最新の情報に更新すると，ショートカットの削除が画面に反映されます。

(2)　手動でアンセットアップする場合

Eclipseセットアップ機能で構築した環境をアンセットアップする前に，Service Architectをアンインストールおよび再インストールした場合は，構築した環境を手動でアンセットアップしてください。手動でアンセットアップする手順を次に示します。

Eclipseのショートカットを削除します。

次に示すファイルを管理者が削除します。

C:¥Users¥Public¥Desktop¥Eclipse.lnk

Eclipseのconfigurationフォルダを削除します。

フォルダの場所を次に示します。

C:¥Users¥（全ユーザ分）¥ADP

Eclipseのフォルダを削除します。

デフォルトのフォルダの場所を次に示します。

<サービスプラットフォームのインストールディレクトリ>¥ADP¥IDE¥eclipse

7.3.3　Service Architectのアンインストール

Service Architectをアンインストールします。アンインストールには，Administrator権限または管理者特権が必要です。

なお，Service Architectをアンインストールする前に，必ずEclipseをアンセットアップしてください。

Windowsの［スタート］メニューから，［プログラム］−［Cosminexus※］−［uCosminexus Service Architectアンインストール］を選択します。

アンインストールを確認するダイアログが表示されます。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

［はい］ボタン，または［いいえ］ボタンをクリックします。

［はい］ボタンをクリックした場合

アンインストールが開始され， Service Architectの構成ソフトウェアがすべて削除されます。

［いいえ］ボタンをクリックした場合

アンインストールする構成ソフトウェアを選択するダイアログが表示されます。アンインストールする構成ソフトウェアを選択して，［次へ］ボタンをクリックすると，アンインストールが開始され，選択した構成ソフトウェアが削除されます。

付録

付録A　サンプルプログラムのファイルの構成

商品手配サンプルプログラムは，次の場所にあります。

<サービスプラットフォームのインストールディレクトリ>¥CSCTE¥Samples¥SOAP1.1_1.2mode¥ProductStock

商品手配サンプルプログラムの構成を次に示します。

ProductStock
├Repository
│　ProductStock.zip
├Requester
│├ArrangementClient
│││　.project
││├.settings
│││　 org.eclipse.wst.common.component
│││　 org.eclipse.wst.common.project.facet.core.xml
││└EarContent
││　└META-INF
││   　application.xml
│└ArrangementClientWeb
│　│　.classpath
│　│　.project
│　├.settings
│　│　.jsdtscope
│　│　org.eclipse.jdt.core.prefs
│　│　org.eclipse.wst.common.component
│　│　org.eclipse.wst.common.project.facet.core.xml
│　│　org.eclipse.wst.jsdt.ui.superType.container
│　│　org.eclipse.wst.jsdt.ui.superType.name
│　├build
│　│└classes
│　├src
│　│└sample
│　│　├arrangementservice
│　│　│　Arrangement.java
│　│　│　ArrangementService.java
│　│　│　ArrangeItem.java
│　│　│　ArrangeItemResponse.java
│　│　│　ObjectFactory.java
│　│　│　package-info.java
│　│　├servlet
│　│　│　ArrangementServlet.java
│　│　└wsdl
│　│　　　ArrangementService.wsdl
│　└WebContent
│　　　│　error.jsp
│　　　│　index.html
│　　　│　result.jsp
│　　　├META-INF
│　　　│　MANIFEST.MF
│　　　└WEB-INF
│　　　　│　web.xml
│　　　　└lib
└Service
　├DeliveryService
　││　.project
　│├.settings
　││　org.eclipse.wst.common.component
　││　org.eclipse.wst.common.project.facet.core.xml
　│└EarContent
　│　└META-INF
　│　　　application.xml
　├DeliveryServiceWeb
　││　.classpath
　││　.project
　│├.settings
　││　.jsdtscope
　││　org.eclipse.jdt.core.prefs
　││　org.eclipse.wst.common.component
　││　org.eclipse.wst.common.project.facet.core.xml
　││　org.eclipse.wst.jsdt.ui.superType.container
　││　org.eclipse.wst.jsdt.ui.superType.name
　│├build
　││└classes
　│├src
　││└sample
　││　└deliveryservice
　││　　　Delivery.java
　││　　　DeliverItemResponse.java
　││　　　DeliverItem.java
　││　　　DeliveryImpl.java
　││　　　ObjectFactory.java
　││　　　package-info.java
　│└WebContent
　│　├META-INF
　│　│　MANIFEST.MF
　│　└WEB-INF
　│　　│　web.xml
　│　　└lib
　├InventoryManagementService
　││　.project
　│├.settings
　││　org.eclipse.wst.common.component
　││　org.eclipse.wst.common.project.facet.core.xml
　│└EarContent
　│　└META-INF
　│　　　application.xml
　├InventoryManagementServiceWeb
　││　.classpath
　││　.project
　│├.settings
　││　.jsdtscope
　││　org.eclipse.jdt.core.prefs
　││　org.eclipse.wst.common.component
　││　org.eclipse.wst.common.project.facet.core.xml
　││　org.eclipse.wst.jsdt.ui.superType.container
　││　org.eclipse.wst.jsdt.ui.superType.name
　│├build
　││└classes
　│├src
　││└sample
　││　└inventorymanagementservice
　││　　　InventoryManager.java
　││　　　InventoryManagerImpl.java
　││　　　ReserveItem.java
　││　　　ReserveItemResponse.java
　││　　　ObjectFactory.java
　││　　　package-info.java
　│└WebContent
　│　├META-INF
　│　│　MANIFEST.MF
　│　└WEB-INF
　│　　│　web.xml
　│　　└lib
　└WSDL
　　　ArrangementService.wsdl
　　　DeliveryService.wsdl
　　　InventoryManagementService.wsdl

付録B　Eclipseセットアップ機能実行時の情報の採取

Eclipseセットアップ機能を実行したときに設定した内容（セットアップ内容，設定変更内容，アンセットアップ内容）は，セットアップログとしてファイルに保存されます。

セットアップログの確認方法，およびセットアップログで確認できる内容を説明します。

セットアップログの確認方法

Windowsの［スタート］メニューから，［プログラム］−［Cosminexus※］−［Eclipseセットアップログ］を選択すると，セットアップログが表示されます。

注※

プログラムフォルダ名を変更している場合は，変更したプログラムフォルダから選択してください。

セットアップログで確認できる内容

Eclipse環境のセットアップログでは，次の内容を確認できます。

Eclipse環境をセットアップしたときの設定内容

アンセットアップしたEclipse環境の設定内容

これらの情報は，実行された順番に1つのファイルに格納されます。このため，最新の情報は，ファイルの最後に格納されています。なお，エラーまたは処理の中断が発生した場合でも，これらの情報は格納されます。

なお，Eclipseセットアップ機能実行時のエラーメッセージは，Eclipseセットアップ機能のコンソールに出力されます。出力されたエラーメッセージについては，マニュアル「アプリケーションサーバ メッセージ(構築／運用／開発用)」を参照して対処してください。

付録C　用語解説

マニュアルで使用する用語について

マニュアル「アプリケーションサーバ & BPM/ESB基盤 用語解説」を参照してください。

索引

A

ArrangementService.wsdl[1]

D

DeliveryReceiptサービスアダプタの定義[1]

DeliveryService.wsdl[1]

E

EclipseからJ2EEサーバを操作するための設定[1]

Eclipseセットアップ機能実行時の情報の採取[1]

Eclipseセットアップ機能を使用した開発環境の構築[1]

Eclipseセットアップ機能を使用する場合[1]

Eclipseの準備[1]

Eclipseプロジェクトのアンデプロイ[1]

Eclipseプロジェクトのアンデプロイと削除[1]

Eclipseプロジェクトのインポート[1]

Eclipseプロジェクトの削除[1]

Eclipseプロジェクトのデプロイ[1]

Eclipseメニュー表記について[1]

Eclipseをインストールするための準備[1]

H

HCSCTEプロジェクトの作成[1]

HCSC エミュレートビューの表示[1]

HCSC簡易セットアップ[1]

HCSC簡易セットアップ機能[1]

HCSCコンポーネント[1]

HCSCコンポーネントのインポート[1]

HCSCコンポーネントの配備と開始[1]

HCSCコンポーネントの配備内容の確認[1]

HCSCサーバ[1]

HCSCサーバの起動[1]

HCSCサーバへ配備した定義内容の削除[1]

I

InventoryManagementService.wsdl[1]

InventoryManagementサービスアダプタの定義[1]

J

J2EEサーバ[1]

J2EEサーバの選択[1]

JDKの確認[1]

M

Management Serverリモート管理機能へのログイン[1]

P

ProductStockビジネスプロセスの定義[1]

X

XMLファイルの作成[1]

あ

アクティビティの定義[1]

アクティビティの配置[1]

アンインストール〔Service Architect〕[1]

アンセットアップ〔Eclipse〕[1]

アンセットアップ〔テスト環境〕[1]

アンセットアップとアンインストール[1]

い

一般的なシステム構成[1]

インストール〔Service Architect〕[1]

［インストール済みのJRE］ページ[1]

インストールディレクトリについて[1]

う

受付アクティビティ[1]

お

応答アクティビティ（在庫がない場合）[1]

応答アクティビティ（配送手配が成功した場合）[1]

か

開発環境とテスト環境の連動設定[1]

開発環境のSOAPモードの設定[1]

開発環境へのシステム構成定義のインポート[1]

開発した商品手配システムを実行する準備[1]

画面や操作の説明で使用している記号について[1]

こ

このマニュアルで体験できること[1]

このマニュアルの読み方[1]

［コンパイラー］ページ[1]

コンポーネントの検証とパッケージング[1]

さ

サーバランタイムの作成[1]

サービスアダプタ[1]

サービスのエミュレーション機能を利用する場合[1]

サービスのエミュレーションの実行[1]

サービス部品[1]、[2]

サービスプラットフォームを利用する一般的なシステム構成[1]

サービス呼出アクティビティ（在庫を引き当てる場合）[1]

サービス呼出アクティビティ（配送を手配する場合）[1]

サービスリクエスタ[1]、[2]

サービスリクエスタ・サービス部品のデプロイ[1]

サンプルプログラムが提供するサービス部品を利用するデバッグ[1]

サンプルプログラムの開発・テスト環境を構築する[1]

サンプルプログラムの開発・テスト環境を構築する流れ[1]

サンプルプログラムの環境を削除する[1]

サンプルプログラムのシステム構成[1]

サンプルプログラムの実行[1]

サンプルプログラムの紹介[1]

サンプルプログラムの処理内容[1]

サンプルプログラムのファイルの構成[1]

サンプルプログラムをご使用になる前に[1]

サンプルプログラムを実行する[1]

サンプルプログラムを実行する準備[1]

し

システムの開発を体験する[1]

手動でアンセットアップする場合[1]

使用している構文要素記号について[1]

商品在庫数の初期化方法[1]

商品手配サンプルプログラムのシステム構成[1]

商品手配サンプルプログラムの処理詳細[1]

商品手配サンプルプログラムの処理内容[1]

商品手配システムの開発[1]

商品手配システムの開発の手順[1]

せ

セットアップログ[1]

て

データ変換アクティビティ（在庫なしの場合）[1]

データ変換アクティビティ（在庫引当の前処理の場合）[1]

データ変換アクティビティ（配送手配の前処理の場合）[1]

データ変換アクティビティ（配送番号の設定の場合）[1]

テスト環境からのシステム構成定義のエクスポート[1]

テスト環境の起動[1]

テスト環境の構築[1]

テスト環境のシステム構成定義を開発環境に取り込むための設定[1]

テスト環境の停止[1]

デバッガの起動[1]

ひ

ビジネスプロセス[1]

ビジネスプロセスの追加[1]

ビジネスプロセスのデバッグ[1]

ビジネスプロセスのデバッグの実行[1]

ビジネスプロセスのデバッグの終了[1]

ビジネスプロセス・サービスアダプタを準備する[1]

ふ

ブレークポイントの設定[1]

プロジェクトの削除[1]

分岐開始アクティビティ[1]

分岐終了アクティビティ[1]

へ

変数の設定[1]

ゆ

ユーザ定義受付[1]

ユーザ定義受付の追加[1]

よ

用語解説[1]

り

リクエストの送信[1]

れ

連携するSOAPサービスリクエスタ・サービス部品を準備する[1]

ろ

ローカル変数情報の出力の設定[1]