intra-mart Accel Platform IM-共通マスタ インポート・エクスポート仕様書 第10版 2019-04-01

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. インポート/エクスポート処理概要

  1. 設定ファイルの解析
  2. 同時実行制御ファイル作成
  3. インポートターゲットファイルをintra-mart Accel Platformにコピー
  4. インポートターゲットファイルを解析
  5. インポート実行
  6. インポートターゲットファイルのコピーを削除
  7. 同時実行制御ファイル削除

7.1.2.2. APIのマネージャからインポート/エクスポートを起動する

インポート/エクスポートはマネージャのメソッドを直接呼び出して実行することもできます。
APIから実行する方法は付録Aを参照してください。

7.1.2.3. インポート/エクスポートの同時実行防止機能

インポート/エクスポート機能には、インポート/エクスポートが同時に実行されないようにロックする機能があります。
インポート/エクスポートの設定ファイルで指定した処理名が同じであり、同じデータ領域に対する処理は同時に実行できません。
インポート/エクスポートが開始されると、Storageに同時実行制御用ファイルが作成されます。
インポート/エクスポート開始時に制御ファイルが存在しなければインポート/エクスポートが開始されます。
すでに存在している場合は、インポート/エクスポートを実行せずに終了します。

作成される制御ファイルのパス

%PUBLIC_STORAGE%/im_master/lock/%テナントID%/%データ領域%/%処理名%
制御ファイルは、インポート/エクスポートの成否に関わらず終了後に削除されます。
ただし、予期せぬ終了(サーバダウンなど)をした場合、制御ファイルが削除されずそのまま残ってしまう場合があります。
制御ファイルが削除されず残っているままでは、中断したインポート/エクスポートは再実行できなくなります。
その場合は、該当するファイルを手動で削除してください。