BldgEnrgyIntensity

Represents the average energy intensity by fuel type across a set of buildings. You can derive this data from published sources. Alternatively, you can do so by using energy use records as the data source and then setting up a window of time with some characteristics of the building size and type. This object is available in API version 54.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

AnnualEnergyIntensityInKwhM2

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The average energy consumption intensity for a year in kWh per square meter. The fuel-specific energy consumption intensities are stored in the associated building energy intensity value records.

AnnualEnergyIntensityInKwhSqft

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The average energy consumption intensity for a year in kWh per square foot. The fuel-specific energy consumption intensities are stored in the associated building energy intensity value records.

AreSysGenEnrgyUseRecIncluded

Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: “Indicates whether to include records created when filling data gaps (true) or not (false). Note: Including these records could result in inaccurate calculations.”
Default value: false

AveragePowerUsageEffectiveness

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description:

AveragingWindowEndDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date until when the energy use records are considered to calculate the building energy intensity.

AveragingWindowStartDate

Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date from when the energy use records are considered to calculate the building energy intensity.

BldgEnergyIntensityIdentifier

Type: textarea
Properties: Create, Nillable, Update
Description: The unique external identifier for the building energy intensity record.

BuildingAssetType

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The stationary asset type of the asset for which the building energy intensity is calculated.

BuildingSize

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description:

BuildingSizeCategoryId

Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The building size category record for the stationary asset. You can add appropriate building size ranges by creating or editing building size category records. This is a relationship field.
Relationship Name: BuildingSizeCategory
Relationship Type: Lookup
Refers To: BldgSizeCategory

BusinessRegion

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The business region. If you select the business region, you can’t select the country and state.

Country

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The name of the country. You can enter a country only when you don’t select the business region.

EmissionFactorDataSource

Type: textarea
Properties: Create, Nillable, Update
Description: The source of the emissions factor reference data.

EmissionFactorUpdateYear

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The year when the emissions factor reference data was last updated by a publishing authority.

ExternalIdentifier

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The external identifier for the emissions factor.

IsRecordLocked

Type: boolean
Properties: Defaulted on create, Filter, Group, Sort
Description: Indicates that the record is locked for editing.
Default value: false

LastCalculatedDate

Type: dateTime
Properties: Create, Filter, Nillable, Sort, Update
Description: The date and time when the record was most recently calculated.

LastReferencedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp for when the current user last viewed a record related to this record.

LastViewedDate

Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed.

MaximumBuildingSizeInM2

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The maximum size of the building in square meters. This value is used to calculate building energy intensity.

MaximumBuildingSizeInSqft

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The maximum size of the building in square feet. This value is used to calculate building energy intensity.

MinimumBuildingSizeInM2

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The minimum size of the building in square meters. This value is used to calculate building energy intensity.

MinimumBuildingSizeInSqft

Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The minimum size of the building in square meters. This value is used to calculate building energy intensity.

Name

Type: string
Properties: Create, Filter, Group, idLookup, Sort, Update
Description: The name of the record.

OwnerId

Type: reference
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: The ID of the user who owns this record. This is a polymorphic relationship field.
Relationship Name: Owner
Relationship Type: Lookup
Refers To: Group, User

ReferenceDataLoadLogId

Type: reference
Properties: Filter, Group, Nillable, Sort
Description: The reference data load log record that’s associated with the emissions factor. This field is a relationship field.
Relationship Name: ReferenceDataLoadLog
Relationship Type: Lookup
Refers To: ReferenceDataLoadLog

RegionalDivision

Type: picklist
Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The regional division for this building energy intensity record.
Possible values:
- EastNorthCentral—East North Central
- EastSouthCentral—East South Central
- MiddleAtlantic—Middle Atlantic
- Mountain
- NewEngland—New England
- Pacific
- SouthAtlantic—South Atlantic
- WestNorthCentral—West North Central
- WestSouthCentral—West South Central

ShouldLockDtastUpdtForRec

Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: Indicates whether the emissions factor record can be locked from dataset updates.
Default value: false

State

Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The name of the state. You can enter a state only when you don’t select the business region and don’t enter multiple countries.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

BldgEnrgyIntensityFeed: Feed tracking is available for the object.
BldgEnrgyIntensityHistory: History is available for tracked fields of the object.
BldgEnrgyIntensityShare: Sharing is available for the object.