利用例-5 (Facility)

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

■csvファイル
　利用例-3と同じcsvファイルから項目を選んで変換します。
　本利用例は、施設管理を想定しているため、csvのデータは建物単位作成されています。本利用例のcsvはこちら。

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

Attribute	追加ルール				説明
id
	dataSource
		csvAttr			csvの項目名として、"施設ID"を指定します。
		prefix			施設IDの前に付加する文字列として、"urn:ngsi-ld:Facility:JP9000020342025-"を指定します。これにより、idの文字列が"urn:ngsi-ld:Facility:JP"と法人番号と施設IDを結合した文字列になります
name
	dataSource
		csvAttr			identifivationに、csvの項目名として"施設名"を指定します。
nameKana
	dataSource
		csvAttr			identifivationに、csvの項目名として"タテモノヨミガナ"を指定します。
originalCategory
	dataSource
		csvAttr			identifivationに、csvの項目名として"用途"を指定します。
refBuilding
	dataSource
		csvAttr			csvの項目名として、"不動産ID"を指定します。
		prefix			不動産IDの前に付加する文字列として、"urn:ngsi-ld:Building:"を指定します。これにより、idの文字列が"urn:ngsi-ld:Building:"と建物の不動産IDを結合した文字列になります
		alternate			自治体が保有する土地は登記しなくても良いという例外の規定があり、実際に殆どの不動産は登記されていません。このため、不動産IDも割り振られていないのが現状です。そこで、不動産IDがなかった場合に備えてalternateの指定もします。この指定はcsvAttrで指定したcsvファイルの項目に値が無かった場合に使用されます。内容はcsvAttrとprefixの指定であり、不動産IDもどきの文字列を生成します。この例では、法人番号と施設IDを組み合わせて文字列を生成しました
		0	dataSource
				csvAttr	法人番号を求めるための元情報元情報としてcsvの項目名として、"自治体名"を指定します。
			entityType		自治体名から法人番号を求めるためのentitiesとして"Organization"を指定します
			searchAttr		Organizationをサーチする項目として法人名が格納してある"name"を指定します
			searchAttr		法人番号を取り出す項目として、identificationGroupのidentificationを指定します
			identificationType		identificationGroupのどの要素かを指定するために"法人番号"を指定します
			prefix		法人番号の前に付加する文字列として、"urn:ngsi-ld:Building:JP"を指定します。これにより、idの文字列が"urn:ngsi-ld:Building:JP"と呉市の法人番号を結合した文字列になります
		1	csvAttr		csvの項目名として、"施設ID"を指定します。
			prefix		施設IDの前に付加する文字列として、"-"を指定します。これにより、最終的にidの文字列が"urn:ngsi-ld:Building:JP"と呉市の法人番号と"-"と施設IDを結合した文字列になります
contactPoint
	dataSource
		csvAttr			電話番号を登録するため、telephoneの値に対しcsvファイルの項目名として"電話番号"を指定します

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

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

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

c:\Tools>Python ctoj.py dir=c:/Tools/data/ inputfile=Facilitycsv.csv outputfile=Facilityjson.json schemafile=Facility.exschema.json logfile=Facilitylog.txt
##### start ctoj converter #####
CSV translated to JSON successfully. output Entity number: 3

■変換結果
　ツール実行結果は以下の通りです。

[
{
"id": "urn:ngsi-ld:Facility:JP9000020342025-01234567",
"type": "Facility",
"name": {
"type": "Text",
"value": "呉市吉浦市民センター"
},
"nameKana": {
"type": "Text",
"value": "クレシヨシウラシミンセンター"
},
"originalCategory": {
"type": "Array",
"value": [
"市民文科系施設"
]
},
"refBuilding": {
"type": "Relationship",
"value": "urn:ngsi-ld:Building:JP9000020342025-01234567"
},
"contactPoint": {
"type": "ContactPoint",
"value": [
{
"telephone": [
"0823-01-2345"
]
}
]
}
},
{
"id": "urn:ngsi-ld:Facility:JP9000020342025-03000012",
"type": "Facility",
"name": {
"type": "Text",
"value": "呉市立吉浦小学校"
},
"nameKana": {
"type": "Text",
"value": "クレシリツヨシウラショウガツコウ"
},
"originalCategory": {
"type": "Array",
"value": [
"学校教育系施設"
]
},
"refBuilding": {
"type": "Relationship",
"value": "urn:ngsi-ld:Building:JP9000020342025-03000012"
}
},
{
"id": "urn:ngsi-ld:Facility:JP9000020342025-04000008",
"type": "Facility",
"name": {
"type": "Text",
"value": "呉市立吉浦中学校"
},
"nameKana": {
"type": "Text",
"value": "クレシリツヨシウラチュウガツコウ"
},
"originalCategory": {
"type": "Array",
"value": [
"学校教育系施設"
]
},
"refBuilding": {
"type": "Relationship",
"value": "urn:ngsi-ld:Building:JP9000020342025-04000008"
}
}
]

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

02: inputdir: c:/Tools/Data/, inputfile: Facilitycsv.csv
09: outputdir: c:/Tools/Data/, outputfile: Facilityjson.json
10: CSV Line# 2
10: CSV Line# 3
10: CSV Line# 4
12: CSV translated to JSON successfully. Enity number: 3