IMI 技術仕様書
マッピングファイル仕様バージョン 1.0.1

2019 年 2 月 28 日

マッピングファイル仕様 v1.0.1

1

概要

マッピングファイルは、DMD（「DMD 仕様書」参照）が定めるデータモデルにおいて値が入る項目と、その代表的なラベルを１対１に結び付けるファイルであり、ユーザーへの表示や、データ入力用の CSV ファイルを生成する際、及び、その CSV ファイルから構造化データへの簡易的な変換などに利用される。
マッピングファイルは、次のような JSON ファイルとする。
{"targetDMD ": "https :// imi.go.jp/dmd /100034987928734" ,"defaultVocab ": "http :// imi.go.jp/ns/core /2",
"description ": " 基 本 マ ッ ピ ン グ ","prefix ": {"ex": "http :// example.com/ns/"},"mapping ": {" 商 品 名 ": " 製 品 型 > 表 記 ","@ 単 価 ": " 製 品 型 > 価 格 [ 単 価 ]{@ex: 単 価 型 }{ 種 別 =' 単 価 '}{ex: ユ ニ ッ ト =' 個 '}> 金 額 { 通 貨 =' 円 '}> 数 値 "," 個 数 ": " 製 品 型 > 入 数 > 数 値 "," 金 額 ": " 製 品 型 > 価 格 [ 金 額 ]{ 種 別 =' 金 額 '}> 金 額 { 通 貨 =' 円 '}> 数 値 "}}

2

プロパティ

各プロパティの意味とデータ構造を表 1 に示す。ルート直下には、追加のプロパティを含めてもよい。その場合、追加のプロパティは、「_」（アンダースコア）から始まる名前とする。
表 1: マッピングファイルのプロパティ
プロパティ

データ型

必須

説明targetDMD文字列

対象となる DMD の URL 又はファイル名

defaultVocab

文字列

プレフィックスが省略された項目に使用される語彙の名前空間

description

文字列

日本語説明

description_en

文字列

英語説明

created

文字列

作成日 YYYY-MM-DD 形式

issued

文字列

発行日 YYYY-MM-DD 形式

modified

文字列

最終更新日 YYYY-MM-DD 形式

title

文字列

タイトル

creator

オブジェクト又は配列

作者
次のプロパティをもつオブジェクト又はその配列- name（文字列）： 名前- homepage
publisher

オブジェクト又は配列(URL)： ホームページのアドレス

発行者
次のプロパティをもつオブジェクト又はその配列- name（文字列）： 名前- homepage
1(URL)： ホームページのアドレス
imi.go.jp

マッピングファイル仕様 v1.0.1

プロパティ

データ型

versionInfo

文字列バージョン情報license

オブジェクト又は配列

ライセンス

base

必須

説明

- name（文字列）： 名前- page(URL)： ライセンスドキュメントの参照

RDF シリアライズを行う場合に用いられるベース

文字列

URIprefix

オブジェクトプレフィックスの一覧
このオブジェクトは、値が文字列である０個以上のプロパティをもつ。各プロパティの名前はプレフィック
スの文字列であり、値はそのプレフィックスに対応する名前空間を表す文字列とする。

mapping

オブジェクト○

項目ラベルと構造化項目名の対応の一覧
このオブジェクトは、値が文字列・オブジェクト・配列のいずれかであるような、一個以上のプロパティをもつ。各プロパティの名前は CSV 等のヘッダーラベルであり、値はそのラベルが対応付けられる構造化項目名である。値が文字列の場合、文字列が構造化項目名であるものとする。値がオブジェクトである場合、このオブジェクトは値が文字列であるような value プロパティを必ず持つものとし、value プロパティの値が構造化項目名であるものとする。値が配列の場合は、配列に含まれるすべて要素は前述の文字列・オブジェク
トのいずれかでなければならず、それぞれの構造化項目名が対象のラベルに対応付けられることを意味する。
対応付けを行わないラベルは含める必要はないが、対応先がないことを明示する場合、値は長さ０の配列とする。

2.1 マッピングファイルの省略
マッピングファイルのプロパティの多くは省略可能となっているが、次の要件を満たす必要がある。

• mapping プロパティにおいて、構造化項目名に名前空間プレフィックスが指定されていない項目がある場合は、defaultVocab プロパティは省略できない。

• mapping プロパティにおいて、構造化項目名に名前空間プレフィックスの指定を行う場合は、prefix プロパ
ティによりプレフィックスが定義されている必要がある。
マッピングファイルを単独で広く配布する場合やインターネット上で公開する場合は、次のプロパティを記述することを推奨する。

• description• created• title• creator
2

imi.go.jp

マッピングファイル仕様 v1.0.1• versionInfo• license
マッピングファイルが DMD などの他パッケージの一部として配布される場合は、パッケージが提供する情報と重複する情報は記述する必要はない。例えば、DMD に含まれるマッピングファイルでは、DMD ヘッダーと重複する内容を記述する必要はない。ただし、パッケージから分離されて単独で配布される可能性がある場合は、上記のプロパティが記述されていることが望ましい。
公開されている DMD をマッピングの対象としている場合は、targetDMD プロパティに記述することを推奨する。

附属書
附属書は、参考情報であり、規定ではない。

附属書 A マッピングファイルの JSON スキーマ
マッピングファイルの JSON スキーマ を附属書 A に示す。
123456789101112131415161718192021222324252627282930
3132333435363738394041{"$schema ": "http ://json -schema.org/draft -04/ schema #","description ": "IMI DMD mapping file","type ": "object","definitions ": {"date ": {"type ": "string","pattern ": "^[1 -9][0 -9]* -[01][0 -9] -[0123][0 -9]$"},"agent ": {"type ": "object","properties ": {"name ": {"type ": "string"},"homepage ": {"type ": "string","format ": "uri"}}},"agentList ": {"anyOf ": [{ "$ref ": "#/ definitions/agent" },{"type ": "array","minItems ": 1,"items ": { "$ref ": "#/ definitions/agent" }}]},"document ": {"type ": "object","properties ": {"name ": {"type ": "string"},"page ": {"type ": "string","format ": "uri"}3

imi.go.jp

マッピングファイル仕様 v1.0.1
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107}
},
"structuredItemName ": {"anyOf ": [{"type ": "string"},{"type ": "object","properties ": {"value ": {"type ": "string"}},"required ": [" value"],"additionalProperties ": true}]}},"properties ": {"targetDMD ": { "type ": "string" },"description ": { "type ": "string" },"description_en ": { "type ": "string" },"defaultVocab ": { "type ": "string", "format ": "uri" },"created ": {"$ref ": "#/ definitions/date"},"issued ": {"$ref ": "#/ definitions/date"},"modified ": {"$ref ": "#/ definitions/date"},"title ": {"type ": "string"},"creator ": { "$ref ": "#/ definitions/agentList" },"publisher ": { "$ref ": "#/ definitions/agentList" },"versionInfo ": {"type ": "string"},"license ": {"anyOf ": [{ "$ref ": "#/ definitions/document" },{"type ": "array","minItems ": 1,"items ": { "$ref ": "#/ definitions/document" }}]},"base ": {"type ": "string","format ": "uri"},"prefix ": {"type ": "object","patternProperties ": {".+": { "type ": "string" }}},"mapping ": {"type ": "object","patternProperties ": {".+": {4

imi.go.jp

マッピングファイル仕様 v1.0.1
108
109
110
111
112
113
114
115
116
117
118
119
120
121

"anyOf ": [{ "$ref ": "#/ definitions/structuredItemName" },{ "type ": "array", "items ": { "$ref ": "#/ definitions/structuredItemName" } …
Ç }]}
}
},
"patternProperties ": {"^_.+": { }}},"required ": [ "mapping" ],"additionalProperties ": false}

5

imi.go.jp

マッピングファイル仕様 v1.0.1

この文書についてこの文書は、「IMI 共通語彙基盤」の技術的な要件をとりまとめた技術仕様書のひとつです。
表題

マッピングファイル仕様

バージョン

1.0.1

公開日

2019 年 2 月 28 日

作成者

独立行政法人情報処理推進機構 (IPA)
社会基盤センター

IMI 検討部会
発行者

独立行政法人情報処理推進機構 (IPA)(法人番号 5010005007126)

この文書のご利用にあたって著作権
この文書は、IPA が著作権を持ち、CC0 1.0 全世界 (https://creativecommons.org/publicdomain/zero/1.0/le-galcode.ja) で公開します。
免責事項
本書の内容を適用した結果生じたこと、また適用できなかった結果について、IPA 及び IMI 検討部会は、一切の責任を負いませんのでご了承ください。



ご意見を募集しています
広くみなさまのご意見を募集しています。以下ご意見投稿のページに進み、ご記入ください。

https://imi.go.jp/783/


この文書の改定履歴• 2019 年 2 月 28 日 MappingSpecification_V101_20190228.pdf 発行• 2018 年 3 月 23 日 MappingSpecification_V10_20180323.pdf 発行

6

imi.go.jp