法人 (Organization)

説明

2023-04-03/2023-08-02

 自治体と民間団体共通の法人を表現するデータモデルです。①は公共施設管理において対象となる自治体を表現する場合の登録の要否、②は公共施設管理において関係する民間企業を表現する場合の登録の要否です。③は12条点検の報告書の内容を登録する場合の登録の要否です。但し、12条点検の報告書は各種点検をまとめたサマリであり、不具合情報は12条点検の報告書を電子化するか否かに関わらず、「案件(Complaint)」に登録されますので、実際に登録するかどうかは、事業者と自治体との協議に因ります。

データモデル

2023-04-03/2024-01-14

Data Model説明
Attribute name回数type補足
id1::1TextNGSI-LDの仕様に合わせ、次の形式の識別子とする。”urn:ngsi-ld:Organization:”<国名コード><法人番号>。国名コードは日本の場合は”JP”です。日本の法人番号を取得していない法人もあり得るため、国名コードを付けています必須
type1::1Text必ず”Organization”の文字列でなくてはならない必須
identificationGroup1::nIdentificationGroupIdentificationGroupは共通パーツを参照。法人番号の登録は必須。これは、GIFのコア・データモデルで必須と指定されているためです。自治体の場合は自治体コードも必須。政令市の場合、区のコードではなく法人である市のコードを登録します。この点、住所の情報であるPostalAddressとは異なります必須
name1::1Text法人の名称を設定する必須
containedInPlace0::1Text法人が基礎自治体、または東京都の特別区の場合は必須とし、都道府県名を記載する
nameKana1::1Text法人の名称のカナ表記を設定する必須
nameEn0::1Text法人の名称の英語表記を設定する
organizationTypePosition0::1Text組織種別(株式会社等)を法人名の前後のどちらに付与するかを記載。
category1::1Text列挙型項目。”市区町村”、”都道府県”、”株式会社”などの区別を登録する。値はOrganizationCategoryを参照のこと。必須
alternateName0::nArray自治体の場合、”塩釜市”や”廣島市”など。略称のアルファベットも登録する
status0::1Text活動状況(倒産、破産、休眠、休業、廃業等)を記載。
description0::1Textこの組織に関する説明を記載
url0::1URL法人が開設しているWebサイトURLを記載。
numberOfRegularEmployees0::1Integer正社員数と従業員数を記載。この項目は変動する数値の項目であり、実装するのであれば誰が更新し続けるのかなどのルール策定が必要
numberOfEmployees0::1Integer
establishedDate0::1Date設立日を記載
yearOfEstablishment0::1Text創業年を西暦YYYY形式で記載
businessCategory0::nArray事業種目(日本標準産業分類)を記載
fiscalYearStartDay0::1Text年度開始日を”MM-DD”形式で記載。省略時には”04-01″を指定したと解釈する
capital0::1Integer資本金を記載。この項目が必要な場合は、更新の責任をだれが負うのかなどの運用と、通貨の属性の必要性について検討が必要
registeredAddress1::1PostalAddress法人の登記上の住所
contactPoint1::nContactPoint連絡先情報は法人と部門の両方にある。本項目は代表電話などを期待必須
refFacility1::1Relationship民間企業の本社や自治体の本庁舎が実際に存在する施設へのリンク必須
architectOfficeRegNumber0::1Text12条点検において、調査者や検査者の勤務先が建築士事務所のときに事務所登録番号を”○○知事登録第○○号”の形式で登録します。但し、本項目は統計分析やオープンデータに適さない可能性がありますので、蓄積するデータの目的に従って登録の要否を判断する必要があります。

技術情報

データモデル名Organization
継承元データモデルコア・データモデル/法人
参照データモデルschema.org/Organizationschema.org/AdministrativeArea
URIhttps://ppp-database/spec/datamodel/Organization
JSON SchemaこのJSON SchemaはNormalized形式に対応しています。必要に応じて、形式チェックの項目を追加するなどして利用する事ができます。本JSON Schemaはデータ仕様の変更や、JSON schemaに対する要望により、予告なく更新されます
補足公共施設と民間施設両方に対応したいとのニーズにより、自治体と民間企業共通のデータモデルとしました。

■Entityの例

 広島県呉市を題材にしていますが、実際と異なる情報の可能性があります。下記リンクからjsonファイルをダウンロードできます。そのままクリックすると、環境によっては日本語が文字化けして表示されます。

Normalized形式の例

{
    "id": "urn:ngsi-ld:Organization:JP9000020342025",
    "type": "Organization",
    "identificationGroup": {
        "type": "IdentificationGroup",
        "value": [
            {
                "identificationType": "法人番号",
                "identification": "9000020342025"
            },
            {
                "identificationType": "自治体コード",
                "identification": "342025"
            }
        ]
    },
    "name": {
        "type": "Text",
        "value": "呉市"
    },
    "containedInPlace": {
        "type": "Text",
        "value": "広島県"
    },
    "nameKana": {
        "type": "Text",
        "value": "クレシ"
    },
    "nameEn": {
        "type": "Text",
        "value": "Kure City"
    },
    "category": {
        "type": "Text",
        "value": "市区町村"
    },
    "description": {
        "type": "Text",
        "value": "大和のふるさと呉市です"
    },
    "url": {
        "type": "URL",
        "value": "https://www.city.kure.lg.jp/"
    },
    "businessCategory": {
        "type": "Array",
        "value": [
            "市町村機関"
        ]
    },
    "registeredAddress": {
        "type": "PostalAddress",
        "value": {
            "addressRegion": "広島県",
            "addressLocality": "呉市",
            "streetAddress": "中央4-1-6"
        }
    },
    "contactPoint": {
        "type": "ContactPoint",
        "value": [
            {
                "contactType": "総合",
                "telephone": "0823-25-3100"
            }
        ]
    },
    "refFaciliry": {
        "type": "Relationship",
        "value": "urn:ngsi-ld:Facility:JP9000020342025-00000001"
    }
}

keyValues形式の例

        {
            "id": "urn:ngsi-ld:Organization:JP9000020342025",
            "type": "Organization",
            "identificationGroup": [
                {
                    "identificationType": "法人番号",
                    "identification": "9000020342025"
                },
                {
                    "identificationType": "自治体コード",
                    "identification": "342025"
                }
            ],
            "name": "呉市",
            "containedInPlace": "広島県",
            "nameKana": "クレシ",
            "nameEn": "Kure City",
            "category": "市区町村",
            "description": "大和のふるさと呉市です",
            "url": "https://www.city.kure.lg.jp/",
            "businessCategory": ["市町村機関"],
            "registeredAddress": {
                "addressRegion": "広島県",
                "addressLocality": "呉市",
                "streetAddress": "中央4-1-6"
            },
            "contactPoint": [
                {
                    "contactType": "総合",
                    "telephone": "0823-25-3100"
                }
            ],
            "refFaciliry": "urn:ngsi-ld:Facility:JP9000020342025-00000001"
        }

更新情報

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

コメント日コメント内容対応更新日
2023-05-24事務局
・idの文字列に法人番号があるが、日本の法人番号を取得してない法人もあり得る
・法人番号の前に国名コード(“JP”)を付加します2023-05-24
2023-06-27佐倉市
・昔の12条点検の報告書を読み返しても、実態を把握しにくい
以下の仕様拡張を行いました。
・12条点検の報告書の項目も登録可能とする
・12条点検の報告書に対応する「報告(Report)」から検出した不具合の「案件(Complaint)」を辿れる様にする
本データモデルでは、新たなAttributeとして、architectOfficeRegNumberを追加しました。
2024-11-13
2023-11-19事務局
・アドレスベースレジストリに合わせてコードによる住所表現も可能とする必要がある
以下の注意書きを補足欄に追加しました。
・identificationGroupに登録する自治体コードは、政令市の場合も法人である市のコードを登録する
2024-01-14
2024-01-09事務局
・コアデータモデルと属性が相違している項目がある
使うべきではないとコメントしている項目ですが、numberOfRegularEmployeesとnumberOfEmployeesのtypeがTextになっていたので、Integerに修正しました。尚、NGSI v2ではAttributeのtypeはメモでしかなく、実際に記述した値の形式が優先されますので、処理上の影響はありません。2024-01-09