10.2. 独自プログラムの実装方法¶
取込/出力対象判定プログラム、取込/出力値変換プログラムの実装についてのリファレンスです。以下のリファレンスに従い独自プログラムを作成してください。
10.2.1. 取込/出力対象判定プログラムの作成¶
取込/出力対象判定プログラムは、実行対象のエンティティに対して、レコード毎に取込/出力対象、対象外とするかを独自に判定することができるアドオンプログラムです。マッピング定義登録・編集画面の基本情報に取込/出力対象判定ロジックを設定する場合は、以下のプログラムを作成してください。
10.2.1.1. Java で作成する場合¶
クラス「 jp.co.itc.imic.foundation.mapping.checker.AbstractMappingChecker 」を継承したJavaクラスを作成してください。
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 startDate 取込基準開始日 String 処理対象の取込基準開始日 endDate 取込基準終了日 String 処理対象の取込基準終了日 domainId ドメインID String null value 対象値 String null
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 referenceDate 出力基準日 String 処理対象の出力基準日 domainId ドメインID String null value 対象値 String null 注釈
判定プログラム内でエラー（例外）終了させる場合
- 判定プログラム内でエラー（例外）により処理を終了（中断）させたい場合は、Exceptionをthrowすることで処理を終了することができます。 Accel-KNIGHTがExceptionをcatchした時点でバッチ処理は異常終了となり、エラーの内容がログに出力されます。
10.2.1.2. JavaScript で作成する場合¶
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 startDate 取込基準開始日 String 処理対象の取込基準開始日 endDate 取込基準終了日 String 処理対象の取込基準終了日 domainId ドメインID String null value 対象値 String null
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 referenceDate 出力基準日 String 処理対象の出力基準日 domainId ドメインID String null value 対象値 String null ※intra-martのJavaScript関数実行APIの仕様上、Map型のオブジェクトを渡すことができないためAccel-KNIGHTではエンティティデータのKey配列とエンティティデータのValue配列とで分けて渡しています。エンティティデータの特定の項目の値を取得する場合は、エンティティデータのKey配列、エンティティデータのValue配列から連想配列を作成する等して取得してください。注釈
判定プログラム内でエラー（例外）終了させる場合
- 判定プログラム内でエラー（例外）により処理を終了（中断）させたい場合は、Errorオブジェクトをthrowすることで処理を終了することができます。 Accel-KNIGHTがExceptionをcatchした時点でバッチ処理は異常終了となり、エラーの内容がログに出力されます。
10.2.1.3. IM-LogicDesigner で作成する場合¶
IM-LogicDesignerの概要、ロジックフローの作成方法等についての詳しい内容は『 intra-mart Accel Platform IM-LogicDesigner ユーザ操作ガイド 』を参照してください。
キー名 型 内容 executeType string 処理区分（00：取込、10：出力、30：取込＋洗い替え）が格納されます。 csvData string[] 取込対象のCSVデータ（1レコード分）が、ファイル定義の項目順で格納されます。 addonParam map 取込対象のCSVデータに紐づく以下の情報が格納されます。
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 startDate 取込基準開始日 String 処理対象の取込基準開始日 endDate 取込基準終了日 String 処理対象の取込基準終了日 domainId ドメインID String null value 対象値 String null
キー名 型 内容 result boolean
キー名 型 内容 executeType string 処理区分（00：取込、10：出力、30：取込＋洗い替え）が格納されます。 entityData map addonParam map 出力対象のエンティティデータに紐づく以下の情報が格納されます。
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 referenceDate 出力基準日 String 処理対象の出力基準日 domainId ドメインID String null value 対象値 String null
キー名 型 内容 result boolean 注釈
ロジックフロー内でエラー（例外）終了させる場合
- ロジックフロー内でエラー（例外）により処理を終了（中断）させたい場合は、「エラー終了」タスクを使用することで処理を終了することができます。 Accel-KNIGHTがExceptionをcatchした時点でバッチ処理は異常終了となり、エラーの内容がログに出力されます。
10.2.2. 取込/出力値変換プログラムの作成¶
取込/出力値変換プログラムは、実行対象のエンティティに対して、独自に項目値の変換（置き換え）をすることができるアドオンプログラムです。マッピング定義登録・編集画面の項目明細に変換ロジックを設定する場合は、以下のプログラムを作成してください。
10.2.2.1. Java で作成する場合¶
クラス「 jp.co.itc.imic.foundation.mapping.convertor.AbstractMappingConvertor 」を継承したJavaクラスを作成してください。
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 startDate 取込基準開始日 String 処理対象の取込基準開始日 endDate 取込基準終了日 String 処理対象の取込基準終了日 domainId ドメインID String 処理対象のドメインID value 対象値 String 処理対象のCSVデータの項目値（置換前の値）
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 referenceDate 出力基準日 String 処理対象の出力基準日 domainId ドメインID String 処理対象のドメインID value 対象値 String 処理対象のエンティティデータの項目値（置換前の値） 注釈
変換プログラム内でエラー（例外）終了させる場合
- 変換プログラム内でエラー（例外）により処理を終了（中断）させたい場合は、Exceptionをthrowすることで処理を終了することができます。 Accel-KNIGHTがExceptionをcatchした時点でバッチ処理は異常終了となり、エラーの内容がログに出力されます。
10.2.2.2. JavaScript で作成する場合¶
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 startDate 取込基準開始日 String 処理対象の取込基準開始日 endDate 取込基準終了日 String 処理対象の取込基準終了日 domainId ドメインID String 処理対象のドメインID value 対象値 String 処理対象のCSVデータの項目値（置換前の値）
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 referenceDate 出力基準日 String 処理対象の出力基準日 domainId ドメインID String 処理対象のドメインID value 対象値 String 処理対象のエンティティデータの項目値（置換前の値） ※intra-martのJavaScript関数実行APIの仕様上、Map型のオブジェクトを渡すことができないためAccel-KNIGHTではエンティティデータのKey配列とエンティティデータのValue配列とで分けて渡しています。エンティティデータの特定の項目の値を取得する場合は、エンティティデータのKey配列、エンティティデータのValue配列から連想配列を作成する等して取得してください。注釈
変換プログラム内でエラー（例外）終了させる場合
- 変換プログラム内でエラー（例外）により処理を終了（中断）させたい場合は、Errorオブジェクトをthrowすることで処理を終了することができます。 Accel-KNIGHTがExceptionをcatchした時点でバッチ処理は異常終了となり、エラーの内容がログに出力されます。
10.2.2.3. IM-LogicDesigner で作成する場合¶
IM-LogicDesignerの概要、ロジックフローの作成方法等についての詳しい内容は『 intra-mart Accel Platform IM-LogicDesigner ユーザ操作ガイド 』を参照してください。
キー名 型 内容 executeType string 処理区分（00：取込、10：出力、30：取込＋洗い替え）が格納されます。 csvData string[] 取込対象のCSVデータ（1レコード分）が、ファイル定義の項目順で格納されます。 addonParam map 取込対象のCSVデータに紐づく以下の情報が格納されます。
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 startDate 取込基準開始日 String 処理対象の取込基準開始日 endDate 取込基準終了日 String 処理対象の取込基準終了日 domainId ドメインID String 処理対象のドメインID value 対象値 String 処理対象のCSVデータの項目値（置換前の値）
キー名 型 内容 result string
キー名 型 内容 executeType string 処理区分（00：取込、10：出力、30：取込＋洗い替え）が格納されます。 entityData map addonParam map 出力対象のエンティティデータに紐づく以下の情報が格納されます。
物理名 論理名 型 内容 companyCd 会社コード String 処理対象の会社コード localeId ロケールID String 処理対象のロケールID mappingId マッピングID String 処理対象のマッピングID mappingName マッピング定義名 String 処理対象のマッピング定義名 domainClassId ドメイン分類ID String 処理対象のドメイン分類ID domainClassName ドメイン分類名 String 処理対象のドメイン分類名 fileId ファイルID String 処理対象のファイルID fileDefName ファイル定義名 String 処理対象のファイル定義名 filePath ファイルパス String 処理対象のファイルパス dataCategory データカテゴリ String 処理対象のデータカテゴリ dataCategoryName データカテゴリ名 String 処理対象のデータカテゴリ名 referenceDate 出力基準日 String 処理対象の出力基準日 domainId ドメインID String 処理対象のドメインID value 対象値 String 処理対象のエンティティデータの項目値（置換前の値）
キー名 型 内容 result string 注釈
ロジックフロー内でエラー（例外）終了させる場合
- ロジックフロー内でエラー（例外）により処理を終了（中断）させたい場合は、「エラー終了」タスクを使用することで処理を終了することができます。 Accel-KNIGHTがExceptionをcatchした時点でバッチ処理は異常終了となり、エラーの内容がログに出力されます。
注釈
JavaScriptで実装する場合の注意点