利用例-4 (Building)

■利用例の概要
　建物を表現するデータモデルである、Buildingをcsvファイルから生成します。但し、BuildingのsattributeであるZonesについては、利用例-6で別に生成します。これは、建物内の場所を表すcsvと建物そのものを表すcsvは別のファイルになるであろうと考えているためです。但し、idは共通化されており、名寄せは可能となっています。

■csvファイル
　利用例-3と同じcsvファイルから項目を選んで変換します。
　本利用例は、施設管理を想定しているため、csvのデータは建物単位作成されています。サンプルのcsvファイルのファイル名は"Facilitycsv.csv"であり、data配下に格納してあります。

■拡張JSON Schema
　元となるJSON Schemaは、このリンクから入手します。
　csvからJSONに変換するルールとして、以下の情報を追加します。追加した拡張JSON Schemaはdata配下にBuildingMain.exschema.jsonというファイル名で格納してありります

Attribute		追加ルール				説明
id
		dataSource
			csvAttr			csvの項目名として、"建物不動産ID"を指定します。
			prefix			不動産IDの前に付加する文字列として、"urn:ngsi-ld:Building::"を指定します。これにより、idの文字列が"urn:ngsi-ld:Building::"と土地の不動産IDを結合した文字列になります
			alternate			自治体が保有する建物は登記しなくても良いという例外の規定があり、実際に殆どの不動産は登記されていません。このため、不動産IDも割り振られていないのが現状です。そこで、不動産IDがなかった場合に備えてalternateの指定もします。この指定はid直下のdataSourceで指定したcsvファイルの項目に値が無かった場合に使用されます。内容はcsvAttrとprefixの指定であり、不動産IDもどきの文字列を生成します。この例では、法人番号と管理通番を組み合わせて文字列を生成しました
				dataSource
					csvAttr	csvの項目名として、"管理通番"を指定します。
				prefix		法人番号の前に付加する文字列として、"urn:ngsi-ld:Building:JP9000020342025-"を指定します。これによりこの例では、idの文字列が"urn:ngsi-ld:Building:JP"と呉市の法人番号と管理通番を結合した文字列になります
name
		dataSource
			csvAttr			csvの項目名として"建物名"を指定します。
nameKana
		dataSource
			csvAttr			csvの項目名として"建物名カナ"を指定します。
facilityID
		dataSource
			csvAttr			csvの項目名として"管理通番"を指定します。
refLand
		dataSource
			csvAttr			csvの項目名として、"土地不動産ID"を指定します。
			prefix			土地の不動産IDの前に付加する文字列として、"urn:ngsi-ld:Land:"を指定します。これにより、idの文字列が"urn:ngsi-ld:Land:"と土地の不動産IDを結合した文字列になります
			alternate			自治体が保有する土地は登記しなくても良いという例外の規定があり、実際に殆どの不動産は登記されていません。このため、不動産IDも割り振られていないのが現状です。そこで、不動産IDがなかった場合に備えてalternateの指定もします。この指定はcsvAttrで指定したcsvファイルの項目に値が無かった場合に使用されます。
				dataSource		.
					csvAttr	csvの項目名の"管理通番"を指定します。
				prefix		管理通番の前に付加する文字列として、"urn:ngsi-ld:Land:JP0990123456001-"を指定します。これにより、idの文字列が"urn:ngsi-ld:Land:JP"と呉市の法人番号と管理通番を結合した文字列になります
totalFloorArea
		dataSource
			csvAttr			csvファイルの項目名として、"床面積"を指定します
completionYear
		dataSource
			csvAttr			csvファイルの項目名として、"建築年"を指定します
acquisitionPrice
		dataSource
			csvAttr			csvファイルの項目名として、"取得価格"を指定します
refDepartment
		dataSource
			csvAttr			所管部門のEntityのidを求めるため、csvファイルの項目名として"所管部門名"を指定します
		entityType				部門名からDepartmentのidを求めるために、検索するEntityとして"Department"を指定します
		searchAttr				Departmentの部門名が登録されているAttributeとして、"name"を指定します
		valueAttr				Departmentからidを取り出すために、Attributeとして、"id"を指定します
identificationGroup
	identificationType
		const				不動産IDを登録するために、"不動産ID"を設定します。c
	identification
		dataSource
			csvAttr			csvファイルの項目名として"建物不動産ID"を指定します。

これら以外のAttrributeはそのまま残します。消しても残しても無視されます。但し、typeはrequiredに指定してあるので、JSONに変換されます。

■実行
　cドライブ直下にToolsというフォルダを作成して、全てのファイルをここに格納して実行しています。

C:\Users\owner>chdir c:/Tools/

c:\Tools>Python ctoj.py dir=c:/Tools/data/ inputfile=Facilitycsv.csv outputfile=Buildingjson.json schemafile=BuildingMain.exschema.json Departmentfile=Departmentjson.json Landfile=Landjson.json logfile=Buildinglog.txtOrganizationfile=Organizationjson.json
##### start ctoj converter #####
CSV translated to JSON successfully. Number of output Entities: 4

■変換結果
　ツール実行結果は以下の通りです。Facilityのcsvを入力としており、ひとつの建物複数の施設が入居しているため、同じ情報が複数回出現しています。

[
{
"id": "urn:ngsi-ld:Building:JP9000020342025-01234567",
"type": "Building",
"name": {
"type": "Text",
"value": "呉市吉浦市民センター"
},
"nameKana": {
"type": "Text",
"value": "クレシヨシウラシミンセンター"
},
"facilityID": {
"type": "Text",
"value": "01234567"
},
"refLand": {
"type": "Relationship",
"value": [
"urn:ngsi-ld:Land:JP0990123456001-01234567"
]
},
"totalFloorArea": {
"type": "Number",
"value": 2152
},
"completionYear": {
"type": "Text",
"value": "1996"
},
"refDepartment": {
"type": "Relationship",
"value": "urn:ngsi-ld:Department:JP9000020342025-0402004"
}
},
{
"id": "urn:ngsi-ld:Building:JP9000020342025-01234567",
"type": "Building",
"name": {
"type": "Text",
"value": "呉市吉浦市民センター"
},
"nameKana": {
"type": "Text",
"value": "クレシヨシウラシミンセンター"
},
"facilityID": {
"type": "Text",
"value": "01234567"
},
"refLand": {
"type": "Relationship",
"value": [
"urn:ngsi-ld:Land:JP0990123456001-01234567"
]
},
"totalFloorArea": {
"type": "Number",
"value": 2152
},
"completionYear": {
"type": "Text",
"value": "1996"
},
"refDepartment": {
"type": "Relationship",
"value": "urn:ngsi-ld:Department:JP9000020342025-0402004"
}
},
{
"id": "urn:ngsi-ld:Building:JP9000020342025-03000012",
"type": "Building",
"name": {
"type": "Text",
"value": "呉市立吉浦小学校"
},
"nameKana": {
"type": "Text",
"value": "クレシリツヨシウラショウガツコウ"
},
"facilityID": {
"type": "Text",
"value": "03000012"
},
"refLand": {
"type": "Relationship",
"value": [
"urn:ngsi-ld:Land:JP0990123456001-03000012"
]
},
"totalFloorArea": {
"type": "Number",
"value": 4000
},
"completionYear": {
"type": "Text",
"value": "1980"
},
"refDepartment": {
"type": "Relationship",
"value": "urn:ngsi-ld:Department:JP9000020342025-0602003"
}
},
{
"id": "urn:ngsi-ld:Building:JP9000020342025-04000008",
"type": "Building",
"name": {
"type": "Text",
"value": "呉市立吉浦中学校"
},
"nameKana": {
"type": "Text",
"value": "クレシリツヨシウラチュウガツコウ"
},
"facilityID": {
"type": "Text",
"value": "04000008"
},
"refLand": {
"type": "Relationship",
"value": [
"urn:ngsi-ld:Land:JP0990123456001-04000008"
]
},
"totalFloorArea": {
"type": "Number",
"value": 3000
},
"completionYear": {
"type": "Text",
"value": "1990"
},
"refDepartment": {
"type": "Relationship",
"value": "urn:ngsi-ld:Department:JP9000020342025-0602003"
}
}
]

ログファイルは以下の通りです。全ての行でエラーは発生していません。

08: inputdir: c:/Tools/data/, inputfile: Facilitycsv.csv
09: referenced entities. directory: c:/Tools/data/, Organizationfile: Organizationjson.json
09: referenced entities. directory: c:/Tools/data/, Departmentfile: Departmentjson.json
09: referenced entities. directory: c:/Tools/data/, Landfile: Landjson.json
09: outputdir: c:/Tools/data/, outputfile: Buildingjson.json
10: CSV Line# 2
10: CSV Line# 3
10: CSV Line# 4
10: CSV Line# 5
12: CSV translated to JSON successfully. Entities number: 4