2.10.4　アクティビティを設定する

(a)　要求電文（ヘッダ）および応答電文（ヘッダ）の変数

要求電文（ヘッダ）および応答電文（ヘッダ）の変数の定義手順を次に示します。

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

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

2. ［変数名］に任意の名称を指定します。

3. ［種別］ドロップダウンリストから「XML」を選択します。

4. ［電文フォーマット］の［参照］ボタンをクリックします。

   電文フォーマットを指定するダイアログが表示されます。

5. 変数に応じて次のファイルを指定します。

   • 要求電文（ヘッダ）の変数

     <サービスプラットフォームのインストールディレクトリ>\CSC\custom-reception\gRPC\schema\urecp_grpc_header_metadata_request.xsd

   • 応答電文（ヘッダ）の変数

     <サービスプラットフォームのインストールディレクトリ>\CSC\custom-reception\gRPC\schema\urecp_grpc_header_metadata_response.xsd

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

   変数が追加されます。

(b)　要求電文（ボディ），応答電文（ボディ），およびフォルト電文の変数

要求電文（ボディ），応答電文（ボディ），およびフォルト電文の変数の定義手順を次に示します。

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

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

2. ［変数名］に任意の名称を指定します。

3. ［種別］ドロップダウンリストから「XML」を選択します。

4. ［電文フォーマット］の［取込］ボタンをクリックします。

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

5. ［受付名］をチェックし，ドロップダウンリストからユーザ定義受付定義画面で設定したgRPC受付の名称を選択します。

6. ［オペレーション名］ドロップダウンリストからgRPC受付に設定したオペレーションを選択します。

7. 変数に応じて［電文種別］ドロップダウンリストで次のように選択します。

   • 要求電文（ボディ）の変数の場合

     ［要求電文（ボディ）］を選択します。

   • 応答電文（ボディ）の変数の場合

     ［応答電文（ボディ）］を選択します。

   • フォルト電文の変数の場合

     ［フォルト電文］を選択します。

8. ［電文フォーマット］に任意の名称を入力します。

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

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

    変数が追加されます。

(a)　受付アクティビティの場合

受付アクティビティに，追加した要求電文の変数を割り当てる手順を次に示します。

1. ビジネスプロセス定義画面のキャンバス上の受付アクティビティをダブルクリックします。

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

2. ［アクティビティ名］に任意の名称を入力します。

3. ［オペレーション名］の［取込］ボタンをクリックします。

   ［オペレーション名の取込］ダイアログが表示されます。

4. ［受付名］に該当するgRPC受付の名称を設定し，［オペレーション名］に取り込み対象となるオペレーション名を設定します。

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

6. ［ボディ割当変数］ドロップダウンリストから，定義した要求電文（ボディ）の変数を選択します。

7. ［ヘッダ割当変数］の［設定］ボタンをクリックします。

   ［ヘッダ割当変数］ダイアログが表示されます。

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

9. ［割当変数］セルのドロップダウンリストから，定義した要求電文（ヘッダ）の変数を選択します。

10. ［ルート要素］セルのドロップダウンリストからルート要素を選択します。

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

    ［ヘッダ割当変数］ダイアログが閉じます。

12. ［受付アクティビティ］ダイアログで［OK］ボタンをクリックします。

(b)　応答アクティビティの場合

応答アクティビティに，追加した応答電文の変数を割り当てる手順を次に示します。フォルト応答用の応答アクティビティについては，「(c) フォルト応答用の応答アクティビティの場合」を参照してください。

1. ビジネスプロセス定義画面のキャンバス上の応答アクティビティをダブルクリックします。

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

2. ［アクティビティ名］に任意の名称を入力します。

3. ［オペレーション名］の［取込］ボタンをクリックします。

   ［オペレーション名の取込］ダイアログが表示されます。

4. ［ユーザ定義受付から取込］ラジオボタンを選択し，［受付名］を選択します。

5. ［オペレーション名］にgRPC受付に設定したオペレーション名を設定します。

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

7. ［ボディ割当変数］ドロップダウンリストから，定義した応答電文（ボディ）の変数を選択します。

8. ［ヘッダ割当変数］の［設定］ボタンをクリックします。

   ［ヘッダ割当変数］ダイアログが表示されます。

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

10. ［割当変数］セルのドロップダウンリストから，定義した応答電文（ヘッダ）の変数を選択します。

11. ［ルート要素］セルのドロップダウンリストからルート要素を選択します。

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

    ［ヘッダ割当変数］ダイアログが閉じます。

13. ［応答アクティビティ］ダイアログで［OK］ボタンをクリックします。

(c)　フォルト応答用の応答アクティビティの場合

フォルト応答用の応答アクティビティに，追加したフォルト電文の変数を割り当てる手順を次に示します。

1. ビジネスプロセス定義画面のキャンバス上の応答アクティビティをダブルクリックします。

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

2. ［アクティビティ名］に任意の名称を入力します。

3. ［オペレーション名］の［取込］ボタンをクリックします。

   ［オペレーション名の取込］ダイアログが表示されます。

4. ［受付名］を選択し，［オペレーション名］にgRPC受付に設定したオペレーション名を設定します。

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

6. ［ボディ割当変数］ドロップダウンリストから，定義したフォルト電文の変数を選択します。

7. ［フォルト名］にgRPC受付で定義されたフォルト名を入力します。

8. ［応答アクティビティ］ダイアログで［OK］ボタンをクリックします。

(a)　要求電文のヘッダ電文フォーマット

gRPC受付の要求電文のヘッダ電文フォーマットは，サービスプラットフォームが提供するスキーマを使用します。そのため，ヘッダ電文の定義ファイルの作成は不要です。

サービスプラットフォームが提供する電文フォーマットのXMLスキーマは，「<サービスプラットフォームのインストールディレクトリ>\CSC\custom-reception\gRPC\schema」に格納されています。

gRPC受付の要求電文フォーマットの形式を次に示します。名前空間名は「http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/grpc/header/metadata_request」です。

表2‒38　gRPC受付のヘッダ電文の要求電文フォーマット

タグ名			種別	出現回数	説明
<grpc-metadata-request>			−	1回	−
	<metadata>		−	0回以上	gRPCクライアントから送信されたメタデータが設定されます。
		<key>	string	1回	gRPCクライアントから送信されたメタデータのキーが設定されます。 バイナリ形式の場合，この要素値は「-bin」で終了します。
		<value>	string	1回	メタデータのキーに対する値が設定されます。 バイナリ形式の場合，Base64でエンコードした値を設定します。

(b)　応答電文のヘッダ電文フォーマット

gRPC受付の応答電文のヘッダ電文フォーマットは，サービスプラットフォームが提供するスキーマを使用します。そのため，ヘッダ電文の定義ファイルの作成は不要です。

サービスプラットフォームが提供する電文フォーマットのXMLスキーマは，「<サービスプラットフォームのインストールディレクトリ>\CSC\custom-reception\gRPC\schema」に格納されています。

gRPC受付の応答電文フォーマットの形式を次に示します。名前空間名は「http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/grpc/header/metadata_response」です。

表2‒39　gRPC受付のヘッダ電文の応答電文フォーマット

タグ名			種別	出現回数	説明
<grpc-metadata-response>			−	1回	−
	<metadata>		−	0回以上	gRPCクライアントに送信するメタデータが設定されます。
		<key>	string	1回	gRPCクライアントに送信するメタデータのキーが設定されます。キーに指定できる値は半角英数字とアンダーバー（_），ハイフン（-），ピリオド（.）です。キーの省略はできません。また，指定値の大文字・小文字は区別しません。 バイナリ形式で送信する場合，この要素値は「-bin（大文字・小文字を区別する）」で終了します。ただし，「-bin」だけを指定することはできません。
		<value>	string	1回	メタデータのキーに対する値が設定されます。 テキスト形式の場合の，指定できる値は「0x20」，および「0x21-0x7E」の範囲の文字列です。指定できる値以外を指定した場合は，動作は保証されません。空白（0x20）は，値の最初または最後に置くことはできません。 バイナリ形式の場合，Base64でエンコードした値を設定します。