intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

Copyright © 2012 NTT DATA INTRAMART CORPORATION↑Top
1

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

目次
1. 改訂情報
2. はじめに2.1. 目的
2.2. 構成
2.3. 前提条件
3. データ領域
3.1. 会社グループ
3.2. 会社組織
3.3. パブリックグループ
3.4. パブリックグループ分類
3.5. プライベートグループ
3.6. ユーザ
3.7. ユーザ分類
3.8. 法人グループ
3.9. 法人
3.10. 取引先
3.11. 品目3.12. 品目カテゴリ
3.13. 通貨
4. インポート
4.1. 概要
4.1.1. 国際化情報をもつエンティティのインポート
4.1.2. 期間化情報を持つエンティティのインポート
4.1.3. 国際化、期間化情報を持つエンティティの更新
4.2. スナップショットインポート
4.2.1. スナップショットインポートで作成／更新される期間
4.3. 全期間インポート
4.3.1. インポートでAPIがリスナに通知する内容
5. エクスポート
5.1. 概要
5.2. スナップショットエクスポート
5.3. 全期間エクスポート
5.4. フィルタリング機能
6. データファイルのフォーマット
6.1. CSVフォーマット
6.1.1. 会社グループ
6.1.2. 会社組織
6.1.3. パブリックグループ

2

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
6.1.4. パブリックグループ分類
6.1.5. プライベートグループ
6.1.6. ユーザ
6.1.7. ユーザ分類
6.1.8. 法人グループ
6.1.9. 法人
6.1.10. 取引先
6.1.11. 品目カテゴリ
6.1.12. 品目
6.1.13. 通貨
6.2. XMLフォーマット
6.2.1. 会社グループ
6.2.2. 会社・組織
6.2.3. パブリックグループ
6.2.4. パブリックグループ分類
6.2.5. プライベートグループ
6.2.6. ユーザ
6.2.7. ユーザ分類
6.2.8. 法人グループ
6.2.9. 法人
6.2.10. 取引先
6.2.11. 品目カテゴリ
6.2.12. 品目
6.2.13. 通貨
7. インポート／エクスポートの実行
7.1. 実行プログラム概要
7.1.1. ジョブプログラム
7.1.2. インポート／エクスポートAPI
7.2. 設定ファイル
7.2.1. インポート設定ファイル
7.2.2. エクスポート設定ファイル
7.2.3. CSVでのデータファイル指定方法
8. （付録） IM-共通マスタAPIから実行する3

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

改訂情報
変更年月日

変更内容

2012-10-01

初版

2012-11-01

第2版 下記を追加・変更しました「7.3注意事項」を追加しました。

2013-04-01

第3版 下記を追加・変更しました「データ領域 」を修正しました。

2013-07-01

第4版 下記を追加・変更しました「設定ファイル 」を修正しました。

2014-01-01

第5版 下記を追加・変更しました
ドキュメント名称を変更しました。
「7.3 注意事項」を削除しました。

2014-01-28

第6版 下記を追加・変更しました「XMLフォーマット 」の構造定義を修正しました。

2014-08-01

第7版 下記を追加・変更しました「CSVフォーマット 」の削除フラグに関する脚注を追記しました。

2017-08-01

第8版 下記を追加・変更しました「XMLフォーマット 」の「法人」と「取引先」に「法人番号」を追加しました。
「CSVフォーマット 」の「法人」と「取引先」に「法人番号」を追加しました。

2018-08-01

第9版 下記を追加・変更しました「CSVフォーマット 」の「パブリックグループ所属／パブリックグ
ループ所属役割」について、必須に関する記述を修正しました。

2019-04-01

第10版 下記を追加・変更しました「CSVフォーマット 」の「性別」に「その他」と「回答しない」を追加しました。
「XMLフォーマット 」の「性別」に「その他」と「回答しない」を追加しました。

4

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
変更年月日

変更内容

2020-08-01

第11版 下記を追加・変更しました「設定ファイル 」の「エクスポート設定ファイル」のエクスポート
設定ファイル例を修正しました。
「設定ファイル 」の「拡張パラメータ」の「format-xml」に関する記述を修正しました。
「インポート 」に削除フラグが有効なエンティティをインポートする場合の注意点を追加しました。

5

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

はじめに目的
本書は、IM-共通マスタのインポート／エクスポート機能について以下の内容を説明することを目的とします。
インポート／エクスポートの対象となる範囲
インポート／エクスポートのデータ形式とその処理方法の違い
インポート／エクスポートの実行方法

構成
本書の構成は以下のとおりです。
「データ領域 」では、IM-共通マスタ インポート／エクスポート機能で扱うデータの範囲について説明する。
「インポート 」および「エクスポート 」では、２つのデータ形式（CSV形式、XML形式）それぞれに対して、処理方法を説明する。
「データファイルのフォーマット 」では、２つのデータ形式のフォーマットについて説明する。
「インポート／エクスポートの実行 」では、インポート／エクスポートの実行方法について説明
する。

前提条件
本書は、intra-mart Accel Platformに付属するIM-共通マスタの各種の制限事項、動作環境を前提条件としています。
本書ではIM-共通マスタについては詳細には解説しませんので、IM-共通マスタの仕様については『 IM共通マスタ 仕様書 』を参考にしてください。

6intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

データ領域
IM-共通マスタインポート／エクスポート機能は、以下の表のデータ領域が対象です。
データ領域に含まれるエンティティについては次節から解説します。
【表:会社グループのエンティティ】
データ領域

対象のエンティティ

会社グループ会社グループとその構成、会社の所属

会社組織

会社と組織、役職、内包構成（ツリー構造）、ユーザの所属

パブリックグループ

パブリックグループと役割、内包構成（ツリー構造）、ユーザの所属

パブリックグループ分

パブリックグループ分類の情報

類
プライベートグループ

プライベートグループと、ユーザの所属

ユーザ

ユーザのプロファイル情報

ユーザ分類

ユーザ分類の情報

法人グループ

法人グループ、法人グループの内包構造、法人の所属

法人

法人、取引先の所属

取引先

取引先の情報品目

品目の情報

品目カテゴリ品目カテゴリとその内包構成（ツリー構造）、品目の所属

通貨

通貨、通貨精度、通貨換算コード、通貨レートの情報項目
会社グループ
会社組織
パブリックグループ
パブリックグループ分類
プライベートグループ
ユーザ
ユーザ分類
法人グループ
法人
取引先品目
品目カテゴリ通貨

7

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

会社グループ
データ領域『会社グループ』は、3つのエンティティから構成されています。
【表:会社グループのエンティティ】
エンティティ

対象のテーブル会社グループ

imm_company_grp

会社グループ内包 imm_company_grp_inc_ath
会社グループ所属 imm_company_grp_ath
会社の所属をインポートする場合、その会社がすでに登録されている必要があります。
会社グループセットは、会社グループセットを示す会社グループをインポートしたときに作成されます。
会社グループセットのみをインポート／エクスポートすることはできません。
また、作成済みの会社グループセットを更新することはできません。

会社組織
データ領域『会社組織』は、7つのエンティティから構成されています。
【表:会社組織のエンティティ】
エンティティ

テーブル

組織

imm_department

組織内包

imm_department_inc_ath

役職

imm_company_post

組織所属 / 組織所属役職

imm_department_ath /imm_department_post_ath

組織分類

imm_department_ctg

組織分類項目

imm_department_ctg_itm

組織分類所属

imm_department_ctg_ath

組織所属をインポートする場合、所属対象のユーザがすでに登録されている必要があります。
組織所属役職をインポート／エクスポートする場合、必ず組織所属もインポート／エクスポートする必要があります。
組織所属役職がない場合は、組織所属のみでインポート／エクスポートします。
会社／組織セットは、組織インポート時に必要に応じて作成されます。
会社／組織セットのみのインポート／エクスポートはできません。
また、既存の会社／組織セットを更新することはできません。

8intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
組織所属のインポート時に、主所属を設定できます。
ただし、主所属の期間が重複していた場合、上書きします。
インポート対象ではない主所属期間がすでに存在していた場合は、重複する期間の主所属を解除した上でインポートします。
同一のインポートデータファイル内に重複した主所属が存在していた場合、どの主所属が有効になるかは保証しません。
会社コード、組織セットコード、組織コードが同じ組織は最上位の組織として扱われます。

パブリックグループ
データ領域『パブリックグループ』は、5つのエンティティから構成されています。
【表:パブリックグループのエンティティ】
エンティティ

テーブル

パブリックグループ

imm_public_grp

パブリックグループ内包

imm_public_grp_inc_ath

役割

imm_public_grp_role

パブリックグループ所属 / 所属 imm_public_grp_ath / imm_public_grp_role_ath
役割パブリックグループ分類所属

imm_public_grp_ctg_ath

パブリックグループ所属をインポートする場合、所属させるユーザがすでに登録されている必要があります。
パブリックグループ所属役割をインポート／エクスポートする場合、パブリックグループ所属もインポート／エクスポートする必要があります。
パブリックグループ所属役割がない場合は、パブリックグループ所属のみでインポート／エクス
ポートします。
パブリックグループセットはパブリックグループインポート時に必要に応じて作成されます。
パブリックグループセットを単独でインポート／エクスポートはできません。
また、既存のパブリックグループセットを更新することはできません。
パブリックグループセットコード、パブリックグループコードが同じパブリックグループは最上位のパブリックグループとして扱われます。

パブリックグループ分類
データ領域『パブリックグループ分類』は2つのエンティティから構成されています。

9intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01【表:パブリックグループ分類のエンティティ】
エンティティ

テーブル

パブリックグループ分類

imm_public_grp_ctg

パブリックグループ分類項目 imm_public_grp_ctg_itm

プライベートグループ
データ領域『プライベートグループ』は、2つのエンティティから構成されています。
【表:プライベートグループのエンティティ】
エンティティ

テーブル

プライベートグループ

imm_private_grp

プライベートグループ所属 imm_private_grp_ath
プライベートグループ所属をインポートする場合、所属させるユーザがすでに登録されている必要があります。

ユーザ
データ領域『ユーザ』は、2つのエンティティから構成されています。
【表:ユーザのエンティティ】
エンティティ

テーブル

ユーザ

imm_user

ユーザ分類所属 imm_user_ctg_ath

ユーザ分類
データ領域『ユーザ分類』は、2つのエンティティから構成されています。
【表:ユーザ分類のエンティティ】
エンティティ

テーブル

ユーザ分類

imm_user_ctg

ユーザ分類項目 imm_user_ctg_itm

法人グループ10

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
データ領域『法人グループ』は、3つのエンティティから構成されています。
【表:法人グループのエンティティ】
エンティティ

テーブル

法人グループ

imm_corporation_group

法人グループ内包 imm_corporation_group_inc_ath
法人グループ所属 imm_corporation_group_ath
法人グループ所属をインポートする場合、法人が既に存在している必要があります。
法人グループセットコード、法人グループコードが同じ法人グループは最上位の法人グループとして扱われます。

法人
データ領域『法人』は、2つのエンティティから構成されています。
【表:法人のエンティティ】
エンティティ テーブル法人

imm_corporation

法人所属

imm_corporation_ath

法人所属をインポートする場合、取引先がすでに存在している必要があります。
法人分類／法人分類項目／法人分類所属は、インポート／エクスポートの対象外です。

取引先
データ領域『取引先』は、1つのエンティティから構成されています。
【表:取引先のエンティティ】
エンティティ テーブル
取引先

imm_customer

取引先分類／取引先分類項目／取引先分類所属は、インポート／エクスポートの対象外です。

品目
データ領域『品目』は、1つのエンティティから構成されています。

11

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01【表:品目のエンティティ】
エンティティ テーブル
imm_item

品目品目分類／品目分類項目／品目分類所属は、インポート／エクスポートの対象外です。

品目カテゴリ
データ領域『品目カテゴリ』は、3つのエンティティから構成されています。
【表:品目カテゴリのエンティティ】
エンティティ

テーブル

品目カテゴリ

imm_item_category

品目カテゴリ内包 imm_item_category_inc_ath
品目カテゴリ所属 imm_item_category_ath
品目カテゴリ所属をインポートするためには、品目がすでに存在している必要があります。
品目カテゴリセットは、品目カテゴリインポート時に必要に応じて作成されます。
品目カテゴリセットのみをインポート／エクスポートすることはできません。
また、既存の品目カテゴリセットを更新することはできません。

通貨
データ領域『通貨』は、4つのエンティティで構成されています。
【表:通貨レートのエンティティ】
エンティティ

テーブル

通貨

imm_currency

通貨精度

imm_currency_precision

通貨換算コード imm_currency_conversion
通貨レート

imm_currency_rate

通貨精度をインポート／エクスポートするには、通貨もインポート／エクスポートする必要があります。
通貨レートをインポート／エクスポートするには、通貨および通貨換算コードもインポート、エクスポートする必要があります。
通貨レートは、TTB／TTSの2レコードをセットで扱います。
通貨コードから元通貨コードのTTBと、TTS（＝元通貨コードと通貨コードを入れ替えたときの12intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
TTB）がセットです。

13

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

インポート
概要
IM-共通マスタのインポート機能は、単一期間をインポートするスナップショットインポートと、シス
テム開始日からシステム終了日までの間にいくつかの期間をインポートする全期間インポートがあります。
インポートに使用するデータファイルには、XMLとCSVの2つのフォーマットを使用できます。
XMLでは複数の期間を扱えるのに対し、CSVでは期間情報は持ちません。
期間以外の扱える情報には差異はありません。
複数の期間、またはエンティティごとに異なる期間を持つデータを同時にインポートする場合はXMLでデータファイルを作成してください。
インポートは原則として、データの登録／更新のみです。
既存のエンティティ、エンティティの所属情報を削除することはできませんので注意してください。
ただし例外として内包構成のみ、インポート対象期間の既存情報が削除されます。
内包構成は追記ができず、必ずすべての構成情報をインポートする必要があります。
また、内包構成に関して、一部の内包情報を有効/無効化することはできません。
インポートファイルでは、項目ごとに削除フラグで有効/無効が設定できますが、同一セット内で削除
フラグに統一した値を指定する必要があります。
同一セット内で削除フラグの値が異なる場合、最後に位置する項目の削除フラグの値でセット内の全ての内包情報が更新されます。
【表:機能比較表】
スナップショット

全期間

扱えるロケール

制限なし

制限なし

扱える期間

1期間のみ

複数の期間を作成可能

すべて同じ開始日／終了日

それぞれに任意の期間を設定可能

設定ファイルに指定

インポートデータファイル内でに期間の指定方法

指定
データファイル

CSV、XMLXML

データファイルフォーマットでXMLを選択してスナップショットインポートを実行した場合の注
意点
XMLデータファイルに開始日／終了日を設定しても無視されます。
複数の期間化情報が記述されている場合は、その中のいずれか1つの期間化情報のみがインポートされます。
この場合、どの期間化情報を選択するかは選択できず、また必ず特定のものが選択されることを保証していません。
削除フラグが有効なエンティティをインポートする場合の注意点
データの登録／更新いずれの場合も、既存エンティティは物理削除されません。論理削除さ14

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
れた（削除フラグが有効な）エンティティが登録されます。
論理削除されたエンティティは、該当の期間（特に期間指定が無い場合は全期間）で無効化
された情報として取り扱われます。
詳細については、『 期間の取り扱い方について 』を参照してください。

国際化情報をもつエンティティのインポート
インポートファイルには複数ロケールの国際化情報を記述でき、記述した国際化情報はすべて登録されます。
記述がないロケールのデータはそのまま残り、削除されることはありません。
その場合は非国際化情報のみが更新されます。
CSVでインポートする場合の注意点
データファイルのフォーマットがCSVの場合、1行に1ロケールのデータを記述します。
複数のロケールをインポートする場合、1つのデータに対して複数行記述しますが、非国際化
データはすべて同じ内容で記述する必要があります。
省略、または異なるデータを記述することはできません。
以下のリストは、パブリックグループのCSVデータの例です。
先頭から4つの太字部分 （パブリックグループセットコード、パブリックグループコード、ソー
トキー、削除フラグ） は必ず同一である必要があります。
【リスト:日本語の英語を持つパブリックグループの例】
public-group,public-group,17,false,ja,サンプルパブリック,サンプル,サンプルパブリック,サンプル
public-group,public-group,17,false,en,sample-public,sample,sample public,sample

1行目が日本語、2行目が英語の情報となる。ソートキー、削除フラグは同じでなければならない。
異なるデータを設定した場合、どちらか一方のデータで登録されます。
この場合、どちらか特定のものが一定して選択されることを保証していません。

期間化情報を持つエンティティのインポート
全期間インポートでは、データファイルに記述したとおりの期間が作成されます。
データファイル内の期間情報が連続していない場合、または重複している場合はエラーが発生しインポートは中止します。
スナップショットインポートでは原則、1期間のみがインポート対象です。
ただし、インポートの期間がシステム開始日からシステム終了日までに満たない場合、複数期間を作成する場合があります。
新しいエンティティをインポートした場合。
国際化情報を持つエンティティに対して、ロケールを追加した場合。（次節で解説）
この場合、インポート対象の1期間以外のデータは自動で補完されるものであり、任意のデータを指定することはできません。

15

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

国際化、期間化情報を持つエンティティの更新
期間化情報を持つエンティティが、国際化情報を持っている場合、すべての国際化情報の期間が同じように変更されます。
インポートデータファイルに記述されていない国際化情報の期間も更新されます。

【図:期間Bをインポートした例】
インポート実行後の濃い灰色の部分が更新対象となる期間です。
日本語（ja）の期間Bはインポートデータで更新する。
英語（en）は、対象ではないので国際化情報は更新しない。開始日と終了日、削除フラグを更新する。
中国語（zh_CN）は、インポート対象の期間Bが作成し、不足する期間Aと期間Cも同時に作成する。

スナップショットインポートある時点での日付上に存在する期間化情報を抽出したデータをスナップショットと呼びます。
スナップショットインポートでは、このスナップショットデータを元にしてインポートできます。
期間化情報を持つエンティティすべてに対してインポートの開始日から終了日までの１期間を作成する。
期間化情報を持たないエンティティに対しては期間に関係なく登録/更新する。
インポート対象になる期間化情報の開始日、終了日は設定ファイルで設定する。
インポートにより作成される期間と既存のマスタ情報に存在する期間が重複する部分は、既存の期間が短縮、または削除される。
インポートファイル内のデータは、並び順の制限はない。
同一ファイル内であれば、先にインポートする必要があるデータからインポートする。

スナップショットインポートで作成／更新される期間
スナップショットインポートで作成される期間は、設定ファイルで指定した1期間です。
既存の期間が設定した開始日／終了日上にある場合は、その開始日／終了日で期間が分割されます。

16

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
新規追加の場合
インポート対象期間の「期間B」が作成されます。
この期間のみでは、”全期間のデータを持つ”という制約を満たせないので、前後に期間を追加します。
システム開始日からインポート開始日までの期間「期間A」が作成されます。
インポート終了日からシステム終了日までの期間「期間C」が作成されます。

【図:新規作成】

既存のデータが更新される場合
期間が４つに分割されているエンティティに、ある期間をインポートした場合。
「期間A」の終了日をインポートの開始日に変更します。
「期間B」はインポートの期間に含まれるので、「期間B」は削除します。
「期間C」の開始日をインポートの終了日に変更します。
「期間D」はインポート期間の範囲外なので変更しません。
インポートされるデータを、「期間X」として作成します。

【図:期間の上書き1】
期間が1つだけのエンティティにインポートした場合「期間A」の終了日をインポートの開始日に変更します。
インポートされたデータは、「期間B」として作成します。
インポートの終了日からシステムの終了日までの期間「期間C」を作成します。
開始日／終了日以外は「期間A」と同じものです。

17intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01【図:期間の上書き2】

全期間インポートあるエンティティに対して、システム開始日からシステム終了日までのいくつかの期間情報を纏めてインポートできます。
すべての期間化情報に任意の期間化情報を設定してインポートできます。
期間化情報を持つエンティティそれぞれが異なる期間情報を持つ。
システム開始日からシステム終了日までの連続した期間を設定する必要がある。ある日付で複数の期間を持つことはなく、また期間情報が無くなることはできない。
期間化情報を持たないエンティティに対しては、期間は関係なく登録/更新する。
インポートデータファイル内に期間を記述する。
既存のデータで、データの開始日と終了日を変更しない場合でも省略することはできない。
すべての期間が、インポートファイルの期間で新しく作成される。
既存の期間を残す場合は同じ内容で定義する。ただし、期間コードは新しく割り振られる。
期間の定義が一部のみである場合はエラーになる。
インポートファイル内のデータは、並び順の制限はない。

インポートでAPIがリスナに通知する内容
インポートでは、データの更新にIM-共通マスタのAPIを使用します。
インポート実行中に更新内容がリスナに通知する順番を解説します。
メソッド名の「？？？」部分はManagerそれぞれのエンティティで異なります。
全期間インポートでは、期間コードを新しく割り振るために期間の変更を複数回実行します。

【図:インポートターゲット】
先頭に新しい期間コードを持った期間を作成するため、先頭の期間を後方へ移動します。【図:新しい期間を作成】
システム開始日から始まる期間「期間Ａ」の期間を変更します。
01： update???Term（期間A）
02： remove???Term（期間B）
03： create???Term（期間X）// 期間Ａ： 今日の日付〜システム終了日// 期間Ｘ： システム開始日〜今日の日付

18intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01【図:新しい期間を作成】
新しく作成した期間を全期間に変更し、期間Ｘで全期間を埋めます。【図:全期間に変更】
04： update???Term（期間X）
05： remove???Term（期間A）// 期間Ｘ： システム開始日〜システム終了日【図:全期間に変更】「期間Ｘ」をインポートデータの１つ目の終了日で分割します。【図:期間Ｘを分割】「期間Ｘ」の期間化情報を更新します。
06： createTerm（期間Y）
07： updateTerm（期間X）
08： update???（期間X）// 期間Ｙ： 期間2の開始日〜システム終了日// 期間Ｘ： システム開始日〜期間１の終了日【図:期間Ｘを分割】「期間Ｙ」をインポートデータの2つめの終了日で分割します。【図:期間Ｙを作成】「期間Ｙ」の期間化情報を更新します。
09： createTerm（期間Z）
10： updateTerm（期間Y）
11： update???（期間Y）// 期間Ｚ：期間3の開始日〜システム終了日// 期間Ｙ： 期間2の開始日〜期間2の終了日

最後の期間は分割を実行しません。
「期間Ｚ」の期間化情報を更新します。
12： updateTerm（期間Z）
13： update???（期間Z）【図:期間Ｙを作成】

19

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

エクスポート概要
IM-共通マスタは、マスタ情報のエクスポート機能を提供します。
エクスポートの方式は、指定した日付のスナップショットをエクスポートするスナップショットエクス
ポート、システム開始日から終了日まで全期間をエクスポートする全期間エクスポートがあります。
エクスポートできるデータファイルのフォーマットは、CSV形式とXML形式があります。
XML形式ではすべての期間情報を出力しますが、CSV形式では期間情報は出力せず、特定日で有効なデータのみを出力します。
期間情報以外の出力データに違いはありません。
どちらの形式で出力しても、出力したデータファイルを再度インポートできます。
【表:機能比較表】
スナップショット

全期間

扱えるロケール

制限なし

制限なし

扱える期間

指定した日付上の1期間存在するすべての期間

データファイル

CSV

XML

XML

出力される期間情報 (開始日／終了日)なし

出力対象の期間 すべて出力

ファイルの単位

エンティティ

データ領域

スナップショットエクスポート
スナップショットエクスポートでは、指定したある日付でのスナップショットを出力します。
期間化情報を持つエンティティは、指定した日付上にある期間の情報が出力対象です。
期間化されていないエンティティは、日付に関係なく出力します。
すべての国際化情報を出力します。
エクスポート基準日は設定ファイルで指定します。
エクスポートされるデータはすべて1つのファイルに出力します。
出力するフォーマットは、CSV、XMLから選択できます。
CSV出力時、期間の開始日／終了日は出力しません。
XML出力時は出力対象となった期間の開始日／終了日を出力します。

全期間エクスポート
全期間エクスポートでは、システム開始日からシステム終了日までの全期間のデータを出力します。

20

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
期間化情報、非期間化情報をすべて出力します。
すべての国際化情報を出力します。
エクスポート対象データはすべて1つのファイルに出力します。
出力するファイルのフォーマットはXMLのみです。

フィルタリング機能
フィルタリング機能は、エクスポート時に出力対象のデータを制限して出力する機能です。出力対象の制限は、各データ領域で決められたエンティティを指定できます。
フィルタリング対象で指定したエンティティと、そのエンティティに関連づけられているデータが出力対象です。
フィルタリング対象のエンティティと関連づけがないエンティティはすべて出力対象です。
各データ領域の分類、分類項目が該当します。
対象を複数指定することはできません。
設定方法は「出力フィルタ 」を参照してください。
出力対象のロケールを指定することはできません。
一部ロケールのみを抽出した場合、エンティティ間の整合性がとれなくなるためです。

21

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

データファイルのフォーマット
この章では、インポート／エクスポートのデータファイルフォーマットについて解説します。

CSVフォーマット
IM-共通マスタ のCSVインポート、エクスポート機能で使用するフォーマットを示します。
備考欄に特に記述がない項目は、任意の文字列を指定します。
最大文字数や利用可能な文字については、『IM-共通マスタ 入力項目定義書』を参考にしてください。
CSV定義表の必須とは、必須（表中で○）のものは空文字で登録不可能、必須でない（表中で○でない）ものは空文字で登録可能の意味であり、データファイルで項目を省略可能か否かという意味ではありません。
例えば、略称や検索名を指定せずに備考を指定する場合は、略称／検索名は空文字を指定してください。
国際化にマークがあるものは、複数の国際化情報を登録するときに任意のデータを指定できる項目です。
マークがないものは国際化されていませんので同一のものを指定します。
ターゲットファイルのエンティティ
CSVフォーマットでは、エンティティごとにデータファイルを分割する必要があります。
インポート／エクスポート実行時に設定ファイルのターゲットファイルのtype属性でエンティティを指定します。
設定ファイルについての詳細は7章で解説しますので、あわせて参照してください。
対象のデータファイルに組織を指定する例
05：<file type="department">im_master/import/data.csv</file>

CSVの書式CSVで改行、カンマ（,）は、二重引用符（”）で括ることで、表せます。また二重引用符（”）は、二重
引用符を2つ書くことで表せます。
（例）・カンマ
aoyagi,2,false,0,ja,青柳辰巳,アオヤギ タツミ,,,,,,,,,,,,,,,"開発リーダ,"・改行ueda,1,false,0,ja,上田辰男,ウエダ タツオ,,,,,,,,,,,,,,,"一般社員ユーザ
改行"
・二重引用符maruyama,4,false,0,ja,円山益男,マルヤマ マスオ,,,,,,,,,,,,,,,"プロジェクトリーダ"""

項目
会社グループ会社グループ22

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
会社グループ内包
会社グループ所属
会社組織
組織
組織内包
役職
組織所属／組織所属役職
組織分類
組織分類項目
組織分類所属パブリックグループ
パブリックグループ
パブリックグループ内包
役割
パブリックグループ所属／パブリックグループ所属役割
パブリックグループ分類所属
パブリックグループ分類
パブリックグループ分類
パブリックグループ分類項目
プライベートグループ
プライベートグループ
プライベートグループ所属
ユーザ
ユーザ
ユーザ分類所属
ユーザ分類
ユーザ分類
ユーザ分類項目
法人グループ
法人グループ
法人グループ内包
法人グループ所属
法人
法人
法人所属
取引先
取引先
品目カテゴリ品目カテゴリ品目カテゴリ内包
品目カテゴリ所属

23

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
品目
品目
通貨
通貨
通貨精度
通貨換算コード
通貨レート

会社グループ会社グループ【表:会社グループ】

1

項目名

ヘッダ

必須

会社グループセッ

company_group_set_cd○

company_group_cd

○

国際化

備考

トコード
2

会社グループコー
ド

3

ソートキー

sort_key

○

4

削除フラグ

delete_flag○

5

ロケールID

locale_id○○6

会社グループ名

company_group_name

○

○

7

会社グループ略称

company_group_short_name○8

会社グループ検索

company_group_search_name

○

notes

○

“true” / “false”
言語コード

名
9

備考

会社グループ内包【表:会社グループ内包】
項目名
1

ヘッダ

必須

会社グループセット company_group_set_cd

○

コード
2

会社グループコード company_group_cd

3

親会社グループコー parent_company_group_cd ○
ド

24

○

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

4

項目名

ヘッダ

必須

削除フラグ

delete_flag

○

国際化

備考
“true” / “false”※同一セット内では削除フラグは統一した値を指定してください。

会社グループ所属【表:会社グループ所属】
項目名
1

ヘッダ

必須

会社グループセット company_group_set_cd

○

国際化

備考

コード
2

会社グループコード company_group_cd

○

3

会社コード

company_cd

○

4

削除フラグ

delete_flag○“true” / “false”

会社組織
組織【表:組織】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

組織セットコード

department_set_cd

○

3

組織コード

department_cd

○

4

ソートキー

sort_key

○

5

削除フラグ

delete_flag○

6

ロケールID

locale_id

○

○

7

組織名

department_name

○

○

8

組織略称

department_short_name

○

9

組織検索名

department_search_name○

10 国コード

country_cd○

11 郵便番号

zip_code

○

25

国際化

備考

“true” / “false”
言語コードintra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

12 住所１address1○

13 住所２address2○

14 住所３address3○

15 電話番号

telephone_number○

16 内線番号

extension_number○

17 FAX番号

fax_number○

18 内線FAX番号

extension_fax_number○

19 メールアドレス１

email_address1○

20 メールアドレス２

email_address2○

21 URL

url

○

22 備考

notes

○

備考

組織内包
【表:組織内包】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

組織セットコード

department_set_cd

○

3

組織コード

department_cd○

4

親組織コードparent_department_cd

○

5

削除フラグ

delete_flag

○

国際化

備考

“true” / “false”※同一セット内では削除フラグは統一した値を指定してください。

役職【表:役職】
項目名
1 会社コード

ヘッダ

必須

company_cd○

2 組織セットコード department_set_cd

○

26

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

3 役職コード

post_cd○

4 ソートキー

sort_key○

5 削除フラグ

delete_flag

○

6 ランク

rank

○

7 ロケールID

locale_id

○

○

8 役職名

post_name

○

○

9 備考

notes

備考

“true” / “false”

言語コード

○

組織所属／組織所属役職【表:組織所属／組織所属役職】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

組織セットコード

department_set_cd

○

3

組織コード

department_cd○

4

ユーザコードuser_cd○5

主所属フラグ

department_main

6

削除フラグ

delete_flag

7

役職コード

post_cd

8

削除フラグ（役職） delete_flag

国際化

備考

“true” / “false”○“true” / “false”“true” / “false”“true”の場合、組織所属役職を削除。
※項目が省略された
場合は、“false”が適用されます。

組織分類【表:組織分類】
項目名

ヘッダ

必須

1 会社コード

company_cd○

2 分類コード

category_cd○

3 削除フラグ

delete_flag

○

27

国際化

備考

“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名
4 分類タイプ

ヘッダ

必須

category_type

○

国際化

備考
“1” / “0”
0:単一分類区分
1:複数分類区分

5 ソートキー

sort_key○

6 ロケールID

locale_id

○

○

7 分類名

category_name

○

○

8 備考

notes

言語コード

○

組織分類項目【表:組織分類項目】
項目名

ヘッダ

必須

国際化

1 会社コード

company_cd○

2 分類コード

category_cd○

3 分類項目コード

category_item_cd○

4 削除フラグ

delete_flag○

5 ソートキー

sort_key○

6 ロケールID

locale_id○○

7 分類項目名

category_item_cd

○

○

8 備考

notes

備考

“true” / “false”

言語コード

○

組織分類所属
【表:組織分類所属】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

組織セットコード

department_set_cd

○

3

組織コード

department_cd

○

4

分類コード

category_cd○

5

分類項目コード

category_item_cd

○

6

削除フラグ

delete_flag

○

28

国際化

備考

“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名
7

ヘッダ

必須

国際化

削除フラグ（分類） delete_flag

備考“true” / “false”“true”の場合、組織
所属分類を削除。
※項目が省略された
場合は、“false”が適用されます。

パブリックグループ
パブリックグループ【表:パブリックグループ】
項目名
1

ヘッダ

必須

パブリックグループ public_group_set_cd

国際化

備考

○

セットコード2

パブリックグループ public_group_cd

○

コード
3

ソートキー

sort_key

○

4

削除フラグ

delete_flag○

5

ロケールID

locale_id○○6パブリックグループ public_group_name○○“true” / “false”
言語コード

名
7

パブリックグループ public_group_short_name

○

略称
8

パブリックグループ public_group_search_name

○

検索名
9

備考

notes

○

パブリックグループ内包【表:パブリックグループ内包】
項目名
1

ヘッダ

必須

パブリックグループ public_group_set_cd
セットコード

29

○

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名
2

ヘッダ

必須

パブリックグループ public_group_cd

国際化

備考

○

コード
3

親パブリックグルー parent_public_group_cd

○

プコード
4

delete_flag

削除フラグ

○

“true” / “false”※同一セット内では削除フラグは統一した値を指定してくだ
さい。

役割【表:役割】
項目名
1

ヘッダ

必須

パブリックグループ public_group_set_cd

国際化

備考

○

セットコード2

役割コード

role_cd

○

3

ソートキー

sort_key

○

4

削除フラグ

delete_flag

○

5

ランク

rank

○

6

ロケールID

locale_id

○

○

7

役割名

role_name

○

○

8

備考

notes

“true” / “false”

言語コード

○

パブリックグループ所属／パブリックグループ所属役割【表:パブリックグループ所属／パブリックグループ所属役割】
項目名
1

ヘッダ

必須

パブリックグループ public_group_set_cd

国際化

備考

○

セットコード2

パブリックグループ public_group_cd

○

コード
3

ユーザコードuser_cd

○

4

削除フラグ

delete_flag○

30“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

5

役割コード

role_cd

6

削除フラグ（役割） delete_flag

必須

国際化

備考

“true” / “false”“true”の場合、パブリックグループ所属
役割を削除。
※項目が省略された
場合は、“false”が適用されます。

パブリックグループ分類所属【表:パブリックグループ分類所属】
項目名
1

ヘッダ

必須

パブリックグループ public_group_set_cd

国際化

備考

○

セットコード2

パブリックグループ public_group_cd

○

コード
3

分類コード

category_cd○

4

分類項目コード

category_item_cd

○

5

削除フラグ

delete_flag○

6

削除フラグ（分類） delete_flag“true” / “false”“true” / “false”“true”の場合、パブリックグループ所属
分類を削除。
※項目が省略された
場合は、“false”が適用されます。

パブリックグループ分類
パブリックグループ分類【表:パブリックグループ分類区分】
項目名

ヘッダ

必須

1 分類コード

category_cd○

2 削除フラグ

delete_flag

○

31

国際化

備考

“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名
3 分類タイプ

ヘッダ

必須

category_type

○

国際化

備考
“1” / “0”
0:単一分類区分
1:複数分類区分

4 ソートキー

sort_key○

5 ロケールID

locale_id

○

○

6 分類名

category_name

○

○

7 備考

notes

言語コード

○

パブリックグループ分類項目【表:パブリックグループ分類区分項目】
項目名

ヘッダ

必須

国際化

1 分類コード

category_cd○

2 分類項目コード

category_item_cd○

3 削除フラグ

delete_flag○

4 ソートキー

sort_key○

5 ロケールID

locale_id○○

6 分類項目名

category_item_cd

○

○

7 備考

notes

備考

“true” / “false”

言語コード

○

プライベートグループ
プライベートグループ【表:プライベートグループ】

1

項目名

ヘッダ

必須

プライベートグ

private_group_cd○

ループコード2

ユーザコードuser_cd

○

3

ソートキー

sort_key○

4

プライベートグ

private_group_name

○

ループ名

32

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

5

項目名

ヘッダ

必須

プライベートグ

private_group_search_name ○

国際化

備考

国際化

備考

国際化

備考

ループ検索名
6

備考

notes

○

プライベートグループ所属【表:プライベートグループ所属】
項目名
1

ヘッダ

必須

プライベートグルー private_group_cd

○

プコード
2

所有者コードowner_cd○3

ユーザコードuser_cd

○

4

ソートキー

sort_key

○

ユーザ
ユーザ
【表:ユーザ】
項目名

ヘッダ

必須

1

ユーザコードuser_cd

○

2

ソートキー

sort_key

○

3

削除フラグ

delete_flag

○

4

性別

sex

“true” / “false”“0”/”1”/“2”/“9”0:男性 1:女性 2:その他 9:回答しない

5

ロケールID

locale_id

○

○

6

ユーザ名

user_name○○7

ユーザ検索名

user_search_name

○

8

国コード

country_cd

○

9

郵便番号

zip_code○

10 住所１address1○

11 住所２address2

○

33

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

12 住所３address3○

13 電話番号

telephone_number○

14 内線番号

extension_number○

15 FAX番号

fax_number○

16 内線FAX番号

extension_fax_number○

17 携帯電話番号

mobile_number○

18 メールアドレス１

email_address1○

19 メールアドレス２

email_address2○

20 携帯メールアドレス mobile_email_address○

21 URL

url

○

22 備考

notes

○

備考

ユーザ分類所属【表:ユーザ分類所属】
項目名

ヘッダ

必須

1

ユーザコードuser_cd

○

2

分類コード

category_cd○3

分類項目コード

category_item_cd

○

4

削除フラグ

delete_flag○

5

削除フラグ（分類） delete_flag

国際化

備考

“true” / “false”“true” / “false”“true”の場合、ユー
ザ所属分類を削除。
※項目が省略された
場合は、“false”が適用されます。

ユーザ分類
ユーザ分類

34

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01【表:ユーザ分類区分】
項目名

ヘッダ

必須

国際化

備考

1 分類コード

category_cd○

2 削除フラグ

delete_flag○“true” / “false”

3 分類タイプ

category_type○“1” / “0”
0:単一分類区分
1:複数分類区分

4 ソートキー

sort_key○

5 ロケールID

locale_id

○

○

6 分類名

category_name

○

○

7 備考

notes

言語コード

○

ユーザ分類項目【表:ユーザ分類区分項目】
項目名

ヘッダ

必須

国際化

1 分類コード

category_cd○

2 分類項目コード

category_item_cd○

3 削除フラグ

delete_flag○

4 ソートキー

sort_key○

5 ロケールID

locale_id○○

6 分類項目名

category_item_cd

○

○

7 備考

notes

備考

“true” / “false”

言語コード

○

法人グループ
法人グループ【表:法人グループ】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

法人グループcorporation_group_set_cd○

セットコード

35

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

3

項目名

ヘッダ

必須

法人グループcorporation_group_cd

○

国際化

備考

コード
4

ソートキー

sort_key

○

5

削除フラグ

delete_flag○

6

ロケールID

locale_id○○7

法人グループ名

corporation_group_name

○

○

8

法人グループ略

corporation_group_short_name○corporation_group_search_name○“true” / “false”
言語コード

称
9

法人グループ検
索名

10 備考

notes

法人グループ内包【表:法人グループ内包】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

法人グループセッcorporation_group_set_cd○

corporation_group_cd

○

国際化

備考

トコード
3

法人グループコード

4

親法人グループ

parent_corporation_group_cd ○

コード
5

削除フラグ

delete_flag○“true” / “false”※同一セット内では削除フラグは統一した値を指定してください。

法人グループ所属【表:法人グループ所属】

1

項目名

ヘッダ

必須

会社コード

company_cd

○

36

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名
2

ヘッダ

必須

国際化

備考

法人グループセット corporation_group_set_cd ○コード

3

法人グループコード corporation_group_cd

○

4

法人コード

corporation_cd

○

5

削除フラグ

delete_flag○“true” / “false”

法人
法人【表:法人】
項目名

ヘッダ

必須

1

会社コード

company_cd

○

2

法人コード

corporation_cd

○

3

ソートキー

sort_key

○

4

削除フラグ

delete_flag○

5

ロケールID

locale_id

○

○

6

法人名

corporation_name

○

○

7

法人略称

corporation_short_name

○

8

法人検索名

corporation_search_name

○

9

国コード

country_cd○

10 郵便番号

zip_code○

11 住所１address1○

12 住所２address2○

13 住所３address3○

14 電話番号

telephone_number○

15 内線番号

extension_number○

16 FAX番号

fax_number○

17 内線FAX番号

extension_fax_number○

18 メールアドレス１

email_address1○

19 メールアドレス２

email_address2

○

37

国際化

備考

“true” / “false”
言語コードintra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

20 URL

url

○

21 備考

notes

○

22 法人番号

corporate_number

○

備考

法人所属
【表:法人所属】
項目名

ヘッダ

必須

1 法人コード

corporation_cd○

2 会社コード

company_cd○

3 取引先コード

customer_cd○

4 削除フラグ

delete_flag

○

国際化

備考

“true” / “false”

取引先
取引先【表:取引先】
項目名

ヘッダ

必須

国際化

1

会社コード

company_cd○

2

取引先コードcustomer_cd

○

3

ソートキー

sort_key

○

4

削除フラグ

delete_flag○

5

ロケールID

locale_id

○

○

6

取引先名

customer_name

○

○

7

取引先略称

customer_short_name○8

取引先検索名

customer_search_name

○

9

担当者

charge_person_name“true” / “false”

10 国コード

country_cd○

11 郵便番号

zip_code○

12 住所１address1

○

38

備考

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

13 住所２address2○

14 住所３address3○

15 電話番号

telephone_number○

16 内線番号

extension_number○

17 FAX番号

fax_number○

18 内線FAX番号

extension_fax_number○

19 メールアドレス１

email_address1○

20 メールアドレス２

email_address2○

21 URL

url

○

22 備考

notes

○

23 取引先法人番号

corporate_number○

備考

品目カテゴリ品目カテゴリ【表:品目カテゴリ】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

品目カテゴリセッ

item_category_set_cd○

item_category_cd

○

国際化

備考

トコード
3

品目カテゴリコー
ド

4

ソートキー

sort_key

○

5

削除フラグ

delete_flag○

6

ロケールID

locale_id○○

7

品目カテゴリ名

item_category_name

○

○

8

品目カテゴリ略称

item_category_short_name○

9

品目カテゴリ検索

item_category_search_name

○

notes

○

“true” / “false”

名
10 備考

39

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
品目カテゴリ内包【表:品目カテゴリ内包】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

品目カテゴリセット item_category_set_cd

国際化

備考

○

コード
3

品目カテゴリコード item_category_cd○

4

親品目カテゴリコー parent_item_category_cd

○

ド
5

削除フラグ

delete_flag○“true” / “false”※同一セット内では削除フラグは統一した値を指定してください。

品目カテゴリ所属【表:品目カテゴリ所属】
項目名
1

ヘッダ

必須

品目カテゴリセット item_category_set_cd

国際化

備考

○

コード
2

品目カテゴリコード item_category_cd

○

3

会社コード

company_cd

○

4

品目コード

item_cd

○

5

削除フラグ

delete_flag○“true” / “false”

品目
品目【表:品目】
項目名

ヘッダ

必須

1 会社コード

company_cd○

2 品目コード

item_cd○

3 ソートキー

sort_key

○

40

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

4 削除フラグ

delete_flag○

5 ロケールID

locale_id

○

○

6 品目名

item_name○○

7 品目略称

item_short_name○

8 品目検索名

item_search_name

○

9 備考

notes

○

備考

“true” / “false”
言語コード

通貨
通貨
【表:通貨】
項目名

ヘッダ

必須

国際化

1 会社コード

company_cd○

2 通貨コード

currency-cd○

3 ソートキー

sort_key○

4 削除フラグ

delete_flag○

5 通貨ISOコード

currency_iso_cd○

6 通貨単位記号

unit_sign○

7 ロケールID

locale_id

○

○

8 通貨名

currency_name

○

○

9 備考

notes

備考

“true” / “false”

言語コード

○

通貨精度
【表:通貨精度】
項目名

ヘッダ

必須

1

会社コード

company_cd○

2

通貨精度区分currency-precision-type

○

3

通貨コード

currency-cd

○

41

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

国際化

4

ソートキー

sort_key

○

5

削除フラグ

delete_flag○

6

ロケールID

locale_id○○

7

通貨精度区分名

currency_prec_type_name

○

○

8

通貨精度区分略

currency_prec_type_short_name○currency_prec_type_search_name○

備考“true” / “false”
言語コード

称
9

通貨精度区分検索名

10 通貨精度

currency_precision○○

11 通貨スケール

currency_scale

○

○

国際化

通貨換算コード【表:通貨換算コード】
項目名

ヘッダ

必須

1

会社コード

company_cd○2

通貨換算コード

currency_conversion_cd

○

3

ソートキー

sort_key

○

4

削除フラグ

delete_flag○

5

ロケールID

locale_id○○6

通貨換算コード名

currency_conv_name

○

○

7

通貨換算コード略

currency_conv_short_name○currency_conv_search_name○“true” / “false”
言語コード

称
8

通貨換算コード検
索名

通貨レート【表:通貨レート】
項目名

ヘッダ

必須

1 会社コード

company_cd○

2 通貨コード

currency-cd

○

42

備考

国際化

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
項目名

ヘッダ

必須

3 通貨換算コード

currency_conversion_cd ○4 元通貨コード

base_currency_cd○

5 ソートキー

sort_key○

6 削除フラグ

delete_flag

○

7 TTB

ttb

○

8 TTS

tts

○

国際化

備考

“true” / “false”

XMLフォーマット
IM-共通マスタ のXMLインポート、エクスポート機能で使用されるフォーマットを示します。
備考欄に特に記述がない項目は、文字列を指定します。
インポート実行時には、入力チェックを行っていないため、正常にデータベースに登録できた値でも、画面から操作できない可能性があります。
最大文字数や利用可能な文字については、『IM-共通マスタ 入力項目定義書』を参考にしてください。
属性名の必須はマークがついているものがすべて必須ですが、その属性が属する要素自体が省略可能な
場合は、属性自体の記述はありません。
属する要素が存在するときにのみその属性が必須です。
データファイルのルート要素は<root>です。
次節以降のXML構造定義表では、簡略化のため省略しています。
また、期間コードはエクスポート時に出力可能ですが、インポートでは使用しません。
必ず新しい期間コードが割り当てられます。

項目
会社グループ
会社・組織
パブリックグループ
パブリックグループ分類
プライベートグループ
ユーザ
ユーザ分類
法人グループ
法人
取引先品目カテゴリ品目
通貨

会社グループ43

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

会社グループ【表:会社グループ】
要素名

属性名

必須 備考

company-group-set-○

company-groupcompany-group-set

cd
sort-key○company-group-cd○

sort-key○company-groupterm○
term-cd
start-date○yyyy-MM-dd形式の日付
文字列

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag
locale○“true” / “false”○
locale-id

company-group-name

○

言語コード

○

company-group-shortname
company-groupsearch-namenotes
company-attach
company-cd
term

○
○

term-cd
start-date○yyyy-MM-dd形式の日付
文字列

44

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須 備考

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag○“true” / “false”

inclusion
term○
term-cd
start-date○yyyy-MM-dd形式の日付
文字列

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag○

relation○parent-company-○

group-cd
company-group-cd

会社・組織【表:会社組織】
必
要素名

属性名

須

company-cd○

department-○

company

department-set

set-cddepartment
department-○

cd
sort-keyterm○○

term-cd45

備考○“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

備考

start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

locale○locale-id

department-

○
○

name
departmentshort-namedepartmentsearch-namecountry-cd
zip-code
address1
address2
address3
telephonenumber
extensionnumber
fax-number
extension-faxnumber
email-address1
email-address2
url
notes
category-itemattach

category-cd○

category-○

item-cd46

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

備考

delete-flag○“true” / “false”

category
delete-flag“true” / “false”“true”の場合、組織所属分類を削除。
※要素「category」が省略された場合は、“false”が適用されます。

user-attachuser-cdterm○○

term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

department-○“true” / “false”

main
post-attach
post-cd○

delete-flag○

post“true” / “false”“true”の場合、組織所属役職を削除。
※要素「post」が省略された場合は、“false”が適用されます。
inclusion
term○
term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

parent-○relationdepartmentcd

47

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

department-

○

備考

cd
post
post-cd

○

rank

○

sort-key

○

term

○
term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

locale○locale-id

post-name

○

言語コード

○

notes
category
category-cd○

delete-flag○sort-key○category-type ○“true” / “false”“1” / “0”
0:単一分類区分 1:複数分類区分

locale○locale-id

category-name

○

言語コード

○

notes
category-item
category-○

item-cd
delete-flag○sort-key○48“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名
locale須

備考○
locale-id

category-item-

○

言語コード

○

name
notes

パブリックグループ【表:パブリックグループ】
必
要素名

属性名

須

public-group-○

備考

public-grouppublic-group-set

set-cdsort-key○

public-group-○

public-groupcd
sort-keyterm○○

term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

locale○locale-id

public-group-

○
○

name
public-groupshort-name

49

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

category-cd○

category-○

備考

public-groupsearch-namenotes
category-itemattach

item-cd
delete-flag○“true” / “false”

category
delete-flag“true” / “false”“true”の場合、パブリックグループ所属分
類を削除。
※要素「category」が省略された場合は、“false”が適用されます。

user-attachuser-cdterm○○

term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

role-cd○

delete-flag○role-attachrole“true” / “false”“true”の場合、パブリックグループ所属役
割を削除。
※要素「role」が省略された場合は、“false”が適用されます。
inclusion
term○
term-cd50

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

備考

start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

relationparent-public- ○group-cd
public-group-

○

cd
role
role-cd

○

rank

○

sort-key

○

term

○
term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

locale○locale-id

role-name

○

言語コード

○

notes

パブリックグループ分類【表:パブリックグループ分類】
要素名

属性名

必須

category-cd○

delete-flag○

備考public-group-category
category

51“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須

sort-key○category-type○

備考“1” / “0”
0:単一分類区分 1:複数分類区分

locale○locale-id○

category-name

言語コード

○

notes
category-item-cd ○delete-flag○sort-key○

locale“true” / “false”○
locale-id○

category-item-

言語コード

○

name
notes

プライベートグループ【表:プライベートグループ】
要素名

属性名

必須

private-group-cd○

user-cd○

sort-key○

private-groupprivate-group-name○private-group-search-namenotes
private-group-attach

ユーザ

user-cd○

sort-key

○

52

備考

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

ユーザ【表:ユーザ】
必
要素名

属性名

須

user-cd○

sort-key

○

備考

user

sex
term

0:男性 1:女性 2:その他 9:回答しない○

term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

locale○locale-id

user-name

○

言語コード

○

user-searchnamecountry-cd
zip-code
address1
address2
address3
telephonenumber
extensionnumber
fax-number
extension-faxnumber
mobilenumber

53

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

備考

emailaddress1
emailaddress2
mobile-emailaddress
url
notes
category-itemattach

category-cd ○category-○

item-cd
delete-flag○“true” / “false”

category
delete-flag“true” / “false”“true”の場合、ユーザ所属分類を削除。
※要素「category」が省略された場合は、“false”が適用されます。

ユーザ分類【表:ユーザ分類】
要素名

属性名

必須

category-cd○

delete-flag○sort-key○category-type○

備考

user-category
category“true” / “false”“1” / “0”
0:単一分類区分 1:複数分類区分

locale○locale-id

○

54

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須

category-name

備考

○

notes
category-item
category-item-cd ○delete-flag○sort-key○

locale“true” / “false”○
locale-id○

category-item-

言語コード

○

name
notes

法人グループ【表:法人グループ】
必
要素名

属性名

須

company-cd○

corporation-group-○

備考

corporation-groupcompany

corporation-group-set

set-cdsort-key○

corporation-group-cd○

sort-key○

corporation-groupterm○
term-cd
start-date○yyyy-MM-dd形式の日
付文字列

55

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

備考

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag
locale○“true” / “false”○
locale-id

corporation-group-

○

言語コード

○

name
corporation-groupshort-namecorporation-groupsearch-namenotes
corporation-attach
corporation-cd
term

○
○

term-cd
start-date○yyyy-MM-dd形式の日
付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

inclusion
term○
term-cd
start-date○yyyy-MM-dd形式の日
付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○parent-corporation-○

relationgroup-cd

56“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

corporation-group-cd

○

備考

法人
【表:法人】
要素名

属性名

必須

company-cd○

corporation-cd○

sort-key○

備考

corporationcompany

corporation

term○
term-cd
start-date○yyyy-MM-dd形式の日付文字
列

end-date○

yyyy-MM-dd形式の日付文字
列

delete-flag
locale○“true” / “false”○
locale-id

corporation-name○○corporation-short-namecorporation-searchname
corporate-number
country-cd
zip-code
address1
address2

57

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須

customer-cd○

備考

address3
telephone-number
extension-number
fax-number
extension-fax-number
email-address1
email-address2
url
notes
customer-attachterm○
term-cd
start-date○yyyy-MM-dd形式の日付文字
列

end-date○

yyyy-MM-dd形式の日付文字
列

delete-flag○“true” / “false”

取引先【表:取引先】
要素名

属性名

必須

customer

備考○
company-cd○

customer-cd○

sort-key

○

term

○
term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

58

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須

備考

delete-flag○“true” / “false”

locale○locale-id○

customer-name

言語コード

○

customer-short-namecustomer-search-namecorporate-number
charge-person-namecountry-cd
zip-code
address1
address2
address3
telephone-number
extension-number
fax-number
extension-fax-number
email-address1
email-address2
url
notes

品目カテゴリ【表:品目カテゴリ】
要素名

属性名

必須 備考

company-cd○

item-categorycompany

item-category-set

59

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須 備考

item-category-set-cd ○sort-key○item-category-cd○

sort-key○item-categoryterm○
term-cd
start-date○yyyy-MM-dd形式の日付
文字列

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag
locale○“true” / “false”○
locale-id

item-category-name

○

言語コード

○

item-category-shortname
item-category-searchname
notes
item-attach
item-cdterm○○

term-cd
start-date○yyyy-MM-dd形式の日付
文字列

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag○inclusion
term○
term-cd

60“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
要素名

属性名

必須 備考

start-date○yyyy-MM-dd形式の日付
文字列

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag○

relation“true” / “false”○
parent-item-○

category-cd
item-category-cd○

品目【表:品目】
要素名

属性名

必須

company-cd○

item-cd○

sort-key

○

備考

item

term

○
term-cd
start-date○yyyy-MM-dd形式の日付文字列

end-date○

yyyy-MM-dd形式の日付文字列

delete-flag○“true” / “false”

locale○locale-id

item-name○○item-short-nameitem-search-name
notes

通貨
61

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01【表:通貨】
必
要素名

属性名

須

company-cd○

currency-cd○

delete-flag○sort-key○

備考

currency
company

currency“true” / “false”

currency-iso-cd
unit-sign○

locale○locale-id

currency-name

○

言語コード

○

notes
currency-ratecurrency-○

conversion-cd
base-currency-cd○

sort-key

○

term

○
term-cd
start-date○yyyy-MM-dd形式の日付
文字列

end-date○

yyyy-MM-dd形式の日付
文字列

delete-flag○

selling○buying○values62“true” / “false”

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
必
要素名

属性名

須

currency-precision-○

備考

currency-precision

type
delete-flag○sort-key○currency-precision○

currency-scale○

locale“true” / “false”○
locale-id○

currency-

○

言語コード

currency-prec-type-namecurrency-prec-type-shortname
currency-prec-typesearch-namecurrency-conversion

conversion-cd
delete-flag○sort-key○

locale“true” / “false”○
locale-id

currency-conv-name○○currency-conv-short-namecurrency-conv-searchname

63

言語コード

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01

インポート／エクスポートの実行
IM-共通マスタの、インポート／エクスポート機能は、APIの一部として実装しています。
標準のインポート／エクスポートはジョブから実行できます。

実行プログラム概要
IM-共通マスタ のインポート／エクスポート機能は、以下2つのプログラムで構成されています。
ジョブ起動プログラム
必要な情報を集め、インポート／エクスポートAPIを起動します。
インポート／エクスポートAPI
設定ファイルを読み込み、インポート／エクスポートを実行します。

ジョブプログラムジョブプログラムは、APIの起動に必要な情報の取得、インポート／エクスポート設定ファイルの取得、トランザクションを処理します。
intra-mart Accel Platformインストール後のテナント環境セットアップで、以下の表の各インポート／エクスポートジョブが登録されます。
ジョブの実行方法については、『テナント管理者操作ガイド』を参照してください。
【表:ジョブID一覧】
ジョブID

ジョブ名 ジョブプログラムクラス

imm-job-detail-

会社グcompanygroup-import

ループイStandardCompanyGroupJobSchedulerImporter

ンポート
imm-job-detail-

会社グcompanygroup-export

ループエStandardCompanyGroupJobSchedulerExporter

クスポート
imm-job-detail-会社・組 StandardCompanyJobSchedulerImportercompany-import

織イン
ポート

imm-job-detail-会社・組 StandardCompanyJobSchedulerExportercompany-export

織エクス
ポート

imm-job-detail-パブリッ StandardPublicGroupJobSchedulerImporter

publicgroup-import

クグルー
プイン
ポート

64

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
ジョブID

ジョブ名 ジョブプログラムクラス

imm-job-detail-パブリッ StandardPublicGroupJobSchedulerExporter

publicgroup-export

クグルー
プエクス
ポート

imm-job-detail-パブリッ StandardPublicGroupCategoryJobSchedulerImporter

publicgroupcategory-

クグルー

importプ分類インポート

imm-job-detail-パブリッ StandardPublicGroupCategoryJobSchedulerExporter

publicgroupcategory-

クグルー

export

プ分類エ
クスポー
ト

imm-job-detail-プライ

privategroup-import

ベートグStandardPrivateGroupJobSchedulerImporter

ループイ
ンポート
imm-job-detail-プライ

privategroup-export

ベートグ

StandardPrivateGroupJobSchedulerExporter

ループエ
クスポー
ト
imm-job-detail-user-

ユーザイ StandardUserJobSchedulerImporter

importンポート

imm-job-detail-user-

ユーザエ StandardUserJobSchedulerExporter

exportクスポート

imm-job-detail-

ユーザ分 StandardUserCategoryJobSchedulerImporter

usercategory-import

類イン
ポート

imm-job-detail-

ユーザ分 StandardUserCategoryJobSchedulerExporter

usercategory-export

類エクス
ポート

imm-job-detail-法人グ

corporationgroup-

ループイ

importンポート

StandardCorporationGroupJobSchedulerImporter

65

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
ジョブID

ジョブ名 ジョブプログラムクラス

imm-job-detail-法人グ

corporationgroup-

ループエ

exportクスポーStandardCorporationGroupJobSchedulerExporterト
imm-job-detail-

法人イン StandardCorporationJobSchedulerImporter

corporation-import

ポート

imm-job-detail-法人エク StandardCorporationJobSchedulerExporter

corporation-export

スポート

imm-job-detail-

取引先イ StandardCustomerJobSchedulerImporter

customer-import

ンポート

imm-job-detail-

取引先エ StandardCustomerJobSchedulerExporter

customer-export

クスポート

imm-job-detail-

品目カテ StandardItemCategoryJobSchedulerImporter

itemcategory-import

ゴリイン
ポート

imm-job-detail-

品目カテ StandardItemCategoryJobSchedulerExporter

itemcategory-export

ゴリエク
スポート

imm-job-detail-item-

品目イン StandardItemJobSchedulerImporter

importポート

imm-job-detail-item-

品目エク StandardItemJobSchedulerExporter

exportスポート

imm-job-detail-

通貨イン StandardCurrencyJobSchedulerImporter

currency-import

ポート

imm-job-detail-

通貨エク StandardCurrencyJobSchedulerExporter

currency-export

スポート

ジョブプラグラムのパッケージはJavaで作成されており、すべて「jp.co.intra_mart.system.master.job_scheduler」です。

インポート／エクスポートAPI
インポート／エクスポートプログラムはIM-共通マスタAPIの一部として実装されています。
インポート／エクスポートの起動は、それぞれデータ領域のAPIを使用します。

インポート／エクスポート処理概要
1. 設定ファイルの解析

66

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
2. 同時実行制御ファイル作成
3. インポートターゲットファイルをintra-mart Accel Platformにコピー
4. インポートターゲットファイルを解析
5. インポート実行
6. インポートターゲットファイルのコピーを削除
7. 同時実行制御ファイル削除

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

インポート／エクスポートの同時実行防止機能
インポート／エクスポート機能には、インポート／エクスポートが同時に実行されないようにロックする機能があります。
インポート／エクスポートの設定ファイルで指定した処理名が同じであり、同じデータ領域に対する処理は同時に実行できません。
インポート／エクスポートが開始されると、Storageに同時実行制御用ファイルが作成されます。
インポート／エクスポート開始時に制御ファイルが存在しなければインポート／エクスポートが開始されます。
すでに存在している場合は、インポート／エクスポートを実行せずに終了します。
作成される制御ファイルのパス%PUBLIC_STORAGE%/im_master/lock/%テナントID%/%データ領域%/%処理名%
制御ファイルは、インポート／エクスポートの成否に関わらず終了後に削除されます。
ただし、予期せぬ終了（サーバダウンなど）をした場合、制御ファイルが削除されずそのまま残ってしまう場合があります。
制御ファイルが削除されず残っているままでは、中断したインポート／エクスポートは再実行できなくなります。
その場合は、該当するファイルを手動で削除してください。

設定ファイル
設定ファイルのフォーマットは、インポート用とエクスポート用の2種類あります。
テナント環境セットアップで登録されるジョブでは、すべてのデータ領域で共通の設定ファイルを使用しています。
インポート設定ファイル： <パブリックストレージ>/im_master/config/import_config.xml
エクスポート設定ファイル： <パブリックストレージ>/im_master/config/export_config.xml※パブリックストレージのデフォルトは <ストレージルート>/public/storage67

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
この設定ファイルはインポート／エクスポートジョブで定義されています。
標準のジョブでは、設定ファイルの場所は変更できません。
設定ファイルの場所を変更したい場合はジョブプログラムを作成するか、APIから直接インポート／エクスポートを実行する必要があります。

インポート設定ファイル
インポートを実行するための設定ファイルです。
インポートの設定項目はインポート機能共通ですが、実行するマネージャ単位で記述する必要があります。
インポート設定ファイルの例（会社グループ）
1
2
3
4
5
6
7
8
9
10
11
12
13

<app-master-import><company-group-import><name>sample_import</name><format>XML</format><file>im_master/import/data.xml</file><directory>im_master/import/data.</directory><start-date>2000-01-01</start-date><end-date>2010-01-01</end-date><encoding>UTF-8</encoding><extension-param name="replace-pattern">true</extension-param><extension-param name="sub-dirs">false</extension-param></company-group-import></ app-master-import >

データ領域の指定
インポート設定ファイルのルートは<app-master-import>です。
その直下にデータ領域識別要素があり、その中に設定情報を記述します。
指定できるデータ領域を以下の表に示します。
【表:インポートターゲット識別要素】
ジョブ名

データ領域識別要素名

会社グループcompany-group-import

会社組織

company-import

パブリックグループ

public-group-import

パブリックグループ分類

public-group-category-import

プライベートグループ

private-group-import

ユーザ

user-import

ユーザ分類

user-category-import68intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
ジョブ名

データ領域識別要素名

法人グループcorporation-group-import

法人

corporation-import

取引先

customer-import

品目カテゴリitem-category-import品目

item-import

通貨

currency-import

処理名
インポートの処理名を設定します。
3<name>sample_import</name>

処理名で設定した名前は、実行するインポートの固有名です。
同名の処理名を持つインポートは同時に実行できません。
任意の文字列を指定可能ですが、ファイル名として使用できない文字を使用することはできません。
使用できない文字列は、Storage を管理しているOSに依存します。
環境に依存しない英数字、記号の使用を推奨します。

インポートファイルのフォーマット
ファイルフォーマットを設定します。
4<format>XML</format>

CSVまたはXMLを指定します。
省略できません。

インポートターゲットファイル／ディレクトリ
インポート対象のデータファイルを指定します。
5<file>im_master/import/data.xml</file>

インポート対象のデータファイルがあるディレクトリを指定します。
6<directory>im_master/import/data.</directory>

ディレクトリ内のすべてのファイルが対象です。インポートできない形式のファイルがある場合

69

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
はエラーが出力されます。
ファイルまたはディレクトリは複数指定できます。
ファイルまたはディレクトリのいずれかを必ず指定します。両方省略することはできません。
ファイル要素でディレクトリは指定できず、ディレクトリ要素でファイルを指定することもできません。
複数指定した場合、インポートする順番は不定です。
CSVでインポートする場合、そのデータファイルのエンティティを指定する必要があります。
指定方法は「CSVでのデータファイル指定方法 」を参照してください。

インポート開始日／インポート終了日
データをインポートする期間を指定します。
7
8<start-date>2000-01-01</start-date><end-date>2010-01-01</end-date>日付は、『yyyy-MM-dd』形式で指定します。
終了日の指定は、＋１日を指定します。
『データ取得時の基準日＜エンティティの終了日』であるため、実際に登録するデータはエン
ティティの終了日＋１日である必要があります。
開始日を省略した場合は、インポート開始時点での日付が設定されます。
終了日を省略した場合は、システム終了日が設定されます。
開始日と終了日、両方省略した場合、インポートデータファイルのフォーマットによって動作が変わります。
XMLの場合、システム開始日からシステム終了日までの全期間インポートが実行されます。
CSVの場合、前述したデフォルト日付でスナップショットインポートが実行されます。

文字コード
ファイルの文字コードを指定します。
9<encoding>UTF-8</encoding>

CSV形式でインポートする場合、必須です。
XML形式でインポートする場合は、XMLファイルのヘッダで判断します。このパラメータは無視します。
インポートするデータファイルの文字コードです。Storage Serviceの文字コードである必要はありません。
UTF-8エンコーディングでファイルをインポートする場合、BOM(Byte Order Mark)が付加されない形式をご利用ください。BOMの付加された形式を利用した場合、正常なインポートが行われません。

拡張パラメータ70intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
いくつかのパラメータを拡張パラメータとして設定可能です。
10
11<extension-param name="replace-pattern">true</extension-param><extension-param name="sub-dirs">false</extension-param>【表:スタンダードインポートで使用可能な拡張パラメータ】
拡張パラメー

設定可能な値とデフォ

タ名

概要

ルト値

replace-

インポートターゲットのパターン文字列置換を有効に

true or false

pattern

するかデフォルト true

sub-dirs

directoryで指定したフォルダのサブフォルダもイン

true or false

ポート対象とするか

デフォルト false

インポートファイルがCSV形式の時、1行目をヘッダとtrue or false

して無視するか

デフォルト false

with-header

使用できるパターン文字列%date%
yyyy-MM-dd形式のインポート実行開始時点での日付
サブディレクトリを対象とする場合、指定したディレクトリより下位にあるファイルを取得し、インポートを実行します。
前述のとおり、対象ディレクトリにインポート用ではないファイルが存在した場合エラーが出力されるため、注意してください。

エクスポート設定ファイル
エクスポートを実行するための設定ファイルです。
エクスポートの設定項目はエクスポート機能共通ですが、実行するマネージャ単位で記述する必要があります。
エクスポート設定ファイル例
1
2
3
4
5
6
7
8
9
10
11
12

<app-master-export><company-group-export><name>sample_export</name><format>XML</format><file>im_master/export/data.xml</file><date>2099-12-31</date><encoding>UTF-8</encoding><filter name="company-group">company_group_cd_01</filter><extension-param name="replace-pattern">true</extension-param><extension-param name="format-xml">true</extension-param></company-group-export></ app-master-export >71intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
データ領域の指定
エクスポート設定ファイルのルートは<app-master-export>です。
その直下にデータ領域識別要素があり、その中に設定情報を記述します。
前節のエクスポート設定ファイルの例は、会社グループの設定例です。
指定できるデータ領域を以下の表に示します。
【表:エクスポートターゲット識別要素】
ジョブ名

データ領域識別要素名

会社グループcompany-group-export

会社組織

company-export

パブリックグループ

public-group-export

パブリックグループ分類

public-group-category-export

プライベートグループ

private-group-export

ユーザ

user-export

ユーザ分類

user-category-export

法人グループcorporation-group-export

法人

corporation-export

取引先

customer-export

品目カテゴリitem-category-export品目

item-export

通貨

currency-export

処理名
エクスポートの処理名を設定します。
3<name>sample_export</name>

同名の処理名を持つエクスポートは同時に実行できません。
任意の文字列を指定可能ですが、ファイル名として使用できない文字を使用することはできません。
使用できない文字列は、Storageが稼働しているOSに依存します。
環境に依存しない英数字、記号の使用を推奨します。

エクスポートファイルのフォーマット
ファイルフォーマットを設定します。

72

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
4<format>XML</format>

CSVまたはXMLを指定します。
省略できません。

エクスポートターゲットファイル
出力先ファイルを指定します。
5<file>im_master/export/data.xml</file>

拡張子を含めて指定してください。
ディレクトリは指定できません。
省略できません。
複数指定することもできますが、内容はすべて同じものを出力します。
CSVでエクスポートする場合、そのデータファイルのエンティティを指定する必要があります。
指定方法は「CSVでのデータファイル指定方法 」を参照してください。

エクスポート基準日
基準日のスナップショットをエクスポートします。
6<date>2099-12-31</date>

省略した場合、エクスポートデータファイルのフォーマットによって動作が変わります。
CSVの場合、エクスポート開始時点での日付でスナップショットエクスポートが実行されます。
XMLの場合、全期間エクスポートが実行されます。

文字コード出力する文字コードです。
7<encoding >UTF-8</encoding>

省略できません。
任意の文字コードを指定できます。
サーバの文字コードである必要はありません。
XMLフォーマットで出力時、XMLヘッダにもこの文字コード指定を出力します。

出力フィルタエクスポートするデータをフィルタリングできます。

73intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
8<filter name="company-group">company_group_cd_01</filter>

下表のフィルタ対象となるデータを１つ選びます。選んだデータに関連するデータのみが出力対象です。
【表:フィルタリング対象】
データ領域

フィルタ対象ｎａｍｅ属性会社グループ会社グループセット

company-group-set

会社組織

会社

company

パブリックグループ

パブリックグループセット public-group-set

プライベートグループ

オーナーユーザ

user

ユーザ

ユーザ

user

法人グループ会社

company

法人

会社

company

取引先会社

company

品目カテゴリ会社

company

品目

会社

company

通貨会社

company

拡張パラメータ
いくつかのパラメータを拡張パラメータとして設定可能です。
910<extension-param name="replace-pattern">true</extension-param><extension-param name="format-xml">true</extension-param>【表:スタンダードエクスポートで使用できる拡張パラメータ】
拡張パラメー
タ名

概要

設定可能な値とデフォルト値

replace-

エクスポートターゲットのパターン文字列置換を

true or false

pattern有効にするか？

デフォルト true

format-xml

XML出力時に整形をするか？

true or false
デフォルト true

with-header

CSVでエクスポートするとき、1行目にヘッダを出 true or false
デフォルト false

力するか？

74

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
拡張パラメー
タ名

概要

設定可能な値とデフォルト値

export-term- XML出力時、期間コードを出力するか？

true or false

cd

デフォルト false
使用できるパターン文字列%date%
yyyy-MM-dd形式の、インポート実行開始時点での日付
期間コードを出力可能ですが、インポートでは使用しません。
参照専用の項目です。

CSVでのデータファイル指定方法
インポート／エクスポートは、データ領域単位で実行しますが、CSVファイルにいくつかのエンティ
ティを一括して入出力できません。
インポート／エクスポートのデータファイルが、どのエンティティのものなのか指定する必要があります。
この節では、CSVがどのエンティティの規則に従って作成されているのかを指定する方法を解説します。
設定ファイル内のファイル要素、またはディレクトリ要素の属性にtypeを設定できます。
各エンティティに固有のtypeが割り当てられています。
指定しなかった場合、または定義されていない文字列を指定した場合は無視されます。
ディレクトリ要素でデータファイルを指定した場合は、そのディレクトリ内のファイルすべてがそのエンティティのデータファイルであるとしてインポートを実行します。
同一ディレクトリ内に別エンティティのデータファイルを置くことはできません。
5<file type="department">im_master/import/data.csv</file>【表:typeに指定できるもの】
データ領域

エンティティ

指定する文字列

会社グループ会社グループcompany-group

会社グループ内包

inclusion

会社グループ所属

attach-company

組織

department

組織内包

inclusion

役職

post

組織所属／組織所属役職

attach-user

組織分類

category

会社・組織

75

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01
データ領域

エンティティ

指定する文字列

組織分類項目

item

組織分類所属

attach-item

パブリックグループ

public-group

パブリックグループ内包

inclusion

役割

role

パブリックグループ所属／所属役割

attach-user

パブリックグループ分類所属

attach-item

パブリックグループ分類

category

パブリックグループ分類項目

item

プライベートグループ

private-group

プライベートグループ所属

attach-user

ユーザ

user

ユーザ分類所属

attach-item

ユーザ分類

category

ユーザ分類項目

item

法人グループcorporation-group

法人グループ内包

inclusion

法人グループ所属

attach-corporation

法人

corporation

法人所属

attach-customer

取引先

取引先

customer

品目

品目

item

品目カテゴリ品目カテゴリitem-category

品目カテゴリ内包

inclusion

品目カテゴリ所属

attach-item

通貨

currency

通貨精度

currency-precision

通貨換算コード

currency-

パブリックグループ

パブリックグループ分類

プライベートグループ

ユーザ

ユーザ分類

法人グループ

法人

通貨

conversion
currency-rate

通貨レート

76

intra-mart Accel Platform — IM-共通マスタ インポート・エクスポート仕様書 第11版 2020-08-01（付録） IM-共通マスタAPIから実行する
インポート／エクスポートは、APIのメソッドとして用意されています。
テナント環境セットアップで登録される各ジョブファイルは、このAPIを実行しています。
この章では、APIからインポート／エクスポートを実行する方法を解説します。
プログラムの一部としてインポート／エクスポートをしたい。
設定ファイルを使い分けたい。
plugin.xmlでカテゴリをstandard以外に設定したインポート／エクスポートを実行したい。
この場合は、APIを実行するプログラムを作成して実行することができます。
APIからインポートを実行する場合、トランザクション処理を実装する必要があります。
トランザクションを開始せずにインポートを実行した場合、オートコミットモードで実行されます。
この場合、インポートが予期せぬ中断がされた場合にマスタデータの整合性が壊れる恐れがあります。
必ずトランザクションを実装し、中断された場合はロールバックするようにしてください。
1
2
3
4
5
6
7
8
9
10
11
12
13

String categoryName = "standard";
String updateUserCd = "system";String storageFilePath = "im_master/config/import_config.xml";
TenantInfoManager tenantManager= new TenantInfoManager();
Locale defaultLocale = tenantManager.getTenantoInfo().getLocale();PublicStorage configFile = new PublicStorage(storageFilePath);
ByteArrayInputStream stream = new ByteArrayInputStream(configFile.load());
CompanyManager manager = new CompanyManager(updateUserCd,
defaultLocal);manager.importData(categoryName, stream);//例外、トランザクション処理は割愛しています。

【リスト:サンプルプログラム】
7行目 Public Storageから設定ファイルを取得しています。
インポートデータファイルではありませんので注意してください。
8行目 読み込んだバイト配列でInputStreamを作成しています。
これがインポートするマネージャの引数の1つとなります。
11行目 インポートを実行します。
一つ目の引数categoryNameは、plugin.xmlで設定したカテゴリ名です。
作成済みのInputStreamを一緒に実行メソッドに渡しています。
この処理を実行するとインポートが開始されます。

77