5.5.1　変数の定義

(a)　スコープアクティビティを使用している場合の変数の使用

ビジネスプロセス内またはスコープ内のアクティビティで使用する変数を追加したり，編集したりできます。このとき，外側のスコープで宣言した変数は，内側のスコープから参照できますが，内側のスコープで宣言した変数はスコープ外からは参照できません。また，スコープが異なる場合は，同じ変数名を宣言できます。次に示す図の場合，スコープAやスコープBはプロセス（外側）の変数を参照できますが，プロセス（外側）からはスコープAやスコープBの変数は参照できません。

図5‒7　スコープと変数の関係

(b)　フォルト処理を定義する場合の変数

• スコープアクティビティにフォルト処理を定義する場合に，次の変数を定義するときに注意する点を説明します。

  • ［フォルト処理の割当］ダイアログの割り当て変数

  • フォルトコネクションの接続先のアクティビティで設定する変数

  これらの変数には，フォルト処理を定義したスコープの外側のスコープで定義された変数を定義してください。スコープ内で定義された変数は定義できません。

  これらの変数と，フォルト処理を定義したスコープで定義した変数が，同じ名前でないことを確認してください。同じ名前の変数が定義されていると，アクティビティ実行時にフォルト処理を定義したスコープの変数が使用され，意図しない動作をするおそれがあるためです。

• 次のアクティビティで同じ変数を使用したい場合は，フォルト処理を定義したスコープの外側のスコープで定義された変数を使用するよう定義してください。

  • スコープ内に定義したアクティビティ

  • フォルトコネクションの接続先のアクティビティ

(c)　補償処理を定義する場合の変数

• スコープアクティビティに補償処理を定義する場合に，補償コネクションの接続先のアクティビティで設定する変数を定義するときに注意する点を説明します。

  • この変数には，補償処理を定義したスコープの外側のスコープで定義された変数を定義してください。スコープ内で定義された変数は定義できません。

  • この変数と，補償処理を定義したスコープで定義した変数が，同じ名前でないことを確認してください。同じ名前の変数が定義されていると，アクティビティ実行時に補償処理を定義したスコープの変数が使用され，意図しない動作をするおそれがあるためです。

• スコープの実行が完了すると，スコープに定義されたローカル変数は削除されます。そのため，次のアクティビティで同じ変数を使用したい場合は，補償処理を定義したスコープの外側のスコープで定義された変数を使用するよう定義してください。

  • スコープ内に定義したアクティビティ

  • 補償コネクションの接続先のアクティビティ

(d)　変数の定義で設定する電文フォーマット

電文フォーマットのファイル名

変数の定義時には，同じファイル名で異なるXMLスキーマの電文フォーマットである定義ファイルを複数の変数で設定できます。しかし，実行時には，どれか1つのXMLスキーマが使用されるため，意図しない動作をする場合があります。したがって，変数の定義で設定する電文フォーマットのファイル名とXMLスキーマは，必ず1対1になるように設定してください。

外部のXMLスキーマの参照を含む電文フォーマットの設定

外部のXMLスキーマを参照している電文フォーマットを設定する場合，必ずルートスキーマに当たるファイルを設定してください。ルートスキーマから参照される外部のXMLスキーマファイルは，自動的に取り込まれます。

電文フォーマットの形式

変数に使用する電文フォーマットは，一定の条件を満たしている必要があります。条件の詳細については，「2.6.5　XMLスキーマの適用範囲」を参照してください。

(e)　変数の定義情報の変更

変数および相関セットの定義情報（変数名，型，電文フォーマット，部分）は，必要に応じて変更または削除できます。

注意事項

変数の定義情報を変更する場合は，次の点に注意してください。

• データ変換アクティビティで使用している変数の電文フォーマットを変更した場合は，データ変換を定義し直してください。電文フォーマットを変更した場合の手順については，「7.3.2　電文フォーマットを変更した場合の定義手順」を参照してください。

• データ変換定義ファイルが定義済みのデータ変換アクティビティで使用している変数の変数名を変更した場合，警告メッセージが表示されます。この場合，変更した変数に関わるマッピングは破棄されます。

• 変数の定義情報を変更すると，その変数を割り当てた個所に，再度割り当てが必要になる場合があります。

  例えば，あるアクティビティに変数Xを割り当て，その後，その変数Xの名前を変数Yに変更した場合，次のどちらかを行ってください。

  ・アクティビティへ再度変数を割り当てる。

  ・再度変数Xを定義する。

• ビジネスプロセスをバージョンアップしたあとに変数を変更する場合は注意が必要です。詳細は，「5.9.4(3)　ビジネスプロセスのバージョンアップ時の注意事項」を参照してください。

(f)　変数の定義情報の初期化

ビジネスプロセスを実行するときに，変数には，文字，メッセージに含まれる数値や条件式の項となる数値，またはメッセージを設定する必要があります。

サービスリクエスタからの要求を受け付けたときや，サービス呼出アクティビティでサービスからの応答を受け取ったときは，変数に値が入っていますが，それ以外はデータ変換アクティビティや代入アクティビティなどを使用して変数に値を設定（初期化）する必要があります。

変数の初期化が不要な場合について説明します。

次の個所に指定している変数は，変数（電文）を参照する前に値が設定されているため，変数の初期化は不要です。

• サービスリクエスタから要求を受け付けた変数

• サービス呼出アクティビティの応答電文のボディ割当変数/ヘッダ割当変数

• Java呼出アクティビティの戻り値用割当変数

• データ変換アクティビティの変換先変数

• 代入アクティビティのコピー先の変数

• フォルトコネクションに指定した割当変数

変数の初期化が不要な場合の例を次の図に示します。

図5‒8　変数の初期化が不要な場合の例

変数A：

サービスリクエスタからの要求電文が変数の値として設定されます。また，サービス呼出は値が設定済みの変数Aを要求電文としているため，初期化は不要です。

変数B：

サービスからの応答電文で変数が設定されるため，初期化は不要です。

変数の初期化が必要な場合について説明します。

変数の初期化が不要な場合に示した個所に指定していない変数は値が設定されていないため，ビジネスプロセス上で参照するとエラーになります。事前に値を設定し，変数を初期化しておく必要があります。

値が設定されていない変数を指定する可能性のある個所を次に示します。

• サービス呼出アクティビティの要求電文のボディ割当変数/ヘッダ割当変数

• Java呼出アクティビティの引数用割当変数

• データ変換アクティビティの変換元変数

• 代入アクティビティのコピー元の変数

• 待機アクティビティ，検証アクティビティ，繰り返しアクティビティ，分岐アクティビティ，リンクコネクションのXPath式内で変数名を記述している個所

• 応答アクティビティのボディ割当変数/ヘッダ割当変数

変数の初期化が必要な場合の例を次の図に示します。

図5‒9　変数の初期化が必要な場合の例

変数A：

サービスリクエスタからの要求電文が変数に設定されているため，初期化は不要です。

変数B：

変数の初期化が必要になります。データ変換Aで変数Aの情報を基に，変数Bに値を設定します。

変数C：

サービスからの応答電文が変数に設定されるため，初期化は不要です。

変数D：

変数の初期化が必要になります。データ変換Bで変数Cの情報を基に，変数Dに値を設定します。

(a)　新規に変数を定義する場合

新規に変数を定義する手順を次に示します。なお，変数は，繰り返しアクティビティ内のキャンバスでは定義できません。

1. 次のどれかの方法で，変数・相関セット一覧ダイアログを表示します。

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

   • 次に示すアクティビティダイアログの［編集］ボタンをクリックします。

     ・受付アクティビティ

     ・応答アクティビティ

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

     ・Java呼出アクティビティ

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

     ・代入アクティビティ

     ・フォルト送出アクティビティ

     ・検証アクティビティ

   • 次に示すダイアログのボタンをクリックします。

     ・［条件式の作成］ダイアログ（繰り返しアクティビティまたは分岐アクティビティから表示）の［編集］ボタン

     ・繰り返しアクティビティの［繰り返しリスト設定］ダイアログの［編集］ボタン

2. 一覧から「変数一覧」を選択します。

3. 変数名を入力します。

4. 変数の種別をドロップダウンリストから選択します。

5. 変数の種別がメッセージ型の場合，必要に応じて，次のどちらかの操作をします。

   呼び出すサービス部品またはユーザ定義受付の要求電文，応答電文，またはフォルト電文に設定されている電文フォーマットを，変数に設定する場合

   ［取込］ボタンをクリックし，［電文フォーマットの取込］ダイアログを表示します。［電文フォーマットの取込］ダイアログで，使用する電文フォーマットを指定します。

   ［電文フォーマットの取込］ダイアログの入力・表示項目の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「1.4.5　電文フォーマットの取込ダイアログ」を参照してください。

   ［電文フォーマットの取込］ダイアログでの操作の終了後，手順6.に進みます。

   上記以外の電文フォーマットを変数に設定する場合

   ［参照］ボタンをクリックして，変数を使用する電文フォーマットの定義ファイルを設定します。

   サービスアダプタからサービス部品を呼び出したときに発生したエラーの例外を，サービスアダプタでフォルト電文に変換する場合は，［参照］ボタンをクリックして，<サービスプラットフォームのインストールディレクトリ>\CSC\system\msg\cscfault.xsdを選択してください。

6. 変数の種別がメッセージ型の場合，［部分指定］チェックボックスにチェックします。

7. ［行追加］ボタンをクリックし，部分名，指定式，および型を指定します。

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

   変数一覧に，追加した変数が表示されます。

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

注意事項

変数・相関セット一覧ダイアログから電文フォーマットの定義ファイルを指定する場合，ファイル名はNCName型で指定します。

NCName型ではない場合，指定時にエラーとなります。

(b)　電文フォーマットの定義ファイルを変更した場合

変数の定義で設定した電文フォーマットの定義ファイルを変更した場合，変更後の定義ファイルの内容は，次の手順で反映できます。

1. 変数・相関セット一覧ダイアログを表示します。

   変数・相関セット一覧ダイアログを表示する方法については，「5.5.1(6)(a)　新規に変数を定義する場合」の手順1.を参照してください。

2. 次のどちらかの操作をします。

   変数の種別がメッセージ型の場合で，呼び出すサービス部品またはユーザ定義受付の要求電文，応答電文，またはフォルト電文に設定されている電文フォーマットを，変数に設定する場合

   ［取込］ボタンをクリックし，［電文フォーマットの取込］ダイアログを表示します。［電文フォーマットの取込］ダイアログで，使用する電文フォーマットを指定します。

   ［電文フォーマットの取込］ダイアログの入力・表示項目の詳細については，マニュアル「サービスプラットフォーム リファレンス」の「1.4.5　電文フォーマットの取込ダイアログ」を参照してください。

   ［電文フォーマットの取込］ダイアログでの操作の終了後，手順3.に進みます。

   変数の種別がメッセージ型の場合で，上記以外の場合

   ［参照］ボタンをクリックして，変数を使用する電文フォーマットの定義ファイルを設定します。

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