3.2. データモデル - 公共施設管理

---

　地方公共団体と同じデータモデルになることを念頭に策定してあります。

データモデル名Organization				想定表示名: 団体、または法人					対象ドメイン:公共施設管理
IRI: https://pfikyokai.or.jp/Organization
継承元、参照規約: コアデータモデル/法人、schema.org/Organization
補足: 一旦、地方公共団体と同じデータモデルになると仮定してコアデータモデルの「法人」から策定しました。尚、コアデータモデルの施設には施設管理事業者の内容を示す項目は無く、施設補修のレポートにもありません。このため、団体に関するデータが不要となる可能性もあります。
項目名 Attribute name			CDM項目名	既存DM		PFM	事務局案		説明
				CDM	Sch		データ型	回数
id			法人番号	必			Text	1::1	NGSI-LDの仕様に合わせ、次の形式とする。"urn:ngsi-ld:Organization:"<法人番号>。
type			type				Text	1::1	必ず"Organization"の文字列でなくてはならない
identificationGroup			ID群	〇	〇		StructuredValue	0::n	法人に付与した一意のIDを記載。
	identification		ID	必			Text	1::1
	identificationType		ID種別	必			Text	1::1	例えば"都道府県コード"及び"市区町村コード"
name			商号または名称	必	〇		Text	1::1	正式な施設管理事業者の名称を設定する。登記上の名称であり、漢字、ひらがな、カタカナ、その他の文字を使って記載する。
nameKana			商号または名称（カナ）	必			Text	1::1	カナ表記を設定する
nameEn			商号または名称（英字）	〇			Text	0::1	米国英語表記を設定する
organizationTypePosition			組織種別位置（前株、後株）	〇			Text	0::1	組織種別（株式会社等）を法人名の前後のどちらに付与するかを記載。
category			種別	〇			Text	1::1	列挙型項目: "市区町村"、"都道府県"、"株式会社"、"有限会社"、"合名会社"、"合資会社"、"合同会社"。広域連合などは、必要に応じて順次追加する。
abbreviatedAlphabet			略称アルファベット	〇			Text	削	略称アルファベットを記載。
alternateName			通称	〇	〇		Text	0::n	コアデータモデルでは最大一つとなっているが、複数記載できるように拡張しました。例えばJR東日本の場合、["JR東日本", "JR東", "JRE" JR East"]
status			事業活動状況	〇			Text	0::1	活動状況（倒産、破産、休眠、休業、廃業等）を記載。
description			説明	〇	〇		Text	0::1	説明を記載
url			WebサイトURL	〇	〇		Text	0::1	法人に関する情報源を示すWebサイトURLを記載。
associatedOrganization			関連組織	〇			Text	0::n	関連組織（子会社、提携先等）を記載。
numberOfRegularEmployees			正社員数	〇			Text	0::1	正社員数を記載。
numberOfEmployees			従業員数	〇			Text	0::1	従業員数を記載。
feature			地物（関連施設）	〇			Text	0::n	法人に関連する地物（関連施設）を記載。
representativeName			代表者名称	〇			StructuredValue	削	代表者名称を記載。尚、コアデータモデルでは、出身地や配偶者の有無など多様な属性情報を定義してあるが、公共施設管理には関係しないと考え、必須項目のみ記載した。尚、代表者は更新があり得る情報であり、個人情報にも通ずるため、本項目は記載しない()定義から外す)事としてはどうか
	identificationGroup		ID群	必			StructuredValue	削	個人番号、教員番号など
		identification	ID	必			Text	削
		identificationType	ID種別	必			Text	削
	familyName		氏	必			Text	削
	givenName		名	必			Text	削
	familyNameKana		氏（カナ）	必			Text	削
	givenNameKana		名（カナ）	必			Text	削
	sex		性別	必			Text	削
representativePosition			代表者役職名	〇			Text	削
establishedDate			設立年月日	〇			DateTime	0::1
yearOfEstablishment			創業年	〇			Text	0::1
businessCategory			事業種目	〇			Text	0::n
fiscalYearStartDay			事業年度開始日	〇			Text	0::1	年度開始日を"MM-DD"形式で記載
capital			資本金	〇			Integer	0::1	資本金を記載。
registeredAddress			登記住所	〇	〇		PaostalAddress	0::1	登記住所を記載。
businessPlaceInformation			事業所情報	〇	〇		StructuredValue	削	事業所情報は、次項の「部門」に記載するため、ここからは削除
contactPoint			連絡先情報	必			ContactPoint	0::n	連絡先情報は団体と部門の両方にあるため、必須項目から外してはどうか。尚、本節では主管課の補足情報でしかないので、この項目の利用は想定していません。
	availableLanguage		対応言語	無し			Text	0::n	対応できる言語を記述します日本語では、"ja"または"jpn"。
	contactType		対応種別	無し			Text	0::n	連絡の種別を記述する。CDMにはない項目。例えば施設の場合、"施設の不具合"、"予約"、"その他"などの記載があり得る。この項目がある場合、データモデルでは、連絡先を複数記述出来る事が期待される。
	telephone		電話番号	〇			Text	0::n	電話番号、携帯電話番号
	extension		内線番号	〇			Text	0::1	内線番号
	email		メールアドレス	〇			Text	0::1	連絡先メールアドレス
	formURL		FormURL	〇			Text	0::1	連絡先がWebFormの場合のURL
containedInPlace			都道府県				Text	0::1	民間企業の場合、値を設定しない。
dateCreated							DateTime	1::1	NGSI V2のBuiltin Attributes
dateModified							DateTime	1::1	NGSI V2のBuiltin Attributes
例 Normalized形式 {    "id": "urn:ngsi-ld:Organization:999920342025",    "type": "Organization",    "name": {        "type": "Text",        "value": "〇×株式会社"    },    "nameKana": {        "type": "Text",        "value": "マルバツカブシキガイシャ"    },    "category": {        "type": "Text",        "value": "株式会社"    },    "contactPoint": [        {            "type": "ContactPoint",            "value": {                "telephone": [                    "012-345-6789"                ],                "emailAddress": "hello@nanda.kanda.jp"            }        }    ] } keyValues形式 {    "id": "urn:ngsi-ld:Organization:999920342025",    "type": "Organization",    "name": "〇×株式会社",    "nameKana": "マルバツカブシキガイシャ",    "category": "株式会社",    "contactPoint": [        {            "type": "ContactPoint",            "value": {                "telephone": [                    "012-345-6789"                ],                "emailAddress": "hello@nanda.kanda.jp"            }        }    ] }

---

3.2 2 設備/デバイス

　公共施設に設置された各種設備機器の情報です。SDMのモデルに従い、設置した一つひとつの機器の情報(Device)と機器のモデル情報(DeviceModel)に分かれています。

データモデル名: Device		想定表示名: 設備/デバイス					対象ドメイン:公共施設管理
IRI: https://pfikyokai.or.jp/Device
継承元、参照規約: コアデータモデル設備、Smart Data Models/Device
補足: コアデータモデルの設備を継承。但し、コアデータモデルの設備は、例えば消防設備である消火栓の一覧を作成するなどを想定しており、施設内の設備の補修などの目的には情報の内容や粒度が異なるため、Smart Data ModelsのDeviceで補強する。
項目名 Attribute name	CDM項目名	既存DM		PFM	事務局案		説明
		CDM	SDM		データ型	回数
id	ID	〇	必		Text	1::1	NGSI-LDの仕様に合わせ、次の形式とする。"urn:ngsi-ld:Device:"<一意となる文字列>。一意となる文字列は何でもよい。例えばシリアルナンバー
type	type		必		Text	1::1	必ず"Device"の文字列でなくてはならない
category	区分 種別情報	〇	〇		Text	0::1	設備の種別。列挙型項目。SDMではactuator, beacon, endgun, HVAC(空調), implement, irrSection, irrSystem, meter, multimedia, network, sensor'などの定義が並ぶ。
name	名称	必	〇		Text	0::1	設備の名称を日本語で設定する。名称がついているとは限らず、必須ではないとした。
nameKana	名称（カナ）	必			Text	0::1	設備の名称のカナ表記を設定する
nameEn	名称（英字）	必			Text	0::1	設備の名称の米国英語表記を設定する
description	説明	〇	〇		Text	0::1	建物情報として公開可能な詳細情報
status	状態	〇			Text	0::1	「建築」、「稼働中」、「閉鎖中」などのステータス
refPublicFacility	設備住所	必			Relationship	1::1	CDMでは住所情報を格納することになっているが、ここでは公共施設のidを角煮鵜する事とした。
openingHours	サービス曜日 開始時刻 終了時刻 日時備考	〇	〇		Text (Array)	削	曜日ごとの利用可能時刻の配列。参照先のPublicFacilityと重複するので、削除してはどうか。
url	URL	〇			Text	0::1	設置場所写真のURLなど
remarks	備考	〇			Text	0::1	備考
contactPoint	連絡先情報	〇			ContactPoint	削	施設の情報と重複しているため削除してはどうか
refDeviceModel			〇		Relationship	1::1	機器のモデル情報のEntityのid
dateInstalled			〇		Text	1::1	設置した日付
areaServed			〇		Text	0::1	設備の提供領域。例えば照明機器や空調機器で"図書室"や"職員室"。不具合時に影響を受ける場所
controlledAsset			〇		Test (Array)	0::1	制御や計測するもの。例えば"プール"
controlledProperty			必		Text	0::1	制御や計測する対象。例えば"水位"
zoneInstalled				〇	Text (Array)	1::n	設置した場所。「設備」で定義したZonesと任意文字列の配列で記載します。例えば["校舎", "2F","1年C組", "天井"]
dateCreated			〇		DateTime	1::1	NGSI V2のBuiltin Attributes
dateModified			〇		DateTime	1::1	NGSI V2のBuiltin Attributes
例 Normalized形式 {    "id": "urn:ngsi-ld:Device:9000020342025:22:001",    "type": "Device",    "category": {        "type": "Array",        "value": [            "空調",            "温度センサ"        ]    },    "refPublicFacility": {        "type": "StructuredValue",        "value": {            "type": "Relationship",            "value": "urn:ngsi-ld:PublicFacility:9000020342025:22"        }    },    "refDeviceModel": {        "type": "StructuredValue",        "value": {            "type": "Relationship",            "value": "urn:ngsi-ld:DeviceModel:Hitchi:RAS-DM28KE8:W"        }    },    "dateInstalled": {        "type": "Date",        "value": "2020-10-10"    },    "zoneInstalled": {        "type": "Array",        "value": ["校舎", "2F", "1年C組"]    } } keyValues形式 {    "id": "urn:ngsi-ld:Device:9000020342025:22:001",    "type": "Device",    "category": [        "空調",        "温度センサ"    ],    "refPublicFacility": {        "type": "Relationship",        "value": "urn:ngsi-ld:PublicFacility:9000020342025:22"    },    "refDeviceModel": {        "type": "Relationship",        "value": "urn:ngsi-ld:DeviceModel:Hitchi:RAS-DM28KE8:W"    },    "dateInstalled": {        "type": "Date",        "value": "2020-10-10"    },    "zoneInstalled": ["校舎", "2F", "1年C組"] }

　CD: コアデータモデルの設備
　SDM: Smart Data ModelsのDevice
　PFM: 公共施設管理の施設補修のレポートを想定して設定した内容(事実には基づいていません)

データモデル名: DeviceModel	想定表示名: 設備/デバイスモデル				対象ドメイン:公共施設管理
IRI: https://pfikyokai.or.jp/DeviceModel
継承元、参照規約: コアデータモデルには該当のモデルはありません。Smart Data Models/DeviceModel
補足: コアデータモデルの設備を継承。但し、コアデータモデルの設備は、例えば消防設備である消火栓の一覧を作成するなどを想定しており、施設内の設備の補修などの目的には情報の内容や粒度が異なるため、Smart Data ModelsのDeviceで補強する。
項目名 Attribute name	既存DM	PFM	事務局案		説明
	SDM		データ型	回数
id	必		Text	1::1	NGSI-LDの仕様に合わせ、次の形式とする。"urn:ngsi-ld:Building:"<一意となる文字列>。一意となる文字列は何でもよい。例えば都市OS内の通番
type	必		Text	1::1	必ず"DeviceModel"の文字列でなくてはならない
alternateName	〇		Text	0::1	通称を入れる。今回のユースケースでは関係ないのではないか。
annotations	〇		Text	0::1	設備に関する注釈
brandName	必		Text	0::1	機器のブランド名を設定する。例えば"しろくまくん"。
category	必		Text (Array)	1::n	設備の種別。列挙型項目。SDMではactuator, beacon, endgun, HVAC(空調), implement, irrSection, irrSystem, meter, multimedia, network, sensor'などの定義が並ぶ。空調、照明、便座、などを検討する必要あり。
color	〇		Text	0::1	機器の色を設定する。例えば"白"
controlledProperty	必		Text	0::1	制御や計測する対象。例えば"水位"。この項目が必要な場合、設定する文字列の定義が必要。
dataProvider	〇		Text	0::1	このEntityに対するプロバイダを特定する文字列。今回のユースケースではプロバイダは存在しません。
description	〇		Text	0::1	建物情報として公開可能な詳細情報
deviceClass	〇		Text (Array)	0::1	デバイスのクラスです。RFC7228で規定されています。今回のユースケースでは関係しないと考えています
documentation	〇		Text	0::1	デバイスのドキュメントに対するリンクです。
energyLimitationClass	〇		Text	0::1	これも、デバイスのクラスです。RFC7228で規定されています。今回のユースケースでは関係しないと考えています
function	〇		Text	0::1	デバイスの機能です。SAREFで規定されており、levelControl, sensing, onOff, openClose, metering, eventNotificationなどがある
image	〇		Text	0::1	デバイスの写真等のurlです。
macAddress	〇		Text	削	デバイスのMACアドレスです。Deviceにあるべきで、ここにあるのはSDMの間違いだと思います。
manufacturerName	〇		Text	1::1	メーカー名を設定する。例えば"日立"
modelName	〇		Text	1::1	機器のモデル名を設定する。例えば"RAS-DM28KE8"
name	〇		Text	0::1	設備の名称を設定する
owner	〇		Text	0::1	所有者のidです。この項目の意味は分かりません。
seeAlso	〇		Text (Array)	0::1	追加情報のURIを格納します。つまり、idやurlが入ります。
source	〇		Text	0::1	データ提供者のurlです
supportedProtocol	〇		Text	0::1	サポートしているプロトコルです
supportedUnits	〇		Text	0::1	サポートしている測定値の精度です
dateCreated	〇		DateTime	1::1	NGSI V2のBuiltin Attributes
dateModified	〇		DateTime	1::1	NGSI V2のBuiltin Attributes
例 Normalized形式 {{    "id": "urn:ngsi-ld:DeviceModel:Hitchi:RAS-DM28KE8:W",    "type": "DeviceModel",    "category": {        "type": "Array",        "value": [            "空調",            "温度センサ"        ]    },    "manufacturerName": {        "type": "Text",        "value": "日立"    },    "modelName": {        "type": "Text",        "value": "RAS-DM28KE8"    },    "brandName": {        "type": "Text",        "value": "しろくまくん"    },    "color": {        "type": "Text",        "value": "白"    } } keyValues形式 {    "id": "urn:ngsi-ld:DeviceModel:Hitchi:RAS-DM28KE8:W",    "type": "DeviceModel",    "category": [        "空調",        "温度センサ"    ],    "manufacturerName": "日立",    "modelName": "RAS-DM28KE8",    "brandName": "しろくまくん",    "color": "白" }

---