報告 (Report)

説明

2023-04-04/2024-09-20

 事業者から自治体に提出するレポートに対応するデータモデルです。このデータモデルの名称はReportですが、説明文などで用いる呼称は「報告」です。

データモデル

2023-05-10/2024-09-27

 下表の「呼称」の列は、説明文やケーススタディで用いる項目の名称です。仕様としては意味を持たない情報ですが、本来の項目名であるAttribute nameは日本語話者にとっては感覚的に理解しにくいため、便宜上定義してあります。説明の①の列は不具合に対する報告です。②と③は12条点検の報告であり、②は建物全体の報告、③は個々の建築物(棟)の報告です。複数の建築物から構成される建物の場合に棟毎に登録できる様に、②と③を区別して記述しています。

 青字部分は現在レビュー中です。

Data Model説明
Attribute name呼称回数type補足
id報告ID1::1TextNGSI-LDの仕様に合わせ、次の形式の識別子とする。”urn:ngsi-ld:Report:”<一意となる文字列>。事業者が交代しても一意となる様な工夫が必要です。必須
type1::1Text必ず”Report”の文字列でなくてはならない必須
timestamp報告日1::1Date報告日
category報告書名称1::1Text報告書の名称を記述します。報告書の名称は自治体や事業者により異なる可能性がありますが、法令で決められている名称は法令の通りに記述します。用語の定義はReportCategoryを参照
dateOperation実施日0::1Date報告する点検等の実施日
operationName作業名0::1Text「報告書名称」の補足情報です。例えば、報告書名称を”不具合報告”とし作業名を”巡回点検”とするなど
refSubmitter報告者0::1Relationship報告者の法人に対するリンク。特定行政庁や自治体等に提出する公的な報告書など作成する場合は、その報告書の届出者/報告者の所属法人名や連絡先を取り出すために用います
inspector調査者0::nArray12条点検の報告における、調査者や検査者の法人に対するリンクを登録します。但し、本項目は統計分析やオープンデータに適さない可能性がありますので、蓄積するデータの目的に従って登録の要否を判断する必要があります。
reportParent親報告0::1Relationship12条点検の報告において、建物が複数の建築物(棟)から構成される場合、建築物の報告から建物の報告に対するリンクを登録します
refTarget建物ID0::1Relationship定期検査や不具合報告などにおいて、対象建物または建築物(棟)へのリンク。
refFacility0::1Relationship不具合の報告などにおいて、報告対象の施設へのリンクです。施設管理の管理単位が施設の場合に用います。
refComplaint案件ID0::nArray
(Relationship)
本報告が関係する「案件」へのリンク。複数の案件がある場合はリストで登録する。検査の結果不具合が見つからなかった場合にも本データモデルを登録するかどうかは運用に依存するが、登録する場合は本Attributeを設定しないか、不具合現象(phenomenonのcategory)に”良好”を登録した案件 (Complaint) をリンクする。「報告」と「案件」の関係の例については、包括施設管理における使い方(6/7)も参考にしてください。
equipment対象設備0::1Array12条点検における検査対象の建築設備をリスト形式で登録します。登録する用語は”換気設備”、”排煙設備”、”非常用の照明装置”、および”給水設備及び排水設備”です
damageControl簡易修繕0::1Text簡易修繕の内容。列挙型項目。用語の定義はDamageControlを参照。尚、簡易修繕を行わなかった場合はこの項目には登録しません
pictures写真0::nArray写真を登録します
no写真番号0::1Text写真に識別が必要な場合に識別の情報を登録する。例えば写真番号
url写真url1::1URL写真の登録場所
remarks写真補足0::1Text写真への補足
request要望0::1Text職員などからの要望事項です。修繕の期限などの条件がある場合は記述します。
remarks備考0::1Text備考
opinion所見0::1Text担当者の所見
documentドキュメント1::nArraypdf等になった、報告書の格納情報。複数の書類を登録します。12条点検の報告書を登録する場合、建築物(棟)単位の報告書は個々の建築物に対応する「報告(Report)」に登録する
title報告書タイトル1::1Text電子化したドキュメントのタイトル
fileName報告書ファイル名0::1Text電子化したドキュメントの格納ファイル名。ドキュメントはファイルサーバなどに格納されている場合に次の項目と共に使用します
filePath報告書パス0::1Text電子化したドキュメントの格納フォルダのパス
url報告書url0::1URLURL電子化したドキュメントがWebサーバなどURLでアクセスできる場合に前項の代わりに使用します

技術情報

2023-04-04

定義名Report
継承元データモデル包括施設管理の受託事業者の提案による
参照データモデルなし
URIhttps://ppp-database.org/spec/datamodel/Report/
JSON SchemaこのJSON SchemaはNormalized形式に対応しています。必要に応じて、形式チェックの項目を追加するなどして利用する事ができます。本JSON Schemaはデータ仕様の変更や、JSON schemaに対する要望により、予告なく更新されます
補足事業者から自治体に提出するレポートに対応するデータモデルです。レポートに記載された情報を登録するデータモデルは見つかっていません。そこで、実際に事業者が使っているレポートなどから項目を拾いました。

更新情報

■コメントおよび更新の一覧

コメント日コメント内容対応更新日
2023-05-10・写真を複数登録する際に、識別するための番号を登録したい・”pictures”に”no”を追加する。但し、属性はTextとし、数字以外も登録かのうとする2023-05-13
2023-06-27千葉県佐倉市
・12条点検のレポートの仕様も共通化して欲しい
以下の改善を行いました。
・12条点検の報告書の項目も登録可能とする
・12条点検の報告書に対応する「報告(Report)」から検出した不具合の「案件(Complaint)」を辿れる様にする
本データモデルについては、Attributeとしてinspector, reportParent, equipmentを追加しました
2023-11-13
2024-01-30以下のコメントを頂きました
・点検の結果、正常であった場合の証跡を残すため、不具合が無い旨の用語を欲しい
案件(Complaint)のAttributeであるphenomenonに登録する用語である
Phenomenonに”良好”を追加したことに伴い、本データモデルのrefComplaintに説明を追記した
2024-01-30
2024-09-20事務局
・各種説明やケーススタディに項目名を記載する際、Attribute nameでは理解しにくい
日本語話者向けに「呼称」の列を追加しました。仕様としては意味はなく、説明文やケーススタディの理解が容易になる様に付けた便宜上の名称です2024-09-20
2024-09-27事務局
・「報告書名称」とは別に、巡回点検などの不具合検出時の作業を区別する名称を登録したいとの要望があった
・期限などの条件があった場合の登録方法が明確ではない
「作業名」の項目を追加します。
・「要望」に期限などの条件に関する記述を追加します
青字の部分は現在レビュー中です。
2024-09-27