Oracle ESB レッスン 02: CustomerData バッチ CSV ファイル アダプタ Oracle 統合製品管理 Page 1
シナリオの概要 機能 複数レコードを含む CSV ファイルを 1 レコードずつ処理する CustomerData にインバウンド ファイル アダプタを追加する 顧客データと同期する CSV ファイル Features - JDeveloper ESB ダイアグラマ - ファイル アダプタ - システム固有のファイル トランスレータ - 変換 手順 - CustomerData チュートリアルのインストール - ファイル アダプタの作成 - ルーティング ルールの追加 - 変換の追加 - 結果のテストおよび表示 Page 2
SOA Suite の起動 Start メニューに移動 Start Oracle (SOA) Start SOA Suite を選択 Status 列に Alive が表示されるまで待つ Page 3
JDeveloper: CustomerData プロジェクトの開始 -JDeveloper を起動する -ESB QuickStart Guide で作成した ESBSamples/CustomerData プロジェクトを開く Page 4
Adapter Services パレットの選択 - Adapter Services を選択する - File Adapter を中央作業スペースにドラッグする Page 5
ファイル アダプタの作成 - Name フィールドにCustomerCSVと入力する - Browse をクリックする - ESBのSystems/Groups in Projectを参照する - CustomerDataを選択する - OK をクリックする - Configure File Adapter をクリックする Page 6
ファイル アダプタ : Welcome 画面およびサービス名 Next をクリックする - デフォルトのサービス名で確定する - Next をクリックする Page 7
ファイル アダプタ : 操作および物理パス - Read File を選択する - Operation Name フィールドに ReadCustomerCSVと入力する - Next をクリックする - Directory for Incoming Files フィールドにC:\Custom\Inと入力する - Next をクリックする Page 8
ファイル アダプタ : フィルタ処理およびポーリング頻度 - Include Files Name Pattern フィールドに *.csv と入力する - Files contain Multiple Messages を選択する - Publish Message in Batches of: を 1 に設定する - Next をクリックする - Polling Frequency を 1 Seconds に設定する - Next をクリックする Page 9
ファイル アダプタ : Native Format Builder の起動 Define Schema for Native Format をクリックする Next をクリックする Page 10
ファイル アダプタ : NFB のタイプおよびサンプル ファイル - Select file type をデフォルトの Delimited のままにする - Next をクリックする - File name の Browse をクリックし C:\Customer\CustomerBatch.csv を選択する - 最初の行にフィールド名が表示されたことを確認する - Next をクリックする Page 11
ファイル アダプタ : NFB レコードおよび XSD 情報 - デフォルトで確定する - ファイルには複数のレコードのインスタンスが含まれる - 複数のレコードは単一タイプに属する - Next をクリックする - Namespace フィールドに http://mynamespace.com/customercsv と入力する - Element name containing multiple records フィールドに CustomerCSV と入力する - Element name that will represent the record フィールドに Customer と入力する - Next をクリックする Page 12
ファイル アダプタ : NFB デリミタおよび最初のレコード - デフォルトで確定する - Records Delimited by フィールドを End of Line($eol) に設定する - Optionally enclosed by フィールドを に設定する - Next をクリックする - Use the first record as the field names を選択する - スキーマで設定された CSV から読み込まれたフィールド名に注目する - Next をクリックする Page 13
ファイル アダプタ : NFB XSD 名および終了 - File name フィールドに CustomerBatch.xsd と入力する Finish をクリックする - XSD に完全に準拠したファイル が作成される - Next をクリックする Page 14
ファイル アダプタ : デフォルトの確定および終了 - デフォルトで確定する - Schema Location フィールドに CustomerBatch.xsd と入力する - Schema Element フィールドを CustomerCSV に設定する - Next をクリックする Finish をクリックする Page 15
設定の確認およびサービスの作成 - WSDL ファイル設定を確認する - Name フィールドが CustomerCSV になっていることを確認する - System/Groups フィールドが CustomerData になっていることを確認する - WSDL File フィールドが CustomerCSV.wsdl になっていることを確認する - Port Type フィールドが ReadCustomerCSV_ptt になっていることを確認する - OK をクリックする - 新しいサービスをダイアグラマで表示する - ファイル アダプタ サービスが CustomerCSV になっていることを確認する - 生成されたルーティング サービスが CustomerCSV_RS であることを確認する - CustomerCSV_RS を選択しダブルクリックする Page 16
CustomerCSV_RS へのルーティング ルールの追加 - Routing Rules をクリックしてサービスを展開する Page 17
CustomerCSV_RS へのルーティング ルールの追加 - ウィンドウを右側に拡大して を表示する - をクリックして新しいルーティング ルールを追加する Page 18
ターゲット サービスの操作の選択 - Expand ESB Services in project CustomerData CustOut_RS の順で展開する - MapCustomerData を選択する - OK をクリックする Page 19
変換マップの作成 - をクリックして変換マップを作成する - Create New Mapper File を選択する - デフォルトの XSLT ファイル名で確定する - OK をクリックする Page 20
自動マッピングによる XSLT マップの作成 - 左側にあるソース スキーマimp1:CustomerCSVをクリックする - このスキーマを右側にあるターゲット スキーマinp1:Customerにドラッグする - マウスから手を離すと Auto Map Preferences ダイアログが表示される - Match Elements Considering their Ancestor Types の選択を解除する - OK をクリックすると完成されたマップが表示される Page 21
完成した XSLT の表示 - Save アイコンをクリックする - X をクリックしてマップを閉じる Page 22
完成したルーティング サービスの表示 - Save アイコンをクリックする - X をクリックしてマップを閉じる Page 23
完成したダイアグラムの表示 - 更新されたダイアグラムを表示する - Save アイコンをクリックする - CustomerCSV_RS から CustOut_RS への新規ルーティング ルールを表示する Page 24
サービスを ESB サーバー用サービスに登録 - Applications タブに移動する - CustomerDataを右クリックし Register with ESB を選択する - LocalIntegrationServerConnectionを左クリックする - Registration Summary が表示される - OK をクリックする Page 25
ESB Control でのダイアグラム更新の表示 - ESB Control に移動する - http://localhost:8888/esb/esb/esbconsole.html - CustOut_RS をクリックし新しいサービス関係を表示する Page 26
CSV ファイルのテスト - C:\Customer\CustomerBatch.csv を C:\Customer \In に コピーする Page 27
ESB Control での結果の表示 - Instances アイコンをクリックし新しい 2 つのインスタンスを表示する ファイル内のレコードは個別のトランザクションとして処理されている - 最上行のインスタンスをクリックし実行されたサービスを表示する CustDBOut はフィルタ条件により実行されなかったことに注意する - 2 行目以降のインスタンスをクリックして実行パスを表示する CustDBOutサービスが実行されたことに注意する Page 28