ビジネスメッセージを交換するために必要な情報のうち,CPAファイルに記載されているだけではuCosminexus Message Service for ebXMLが動作するのに不足している情報を定義します。ユーザーは,メッセージ交換定義導入コマンドを実行することによって,CPA拡張定義ファイルで定義した情報をメッセージ交換定義ファイルに追加します。
CPA拡張定義ファイルの作成は任意です。ただし,CPA拡張定義ファイルを作成する場合,ファイルの情報はメッセージ交換定義導入コマンドの引数として使用されるため,コマンド実行前にあらかじめファイルを作成しておいてください。
XML形式です。CPA拡張定義ファイルの記述形式を,次の表に示します。
表7-10 CPA拡張定義ファイルの記述形式
項番 | 要素 | 記述内容 | デフォルト値 | 任意/必須 |
---|---|---|---|---|
1 | CPAExtendInfo | CPA拡張定義ファイルのルート要素です。 | - | 任意(HTTPベーシック認証またはXML電子署名をする場合は必須) |
2 | ├SignatureRequired | ビジネスメッセージに対してXML電子署名をするかどうかを指定します。 次のどちらかの値を指定します。
| never | 任意(XML電子署名をする場合は必須) |
3 | ├SignPayload | ビジネスメッセージに対してXML電子署名をする場合に,ビジネスメッセージに添付するペイロードを電子署名対象とするかどうかを指定します。この項目は,項番1の指定が"always"の場合だけ有効になります。それ以外の場合は,無視されます。 次のどちらかの値を指定します
| always | 任意 |
4 | ├DurationTime | 送信メッセージの永続期限の最小値を,XMLスキーマのDuration形式で指定します。DurationTime要素の指定を省略した場合,送信メッセージの永続期間はCPAファイルのリトライ情報(RetriesおよびRetryInterval)から,次の式どおりに算出されます。 送信メッセージの永続期間=最小再送時間間隔×(最大再送回数+1)(秒) CPAファイルにリトライ情報がない場合,値は0となります。また,CPAファイルのリトライ情報の値に現実的でない大きな値を指定した場合,上に示す計算結果がDuration形式として不正な値になることがあります。 | なし。 | 任意 |
5 | ├AccessAuthenticationInfo | HTTP認証をすることを示す要素です。 | - | 任意(HTTPベーシック認証をする場合は必須) |
6 | │ └Basic | ベーシック認証をすることを示す要素です。 | - | 任意(HTTPベーシック認証をする場合は必須) |
7 | │ ├UserId | HTTPベーシック認証をする場合に,使用するユーザー名を指定します。 | なし。 | 任意(HTTPベーシック認証をする場合は必須) |
8 | │ └Password | HTTPベーシック認証をする場合に,使用するパスワードを指定します。 | なし。 | 任意(HTTPベーシック認証をする場合は必須) |
9 | └ConnectionTimeout | HTTPコネクションのタイムアウト時間を指定します。 TCP/IPコネクション確立時に,指定した期間反応がない場合は,通信エラーとします。 指定の範囲は,1~3,000(秒)です。 | 90 | 任意 |
(凡例)-:該当しません。
CPA拡張定義ファイルの格納先は任意です。
なお,次のディレクトリにサンプルファイルがあります。サンプルファイルを定義ファイルの格納ディレクトリにコピーして編集してください。
<uCosminexus Message Service for ebXMLインストールディレクトリ>¥sample¥conf¥cpa_extend.xml
/opt/ebxml/msh/sample/conf/cpa_extend.xml
<?xml version="1.0" encoding="Shift_JIS"?>
<CPAExtendInfo
xmlns="http://www.hitachi.co.jp/soft/xml/ebxml/msh/schema/cpa-entinfo.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SignatureRequired>always</SignatureRequired>
<SignPayload>always</SignPayload>
<DurationTime>P1D</DurationTime>
<AccessAuthenticationInfo>
<Basic>
<UserId>UserName</UserId>
<Password>Password</Password>
</Basic>
</AccessAuthenticationInfo>
<ConnectionTimeout>90</ConnectionTimeout>
</CPAExtendInfo>
<?xml version="1.0" encoding="UTF-8"?>
<CPAExtendInfo
xmlns="http://www.hitachi.co.jp/soft/xml/ebxml/msh/schema/cpa-entinfo.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SignatureRequired>always</SignatureRequired>
<SignPayload>always</SignPayload>
<DurationTime>P1D</DurationTime>
<AccessAuthenticationInfo>
<Basic>
<UserId>UserName</UserId>
<Password>Password</Password>
</Basic>
</AccessAuthenticationInfo>
<ConnectionTimeout>90</ConnectionTimeout>
</CPAExtendInfo>