説明
2023-04-03/2024-09-20
法人 (Organization) 内の部門や機能を表現するデータモデルです。このデータモデルの名称はDepartmentですが、説明文などで用いる呼称は「部門」です。機能とは、例えば「コールセンター」や「お客様相談係」など、必ずしも部門と合致していない連絡先などを指しています。施設管理を行う場合、少なくとも施設の所管課となっている部門を登録する必要があります。
下表において、①は公共施設管理において自治体を表現する場合の登録の要否、②は公共施設管理において民間企業を表現する場合の登録の要否です。
データモデル
2023-04-03/2024-09-27
下表の「呼称」の列は、説明文やケーススタディで用いる項目の名称です。仕様としては意味を持たない情報ですが、本来の項目名であるAttribute nameは日本語話者にとっては感覚的に理解しにくいため、便宜上定義してあります。
| Data Model | 説明 | |||||
| 回数 | type | 補足 | ① | ② | ||
| id | 部門ID | 1::1 | Text | NGSI-LDの仕様に合わせ、次の形式の識別子とする。”urn:ngsi-ld:Department:”<国名コード><法人番号>”-“<部門コード>。法人番号は13桁の数字からなる文字列。部門コードは組織の中で一意となる文字列。国名コードは日本の場合は”JP”です。日本の法人番号を取得していない法人もあり得るため、国名コードを付けています | 必須 | |
| type | 1::1 | Text | 必ず”Department”の文字列でなくてはならない | 必須 | ||
| name | 部門名 | 1::1 | Text | 事業所や部門の名称を設定する。部門の名称はこの項目だけで部門が識別できるようにします。例えば、”○○局○○部○○課”などです。単に”第一課”などとすると、他の部局の第一課と区別がつかなくなります | 必須 | |
| refFacility | 施設ID | 1::1 | Relationship | 部門が設置されている(入居している)施設へのリンクです。部門が設置されている施設 (Facility) のidを登録します。このリンクから幾つかのEntityを辿ることにより、住所、ビル名、フロアサイズなどの各種情報を求める事ができます。このリンクを経由して法人の住所情報が得られます。継承元のコア・データモデルに倣い必須としています。尚、業務上住所情報が不要な部門を登録する場合は必ずしも登録は必須ではありません。 | 必須 | |
| departmentOf | 法人ID | 1::1 | Relationship | 所属する法人のへのリンクです。所属する法人 (Organization) のidを登録します。このリンクを辿ることで、法人名などの情報を得る事が出来ます | 必須 | |
| contactPoint | 連絡先 | 1::n | ContactPoint | 連絡先情報。継承元のコア・データモデルで必須となっていますが、電話番号が必須なのかメールなのか等の指定はありません。共通データ仕様でもコア・データモデルの通り必須してありますが、何を登録するのかしないのかは状況に合わせて個々に決める必要があります。項目の詳細は共通パーツを参照してください。例えば公共施設管理の所管部門の場合は、電話番号の登録を期待しているなどです | 必須 | |
技術情報
| 定義名 | Department |
| コア・データモデル/事業所 | |
| 参照データモデル | schema.org/Organization |
| URI | https://ppp-database.org/spec/datamodel/Department/ |
| JSON Schema | このJSON SchemaはNormalized形式に対応しています。必要に応じて、形式チェックの項目を追加するなどして利用する事ができます。本JSON Schemaはデータ仕様の変更や、JSON schemaに対する要望により、予告なく更新されます |
| 補足 | Organization(法人)同様、自治体と民間企業共通のデータモデルとしました。施設管理を行う場合、少なくとも施設の所管課となっている部門を登録する必要があります。一般に組織は階層化されていますが、本データモデルは階層化されていません。すべての部門が組織(Organization)に直接リンクしています。階層化されていないので、例えば「お客様相談窓口」や「○○係」など、部門になっていない機能も登録可能です。 |
組織との関係
現版のデータモデルは、組織階層を正確に表現する事を目的としておらず、外部から見た連絡先や受付窓口を表現する事を目的としています。例えば、組織横断で作られたプロジェクトや組織を持たない「○○相談係」や「○○コンタクトセンター」なども表現できる事を意図しています。このため、連絡方法を登録するcontactPointを必須項目としています。refFacilityは、郵送先や面談場所などを求めるために設けています。尚、実在する組織を登録する事も可能です。この場合、nameに上位組織の名称も含んだ組織名を登録しておくなどの配慮が必要です。
将来、組織階層を表現するデータモデルに拡張する場合、上位階層とのリンクを追加するなどの技術的な対応が必要です。また、公開範囲などの再検討も必要となります。
Entityの例
広島県呉市を題材にしていますが、実際と異なる情報の可能性があります。下記リンクからjsonファイルをダウンロードできます。そのままクリックすると、環境によっては日本語が文字化けして表示されます。
{
"id": "urn:ngsi-ld:Department:JP9000020342025-0402004",
"type": "Department",
"name": {
"type": "Text",
"value": "市民部吉浦まちづくりセンター"
},
"departmentOf": {
"type": "Relationship",
"value": "urn:ngsi-ld:Organization:JP9000020342025"
},
"refFacility": {
"type": "Relationship",
"value": "urn:ngsi-ld:Facility:JP9000020342025-01234567"
},
"contactPoint": {
"type": "ContactPoint",
"value": [
{
"availableLanguage": "ja",
"contactType": "総合",
"telephone": "0823-31-0010"
}
]
}
}{
"id": "urn:ngsi-ld:Department:JP9000020342025-0402004",
"type": "Department",
"name": "市民部吉浦まちづくりセンター",
"departmentOf": "urn:ngsi-ld:Organization:JP9000020342025",
"refFacility": "urn:ngsi-ld:Facility:JP9000020342025-01234567",
"contactPoint": [
{
"availableLanguage": "ja",
"contactType": "総合",
"telephone": "0823-31-0010"
}
]
}更新情報
■コメントおよび更新の一覧
| コメント日 | コメント内容 | 対応 | 更新日 |
|---|---|---|---|
| 事務局 ・idの文字列に法人番号があるが、日本の法人番号を取得してない法人もあり得る | ・法人番号の前に国名コード(“JP”)を付加します | ||
| 2024-09-02 | 事務局 ・JSON SchemaのcontactPointの形式がArrayになっていない | ・Arrayになる様に修正しました | 2024-09-02 |
| 2024-09-20 | 事務局 ・各種説明やケーススタディに項目名を記載する際、Attribute nameでは理解しにくい | 日本語話者向けに「呼称」の列を追加しました。仕様としては意味はなく、説明文やケーススタディの理解が容易になる様に付けた便宜上の名称です | 2024-09-20 |
| 2024-09-27 | 事務局 修繕履歴の引継ぎの検討過程で以下の課題が指摘された ・部門が入居している施設の情報が必須となっているが、業務や部門の位置づけによっては必須てある必要はない | 「施設ID(refFacilty)」の説明にこの項目の位置づけと必須ではない場合について追記する | 2024-09-27 |