Cosminexus ビジネスプロセス管理/エンタープライズサービスバス V8　サービスプラットフォーム 開発ガイド

[目次][用語][索引][前へ][次へ]

20.5.2　FTP受付の応答電文フォーマット

FTP受付の応答電文フォーマットをオペレーションごとに示します。

＜この項の構成＞
(1)　PUTオペレーション
(2)　GETオペレーション
(3)　GETINFOオペレーション

(1)　PUTオペレーション

ビジネスプロセスからPUTオペレーションのFTP受付に渡す応答電文フォーマットを次に示します。名前空間名は「http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/ftp/put_response」です。

表20-11　FTP受付の応答電文フォーマット（PUTオペレーション）

タグ名 出現回数※1 説明
<response> 1回 − 
　
　
 <message> 0または1回 ビジネスプロセスの終了状態を示すメッセージです。指定できるメッセージの最大長は1,024文字です。
最大長を超える長さのメッセージを指定した場合，メッセージが1,024文字に収まるようメッセージの後ろの部分は切り捨てられます。
使用できない文字※2が含まれていた場合，使用できない文字はクエスチョンマーク（?）に置き換えられます。
省略した場合，次のメッセージが設定されます。
  • <success>タグの値がtrueの場合
    Transfer complete.
  • <success>タグの値がfalseの場合
    Requested action aborted.
<success> 0または1回 ビジネスプロセスの終了状態を示すフラグです。次のどちらかを指定します。
  • true
    ビジネスプロセスの処理が正常に終了した。
  • false
    ビジネスプロセスの処理でエラーが発生した。
省略した場合，trueが設定されます。

（凡例）
−：該当する項目はありません。

注※1
規定の出現回数を超える場合の動作は保証しません。

注※2
次に示す文字以外は使用できません。
半角英数字，半角空白，半角タブ，半角改行，感嘆符（!），ダブルクォーテーション（"），番号記号（#），ドル記号（$），パーセント（%），アンパサンド（&），アポストロフィ（'），始め小括弧（(），終わり小括弧（)），アスタリスク（*），正符号（+），コンマ（,），ハイフン（-），ピリオド（.），スラッシュ（/），コロン（:），セミコロン（;），左アングルブラケット（<），右アングルブラケット（>），等号（=），クエスチョンマーク（?），単価記号（@），始め角括弧（[），終わり角括弧（]），円マーク（\），アクサンシルコンフレックス（^），アンダーライン（_），アクサングラーブ（`），始め波括弧（{），終わり波括弧（}），パイプライン（|），波ダッシュ（~）

(2)　GETオペレーション

ビジネスプロセスからGETオペレーションのFTP受付に渡す応答電文フォーマットを次に示します。名前空間名は「http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/ftp/get_response」です。

表20-12　FTP受付の応答電文フォーマット（GETオペレーション）

タグ名 出現回数※1 説明
<response> 1回 − 
　
　
　
　
 <message> 0または1回 ビジネスプロセスの終了状態を示すメッセージです。指定できるメッセージの最大長は1,024文字です。
最大長を超える長さのメッセージを指定した場合，メッセージが1,024文字に収まるようメッセージの後ろの部分は切り捨てられます。
使用できない文字※2が含まれていた場合，使用できない文字はクエスチョンマーク（?）に置き換えられます。
省略した場合，次のメッセージが設定されます。
  • <success>タグの値がtrueの場合
    Transfer complete.
  • <success>タグの値がfalseの場合
    Requested action not taken.
<success> 0または1回 ビジネスプロセスの終了状態を示すフラグです。次のどちらかを指定します。
  • true
    ビジネスプロセスの処理が正常に終了した。
  • false
    ビジネスプロセスの処理でエラーが発生した。
省略した場合，trueが設定されます。
<file-name> 0または1回 FTPクライアントへ送り返すファイルのデータが書き出された中間ファイルのファイル名です。
ただし，<success>タグの値がfalseの場合，この設定は不要です。もし設定されていても無視されます。
<file-size> 0または1回 FTPクライアントへ送り返すファイルのデータのサイズです。
ただし，<success>タグの値がfalseの場合，この設定は不要です。もし設定されていても無視されます。

（凡例）
−：該当する項目はありません。

注※1
規定の出現回数を超える場合の動作は保証しません。

注※2
次に示す文字以外は使用できません。
半角英数字，半角空白，半角タブ，半角改行，感嘆符（!），ダブルクォーテーション（"），番号記号（#），ドル記号（$），パーセント（%），アンパサンド（&），アポストロフィ（'），始め小括弧（(），終わり小括弧（)），アスタリスク（*），正符号（+），コンマ（,），ハイフン（-），ピリオド（.），スラッシュ（/），コロン（:），セミコロン（;），左アングルブラケット（<），右アングルブラケット（>），等号（=），クエスチョンマーク（?），単価記号（@），始め角括弧（[），終わり角括弧（]），円マーク（\），アクサンシルコンフレックス（^），アンダーライン（_），アクサングラーブ（`），始め波括弧（{），終わり波括弧（}），パイプライン（|），波ダッシュ（~）

(3)　GETINFOオペレーション

ビジネスプロセスからGETINFOオペレーションのFTP受付に渡す応答電文フォーマットを次に示します。名前空間名は「http://www.hitachi.co.jp/soft/xml/cosminexus/csc/reception/ftp/getinfo_response」です。

表20-13　FTP受付の応答電文フォーマット（GETINFOオペレーション）

タグ名 出現回数※1 説明
<response> 1回 − 
　
　
　
　
 <reply-code> 0または1回 情報取得処理を実行したときにFTPサーバから受け取ったリプライコード（またはそれに準ずるコード）です。
FTPアダプタのGETINFOオペレーションを使用して情報取得処理を実行する場合は，FTPアダプタの応答電文の<reply-code>の値をこのタグに設定することを推奨しています。
このタグに指定できる値は，200〜299の数値，または
400〜599の数値です。
200〜299を設定した場合は，FTPクライアントに返されるリプライコードは266となります。
400〜599の値を設定した場合は，設定した値がFTPクライアントに返されるリプライコードとなります。
<success>タグの値がtrueで，このタグを省略した場合は，FTP受付がリプライコードに226を仮定します。
<success>タグの値がfalseの場合は，この設定は不要です。もし設定されていても無視されます。
<message> 0または1回 情報取得処理を実行したときにFTPサーバから受け取ったリプライメッセージ，またはビジネスプロセスの終了状態を示すメッセージです。
指定できるメッセージの最大長は1,024文字です。最大長を超える長さのメッセージを指定した場合，メッセージが1,024文字に収まるようメッセージの後ろの部分は切り捨てられます。
使用できない文字※2が含まれていた場合，使用できない文字はクエスチョンマーク（?）に置き換えられます。
省略した場合，次のメッセージが設定されます。
  • <success>タグの値がtrueの場合
    Transfer complete.
  • <success>タグの値がfalseの場合
    Requested action not taken.
FTPアダプタのGETINFOオペレーションを使用して情報取得処理を実行する場合は，FTPアダプタの応答電文の<reply-message>の値をこのタグに設定することを推奨しています。
<success> 0または1回 ビジネスプロセスの終了状態を示すフラグです。次のどちらかを指定します。
  • true
    ビジネスプロセスの処理が正常に終了した。
  • false
    ビジネスプロセスの処理でエラーが発生した。
省略した場合，trueが設定されます。
<file-name> 0または1回 FTPクライアントへ送り返すデータが書き出された中間ファイルのファイル名です。
このタグに指定したファイルには，次の形式で取得した情報が書き込まれる必要があります。
  • 文字コード：UTF-16
  • 改行コード：CRLF
ただし，次のどちらかに当てはまる場合，この設定は不要です。もし設定されていても無視されます。
  • <success>タグの値がfalseの場合
  • <success>タグの値がtrueで，<reply-code>の値が400〜599場合

（凡例）
−：該当する項目はありません。

注※1
規定の出現回数を超える場合の動作は保証しません。

注※2
次に示す文字以外は使用できません。
半角英数字，半角空白，半角タブ，半角改行，感嘆符（!），ダブルクォーテーション（"），番号記号（#），ドル記号（$），パーセント（%），アンパサンド（&），アポストロフィ（'），始め小括弧（(），終わり小括弧（)），アスタリスク（*），正符号（+），コンマ（,），ハイフン（-），ピリオド（.），スラッシュ（/），コロン（:），セミコロン（;），左アングルブラケット（<），右アングルブラケット（>），等号（=），クエスチョンマーク（?），単価記号（@），始め角括弧（[），終わり角括弧（]），円マーク（\），アクサンシルコンフレックス（^），アンダーライン（_），アクサングラーブ（`），始め波括弧（{），終わり波括弧（}），パイプライン（|），波ダッシュ（~）

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.