Pages in this section

CSV file formats

Applies to: PropScore · Last updated

The columns and accepted values of the property CSV file and the energy data CSV file, the checks run on import, and what the screen shows.

Common format

Item Detail
Encoding UTF-8. UTF-8 with a BOM is also read.
First row The column-name row. Column names must match the names in the tables on this page exactly.
Column order Does not matter.
A required column is missing Nothing in the file is imported, and 「行 0: Missing required columns: {列名}」 is shown.
Row numbers The 「行」 shown is the row number in the file, counting the column-name row as row 1.
File type Choose a file with the extension .csv.

The import result is shown as 「{件数}件インポート完了」 with the numbers of errors, warnings and anomalies. The first 3 errors are shown, and 「他{件数}件のエラーを表示」 shows the rest.

Property CSV file

Import it from 「CSVインポート」 on 「物件一覧」; the properties are added to the portfolio selected in the sidebar.

Column Required Value
物件名 Required Text. A row is not imported when a property with the same name already exists in the organization.
住所 Required Text. Used to determine the region of the electricity emission factor.
用途 Required office, retail, residential, logistics, hotel, or オフィス, 商業, 住居, 物流, ホテル.
構造 Required RC, SRC, S, W, or 鉄筋コンクリート, 鉄骨鉄筋コンクリート, 鉄骨, 木造.
延床面積(m2) Required A number.
竣工年 Required An integer.
地上階数 Required An integer.
取得日(YYYY-MM-DD) Required A date in the form YYYY-MM-DD.
地下階数 Optional An integer. A blank or a value that cannot be read as an integer becomes 0.
テナント数 Optional An integer.
専有面積(m2) Optional A number.
共用面積(m2) Optional A number.

The number of rows skipped because of a duplicate name is not shown on screen.

Property CSV errors

What the screen shows (after 「行 {行}: 」) Cause
「物件名 is empty」 物件名 is blank.
「住所 is empty」 住所 is blank.
「Invalid 用途: {値}. Valid: {受け付ける値}」 The 用途 value is not accepted.
「Invalid 構造: {値}. Valid: {受け付ける値}」 The 構造 value is not accepted.
「Invalid 延床面積(m2)」 延床面積(m2) is not a number.
「Invalid 竣工年」 竣工年 is not a number.
「Invalid 地上階数」 地上階数 is not a number.
「Invalid 取得日: {値}」 取得日(YYYY-MM-DD) cannot be read as a date.
「CSV parse error: {内容}」 The file cannot be read as CSV.

Energy data CSV file

Import it from 「CSVインポート」 on a property's 「エネルギーデータ」 tab. Each row goes to the property in the organization whose name matches 物件名, not to the property you have open. 「テンプレートDL」 saves energy_data_template.csv, which holds the names of 10 columns (all except 再エネ発電(kWh), 再エネ購入(kWh), 再利用水(m3) and 雨水(m3)) and 2 example rows.

Column Required Value
物件名 Required Text that exactly matches the name of a property registered in the organization.
対象月(YYYY-MM) Required A month in the form YYYY-MM.
電力(kWh) Required A number from 0 to 999999.
ガス(m3) Optional A number from 0 to 99999.
水道(m3) Optional A number from 0 to 99999.
地域冷暖房(GJ) Optional A number.
所有者負担割合(%) Optional A number from 0 to 100. A blank becomes 100.
按分方法 Optional 面積按分, 実績, 推計, or area_proportional, actual, estimated. Any other value, and a blank, is treated as 面積按分.
再エネ発電(kWh) Optional A number.
再エネ購入(kWh) Optional A number.
再利用水(m3) Optional A number.
雨水(m3) Optional A number.
データ取得方法 Optional 実測, 請求期間按分, 前期実績流用, 床面積按分, 不明, or an English value such as measured. A row with any other value is not imported. A blank takes the value chosen in 「このファイルのデータ源」.
推計理由 Optional Text.

In the optional number columns, a value that cannot be read as a number is treated as blank. When the same month of the same property is already registered, its values are replaced with the file's values. For a file with more than 500 data rows, 「0件インポート完了」 is shown without waiting for the import to finish, and the import continues outside the screen.

For how データ取得方法 and 推計理由 are handled, see Data provenance and the estimated ratio.

Energy data CSV checks

Kind Condition What the screen shows
Error (the row is not imported) A value in 電力(kWh), ガス(m3), 水道(m3) or 所有者負担割合(%) is out of range. 「{列名}の値({値})が許容範囲({下限}〜{上限})を超えています」
Error (the row is not imported) 物件名 is blank. 「物件名 is empty」
Error (the row is not imported) The organization has no property named in 物件名. 「Property not found: {物件名}」
Error (the row is not imported) 対象月(YYYY-MM) cannot be read as a month. 「Invalid month format: {値}」
Error (the row is not imported) 電力(kWh) is not a number. 「Invalid electricity value」
Error (the row is not imported) The データ取得方法 value is not accepted. 「データ取得方法 '{値}' は認識できません。次のいずれかを指定してください: 実測, 請求期間按分, 前期実績流用, 床面積按分, 不明」
Warning (imported) 再エネ発電(kWh) plus 再エネ購入(kWh) is more than 1.5 times 電力(kWh). 「再エネ合計({値}kWh)が電力({値}kWh)の1.5倍を超えています」
Warning (imported) 再利用水(m3) plus 雨水(m3) is more than 2.0 times 水道(m3). 「再利用水+雨水合計({値}m3)が水道({値}m3)の2.0倍を超えています」
Warning (imported) The file has more than one row for the same property and month. 「{物件名}の{月}が行{行}と重複しています」
Warning (imported) Together with the registered months, a month in between is missing. 「{物件名}に月の欠落があります: {月}→{月}」
Anomaly (imported) 電力(kWh), ガス(m3) or 水道(m3) rises or falls by more than 50% from the registered value of the previous month. 「{物件名}の{列名}が前月比{割合}%増加しています」 or 「{物件名}の{列名}が前月比{割合}%減少しています」

Errors are shown in the form 「行 {行}: {内容}」, and anomalies in the form 「行 {行} [{項目}]: {内容}」.