ケーススタディ#2 – CSVから共通データ仕様の形式への変換 (9/14) — 設備(Device) – PPP共通データ仕様協議会　共通データ仕様公開サイト

「設備(Device)」の項目への変換ルール

　ケーススタディ#1の設備一覧表の例で「設備(Device)」から選択した項目は以下の通りです。「設備」以外からはメーカー名のみ利用します。各項目の変換の仕方も表内記入しました。

元となるCSV表の項目名	共通データ仕様上の項目名	表形式への変換の説明
メーカー名、製造番号	id	本ユースケースでは”id”は”urn:nsi-ld:Device”に国コード、メーカーの法人番号、設備の型番、設備の製造番号を繋げた形式とします。メーカーの法人番号は「法人(Organization)」をメーカー名で検索して求めます。
(なし)	type	データモデルのtypeを登録します。ここでは”Device”を登録します。
設置日	dateInstalled	設置した日付です。そのままコピーします。
製造日	dateManufactured	製造年月日です。そのままコピーします。
説明	description	設備情報として公開可能な詳細情報です。そのままコピーします。
設備名称	name	機器の色を設定する。例えば”白”。そのままコピーします。
メーカー名、型番	refDeviceModel	この設備の機種IDです。「法人(Organization)」をメーカー名で検索してメーカーの法人番号を求め、型番と組み合わせてidの文字列を作成します。
管理通番	refBuilding	この設備が設置されている建物の建物IDです。オーナーの法人番号と、管理通番と組み合わせてidの文字列を作成します。オーナーを区別する項目が無い為、法人番号は固定値で設定します。
製造番号	serialNumber	製造番号(シリアルナンバー)を登録します。そのままコピーします。
URL	url	設置場所写真のURLなど。そのままコピーします。
場所大分類	zoneInstalled[0]	場所の大分類です。そのままコピーします。
場所中分類	zoneInstalled[1]	場所の中分類です。そのままコピーします。
場所小分類	zoneInstalled[2]	場所の小分類です。そのままコピーします。

CSV表の準備

　ケーススタディ#1の設備一覧表の例を使います。

■入力となる表

設備種別	設備名称	ブランド名	型番	色	メーカー名	建物名	管理通番	場所大分類	場所中分類	場所小分類	設置日	製造日	製造番号	耐用年数
照明器具	照明-1F-支所-001	ペアルック	PL-101X	白	パナ製作所	呉市吉浦市民センター	01234567	建物内部	1F	吉浦支所	2018-04-25	2018-01-12	PL-101X-123	20
空調機	空調-1F-支所-002	ひぐまくん	HG-232W	白	パナ製作所	呉市吉浦市民センター	01234567	建物内部	1F	吉浦支所	2020-05-15	2020-03-25	HG-232W-234	10
照明器具	照明-1F-支所-003	ペアルック	PL-101X	白	パナ製作所	呉市吉浦市民センター	01234567	建物内部	1F	男子トイレ	2019-06-25	2019-03-05	PL-101X-2020	20
空調機	空調-1F-支所-004	ひぐまくん	HG-232W	白	パナ製作所	呉市吉浦市民センター	01234567	建物内部	1F	男子トイレ	2018-07-13	2018-04-21	HG-232W1209	10
流し台	流し-1F-支所-005	KAKA -100	KAKA -100		KAKA	呉市吉浦市民センター	01234567	建物内部	1F	男子トイレ	2019-02-05	2018-02-13	KAKA-100A2356	20
鏡	鏡-1F-支所-006	KAKA -200	KAKA -200		KAKA	呉市吉浦市民センター	01234567	建物内部	1F	男子トイレ	2018-05-25	2018-01-25	KAKA-200A2765	10
洋式便器	便器-1F-支所-007	KAKA -300	KAKA -300		KAKA	呉市吉浦市民センター	01234567	建物内部	1F	男子トイレ	2020-06-24	2020-01-09	KAKA-300A5987	7
照明器具	照明-1F-支所-008	ペアルック	PL-101X	白	パナ製作所	呉市吉浦市民センター	01234567	建物内部	1F	正面玄関	2021-07-15	2021-02-23	PL-101XXGRD	20
空調機	空調-1F-支所-009	ひぐまくん	HG-232W	白	パナ製作所	呉市吉浦市民センター	01234567	建物内部	1F	正面玄関	2019-02-26	2018-11-15	HG-232-236	10
照明器具	照明-2F-吉小-001	ペアルック	PL-101X	白	パナ製作所	呉市立吉浦小学校	03000012	校舎	2F	1年1組	2013-02-20	2013-01-24	PL-101X-345	20
空調機	空調-2F-吉小-002	ひぐまくん	HG-232W	白	パナ製作所	呉市立吉浦小学校	03000012	校舎	2F	1年1組	2015-03-15	2013-02-15	HG-232W-654	10
照明器具	照明-2F-吉小-003	ペアルック	PL-101X	白	パナ製作所	呉市立吉浦小学校	03000012	校舎	2F	西階段室	2016-04-07	2016-01-25	PL-101X-4765	20
防火扉	防火-2F-吉小-004	防火ダウンパネル	DP10-200X		西洋シャッター	呉市立吉浦小学校	03000012	校舎	2F	西階段室	2012-05-19	2012-02-02	DP10-200XGH5	20
舞台照明	舞照-2F-吉小-006	LX-100	LX-100		吉浦電機製作所	呉市立吉浦小学校	03000012	体育館	舞台		2018-04-25	2018-01-12	LX-100-PL109	10
舞台音響	舞音-2F-吉小-007	HIF-10000	HIF-10000		吉浦サウンドシステム	呉市立吉浦小学校	03000012	体育館	舞台		2020-05-15	2020-03-25	HIF-10000-PO8KJ	7
照明器具	照明-3F-吉中-001	ペアルック	PL-101X	白	パナ製作所	呉市立吉浦中学校	04000008	校舎	3F	3年A組	2019-06-25	2019-03-05	PL-101X-987	20
空調機	空調-3F-吉中-002	ひぐまくん	PL-101X	白	パナ製作所	呉市立吉浦中学校	04000008	校舎	3F	3年A組	2018-07-13	2018-04-21	HG-232W-456	10
外灯	外灯-3F-吉中-003	ソーラーライト	HG-232W		吉浦街路灯	呉市立吉浦中学校	04000008	屋外	正門		2019-02-05	2018-02-13	SL-321V2JUY	20
呼出設備	呼出-3F-吉中-004	IX-1000	SL-321V2		ガラホン	呉市立吉浦中学校	04000008	屋外	正門		2018-05-25	2018-01-25	IX-1000-876D	7
遊具	遊具-3F-吉中-005	鉄棒-100	IX-1000		吉浦遊具	呉市立吉浦中学校	04000008	屋外	グランド		2020-06-24	2020-01-09	HB-100X-G2LOI	20
プール	泳場-3F-吉中-006	P25-10	HB-100X-G2		吉浦プール	呉市立吉浦中学校	04000008	屋外	グランド		2021-07-15	2021-02-23	P25-10-2019	20

■CSVファイルの内容

設備種別,設備名称,ブランド名,型番,色,メーカー名,建物名,管理通番,場所大分類,場所中分類,場所小分類,設置日,製造日,製造番号,機種通称,耐用年数,URL,説明
照明器具,照明-1F-支所-001,ペアルック,PL-101X,白,パナ製作所,呉市吉浦市民センター,01234567,建物内部,1F,吉浦支所,2018-04-25,2018-01-12,PL-101X-123,,20,,
空調機,空調-1F-支所-002,ひぐまくん,HG-232W,白,パナ製作所,呉市吉浦市民センター,01234568,建物内部,1F,吉浦支所,2020-05-15,2020-03-25,HG-232W-234,,10,,
照明器具,照明-1F-支所-003,ペアルック,PL-101X,白,パナ製作所,呉市吉浦市民センター,01234569,建物内部,1F,男子トイレ,2019-06-25,2019-03-05,PL-101X-2020,,20,,
空調機,空調-1F-支所-004,ひぐまくん,HG-232W,白,パナ製作所,呉市吉浦市民センター,01234570,建物内部,1F,男子トイレ,2018-07-13,2018-04-21,HG-232W1209,,10,,
流し台,流し-1F-支所-005,KAKA -100,KAKA -100,,KAKA,呉市吉浦市民センター,01234571,建物内部,1F,男子トイレ,2019-02-05,2018-02-13,KAKA-100A2356,,20,,
鏡,鏡-1F-支所-006,KAKA -200,KAKA -200,,KAKA,呉市吉浦市民センター,01234572,建物内部,1F,男子トイレ,2018-05-25,2018-01-25,KAKA-200A2765,,10,,
洋式便器,便器-1F-支所-007,KAKA -300,KAKA -300,,KAKA,呉市吉浦市民センター,01234573,建物内部,1F,男子トイレ,2020-06-24,2020-01-09,KAKA-300A5987,,7,,
照明器具,照明-1F-支所-008,ペアルック,PL-101X,白,パナ製作所,呉市吉浦市民センター,01234574,建物内部,1F,正面玄関,2021-07-15,2021-02-23,PL-101XXGRD,,20,,
空調機,空調-1F-支所-009,ひぐまくん,HG-232W,白,パナ製作所,呉市吉浦市民センター,01234575,建物内部,1F,正面玄関,2019-02-26,2018-11-15,HG-232-236,,10,,
照明器具,照明-2F-吉小-001,ペアルック,PL-101X,白,パナ製作所,呉市立吉浦小学校,03000012,校舎,2F,1年1組,2013-02-20,2013-01-24,PL-101X-345,,20,,
空調機,空調-2F-吉小-002,ひぐまくん,HG-232W,白,パナ製作所,呉市立吉浦小学校,03000012,校舎,2F,1年1組,2015-03-15,2013-02-15,HG-232W-654,,10,,
照明器具,照明-2F-吉小-003,ペアルック,PL-101X,白,パナ製作所,呉市立吉浦小学校,03000012,校舎,2F,西階段室,2016-04-07,2016-01-25,PL-101X-4765,,20,,
防火扉,防火-2F-吉小-004,防火ダウンパネル,DP10-200X,,西洋シャッター,呉市立吉浦小学校,03000012,校舎,2F,西階段室,2012-05-19,2012-02-02,DP10-200XGH5,,20,,
舞台照明,舞照-2F-吉小-006,LX-100,LX-100,,吉浦電機製作所,呉市立吉浦小学校,03000012,体育館,舞台,,2018-04-25,2018-01-12,LX-100-PL109,,10,,
舞台音響,舞音-2F-吉小-007,HIF-10000,HIF-10000,,吉浦サウンドシステム,呉市立吉浦小学校,03000012,体育館,舞台,,2020-05-15,2020-03-25,HIF-10000-PO8KJ,,7,,
照明器具,照明-3F-吉中-001,ペアルック,PL-101X,白,パナ製作所,呉市立吉浦中学校,04000008,校舎,3F,3年A組,2019-06-25,2019-03-05,PL-101X-987,,20,,
空調機,空調-3F-吉中-002,ひぐまくん,PL-101X,白,パナ製作所,呉市立吉浦中学校,04000008,校舎,3F,3年A組,2018-07-13,2018-04-21,HG-232W-456,,10,,
外灯,外灯-3F-吉中-003,ソーラーライト,HG-232W,,吉浦街路灯,呉市立吉浦中学校,04000008,屋外,正門,,2019-02-05,2018-02-13,SL-321V2JUY,,20,,
呼出設備,呼出-3F-吉中-004,IX-1000,SL-321V2,,ガラホン,呉市立吉浦中学校,04000008,屋外,正門,,2018-05-25,2018-01-25,IX-1000-876D,,7,,
遊具,遊具-3F-吉中-005,鉄棒-100,IX-1000,,吉浦遊具,呉市立吉浦中学校,04000008,屋外,グランド,,2020-06-24,2020-01-09,HB-100X-G2LOI,,20,,
プール,泳場-3F-吉中-006,P25-10,HB-100X-G2,,吉浦プール,呉市立吉浦中学校,04000008,屋外,グランド,,2021-07-15,2021-02-23,P25-10-2019,,20,,

設備情報の変換

　このケーススタディでは”ctoj”というツールを使いますので、csvファイルを作成する際にはutf-8で書き込んでおきます。

このケーススタディでは以下の様に拡張JSON Schemaを策定しました。拡張JSON Schemaとは、本協議会が公開しているJSON SchemaにcsvからJSONファイルに変換する際のルールを追記したものです。詳しくはツールのサイトを参照してください。「設備」の場合は例えば以下となります。

  [
    {
      "id": "urn:ngsi-ld:Device:JP0990123456001-PL-101X-123",
      "type": "Device",
      "dateInstalled": {
        "type": "Date",
        "value": "2018-04-25"
      },
      "dateManufactured": {
        "type": "Date",
        "value": "2018-01-12"
      },
      "name": {
        "type": "Text",
        "value": "照明-1F-支所-001"
      },
      "refDeviceModel": {
        "type": "Relationship",
        "value": "urn:ngsi-ld:DeviceModel:JP0990123456001-PL-101X"
      },
      "refBuilding": {
        "type": "Relationship",
        "value": "urn:ngsi-ld:Building:JP9000020342025-01234567"
      },
      "serialNumber": {
        "type": "Text",
        "value": "PL-101X-123"
      },
      "zoneInstalled": {
        "type": "Array",
        "value": [
          "建物内部",
          "1F",
          "吉浦支所"
        ]
      }
    },
--以下略--

　この拡張JSON Schemaを指定してctojツールを実行すると、以下の様に共通データ仕様の形式変換した結果が得られます。下図は変換後の先頭部分です。

  [
    {
      "id": "urn:ngsi-ld:Device:JP0990123456001-PL-101X-123",
      "type": "Device",
      "dateInstalled": {
        "type": "Date",
        "value": "2018-04-25"
      },
      "dateManufactured": {
        "type": "Date",
        "value": "2018-01-12"
      },
      "name": {
        "type": "Text",
        "value": "照明-1F-支所-001"
      },
      "refDeviceModel": {
        "type": "Relationship",
        "value": "urn:ngsi-ld:DeviceModel:JP0990123456001-PL-101X"
      },
      "refBuilding": {
        "type": "Relationship",
        "value": "urn:ngsi-ld:Building:JP9000020342025-01234567"
      },
      "serialNumber": {
        "type": "Text",
        "value": "PL-101X-123"
      },
      "zoneInstalled": {
        "type": "Array",
        "value": [
          "建物内部",
          "1F",
          "吉浦支所"
        ]
      }
    },
--以下略--