1. チュートリアル

Caution
このチュートリアルを実行する前に、WebOTX Developer(Windows版)とWebOTX Enterprise Service Busをインストールした環境を用意してください。

1.1. 統合するサービス（システム）について

図1.1-1

図1.1-2

Memo
Inboundはサービスを受け付ける側で、Outboundは外部サービスを呼び出す側です。

1.2. 準備

1.2.1. 経理システム

図1.2.1-1

図1.2.1-2

図1.2.1-3

Memo
proj_05_JMSQueue.zipは、こちらからダウンロードできます。

まずWebOTXのインストールディレクトリパスの設定を行います。メニューからウィンドウ ＞ 設定を選択します。左側のツリーからJava ＞ ビルド・パス ＞ クラスパス変数を選択します。新規ボタンを押し、名前をAS_INSTALLとしてパスにはWebOTXをインストールしたディレクトリ（例 C:\WebOTX）を指定します。

図1.2.1-4

次いでJREシステム・ライブラリーパスの設定を行います。パッケージエクスプローラから、proj_05_JMSQueueを右クリックしプロパティーを選択します。左側メニューからJavaのビルド・パスを選択し、右上タブからライブラリーを選択します。JREシステム・ライブラリーのアイコンを確認し、赤い×アイコンが表示されている場合は、編集ボタンを押し、ワークスペースのデフォルトJREを選択します。×アイコンが表示されていない場合は、編集は必要ありません。

図1.2.1-5

> otxadmin

otxadmin> list-domains

otxadmin> login --user ユーザ名 --password パスワード --port 6212

otxadmin> create-jmsdest --desttype queue MyQueue

otxadmin> create-jms-resource --restype javax.jms.Queue --wojmsDestinationName=MyQueue MyQueue

otxadmin> create-jms-resource --restype javax.jms.QueueConnectionFactory MyQCF

Memo
WebOTX Standard / Enterprise のアドバンスドモードで既にプロセスグループを作成している場合は、プロセスグループを再起動してください。

1.2.2. 経理システム (JMSアプリケーション)

1. WebOTX Developer's Studioが利用できる場合
2. WebOTX Developer's Studioが利用できない場合

1. メニューから、実行 ＞ 実行の構成(N)を選択し、構成からJavaアプリケーション ＞ 新規(W)をクリックします。
   新規作成してメイン・クラスを検索ボタンからcom.nec.webotx.esb.tutorial.account.AccountSystemを選択し、 プログラムの引数を"MyQueue MyQCF"に設定します。実行(R) をクリックします。

   
   図1.2.2-1

   
   図1.2.2-2

2. 出力の内容を確認します。内容は下記の通りです。

   
   図1.2.2-3

1. 下記のファイルを適当なディレクトリに保存します。
   • runAccountSystem.bat
   • runAccountSystem.sh
   • AccountSystem.java
   • ProductData.java
   • Registry.java
   • XMLUtil.java
   • 05_Registry.xml
2. JMSアプリケーションを実行します。
   (Windows環境の場合) runAccountSystem.batを実行します。

    > runAccountSystem.bat

   (UNIX環境の場合) runAccountSystem.shの環境変数 AS_INSTALL と ObjectSpinner_INSTALL を確認します。 WebOTXのインストールディレクトリが /opt/WebOTX ではない場合、および ObjectSpinnerのインストールディレクトリが /opt/ObjectSpinner ではない場合は、 それぞれ適切に修正してください。確認した後 runAccountSystem.sh を実行します。

    > chmod 777 runAccountSystem.sh
    > ./runAccountSystem.sh

3. 出力の内容を確認します。内容は下記の通りです。

   looking up MyQCF ...done!!
   creating QueueConnection ...done!!
   creating QueueSession ...done!!
   looking up MyQueue ...done!!
   creating Receiver ...done!!
   Receiver ready!!

1.2.3. 営業システム (Webサービス)

1. WebOTX Developer's Studioが利用できる場合
2. WebOTX Developer's Studioがなく、統合運用管理ツールが利用できる場合
3. WebOTX Developer's Studio、統合運用管理ツールいずれも利用できない場合

1. Developer's Studioを起動します。
2. ヘルプメニューからヘルプ目次をクリックします。
3. 目次から、WebOTX Guide(Enterprise Service Bus) > サンプル集を開きます。 表から proj_05_SoapService をクリックすることでプロジェクトをインポートできます。

   
   図1.2.3-1

4. パッケージエクスプローラからプロジェクトを右クリックし、実行 > サーバーで実行 を選択します。
5. 配備先のサーバーを選択し、配備を行います。
6. 同様にしてインポートした全てのプロジェクトを配備します。

1. 05_SoapService.war を適当なディレクトリに保存します。
2. 統合運用管理ツールを起動します。
3. domain1を右クリックし接続を選択します。ユーザ名、パスワードを入力し接続ボタンをクリックします。
4. domain1配下のアプリケーションを右クリックしコンポーネントの配備を選択します。
5. コンポーネントタイプをWebコンポーネントに変更し、参照ボタンから05_SoapService.warを選択します。
   配備ボタンをクリックすると配備が実行されます。

1. 05_SoapService.war を適当なディレクトリに保存します。
2. 運用管理コマンド(otxadmin)を起動します。
   

   > otxadmin
   

   domain1が起動していることを確認します。起動されていれば、runningと表示されます。
   

   otxadmin> list-domains
   

3. domain1にログインします。domain1はWebOTXインストール時に生成済みのドメインです。ユーザ名とパスワードにはドメインログインに使用するユーザ名とパスワードを入力します。
   

   otxadmin> login --user ユーザ名 --password パスワード--port 6212
   

4. 05_SoapService.warを配備します。
   ・WebOTX Standard / Enterprise のアドバンスドモードの場合
   

   otxadmin> deploy --apgroup <アプリケーショングループ名> --pgroup <プロセスグループ名> <05_SoapService.warへのパス>
   

   ・WebOTX Express または WebOTX Standard / Enterprise のスタンダードモードの場合
   

   otxadmin> deploy <05_SoapService.warへのパス>
   

1.3. サービスアセンブリの作成

図1.3-1

図1.3-2

図1.3-3

図1.3-4

図1.3-5

図1.3-6

1.3.1. 営業システム用のサービスユニットの追加

図1.3.1-1

図1.3.1-2

図1.3.1-3

図1.3.1-4

図1.3.1-5

Memo
エンドポイント名はデフォルトで「ep_05_tutorial_XXX」(XXXは連番)が設定されます。営業システムでは、例として連番001を用います。

図1.3.1-6

図1.3.1-7

Memo
サービス名とインタフェース名のローカル名は、エンドポイント名に指定した名前がデフォルトで設定されます。

図1.3.1-8

1.3.2. 経理システム用のサービスユニットの追加

図1.3.2-1

図1.3.2-2

図1.3.2-3

Memo
経理システムでは、例として連番002を用います。

図1.3.2-4

図1.3.2-5

図1.3.2-6

Memo
JMS BCは、ノーマライズメッセージのコンテントの内容（XML）をTextMessageとして送信します。また、添付ファイルはBytesMessageとしてbyte配列で送信します。 従って、経理システムはTextMessageの形式で送られてくるXMLメッセージを処理できるアプリケーションになっています。

1.3.3. XSL変換のサービスユニットの追加

図1.3.3-1

  <?xml version="1.0" encoding="UTF-8"?> 
  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.nec.com" xmlns:otx="http://www.nec.com"> 
  <xs:element name="opr_05_tutorial_001Response"> 
    <xs:complexType> 
      <xs:sequence> 
        <xs:element name="ProductData"> 
          <xs:complexType> 
            <xs:sequence> 
              <xs:element name="id"/> 
                <xs:element name="registDate" type="otx:dateType"/> 
                <xs:element name="deliveryDate" type="otx:dateType"/> 
                <xs:element name="registerName" type="xs:string"/> 
                <xs:element name="productNumber" type="xs:int"/> 
                <xs:element name="productName" type="xs:string"/> 
                <xs:element name="price" type="xs:int"/> 
                <xs:element name="suryo" type="xs:int"/> 
              </xs:sequence> 
            </xs:complexType> 
          </xs:element> 
        </xs:sequence> 
      </xs:complexType> 
    </xs:element> 
    <xs:complexType name="dateType"> 
      <xs:sequence> 
        <xs:element name="year" type="xs:int"/> 
        <xs:element name="month" type="xs:int"/> 
        <xs:element name="date" type="xs:int"/> 
        <xs:element name="hour" type="xs:int"/> 
        <xs:element name="minute" type="xs:int"/> 
        <xs:element name="second" type="xs:int"/> 
      </xs:sequence> 
    </xs:complexType> 
  </xs:schema> 

Memo
source.xsdはソーススキーマファイルです。こちらからダウンロードできます。

  <?xml version="1.0" encoding="UTF-8"?> 
  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.nec.com" xmlns:otx="http://www.nec.com"> 
    <xs:element name="opr_05_tutorial_001"> 
      <xs:complexType> 
        <xs:sequence> 
          <xs:element name="ProductData"> 
            <xs:complexType> 
              <xs:sequence> 
                <xs:element name="id"/> 
                <xs:element name="productNumber" type="xs:int"/> 
                <xs:element name="productName" type="xs:string"/> 
                <xs:element name="price" type="xs:int"/> 
                <xs:element name="suryo" type="xs:int"/> 
                <xs:element name="shoukei" type="xs:int"/> 
              </xs:sequence> 
            </xs:complexType> 
          </xs:element> 
        </xs:sequence> 
      </xs:complexType> 
    </xs:element> 
  </xs:schema> 

Memo
target.xsdはターゲットスキーマファイルです。こちらからダウンロードできます。

図1.3.3-2

図1.3.3-3

図1.3.3-4

図1.3.3-5

図1.3.3-6

図1.3.3-7

図1.3.3-8

図1.3.3-9

図1.3.3-10

図1.3.3-11

図1.3.3-12

図1.3.3-13

ノード間の結線は以下の手順で行います。(1)結線元の矢印をクリック、(2)結線先の矢印をクリック、(3)結線アイコンをクリック。

図1.3.3-14

図1.3.3-15

図1.3.3-16

図1.3.3-17

図1.3.3-18

図1.3.3-19

図1.3.3-20

図1.3.3-21

図1.3.3-22

図1.3.3-23

<?xml version="1.0"?> 
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:S0="http://www.nec.com" xmlns:T0="http://www.nec.com" xmlns:java="http://xml.apache.org/xalan/java" exclude-result-prefixes="java" version="1.0"> 
  <xsl:output method="xml" version="1.0" omit-xml-declaration="no" encoding="UTF-8" indent="yes"/> 
  <xsl:template match="/"> 
    <xsl:for-each select="S0:opr_05_tutorial_001Response"> 
      <xsl:call-template name="node1"/> 
    </xsl:for-each> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001--> 
  <xsl:template name="node1"> 
    <T0:opr_05_tutorial_001> 
      <xsl:call-template name="node2"/> 
    </T0:opr_05_tutorial_001> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData--> 
  <xsl:template name="node2"> 
    <ProductData> 
      <xsl:call-template name="node3"/> 
      <xsl:call-template name="node4"/> 
      <xsl:call-template name="node5"/> 
      <xsl:call-template name="node6"/> 
      <xsl:call-template name="node7"/> 
      <xsl:call-template name="node8"/> 
    </ProductData> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/id--> 
  <xsl:template name="node3"> 
    <id> 
      <xsl:call-template name="node9"/> 
    </id> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/productNumber--> 
  <xsl:template name="node4"> 
    <productNumber> 
      <xsl:call-template name="node10"/> 
    </productNumber> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/productName--> 
  <xsl:template name="node5"> 
    <productName> 
      <xsl:call-template name="node11"/> 
    </productName> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/price--> 
  <xsl:template name="node6"> 
    <price> 
      <xsl:call-template name="node12"/> 
    </price> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/suryo--> 
  <xsl:template name="node7"> 
    <suryo> 
      <xsl:call-template name="node13"/> 
    </suryo> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/shoukei--> 
  <xsl:template name="node8"> 
    <shoukei> 
      <xsl:call-template name="node14"/> 
    </shoukei> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/id/text()--> 
  <xsl:template name="node9"> 
    <xsl:value-of select="./ProductData/id/text()"/> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/productNumber/text()--> 
  <xsl:template name="node10"> 
    <xsl:value-of select="./ProductData/productNumber/text()"/> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/productName/text()--> 
  <xsl:template name="node11"> 
    <xsl:value-of select="./ProductData/productName/text()"/> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/price/text()--> 
  <xsl:template name="node12"> 
    <xsl:value-of select="./ProductData/price/text()"/> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/suryo/text()--> 
  <xsl:template name="node13"> 
    <xsl:value-of select="./ProductData/suryo/text()"/> 
  </xsl:template> 
  <!--template for node /opr_05_tutorial_001/ProductData/shoukei/text()--> 
  <xsl:template name="node14"> 
    <xsl:value-of select="./ProductData/price/text()*./ProductData/suryo/text()"/> 
  </xsl:template> 
</xsl:stylesheet>

図1.3.3-24

図1.3.3-25

1.3.4. シーケンスの設定

図1.3.4-1

図1.3.4-2

図1.3.4-3

図1.3.4-4

図1.3.4-5

図1.3.4-6

図1.3.4-7

図1.3.4-8

図1.3.4-9

図1.3.4-10

図1.3.4-11

図1.3.4-12

Memo
シーケンスでは、例として連番005を用います。

図1.3.4-13

図1.3.4-14

図1.3.4-15

1.3.5. クライアントに公開するエンドポイントの作成

図1.3.5-1

図1.3.5-2

図1.3.5-3

図1.3.5-4

図1.3.5-5

図1.3.5-6

図1.3.5-7

図1.3.5-8

図1.3.5-9

図1.3.5-10

1.4. サービスアセンブリのデプロイ

図1.4-1

図1.4-2

図1.4-3

otxadmin> deploy-jbi-service-assembly --apgroup <アプリケーショングループ名> --pgroup <プロセスグループ名> <05_tutorial.zipまでのパス>\05_tutorial.zip

otxadmin> deploy-jbi-service-assembly <05_tutorial.zipまでのパス>\05_tutorial.zip

otxadmin > start-jbi-service-assembly 05_tutorial

1.5. クライアントの実行

1. WebOTX Developer's Studioが利用できる場合
2. WebOTX Developer's Studioが利用できない場合

<?xml version="1.0" encoding="utf-8" ?>
<registry></registry>

図1.5-1

図1.5-2

図1.5-3

図1.5-4

図1.5-5

<?xml version="1.0" encoding="utf-8"?> 
<registry> 
  <ProductData> 
    <id>1</id> 
    <keijyouDate> 
      <year>2010</year> 
      <month>4</month> 
      <date>1</date> 
      <hour>12</hour> 
      <minute>30</minute> 
      <second>0</second> 
    </keijyouDate> 
    <productNumber>1</productNumber> 
    <productName>Product_A</productName> 
    <price>1500</price> 
    <suryo>1000</suryo> 
    <shoukei>1500000</shoukei> 
  </ProductData> 
</registry> 

1. 下記のファイルを適当なディレクトリに保存します。
   • run.bat
   • run.sh
   • SoapClient.java
   • 05_TestData.xml
2. SOAPクライアントアプリケーションを実行します。
   (Windows環境の場合) run.batをテキストエディタで開き、SOAPメッセージ送信先のURLを確認します。WebOTXのWebサーバのポートが80ではない場合は適切に修正してください。
   確認した後 run.bat を実行します。

    > run.bat

   (UNIX環境の場合) run.shの環境変数 AS_INSTALL と URL を確認します。WebOTXのインストールディレクトリが /opt/WebOTX ではない場合、および WebOTXのWebサーバのポートが8080ではない場合は適切に修正してください。
   確認した後 run.sh を実行します。

    > chmod 777 run.sh
    > ./run.sh

3. 出力の内容を確認します。内容は下記の通りです。

   ******************************************
   ************  successful  ****************
   ******************************************

4. 05_Registry.xmlを開いて、<keijyouDate>の各要素に実行した日時が出力されていることを確認します。

1.6. メッセージログの確認

Memo
本章はテスト用サーバ環境のみの手順です。
メッセージログ機能を設定していない場合や、メッセージログ機能の詳細については2.16. メッセージログ機能の利用を参照してください。

図1.6-1

図1.6-2

図1.6-3

図1.6-4