5.2.4　ProductStock_Normalビジネスプロセスの定義

(a)　要求電文

要求電文のXMLスキーマの作成について説明します。ここで作成したXMLスキーマ「input_Arr.xsd」は，HTTP受付の要求電文に設定します。

• コマンドで使用するJSONファイルの作成

  テキストエディタを起動し，次の内容のJSONファイルを作成します。このファイルの内容は，サービスリクエスタからServiceReceipt受付に送られる電文の一例です。

  {"itemName":"PC", "quantity":1}

  ここでは，ファイル名をinput_Arr.jsonとし，このJSONファイルを任意の場所に格納します。

• cscjson2xsdコマンドの実行例

  この操作は，管理者または管理者特権で実行してください。

  この実行例では，入力するJSONファイルの格納場所を「C:\Users\work」，入力するJSONファイルの名称を「input_Arr.json」，出力するXMLスキーマの名称を「input_Arr.xsd」としています。

  C:\Users\work>"%COSMINEXUS_HOME%\CSCTE\bin\cscjson2xsd.bat" -in input_Arr.json -out input_Arr.xsd
  KECT93001-I Execution of the command will now start. (command = cscjson2xsd)
  KECT93002-I Execution of the command ended normally. (command = cscjson2xsd)

• 作成されたXMLスキーマ（input_Arr.xsd）

  コマンド実行後，次の内容のXMLスキーマ「input_Arr.xsd」が作成されます。

  実際に作成されるXMLスキーマは，次に示す内容と異なる場合がありますが，スキーマとしての定義内容は同じであるため，問題ありません。

  <?xml version="1.0" encoding="UTF-8"?>
  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
    <xs:element name="csc-object">
      <xs:complexType>
        <xs:sequence>
          <xs:element ref="itemName"/>
          <xs:element ref="quantity"/>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
    <xs:element name="itemName" type="xs:NCName"/>
    <xs:element name="quantity" type="xs:integer"/>
  </xs:schema>

ここで作成したJSONファイル，およびXMLスキーマのサンプルは次のディレクトリに格納されています。

<Service Architectのインストールディレクトリ>\CSCTE\Samples\SOAP1.1_1.2mode\ProductStock_REST\Schema\ServiceReceipt\request

(b)　応答電文

応答電文のXMLスキーマの作成について説明します。ここで作成したXMLスキーマ「output_ArrNor.xsd」は，HTTP受付の応答電文に設定します。

• コマンドで使用するJSONファイルの作成

  テキストエディタを起動し，次の内容のJSONファイルを作成します。このファイルの内容は，サービスリクエスタがServiceReceipt受付から受け取る電文の一例です。

  {"deliveryNumber": "D00000001", "itemName": "PC", "message": "Product is available for arrangement.", "quantity":"1"}

  ここでは，ファイル名をoutput_ArrNor.jsonとし，このJSONファイルを任意の場所に格納します。

• cscjson2xsdコマンドの実行例

  この操作は，管理者または管理者特権で実行してください。

  この実行例では，入力するJSONファイルの格納場所を「C:\Users\work」，入力するJSONファイルの名称を「output_ArrNor.json」，出力するXMLスキーマの名称を「output_ArrNor.xsd」としています。

  C:\Users\work>"%COSMINEXUS_HOME%\CSCTE\bin\cscjson2xsd.bat" -in output_ArrNor.json -out output_ArrNor.xsd
  KECT93001-I Execution of the command will now start. (command = cscjson2xsd)
  KECT93002-I Execution of the command ended normally. (command = cscjson2xsd)

• 作成されたXMLスキーマ（output_ArrNor.xsd）

  コマンド実行後，次の内容のXMLスキーマ「output_ArrNor.xsd」が作成されます。

  実際に作成されるXMLスキーマは，次に示す内容と異なる場合がありますが，スキーマとしての定義内容は同じであるため，問題ありません。

  <?xml version="1.0" encoding="UTF-8"?>
  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
  <xs:element name="csc-object">
    <xs:complexType>
      <xs:sequence>
        <xs:element ref="deliveryNumber"/>
        <xs:element ref="itemName"/>
        <xs:element ref="message"/>
        <xs:element ref="quantity"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
  <xs:element name="deliveryNumber" type="xs:NCName"/>
  <xs:element name="itemName" type="xs:NCName"/>
  <xs:element name="message" type="xs:string"/>
  <xs:element name="quantity" type="xs:integer"/>
  </xs:schema>

ここで作成したJSONファイル，およびXMLスキーマのサンプルは次のディレクトリに格納されています。

<Service Architectのインストールディレクトリ>\CSCTE\Samples\SOAP1.1_1.2mode\ProductStock_REST\Schema\ServiceReceipt\response\ProductStock_Normal

(c)　電文フォーマットの指定

作成したXMLスキーマをServiceReceipt受付に設定します。

1. ［ユーザ定義受付（基本）］タブでユーザ定義受付定義（基本）画面に切り替えます。

2. ［要求電文］−［受付］−［電文フォーマット］の［参照］ボタンをクリックして，XMLスキーマ「input_Arr.xsd」を指定します。

3. ［応答電文］−［受付］−［電文フォーマット］の［参照］ボタンをクリックして，XMLスキーマ「output_ArrNor.xsd」を指定します。

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

設定後のユーザ定義受付（基本）タブの例を次に示します。

(a)　受付アクティビティ（アクティビティ名：受付）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	受付	アクティビティの名称を入力します。
   オペレーション名	arrangeItem	サービスリクエスタからHCSCコンポーネントを呼び出すときに利用するオペレーション（ServiceReceipt受付）の名称を入力します。
   ボディ割当変数	InputData	ビジネスプロセスの要求電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数	設定なし	ビジネスプロセスの要求電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   割当相関セット群	設定なし	相関セットグループをアクティビティに割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   通信モデル	同期	オペレーションの通信モデルを指定します。ProductStock_Normalは，各サービス部品の呼び出し結果から応答電文フォーマットを作成するため，「同期」を設定します。
   インスタンス生成	yes	要求電文を受け付けたときに，プロセスを初期化するかどうかを選択します。この商品手配システムでは，初期化するため「yes」を設定します。

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

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

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	在庫引当前処理	アクティビティの名称を入力します。
   変数（変換元変数）	InputData	データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。
   変数（変換先変数）	InventoryAllocationInputData	データの変換先になる変数をドロップダウンリストから選択します。

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

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

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

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

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

   

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

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

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

   

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

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

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

    

    注

    作成したXMLスキーマによって変換先スキーマの要素の出現順が一部異なるため，マッピング線の見え方が異なる場合があります。

(c)　サービス呼出アクティビティ（アクティビティ名：在庫引当）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	在庫引当	アクティビティの名称を入力します。
   サービス名	InventoryManagement	サービス部品呼び出し時に使用するサービスアダプタの名称をドロップダウンリストから選択します。
   オペレーション名	reserveItem	［サービス名］で指定したサービスアダプタのオペレーションのうち，実際に呼び出すオペレーションの名称を指定します。
   通信モデル	同期	［オペレーション名］で指定したオペレーションに設定されている通信モデルが表示されます。
   ボディ割当変数（要求電文）	InventoryAllocationInputData	在庫管理サービスを呼び出す要求電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数（要求電文）	設定なし	在庫管理サービスを呼び出す要求電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   ボディ割当変数（応答電文）	InventoryAllocationOutputData	在庫管理サービスから受け取る応答電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数（応答電文）	設定なし	在庫管理サービスから受け取る応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   割当相関セット群	設定なし	相関セットグループをアクティビティに割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

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

(d)　データ変換アクティビティ（アクティビティ名：在庫なし設定）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	在庫なし設定	アクティビティの名称を入力します。
   変数（変換元変数）	InputData	データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。
   変数（変換先変数）	OutputData	データの変換先になる変数をドロップダウンリストから選択します。

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

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

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

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

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

   

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

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

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

   

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

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

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

    

    注

    作成したXMLスキーマによって変換先スキーマの要素の出現順が一部異なるため，マッピング線の見え方が異なる場合があります。

11. データ変換定義画面のパレット［その他］から定数ファンクション（const）を選択します。

12. マッピングビューアで適当な場所をクリックして定数ファンクションを配置します。

13. 定数ファンクションをダブルクリックします。

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

14. ［定数］ダイアログで次の値を指定します。

    属性名	属性値
    ファンクション名	NoStock_Message
    文字列	No stock is available.

    

15. ［OK］ボタンをクリックして［定数］ダイアログを閉じます。

16. 手順11.〜手順15.と同様の手順で，もう一つ定数ファンクション（const）を作成します。［定数］ダイアログでは次の値を指定します。

    属性名	属性値
    ファンクション名	No_deliveryNumber
    文字列	（何も入力しない）

    

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

18. 次の図のようになるようにマッピング線を設定します。

    

(e)　応答アクティビティ（アクティビティ名：応答_在庫なしエラー）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	応答_在庫なしエラー	アクティビティの名称を入力します。
   オペレーション名	arrangeItem	対応する受付アクティビティに指定したオペレーション名を入力します。
   ボディ割当変数	OutputData	ビジネスプロセスの応答電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数	設定なし	ビジネスプロセスの応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   割当相関セット群	設定なし	相関セットグループをアクティビティに割り当てる場合に入力します。この商品手配システムでは使用しないため，設定しません。
   フォルト名	設定なし	フォルト処理として応答アクティビティを定義して，サービスリクエスタにフォルトが発生したことを示す応答電文を送信する場合のフォルトの名称を入力します。この商品手配システムではフォルト処理を使用しないため，設定しません。

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

(f)　データ変換アクティビティ（アクティビティ名：配送手配前処理）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	配送手配前処理	アクティビティの名称を入力します。
   変数（変換元変数）	InventoryAllocationOutputData	データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。
   変数（変換先変数）	DeliveryArrangementInputData	データの変換先になる変数をドロップダウンリストから選択します。

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

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

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

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

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

   

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

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

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

   

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

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

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

    

    注

    作成したXMLスキーマによって変換先スキーマの要素の出現順が一部異なるため，マッピング線の見え方が異なる場合があります。

(g)　サービス呼出アクティビティ（アクティビティ名：配送手配）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	配送手配	アクティビティの名称を入力します。
   サービス名	DeliveryReceipt	サービス部品呼び出し時に使用するサービスアダプタの名称をドロップダウンリストから選択します。
   オペレーション名	deliverItem	［サービス名］で指定したサービスアダプタのオペレーションのうち，実際に呼び出すオペレーションの名称を指定します。
   通信モデル	同期	［オペレーション名］で指定したオペレーションに設定されている通信モデルが表示されます。
   ボディ割当変数（要求電文）	DeliveryArrangementInputData	配送手配サービスを呼び出す要求電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数（要求電文）	設定なし	配送手配サービスを呼び出す要求電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   ボディ割当変数（応答電文）	DeliveryArrangementOutputData	配送手配サービスから受け取る応答電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数（応答電文）	設定なし	配送手配サービスから受け取る応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   割当相関セット群	設定なし	相関セットグループをアクティビティに割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。

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

(h)　データ変換アクティビティ（アクティビティ名：配送番号設定）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	配送番号設定	アクティビティの名称を入力します。
   変数（変換元変数）※	InputData DeliveryArrangementOutputData	データの変換元になる変数をドロップダウンリストから選択し，［追加］ボタンをクリックします。
   変数（変換先変数）	OutputData	データの変換先になる変数をドロップダウンリストから選択します。

   注※　変換元変数は2つ設定が必要です。

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

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

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

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

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

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

   

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

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

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

   

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

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

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

    

    注

    作成したXMLスキーマによって変換先スキーマの要素の出現順が一部異なるため，マッピング線の見え方が異なる場合があります。

12. データ変換定義画面のパレット［その他］から定数ファンクション（const）を選択します。

13. マッピングビューアで適当な場所をクリックして定数ファンクションを配置します。

14. 定数ファンクションをダブルクリックします。

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

15. ［定数］ダイアログで次の値を指定します。

    属性名	属性値
    ファンクション名	Success_Message
    文字列	Product is available for arrangement.

    

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

17. 次の図のようになるようにマッピング線を設定します。

    

(i)　応答アクティビティ（アクティビティ名：応答_手配成功）

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

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

2. 次の内容を入力します。

   

   項目名	設定する値	説明
   アクティビティ名	応答_手配成功	アクティビティの名称を入力します。
   オペレーション名	arrangeItem	対応する受付アクティビティに指定したオペレーション名を入力します。
   ボディ割当変数	OutputData	ビジネスプロセスの応答電文のボディに割り当てる変数をドロップダウンリストから選択します。
   ヘッダ割当変数	設定なし	ビジネスプロセスの応答電文のヘッダに変数を割り当てる場合に設定します。この商品手配システムでは使用しないため，設定しません。
   割当相関セット群	設定なし	相関セットグループをアクティビティに割り当てる場合に入力します。この商品手配システムでは使用しないため，設定しません。
   フォルト名	設定なし	フォルト処理として応答アクティビティを定義して，サービスリクエスタにフォルトが発生したことを示す応答電文を送信する場合のフォルトの名称を入力します。この商品手配システムではフォルト処理を使用しないため，設定しません。

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

(j)　分岐開始アクティビティ（アクティビティ名：在庫引当結果チェック）

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

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

2. アクティビティ名に「在庫引当結果チェック」を入力します。

3. ［遷移先］が［在庫なし設定］の行をクリックし，［上へ］ボタンをクリックして，いちばん上の行に移動します。

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

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

5. 次の内容を入力します。

   

   項目名	設定する値	説明
   条件名	No Stock	在庫がない場合の条件の名称を指定します。
   変数の表示	なし	このドロップダウンリストは，条件に変数を利用した式を設定する場合に一時的に使用するものです。ここでは何も設定しません。
   式※	csc:getVariableData("InventoryAllocationOutputData", "/csc-object/reservationNumber")="*"	在庫がない場合の条件式をXPath式で指定します。

   注※

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

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

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

7. ［遷移先］が［配送手配前処理］の［優先順位］をクリックし，ドロップダウンリストから「Default」を選択します。

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

   

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

(k)　分岐終了アクティビティ（アクティビティ名：在庫引当結果チェック_終了）

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

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

2. アクティビティ名に，「在庫引当結果チェック_終了」を入力します。

   

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