ConvertService定義ファイルは、変換処理の実行内容を定義するためのファイルです。
ConvertServiceName毎の対応するコンバータタイプ、利用するプラグイン、変換処理におけるマッピング情報などを記述します。
このファイルは、プロジェクトワークスペースの以下のフォルダに格納してください。
${PRJHOME}/src/convert
また、ファイルの拡張子は必ず".conv"としてください。
上記のフォルダに.convという拡張子でファイルを保存しておくことで、ビルド対象となり一覧ファイルに登録されます。
例：
${PRJHOME}/src/conv/棚卸CSV取込.conv
以下がConvertService定義ファイルの記述例です。
個々の設定内容については以降で説明します。
記述例：
(converter
;---------------------------------------------------------------
; 変換定義
;---------------------------------------------------------------
converter_name 棚卸CSV取込
converter_type plugin
;---------------------------------------------------------------
; コンバータタイプ毎の設定情報セクション
;---------------------------------------------------------------
(plugin
;---------------------------------------------------------
; プラグインするクラスの指定
;---------------------------------------------------------
class cspd.share.util.conv.plugin.CsvImportConverter
;---------------------------------------------------------
; プラグインクラスに渡すことが出来る変換設定情報(例)
;---------------------------------------------------------
(import
start_record 2 ;;読込データの開始行(省略時は最初の行から?)
constraint 項目その１,項目その２ ;;読込データの一意性チェック対象項目(チェックに引っかかったらエラー情報に出力)
{record
(項目その１
column A ;;読込対象の列(Excel風にAとかAAとかABとかを指定)
ptype 現象型1 ;;読込項目の現象型指定
required true ;;必須フラグ(trueの場合に取得できなければエラー情報に出力する)
)
(項目その２
column B
ptype 現象型2
required false
default ""
)
(項目その３
column C
ptype 現象型3
required true
)
}
)
)
)
|
converter_name宣言
|
ConvertService名を指定します。
この名前はシステム内で必ずユニークになる必要があります。
ここで宣言されたConvertService名が、ServiceFrameworkのconvertプロセスでconverter宣言で指定されることになります。
|
|
|
converter_type属性
|
converterタイプを設定します。
ここで指定できるタイプ名はあらかじめPEXA側で用意されたものとなります。
現状では、以下のタイプを指定することが出来ます。
|
コンバータタイプ名
|
説明
|
|
plugin
|
任意の変換処理を実装したプラグインクラスを呼び出すタイプのコンバーターです。
システム毎の都合に合わせて用意された機能を呼び出す場合に使用します。
プラグインクラスは、PEXA側で用意しているインタフェース及び抽象基底クラスを実装して作成します。
|
|
|
|
コンバータタイプ毎の設定情報セクション
|
converter_type属性で指定したタイプ名でサブセクションを記述することで、
そのタイプ毎に決められたフォーマットで設定情報を記述することが出来ます。
現在、converter_typeで指定できるのは"plugin"だけとなっており、
現状では具体的な変換処理自体はシステム毎に用件に合わせて個別に作成する必要があります。
今後、実際の開発プロジェクト毎にこのフレームワーク上で実装された機能がもし汎用的に
使用できるものであれば、それらをPEXA組み込みの変換機能として取り込む予定です。
現在の予定としては、以下のような機能を組み込み機能として取り込む予定です。
- CSVデータからデータモデル(基本的にリスト)への変換及び読込時の値チェック
- データモデル(単体もしくはリスト)をCSVデータに変換
実際に組み込み機能としてPEXA側に取り込むことができたら、順次この開発ガイドに反映していきます。
以下で、各converter_type毎の設定セクションで記述できる内容について説明します。
|
|
