機種 (DeviceModel)

説明

2023-04-15

　　設備の機種などの設備の共通情報を登録するためのデータモデルです。①は、公共施設の施設管理において登録が想定されるAttributeです。

データモデル

2023-04-15

Data Model			説明
Attribute name	回数	type	補足	①
id	1::1	Text	NGSI-LDの仕様に合わせ、次の形式の識別子とする。”urn:ngsi-ld:DeviceModel:”<一意となる文字列>。一意となる文字列は、例えば国名コードとメーカの法人番号の後にハイフンを挟んで型番を並べたもの。	必須
type	1::1	Text	必ず”DeviceModel”の文字列でなくてはならない	必須
alternateName	0::1	Text	通称を入れる (もしあれば)
annotations	0::n	Array	設備に関する注釈
brandName	1::1	Text	機器のブランド名を設定する。例えば”しろくまくん”。	必須
category	1::n	Text	設備の種別。列挙型項目。定義はBuildingComponentを参照	必須
color	0::1	Text	機器の色を設定する。例えば”白”
controlledProperty	0::n	Text	検知・制御・計測する対象。列挙型項目。定義はControlledProperty。例えば”水位”、”温度”など。
dataProvider	0::1	Text	このEntityに対するプロバイダを特定する文字列。今回のユースケースではプロバイダは存在しません。
description	0::1	Text	機種情報として公開可能な詳細情報
deviceClass	0::1	Text	制約条件付きデバイス(constrained device)のクラスです。RFC7228で規定。制約条件付きデバイスではない場合、意味を持ちません
documentation	0::1	URI	デバイスのドキュメントに対するリンク
energyLimitationClass	0::1	Text	これも、デバイスのクラスです。RFC7228で規定されています
function	0::n	Array	デバイスの機能です。SAREFで規定されており、levelControl, sensing, onOff, openClose, metering, eventNotificationなどがある
image	0::1	URL	デバイスの写真等のurlです。
manufacturerName	1::1	Text	メーカ名を設定する。例えば”日立製作所”	必須
modelName	1::1	Text	機器のモデル名を設定する。例えば”RAS-DM28KE8″	必須
name	0::1	Text	機種に個別に名称が付いているときに、その名称を設定する
owner	0::n	Array	所有者のidです
seeAlso	0::n	Array	追加情報のURIを格納します。つまり、idやurlが入ります。
serviceLife	0::1	Number	耐用年数です。会計上、税務上の耐用年数ではなく、実際に利用可能な年数です	〇
source	0::1	URL	データ提供者のurlです
supportedProtocol	0::n	Array	サポートしているプロトコルです
supportedUnits	0::n	Array	サポートしている測定値の精度です

技術情報

2023-04-15

定義名	DeviceModel
継承元データモデル	Smart Data Models/DeviceModel
参照データモデル	なし
URI	https://ppp-database/spec/datamodel/DeviceModel
JSON Schema	このJSON SchemaはNormalized形式に対応しています。必要に応じて、形式チェックの項目を追加するなどして利用する事ができます。本JSON Schemaはデータ仕様の変更や、JSON schemaに対する要望により、予告なく更新されます
補足	設備の機種などの機種間の共通情報です。Smart Data Modelとの相違点は次の通りです。controlledPropertyの列挙型メンバの定義が日本語になっている点、controlledPropertyが省略可能となっている点、deviceCategoryとmacAddressを削除した点です