7.1. 実行プログラム概要¶
IM-共通マスタ のインポート/エクスポート機能は、以下2つのプログラムで構成されています。
- ジョブ起動プログラム
- 必要な情報を集め、インポート/エクスポートAPIを起動します。
- インポート/エクスポートAPI
- 設定ファイルを読み込み、インポート/エクスポートを実行します。
7.1.1. ジョブプログラム¶
ジョブプログラムは、APIの起動に必要な情報の取得、インポート/エクスポート設定ファイルの取得、トランザクションを処理します。intra-mart Accel Platformインストール後のテナント環境セットアップで、以下の表の各インポート/エクスポートジョブが登録されます。ジョブの実行方法については、『テナント管理者操作ガイド』を参照してください。
【表:ジョブID一覧】 ジョブID ジョブ名 ジョブプログラムクラス imm-job-detail-companygroup-import 会社グループインポート StandardCompanyGroupJobSchedulerImporter imm-job-detail-companygroup-export 会社グループエクスポート StandardCompanyGroupJobSchedulerExporter imm-job-detail-company-import 会社・組織インポート StandardCompanyJobSchedulerImporter imm-job-detail-company-export 会社・組織エクスポート StandardCompanyJobSchedulerExporter imm-job-detail-publicgroup-import パブリックグループインポート StandardPublicGroupJobSchedulerImporter imm-job-detail-publicgroup-export パブリックグループエクスポート StandardPublicGroupJobSchedulerExporter imm-job-detail-publicgroupcategory-import パブリックグループ分類インポート StandardPublicGroupCategoryJobSchedulerImporter imm-job-detail-publicgroupcategory-export パブリックグループ分類エクスポート StandardPublicGroupCategoryJobSchedulerExporter imm-job-detail-privategroup-import プライベートグループインポート StandardPrivateGroupJobSchedulerImporter imm-job-detail-privategroup-export プライベートグループエクスポート StandardPrivateGroupJobSchedulerExporter imm-job-detail-user-import ユーザインポート StandardUserJobSchedulerImporter imm-job-detail-user-export ユーザエクスポート StandardUserJobSchedulerExporter imm-job-detail-usercategory-import ユーザ分類インポート StandardUserCategoryJobSchedulerImporter imm-job-detail-usercategory-export ユーザ分類エクスポート StandardUserCategoryJobSchedulerExporter imm-job-detail-corporationgroup-import 法人グループインポート StandardCorporationGroupJobSchedulerImporter imm-job-detail-corporationgroup-export 法人グループエクスポート StandardCorporationGroupJobSchedulerExporter imm-job-detail-corporation-import 法人インポート StandardCorporationJobSchedulerImporter imm-job-detail-corporation-export 法人エクスポート StandardCorporationJobSchedulerExporter imm-job-detail-customer-import 取引先インポート StandardCustomerJobSchedulerImporter imm-job-detail-customer-export 取引先エクスポート StandardCustomerJobSchedulerExporter imm-job-detail-itemcategory-import 品目カテゴリインポート StandardItemCategoryJobSchedulerImporter imm-job-detail-itemcategory-export 品目カテゴリエクスポート StandardItemCategoryJobSchedulerExporter imm-job-detail-item-import 品目インポート StandardItemJobSchedulerImporter imm-job-detail-item-export 品目エクスポート StandardItemJobSchedulerExporter imm-job-detail-currency-import 通貨インポート StandardCurrencyJobSchedulerImporter imm-job-detail-currency-export 通貨エクスポート StandardCurrencyJobSchedulerExporter ジョブプラグラムのパッケージはJavaで作成されており、すべて「jp.co.intra_mart.system.master.job_scheduler」です。
7.1.2. インポート/エクスポートAPI¶
インポート/エクスポートプログラムはIM-共通マスタAPIの一部として実装されています。インポート/エクスポートの起動は、それぞれデータ領域のAPIを使用します。
7.1.2.1. インポート/エクスポート処理概要¶
- 設定ファイルの解析
- 同時実行制御ファイル作成
- インポートターゲットファイルをintra-mart Accel Platformにコピー
- インポートターゲットファイルを解析
- インポート実行
- インポートターゲットファイルのコピーを削除
- 同時実行制御ファイル削除
7.1.2.2. APIのマネージャからインポート/エクスポートを起動する¶
インポート/エクスポートはマネージャのメソッドを直接呼び出して実行することもできます。APIから実行する方法は付録Aを参照してください。
7.1.2.3. インポート/エクスポートの同時実行防止機能¶
インポート/エクスポート機能には、インポート/エクスポートが同時に実行されないようにロックする機能があります。インポート/エクスポートの設定ファイルで指定した処理名が同じであり、同じデータ領域に対する処理は同時に実行できません。インポート/エクスポートが開始されると、Storageに同時実行制御用ファイルが作成されます。インポート/エクスポート開始時に制御ファイルが存在しなければインポート/エクスポートが開始されます。すでに存在している場合は、インポート/エクスポートを実行せずに終了します。作成される制御ファイルのパス
%PUBLIC_STORAGE%/im_master/lock/%テナントID%/%データ領域%/%処理名%制御ファイルは、インポート/エクスポートの成否に関わらず終了後に削除されます。ただし、予期せぬ終了(サーバダウンなど)をした場合、制御ファイルが削除されずそのまま残ってしまう場合があります。制御ファイルが削除されず残っているままでは、中断したインポート/エクスポートは再実行できなくなります。その場合は、該当するファイルを手動で削除してください。