Cosminexus V9 BPM/ESB基盤 サービスプラットフォーム 開発ガイド 受付・アダプタ定義編
CSVデータ読み込みサンプルでは,CSV形式のファイルからファイルアダプタによってデータを読み込み,DBアダプタを通してデータベースに格納します。このとき,入力ファイルの製品コードが「1001」である製品だけを取得してデータベースに格納します。製品コードの検索はデータ変換機能で実現します。
入出力項目を次の表に示します。
表D-19 入出力項目一覧(CSVデータ読み込みサンプル)
入出力項目 | 内容 |
---|---|
ファイルアダプタの入力ファイル | <サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\File\sample\read_csv\read_csv_data.csv |
DBアダプタの出力テーブル | ADMIN.CSAFF_SAMPLE_RC※ |
ファイルアダプタを追加設定し,検証する手順を次に示します。
表D-20 サービスアダプタ定義画面(基本)の設定内容(CSVデータ読み込みサンプル)
分類 | 項目 | 設定値 | 設定 | |
---|---|---|---|---|
サービス部品制御情報 | サービス名 | CSAFF_SAMPLE_READ_CSV | ◎ | |
サービスID | CSAFF_RC | ◎ | ||
サービス種別 | ファイルアダプタ | × | ||
最大インスタンス数 | 0 | ◎ | ||
オペレーション | 定義パターン:バイナリ読み込み オペレーション名:CSAFF_SAMPLE_READ_CSV |
◎ | ||
オペレーション情報 | オペレーション名 | CSAFF_SAMPLE_READ_CSV | × | |
通信モデル | 同期 | ◎ | ||
要求電文 | 標準 | 使う(チェックボックス) | 使わない(チェックしない) | ◎ |
サービス部品 | フォーマットID | SAMPLE_READ_CSV_Request | ◎ | |
電文フォーマット | adpff_read.xsd | × | ||
応答電文 | 標準 | 使う(チェックボックス) | 使う(チェックする) | ◎ |
フォーマットID | SAMPLE_READ_CSV_Standard | ◎ | ||
電文フォーマット | csaff_sample_read_csv_standard.xsd | ◎ | ||
サービス部品 | フォーマットID | SAMPLE_READ_CSV_Response | ◎ | |
電文フォーマット | csaff_sample_read_csv.fdx | ◎ | ||
データ変換定義 | SAMPLE_READ_CSV_DT | ◎ |
CSVデータ読み込みサンプルのファイルアダプタを定義する場合の,サービスアダプタ定義画面(詳細)での設定項目を次の表に示します。なお,表に記載されていない項目については,設定不要です。
表D-21 サービスアダプタ定義画面(詳細)の設定内容(CSVデータ読み込みサンプル)
分類 | 項目 | 設定値 | 設定 |
---|---|---|---|
サービスアダプタ制御情報 | サービスアダプタ(EJB-JARファイル) | cscmsg_adpejb.jar | × |
ユーティリティクラス(JARファイル) | adpffpc.jar | × |
データ変換定義を設定します。設定するデータ変換定義を次の図に示します。
図D-5 ファイルアダプタのデータ変換定義画面(CSVデータ読み込みサンプル)
データ変換定義の手順を次に示します。
表D-22 ファンクションの設定内容(CSVデータ読み込みサンプル-ファイルアダプタ)
ファンクション | ファンクション名 | 設定値 | |
---|---|---|---|
loop | loop1 | ノード選択 | csaff_sample_read_csv_data |
ノード条件設定 | 下表参照 |
表D-23 loop1の設定内容
分類 | 設定値 | |
---|---|---|
ノード | csaff_sample_read_csv_data | |
条件 | 条件 | 条件式 |
左辺 | ノード・ファンクション(PRODUCT_CODE) | |
等符号 | = | |
右辺 | 値(1001) |
表D-24 マッピングの設定内容(CSVデータ読み込みサンプル-ファイルアダプタ)
変換元ノード | ファンクション | 変換先ノード |
---|---|---|
− | loop1 | DATA |
ORDER_NO | − | ORDER_NO |
CUSTOMER_CODE | − | CUSTOMER_CODE |
PRODUCT_CODE | − | PRODUCT_CODE |
ORDER_COUNT | − | ORDER_COUNT |
ファイルアダプタ実行環境プロパティファイルを作成する手順を次に示します。
fileaccess.path1 = <サービスプラットフォームのインストールディレクトリ>\\CSC\\custom-adapter\\File\\sample\\read_csv
ビジネスプロセスの定義は,ビジネスプロセスの追加,ビジネスプロセスの内容の定義,ビジネスプロセスの検証の順で行います。
ビジネスプロセスを追加する手順を次に示します。
次に示す変数を設定します。
変数を設定する手順を次に示します。
表D-25 CSAFF_DB_ResponseMessageの設定内容(CSVデータ読み込みサンプル)
分類 | 項目 | 設定値 |
---|---|---|
サービス/受付 | サービス名 | CSAFF_SAMPLE_DB |
受付名 | − | |
取込対象 | オペレーション名 | CSAFF_SAMPLE_DB |
電文種別 | 応答電文(ボディ) | |
− | 電文フォーマット | csaff_sample_sqlformat |
表D-26 CSAFF_RequestMessageの設定内容(CSVデータ読み込みサンプル)
分類 | 項目 | 設定値 |
---|---|---|
サービス/受付 | サービス名 | CSAFF_SAMPLE_READ_CSV |
受付名 | − | |
取込対象 | オペレーション名 | CSAFF_SAMPLE_READ_CSV |
電文種別 | 要求電文(ボディ) | |
− | 電文フォーマット | adpff_read |
表D-27 CSAFF_ResponseMessageの設定内容(CSVデータ読み込みサンプル)
分類 | 項目 | 設定値 |
---|---|---|
サービス/受付 | サービス名 | CSAFF_SAMPLE_READ_CSV |
受付名 | − | |
取込対象 | オペレーション名 | CSAFF_SAMPLE_READ_CSV |
電文種別 | 応答電文(ボディ) | |
− | 電文フォーマット | csaff_sample_standard |
ここでは,次の図に示すアクティビティの配置・定義,データ変換定義,およびアクティビティの連結について説明します。
図D-6 ビジネスプロセス定義全体図(CSVデータ読み込みサンプル)
CSVデータ読み込みサンプルでは,次の表に示すアクティビティを設定します。
表D-28 アクティビティ一覧(CSVデータ読み込みサンプル)
アクティビティ | アクティビティ名 | 説明 |
---|---|---|
受付 | CSAFF_SAMPLE_BP_READ_CSV | ビジネスプロセスの受付。 |
応答 | CSAFF_SAMPLE_BP_READ_CSV_RSP | ビジネスプロセスの応答。 |
サービス呼出 | ファイルアダプタ呼出 | ファイルアダプタの呼び出し。 |
サービス呼出 | DBアダプタ呼出 | DBアダプタの呼び出し。 |
データ変換 | DBアダプタ要求電文作成 | ファイルアダプタの応答電文をDBアダプタの要求電文に変換。 |
アクティビティを配置して設定する手順を次に示します。
表D-29 CSAFF_SAMPLE_BP_READ_CSVの設定内容
項目 | 設定値 |
---|---|
アクティビティ名 | CSAFF_SAMPLE_BP_READ_CSV |
オペレーション名 | CSAFF_SAMPLE_BP_READ_CSV |
ボディ割当変数 | CSAFF_RequestMessage |
通信モデル | 同期 |
インスタンス生成 | Yes |
表D-30 CSAFF_SAMPLE_BP_READ_CSV_RSPの設定内容
項目 | 設定値 |
---|---|
アクティビティ名 | CSAFF_SAMPLE_BP_READ_CSV_RSP |
オペレーション名 | CSAFF_SAMPLE_BP_READ_CSV |
ボディ割当変数 | CSAFF_DB_ResponseMessage |
表D-31 ファイルアダプタ呼出の設定内容(CSVデータ読み込みサンプル)
項目 | 設定値 | |
---|---|---|
アクティビティ名 | ファイルアダプタ呼出 | |
サービス名 | CSAFF_SAMPLE_READ_CSV | |
オペレーション名 | CSAFF_SAMPLE_READ_CSV | |
通信モデル | 同期 | |
要求電文 | ボディ割当変数 | CSAFF_RequestMessage |
応答電文 | ボディ割当変数 | CSAFF_ResponseMessage |
表D-32 DBアダプタ呼出の設定内容(CSVデータ読み込みサンプル)
項目 | 設定値 | |
---|---|---|
アクティビティ名 | DBアダプタ呼出 | |
サービス名 | CSAFF_SAMPLE_DB | |
オペレーション名 | CSAFF_SAMPLE_DB | |
通信モデル | 同期 | |
要求電文 | ボディ割当変数 | CSAFF_DB_RequestMessage |
応答電文 | ボディ割当変数 | CSAFF_DB_ResponseMessage |
表D-33 DBアダプタ要求電文作成の設定内容(CSVデータ読み込みサンプル)
項目 | 設定値 |
---|---|
アクティビティ名 | DBアダプタ要求電文作成 |
変換元変数 | CSAFF_ResponseMessage |
変換先変数 | CSAFF_DB_RequestMessage |
データ変換定義 | SAMPLE_READ_CSV_DT |
DBアダプタ要求電文作成アクティビティのデータ変換定義を設定します。設定するデータ変換定義を次の図に示します。
図D-7 DBアダプタ要求電文作成アクティビティデータ変換定義画面(CSVデータ読み込みサンプル)
DBアダプタ要求電文作成アクティビティのデータ変換定義の手順を次に示します。
表D-34 ファンクションの設定内容(CSVデータ読み込みサンプル-ビジネスプロセス)
ファンクション | ファンクション名 | 設定値 | |
---|---|---|---|
loop | loop1 | ノード選択 | DATA |
ノード条件設定 | 設定しない |
表D-35 マッピングの設定内容(CSVデータ読み込みサンプル-ビジネスプロセス)
変換元ノード | ファンクション | 変換先ノード |
---|---|---|
− | loop1 | DBA_MULTI_SQL |
ORDER_NO | − | val1 |
CUSTOMER_CODE | − | val2 |
PRODUCT_CODE | − | val3 |
ORDER_COUNT | − | val4 |
CSVデータ読み込みサンプルで使用するビジネスプロセスでは,次の表に示すようにアクティビティを連結します。
表D-36 アクティビティの連結内容(CSVデータ読み込みサンプル)
連結元アクティビティ | 連結先アクティビティ |
---|---|
開始 | CSAFF_SAMPLE_BP_READ_CSV |
CSAFF_SAMPLE_BP_READ_CSV | ファイルアダプタ呼出 |
ファイルアダプタ呼出 | DBアダプタ要求電文作成 |
DBアダプタ要求電文作成 | DBアダプタ呼出 |
DBアダプタ呼出 | CSAFF_SAMPLE_BP_READ_CSV_RSP |
CSAFF_SAMPLE_BP_READ_CSV_RSP | 終了 |
アクティビティの連結の手順を次に示します。
ビジネスプロセスを保存して検証する手順を次に示します。
定義したファイルアダプタとビジネスプロセスをサーバに配備して開始します。
ファイルアダプタとビジネスプロセスの配備定義の手順を次に示します。
サンプルを実行するデータベースのテーブルを作成します。
HiRDB SQL Executerを起動して,次のSQL文を実行してください。
CREATE TABLE CSAFF_SAMPLE_RC (ORDER_NO INT, CUSTOMER_CODE CHAR(5), PRODUCT_CODE CHAR(4), ORDER_COUNT INT);
サンプルで提供するビジネスプロセス実行時の要求電文を編集して,要求電文を作成する手順を次に示します。
<?xml version="1.0" encoding="UTF-8"?> <adpff:ReadRequest xmlns:adpff="http://FlatFiles.cstmadp.csc.soft.Hitachi.co.jp/ReadRequest"> <fileheader> <filename><サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\File\sample\read_csv\read_csv_data.csv</filename> <filemode>all</filemode> </fileheader> </adpff:ReadRequest>
サンプルを実行するには,サービスリクエスタからビジネスプロセスを起動します。
サービスリクエスタの処理の流れと概要を次に示します。
サービスリクエスタの実行手順を次に示します。
request read_csv <サービスプラットフォームのインストールディレクトリ>\CSC\custom-adapter\File\sample\read_csv\read_csv_message.xml
All Rights Reserved. Copyright (C) 2012, 2019, Hitachi, Ltd.