「施設(Facility)」の項目への変換ルール
ケーススタディ#1で作成した施設一覧例から「施設(Facility)」に変換します。施設一覧表の例で「施設(Facility)」から選択した項目は以下の通りです。
| 表形式からの変換の説明 | |||
|---|---|---|---|
| 法人番号 管理通番 | id | idは”url:ngsi-ld:Facility:”という文字列の後に国コード、法人番号、および管理通番を繋げた形式です、国コードは日本国内の団体であれば”JP”固定です。 | |
| (なし) | type | データモデルのtypeを登録します。ここでは”Facility”を登録します。 | |
| 施設名 | name | 施設の名称です。”○○市役所”などです。そのまま転記します。 | |
| 施設名カナ | nameKana | 施設の名称のカナ表記です。そのまま転記します。 | |
| 管理通番 | facilityID | 施設管理業務においてオーナーが指定した施設を識別する番号です。「施設」と「建物」の両方にこの項目がありますが、特に理由がなければ「施設」の「管理通番」を使います。このケーススタディでは8桁の数字です。そのまま転記します。 | |
| ステータス | status | 施設が使われているかどうかを示す項目です。そのまま転記します。 | |
| 部門ID | refDepartment | 所管部門の部門IDです。既に作成した「部門」の情報を「所管部門名」で検索して部門IDを求めます。 | |
| 場所 | zones | この項目はここでは作成しません。場所一覧を変換した後で、統合します。 | |
| 建物ID | refBuilding | この施設が入居している建物の建物IDです。建物IDは法人番号と管理通番から生成します。 | |
CSV表の準備
「土地(Land)」同様、ケーススタディ#1の建物一覧表の例を使います。
■入力となる表
| 施設名 | 施設名カナ | 法人番号 | 管理通番 | 建物不動産ID | 土地不動産ID | 所管部門名 | 部門コード | 所管部門電話番号 | 住所国 | 郵便番号 | 住所都道府県 | 住所市区町村 | 住所町字以下 | ステータス |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 呉市役所 | クレシヤクショ | 9000020342025 | 00000001 | JP | 7378501 | 広島県 | 呉市 | 中央4-1-6 | ||||||
| 呉市吉浦市民センター | クレシヨシウラシミンセンター | 9000020342025 | 01234567 | 市民部吉浦まちづくりセンター | 0402004 | 0823-31-7540 | JP | 7370852 | 広島県 | 呉市 | 吉浦東本町1-7-23 | |||
| 呉市立吉浦小学校 | クレシリツヨシウラショウガッコウ | 9000020342025 | 03000012 | 学校施設課 | 0602003 | 0823-25-3447 | JP | 7370853 | 広島県 | 呉市 | 吉浦中町2-6-5 | |||
| 呉市立吉浦中学校 | クレシリツヨシウラチュウガッコウ | 9000020342025 | 04000008 | 学校施設課 | 0602003 | 0823-25-3447 | JP | 7370862 | 広島県 | 呉市 | 狩留賀町8-6 |
■CSVファイルの内容
| 施設名,施設名カナ,法人番号,管理通番,建物不動産ID,土地不動産ID,所管部門名,部門コード,所管部門電話番号,住所国,郵便番号,住所都道府県,住所市区町村,住所町字以下,ステータス 呉市役所,クレシヤクショ,9000020342025,00000001,,,,,,JP,7378501,広島県,呉市,中央4-1-6, 呉市吉浦市民センター,クレシヨシウラシミンセンター,9000020342025,01234567,,,市民部吉浦まちづくりセンター,0402004,0823-31-7540,JP,7370852,広島県,呉市,吉浦東本町1-7-23, 呉市立吉浦小学校,クレシリツヨシウラショウガッコウ,9000020342025,03000012,,,学校施設課,0602003,0823-25-3447,JP,7370853,広島県,呉市,吉浦中町2-6-5, 呉市立吉浦中学校,クレシリツヨシウラチュウガッコウ,9000020342025,04000008,,,学校施設課,0602003,0823-25-3447,JP,7370862,広島県,呉市,狩留賀町8-6, |
施設情報の変換
このケーススタディでは”ctoj”というツールを使いますので、csvファイルを作成する際にはutf-8で書き込んでおきます。
このケーススタディでは以下の様に拡張JSON Schemaを策定しました。拡張JSON Schemaとは、本協議会が公開しているJSON SchemaにcsvからJSONファイルに変換する際のルールを追記したものです。詳しくはツールのサイトを参照してください。「施設」の場合は例えば以下となります。
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://ppp-database.org/spec/datamodel/Facility/",
"type": "object",
"properties": {
"id": {
"type": "string",
"dataSource": {
"csvAttr": "建物不動産ID",
"prefix": "urn:ngsi-ld:Facility:",
"alternate": {
"dataSource": [
{
"csvAttr": "法人番号",
"prefix": "urn:ngsi-ld:Facility:JP"
},
{
"csvAttr": "管理通番",
"prefix": "-"
}
]
}
}
},
"type": {"const": "Facility"},
"name": {
"type": "object",
"properties": {
"type": {"const": "Text"},
"value": {
"type": "string",
"dataSource": {"csvAttr": "施設名"}
}
},
"required": ["type", "value"]
},
"nameKana": {
"type": "object",
"properties": {
"type": {"const": "Text"},
"value": {
"type": "string",
"dataSource": {"csvAttr": "施設名カナ"}
}
},
"required": ["type", "value"]
},
--以下略--この拡張JSON Schemaを指定してctojツールを実行すると、以下の様に共通データ仕様の形式変換した結果が得られます。下図は変換後の先頭部分です。
[
{
"id": "urn:ngsi-ld:Facility:JP9000020342025-00000001",
"type": "Facility",
"name": {
"type": "Text",
"value": "呉市役所"
},
"nameKana": {
"type": "Text",
"value": "クレシヤクショ"
},
"facilityID": {
"type": "Text",
"value": "00000001"
},
"refBuilding": {
"type": "Relationship",
"value": "urn:ngsi-ld:Building:JP9000020342025-00000001"
}
},
{
"id": "urn:ngsi-ld:Facility:JP9000020342025-01234567",
"type": "Facility",
"name": {
"type": "Text",
"value": "呉市吉浦市民センター"
},
"nameKana": {
"type": "Text",
"value": "クレシヨシウラシミンセンター"
},
"facilityID": {
"type": "Text",
"value": "01234567"
},
"refBuilding": {
"type": "Relationship",
"value": "urn:ngsi-ld:Building:JP9000020342025-01234567"
},
"refDepartment": {
"type": "Relationship",
"value": "urn:ngsi-ld:Department:JP9000020342025-0402004"
}
},
--以下略--
