利用例-2 (Department)

---

■利用例の概要
　法人の中の部門を表現するデータモデルである、Departmentをcsvファイルから生成します。

■csvファイル
　ここでは、公共施設の所管部門として二つの部門を登録します。本利用例のcsvはこちら。

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

Attribute	追加ルール			説明
id
	dataSource			idを法人番号と部門番号を組み合わせて作成するので、リスト構造で二つの指定を可能とします。
	0	dataSource
			csvAttr	法人番号を求めるための元情報元情報としてcsvの項目名として、"部門名号"を指定します。
		entityType		部門名から部門番号を求めるためのentitiesとして"Organization"を指定します
		searchAttr		Organizationをサーチする項目として法人名が格納してある"name"を指定します
		searchAttr		法人番号を取り出す項目として、identificationGroupのidentificationを指定します
		identificationType		identificationGroupのどの要素かを指定するために"部門番号"を指定します
		prefix		法人番号の前に付加する文字列として、"urn:ngsi-ld:Department:JP"を指定します。これにより、idの文字列が"urn:ngsi-ld:Department:JP"と呉市の法人番号を結合した文字列になります
	1	csvAttr		csvの項目名として、"部門番号"を指定します。
		prefix		法人番号の前に付加する文字列として、"-"を指定します。これにより、最終的にidの文字列が"urn:ngsi-ld:Department:JP"と呉市の法人番号と"-"と部門番号を結合した文字列になります
name
	dataSource
		csvAttr		csvの項目名として、"部門名"を指定します。
departmentOf				呉市のEntityのidを求めて格納します
	dataSource
		dataSource
			csvAttr	csvの項目名として、"法人名"を指定します。
		entityType		法人名からOrganizationのidを求めるために、検索するEntityとして"Organization"を指定します
		searchAttr		Organizationの法人名が登録されているAttributeとして、"name"を指定します
		valueAttr		Organizationからidを取り出すために、Attributeとして、"id"を指定します
contactPoint
	dataSource
		csvAttr		所在地は市内の住所が格納されているので、streetAddressに対するcsvの項目名として、"所在地"を指定します
	const			自治体名と都道府県名は所在地に含まれていないので、constで"呉市"と"広島県を指定します

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

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

C:\Users\owner>chdir c:/Tools/ c:\Tools>Python ctoj.py dir=c:/Tools/data/ inputfile=Departmentcsv.csv outputfile=Departmentjson.json schemafile=Department.exschema.json Organizationfile=Organizationjson.json logfile=Departmentlog.txt ##### start ctoj converter ##### CSV translated to JSON successfully. output Entity number: 2

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

[    {      "id": "urn:ngsi-ld:Department:JP9000020342025-402004",      "type": "Department",      "name": {        "type": "Text",        "value": "吉浦まちづくりセンター"      },      "departmentOf": {        "type": "Relationship",        "value": "urn:ngsi-ld:Organization:JP9000020342025"      }    },    {      "id": "urn:ngsi-ld:Department:JP9000020342025-602003",      "type": "Department",      "name": {        "type": "Text",        "value": "学校施設課"      },      "departmentOf": {        "type": "Relationship",        "value": "urn:ngsi-ld:Organization:JP9000020342025"      }    }  ]

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

02: inputdir: c:/Tools/Data/, inputfile: Departmentcsv.csv 04: directory: Organizationdir, Organizationfile: Organizationfile 09: outputdir: c:/Tools/Data/, outputfile: Departmentjson.json 10: CSV Line# 2 10: CSV Line# 3 12: CSV translated to JSON successfully. Enity number: 2

---