WebOTX Manual V10.4 (第4版) 目次を表示

---

3.2.8. FTPバインディング

図2.9.8-1

3.2.8.1. サービスユニットのファイル構成

図2.9.8.1-1

3.2.8.2. エンドポイントの設定

図2.9.8.2-1

Memo
 エンドポイントを追加する方法については、 2.7.1. エンドポイントの追加 をご覧下さい。

Caution
  エンドポイントのサービス名とエンドポイント名の設定は他のエンドポイントと重複しないようにしてください。

図2.9.8.2-2

3.2.8.3. オペレーション設定

図2.9.8.3-1

図2.9.8.3-2

図2.9.8.3-3

図2.9.8.3-4

Caution
OS及びFTPサーバの実装によっては、COPY操作およびRENAME操作で既に同名のファイルが存在している場合に、操作が失敗することがあります。その場合は、WebOTX ESBのログおよびOS、FTPサーバのログでエラー情報を確認してください。

図2.9.8.3-5

3.2.8.4. セキュリティ認証の設定

図2.9.8.4-1

3.2.8.5. トランザクションの設定

3.2.8.6. メッセージ送信優先度の設定

3.2.8.7. エラーリトライの設定

3.2.8.8. オプション一覧の設定

3.2.8.9. メッセージエクスチェンジハンドラの設定

3.2.8.10. メッセージコンバートハンドラの設定

3.2.8.11. メッセージ交換方式(MEP)

3.2.8.12. ノーマライズ規則

図2.9.8.12-1

図2.9.8.12-2

3.2.8.13. 異常系メッセージ

WebOTX ESBにおいて「FTP BCに誤ったメッセージが入力された」、「サービス呼び出しに失敗した」等の異常が発生した場合、FTP BCのInbound/Outboundから出力ディレクトリにエラーファイルが出力されます。 クライアントアプリケーションでは出力されたエラーファイルの内容から発生した異常の内容を知ることができます。 以下では、発生する異常の種類ごとのFTP BCからのエラーファイルに格納するメッセージを説明します。

異常の種類により Fault または Error の分類があります。 File BCにおいて異常が発生するパターンの一覧です。 [ リファレンス集 開発編（Enterprise Service Bus） > 2. 異常系メッセージ(Fault/Error) > 2.1. バインディングコンポーネント > 2.1.8. FTP BC ]

相手のエンドポイントがFaultを返却した場合

相手のエンドポイントから Fault を受け取った場合、 FTP BCで受け取ったFault形式のメッセージをファイルに出力します。 SOAP BCから Fault メッセージが通知された例です。

uploaded.txt

<esb-fault xmlns="http://www.nec.com/WebOTX/jbi/fault/"><exchangeid>1340002404705-00000056</exchangeid><date>2012-06-18T14:53:24.768+08:00</date><component>SOAPBinding</component><service-assembly>FTP-Soap</service-assembly><service-unit>SoapOutbound</service-unit><service-name xmlns:ns2="http://www.nec.com/esb/SOAPOutbound">ns2:SOAPOutboundService</service-name><endpoint>SoapOutboundEndpoint</endpoint><role>PROVIDER</role><string>500</string><detail><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body><S:Fault xmlns:ns4="http://www.w3.org/2003/05/soap-envelope"><faultcode xmlns="" xmlns:ns4_="http://www.nec.com/WebOTX/jbi/fault/">S:Client</faultcode><faultstring xmlns="" xmlns:ns4_="http://www.nec.com/WebOTX/jbi/fault/">Cannot find dispatch method for {}inputxml</faultstring></S:Fault></S:Body></S:Envelope></detail></esb-fault>

相手のエンドポイントがErrorを返却した場合
入力ファイルのチェックに失敗した場合

相手のエンドポイントから Error を受け取った場合、入力ファイルのチェックに失敗した場合（たとえば、制御ファイルフォーマット不正）、 FTP BCで Exception 形式のメッセージを *.err というファイルに出力します。 File BC から Error メッセージが通知された例です。

uploaded.err

制御メッセージファイル(null)は有効ではありません。:cvc-elt.1: Cannot find the declaration of element 'abc'.
com.nec.webotx.jbi.binding.file.util.Util.setWebOTXESBException(Util.java:82)
com.nec.webotx.jbi.binding.file.MessageProcessor.processException(MessageProcessor.java:3637)
com.nec.webotx.jbi.binding.file.MessageProcessor.processProviderInout(MessageProcessor.java:3625)
com.nec.webotx.jbi.binding.file.MessageProcessor.execute(MessageProcessor.java:510)
com.nec.webotx.jbi.common.thread.WorkThread.processCommand(WorkThread.java:259)
com.nec.webotx.jbi.common.thread.WorkThread.run(WorkThread.java:97)
java.lang.Thread.run(Thread.java:595)

3.2.8.14. ファイル名のパターン

FTPで受信するファイル名、および送信するファイル名には正規表現や特殊文字を使用することが可能です。 「簡易設定」、「標準設定」や設定する箇所により使用方法が異なるため、以下ではそれぞれ説明します。

簡易設定

簡易設定では、ファイル名に関する設定は「ファイル名のパターン」、「Inboundファイル名のプレフィックス」、「Outboundファイル名のプレフィックス」 の3つがあります。Inboundファイル名、Outboundファイル名はそれぞれ次のようになります。

• Inboundファイル名＝「Inboundファイル名のプレフィックス」 + 「ファイル名のパターン」
  Inboundファイル名は、コンシューマでは受信時のファイル名、プロバイダでは送信時のファイル名となります。
  プロバイダ且つFTP BCコンポーネントの設定項「新仕様のパターンを使用する」をチェックした場合、「Inboundファイル名のプレフィックス」が無効で、Inboundファイル名＝「ファイル名のパターン」です。
• Outboundファイル名＝「Outboundファイル名のプレフィックス」+ 「ファイル名のパターン」
  Outboundファイル名は、コンシューマでは送信時のファイル名、プロバイダでは受信時のファイル名となります。
  コンシューマ且つFTP BCコンポーネントの設定項「新仕様のパターンを使用する」をチェックした場合、「Outboundファイル名のプレフィックス」が無効で、Outboundファイル名＝「ファイル名のパターン」です。

それぞれの設定値について説明します。

既定値ではInboundファイル名は、Inboundファイル名＝ req. + %u、となるため 次のようなファイル名のファイルを受信および送信します。
req.45dd0f88-646c-4cf0-8883-769cd3f010d3

「ファイル名のパターン」に使用可能な特殊文字について説明します。
FTP BCコンポーネントの設定項「新仕様のパターンを使用する」をチェックしない場合、特殊文字にはタイムスタンプ記号とUUIDがあります。 「新仕様のパターンを使用する」をチェックした場合、特殊文字にはタイムスタンプ記号、UUID、シーケンス番号、プロセスID、 メッセージID、Trace-ID、ファイル名置換(拡張子を含まない)、ファイル名置換(拡張子を含む)があります。

(1) タイムスタンプ記号（%[GyMdhHmsSEDFwWakKz]

それぞれの意味は下記のとおりです。

固定の桁数で出力するには、桁数分の記号を記述します。
例えば、現在が2012年1月の場合それぞれ次のように展開されます。

• %y%y-%M → 12-1
• %y%y%y%y-%M%M → 2012-01

(2) UUID(%u)

%u を指定します。例として、req_%u_down.txt と指定する場合、次のように展開されます。
req_45dd0f88-646c-4cf0-8883-769cd3f010d3_down.txt

(3) シーケンス番号(%#)

%# を指定します。参照されるごとに自動的に1を増加する。例として、req_%#.txt と指定する場合、次のように展開されます。
req_1.txt、req_2.txt。
また、桁数を指定できます。桁数に達していない場合、0を補足して出力します。例として req_%3#.txt と指定する場合、次のように展開されます。
req_001.txt、req_002.txt

(4) プロセスID(%i)

%i を指定します。例としてプロセスIDが1367の場合、req_%i.txt と指定すると次のように展開されます。
req_1367.txt
また、 WebOTX ESBをWebOTX ASのExpress、および、Standard/Enterpriseのスタンダードエディションとの組み合わせで動作している場合は、パターンは展開されずそのまま%iが出力されます。

(5) メッセージID(%e)

%e を指定します。例としてメッセージIDが1331187554976-00000941の場合、req_%e.txt と指定すると次のように展開されます。
req_1331187554976-00000941.txt
また、 idが取得できない場合、そのまま%eを出力します。

(6) Trace-ID(%t)

%t を指定します。例として Trace-ID が1341125617871-00000107の場合、req_%t.txt と指定すると次のように展開されます。
req_1341125617871-00000107.txt
また、 Trace-ID が取得できない場合、そのまま%tを出力します。

(7) ファイル名置換(拡張子を含まない)(%f)

%f を指定します。受信ファイル名（拡張子を含まない）に変換します。例として受信ファイル名がreq.txtの場合、%f.txt と指定すると次のように展開されます。
req.txt
FTP BC同士、あるいはFile BCとの組み合わせでのみ使用可能です。置換ファイル名が保持されていない場合、そのまま%fが出力されます。

(8) ファイル名置換(拡張子を含む)(%x)

%x を指定します。受信ファイル名（拡張子を含む）に変換します。例として受信ファイル名がreq.datの場合、%x.txt と指定すると次のように展開されます。
req.dat.txt
FTP BC同士、あるいはFile BCとの組み合わせでのみ使用可能です。置換ファイル名が保持されていない場合、そのまま%xが出力されます。

標準設定

標準設定では、「送信ファイル名」と「受信ファイル名」の設定にはファイル名を含むフルパスを指定する必要があります。それぞれ「送信/受信ファイル名にパターンを有効にする」をtrueにすることで正規表現や特殊文字が使用可能になります。
同様に、「送信前/送信後/受信前/受信後コマンドのターゲット」にもそれぞれ「送信前/送信後/受信前/受信後ロケーションにパターンを有効にする」をtrueにすることで特殊文字が使用可能になります。

「受信ファイル名」に使用可能なパターン

「受信ファイル名」は「受信ファイル名にパターンを有効にする」がtrueに設定される場合に正規表現を使うことができます。
例えば、invoice_[0-1][1-9]\.xml のように指定でき、invoice_01.xml、invoice_29.xml などといったファイル名のファイルを処理対象にできます。

「送信ファイル名」、「送信前/送信後/受信前/受信後コマンドのターゲット」に使用可能なパターン

FTP BCコンポーネントの設定項「新仕様のパターンを使用する」をチェックしない場合、タイムスタンプ記号、UUID、パス名・ファイル名の3種類のパターンを使用できます。
「新仕様のパターンを使用する」をチェックした場合、特殊文字にはタイムスタンプ記号、UUID、シーケンス番号、プロセスID、 メッセージID、Trace-ID、ファイル名置換(拡張子を含まない)、ファイル名置換(拡張子を含む)、 パス名を使用できます。

(1) タイムスタンプ記号(%[GyMdhHmsSEDFwWakKz])

それぞれの意味は下記のとおりです。

(2) UUID(%u)

%u を指定します。例として req_%u_down.txt と指定する場合、次のように展開されます。
req_45dd0f88-646c-4cf0-8883-769cd3f010d3_down.txt

(3) パス名(%p)

%p を指定します。コンシューマ側の場合ユーザが指定するinフォルダ、プロバイダ側の場合ユーザが指定するoutフォルダに変換します。例えば「送信ファイル名」に "%p_backup/output.bak" と指定する場合、受信ファイル名が my_in_box/invoice.dat であれば、展開後の出力ファイルは my_in_box_backup/output.bak となります。

(4) シーケンス番号(%#)

%# を指定します。参照されるごとに自動的に1カウントアップします。例として req_%#.txt と指定する場合、次のように展開されます。
req_1.txt、req_2.txt。
また、桁数を指定できます。桁数に達していない場合、0を補足して出力します。例として req_%3#.txt と指定する場合、次のように展開されます。
req_001.txt、req_002.txt

(5) プロセスID(%i)

%i を指定します。例としてプロセスIDが1367の場合、req_%i.txt と指定すると次のように展開されます。
req_1367.txt
また、 WebOTX ESBをWebOTX ASのExpress、および、Standard/Enterpriseのスタンダードエディションとの組み合わせで動作している場合は、パターンは展開されずそのまま%iが出力されます。

(6) メッセージID(%e)

%e を指定します。例としてメッセージIDが1331187554976-00000941の場合、req_%e.txt と指定すると次のように展開されます。
req_1331187554976-00000941.txt
また、 idが取得できない場合、そのまま%eが出力されます。

(7) Trace-ID(%t)

%t を指定します。例として Trace-IDが1341125617871-00000107の場合、req_%t.txt と指定すると次のように展開されます。
req_1341125617871-00000107.txt
また、 Trace-IDが取得できない場合、そのまま%tが出力されます。

(8) ファイル名置換(%f)

%f を指定します。例として受信ファイル名がreq.txtの場合、%f.txt と指定すると次のように展開されます。
req.txt
FTP BC同士、あるいはFile BCとの組み合わせでのみ使用可能です。置換ファイル名が保持されていない場合、そのまま%fが出力されます。

FTP BCコンポーネントの設定項「新仕様のパターンを使用する」をチェックしない場合、「送信ファイル名」で指定する場合と「送信前/送信後/受信前/受信後コマンドのターゲット」で指定する場合で拡張子の扱いが異なることに注意してください。

• 「送信ファイル名」では %f を受信ファイル名（拡張子を含まない）に変換します。
  例えば、「送信ファイル名」に "%p_backup/%f.bak" と指定する時に、受信ファイル名が my_in_box/invoice.dat であれば、展開後の出力ファイルは my_in_box_backup/invoice.bak となります。
• 「送信前/送信後/受信前/受信後コマンドのターゲット」では %f を操作元ファイル名（拡張子を含む）に変換します。
  例えば、「送信前コマンドのターゲット」を "%f.bak" と指定する時、操作元ファイル名が invoice.dat であれば、展開後の出力ファイルは invoice.dat.bak となります。

FTP BCコンポーネントの設定項「新仕様のパターンを使用する」をチェックした場合、受信ファイル名（拡張子を含まない）に変換します。例として、受信ファイル名がreq.txtの場合、%f.txt と指定する場合、次のように展開されます。
req.txt

(9) ファイル名置換(拡張子を含む)(%x)

V8.5から、特殊文字%xはファイル名(拡張子を含む)を表示します。 %x を指定します。受信ファイル名（拡張子を含む）に変換します。例として受信ファイル名がreq.datの場合、%x.txt と指定すると次のように展開されます。
req.dat.txt
FTP BC同士、あるいはFile BCとの組み合わせでのみ使用可能です。置換ファイル名が保持されていない場合、そのまま%xが出力されます。

Caution
WebOTX AS Standard / Enterprise と連携してWebOTX ESBをアドバンスドモードで動作させる場合、OutboundでFTPサーバへ送信するファイル名にUUIDや、タイムスタンプを使うなどして重複したファイル名でアップロードされないように調整してください。

3.2.8.15. メッセージ処理モード

3.2.8.16. FTPS通信

FTPSを有効にすると、FTPS接続が可能になります。FTPSではFTP BCとFTPサーバの間で、全ての通信がSSLを利用した暗号化したメッセージを送受信します。
FTPS Proxy接続の場合、FTP BCとFTPサーバ間ではSOCKSプロトコルを用いてProxyサーバを経由し、SSLを利用した暗号化したメッセージを送受信します。

Memo
FTPサーバのダイレクト転送がメッセージ転送する時はSSLをサポートしません。

接続モード

Explicitモード：サーバに接続した後、FTP BCがAUTHコマンドを実行して、プロトコルSSLでのハンドシェイク完了後に暗号化された通信を行います。
Implicitモード：サーバに接続した直後にSSLによるハンドシェイクが行います。

保護レベル

FTPサーバのデータ転送チャネル（PORTまたはPASVコマンドで作成されるチャネル）によっての通信を暗号化する場合、PORTコマンドを用いて保護レベルを設定する必要があります。
４つの保護レベル(Clear、Safe、Confidential、Private)があります。
FTPサーバによってサポートできる保護レベルが違います。
以下はFTPサーバのサポート状況の例です。

• force_anon_data_ssl =true
• force_local_data_ssl=true

トラストストアとキーストアのインストール

FTPS接続のトラストストアとキーストアはWebOTX ASのものを利用します。
トラストストアのファイルパスは、${INSTANCE_ROOT}:/config/cacerts.jksです。
キーストアのファイルパスは、${INSTANCE_ROOT}:/config/keystore.jksです。
上記のパスは、FTPS接続を作成する場合、WebOTXのドメインのJavaVMのプロパティで指定されます。
利用するトラストストアのファイルとキーストアのファイルを変更する場合はFTP BCコンポーネントを再起動する必要があります。