COBIE

4.3 DATA FIELDS

Each data table contains several data fields, and these data fields are pre-defined as part of the COBie standard.

Naming
Data field names utilize the following naming conventions:

  1. Names do not contain any spaces.
  2. The first letter is always capitalized, and all subsequent letters are lower case.
  3. If more than one word is used for the data field name, then the words are placed together without a space in between and the first letter of each word capitalized (for example, “PartOf” or “EndDate”).
  4. When a data field references a different data field, either on the same data table or a different one, then the name is a combination of the data table name and the data field on that data table, separated by a period (for example, the “Component.Name” data field on the “System” data table). This is how all the data fields on the “PickList” data table are formatted, identifying the specific data fields and the data table on which they reside.

Organization
To better organize data fields on data tables, they are grouped together based on their purpose. There are six groupings:

  • Identification – data fields used to help identify an asset.
  • Classification – data fields used to better classify an asset.
  • Location – data fields related to an asset’s location.
  • External – data fields populated automatically by external software.
  • Required – additional data fields that are always required for each COBie deliverable.
  • Optional – additional data fields that are only required if specified in the contract.

The data fields on each data table are then sorted based on these groupings (in the order shown above). When more than one data field exists in a data table with the same grouping, then the data fields are sorted alphabetically. The only exception is the “Name” data field, as that is always the first data field on the data table.

Nomenclature
Throughout this standard there are references to specific data fields on specific data tables. To make it easier to identify these, the following nomenclature is used: DataTable.DataField. Often, this nomenclature will be preceded with “COBie.” For example, the “Name” data field on the “Type” data table would be represented as:

     COBie.Type.Name

Default Value
Data fields should not be left blank for a COBie deliverable. Instead, a value of “n/a” should be used (without the quotes) for text fields and “0” for real number fields.

Pre-Determined Values
Some data fields in COBie must be populated with values that are already determined. In other words, users must choose a value from a list and not type in their own value (or even an abbreviation of one of the pre-determined list of values). These lists of pre-determined values are known as PickLists and there is a data table in COBie to store them.

Some of these PickLists are constant for all COBie deliverables (such as COBie.Level.Category and COBie.Type.AssetType), while others will vary based on regional or owner preferences (such as using OmniClass Table 34 values for the COBie.Company.Category data field in the U.S. versus Uniclass Table Ro values for the same data field in the U.K.).

Custom Data Fields
It is not permitted to create custom data fields on data tables. Instead, utilize the COBie.Attributes data table to add additional data fields to your COBie deliverables.

The reason is because, as a standard schema, asset management systems can have pre-built data field mappings to allow for the import of data from a standard COBie deliverable without customization. If data fields are added to data tables, then asset management systems will not be able to recognize and import those data fields without first customizing the import tool.

Comma Separated Values
Some fields require a comma separated list of values. These include:

  • COBie.Zone.Space.Name
  • COBie.Component.Space.SecondaryName
  • COBie.System.Component.Name
  • COBie.Job.Priors
  • COBie.Job.Resource.Name

Data Types
Each data field can be of a certain type of data. Included in the following pages is an indicator on the type of data for that data field, using the following legend:

  • T     Text as a string of characters that can include letters, numbers, and punctuation. Unless otherwise noted:
    • The total field length should be limited to 255 characters or less.
    • Use only ASCII characters (0-9, A-Z, a-z, space “ “, dash “-“, and underscore “_”).
    • Should not include non-printing characters.
    • Name fields should not include spaces due to inconsistency of parsing software.
  • R     Real Number
  • D     Date (following the ISO 8601 standard)
  • U     URL (Uniform Resource Locator or web address)

Details
The following pages details each of the data fields that are part of the COBie standard. This information includes the name, description, examples, and details regarding the organization and status.

INSTRUCTION

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
TitleThe title of this deliverable standard, which is always COBie.Tn/aRequiredCOBie
VersionThe version of the COBie standard you are submitting.Tn/aRequired3
ReleaseThe release of the COBie version.Tn/aRequired1
StatusThe version IFC with which this COBie deliverable aligns.Tn/aRequiredIFC4
RegionThe language in which this COBie deliverable is written…
Format is ISO 639-1 two letter language code.
Tn/aRequireden-US
en-GB
ExportDateTimeThe date or date and time this COBie deliverable was generated.
Format is ISO 8601 (YYYY-MM-DD), with the exact time optional.
Dn/aRequired2022-12-31
2022-12-31T13:00:00
MilestoneA description of the project milestone for which this COBie deliverable represents.Tn/aIf Specified50% DD
90% CD
Handover
n/a
OriginatingCompanyThe name of the company that generated this COBie deliverable, referencing a COBie.Company.Name value.Tn/aRequired (Reference)ABC_Corp
AreaUnitThe units for area measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Area value.Tn/aRequired (Reference)Square Feet
Square Meters
CurrencyUnitThe units for currency in this COBie deliverable, referencing a COBIe.PickList.Units.Currency value.Tn/aRequired (Reference)Dollars
Euros
DurationUnitThe units for duration in this COBie deliverable, referencing a COBIe.PickList.Units.Duration value.Tn/aRequired (Reference)Month
Year
LinearUnitThe units for linear measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Linear value.Tn/aRequired (Reference)Feet
Meters
VolumeUnitThe units for volume measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Volume value.Tn/aRequired (Reference)Cubic Feet
Cubic Meters
WeightUnitThe units for area measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Weight value.Tn/aRequired (Reference)Pounds
Kilograms
AreaMeasurementStandardThe associated measurement method used to calculate spatial area measurements applied to all COBie information other than that found in the Attribute data table.Tn/aRequiredBOMA 2017 for Office Buildings: Standard Methods of Measurement (ANSI/BOMA Z65.1—2017)
CoordinateSystemDescriptionA narrative of how the digital models used to generate a COBie deliverable are situated in real-world space to aid in multi-model alignment.
This may include reference to a specific state plane coordinate system, or to a survey pin located on the project site.
Tn/aRequiredWGS 84
GRS80
CoordinateSystemOriginTypically defined by the project team and is often set at a specific location within the building or project site. The origin is usually chosen to align with a key reference point, such as a building corner, survey control point, or other significant feature. Sometimes, this can be defined with Northing, Easting, and elevation values.Tn/aRequiredThe furthest Southeast intersection of the column grid of Building 206
38°54’12.438″N, 77°2’1.0314″W
ClassificationSystem.CompanyThe classification system used for the COBie.Company.Category data field.
This data field aligns with the values held in the COBie.PickList.Company.Category data field.
Tn/aRequiredOmniClass Table 34
Uniclass Table Ro
ClassificationSystem.FacilityThe classification system used for the COBie.Facility.Category data field.
This data field aligns with the values held in the COBie.PickList.Facility.Category data field.
Tn/aRequiredOmniClass Table 11
Uniclass Table En
ClassificationSystem.SpaceTypeThe classification system used for the COBie.SpaceType.Category data field.
This data field aligns with the values held in the COBie.PickList.SpaceType.Category data field.
Tn/aRequiredOmniClass Table 13
Uniclass Table SL
ClassificationSystem.TypeThe classification system used for the COBie.Type.Category data field.
This data field aligns with the values held in the COBie.PickList.Type.Category data field
Tn/aRequiredOmniClass Table 23
Uniclass Table Pr
ClassificationSystem.SystemThe classification system used for the COBie.System.Category data field.
This data field aligns with the values held in the COBie.PickList.System.Category data field
Tn/aRequiredOmniClass Table 21
Uniclass Table EF

COMPANY

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Company.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredABC_Corp
xyzconstruction-com
PhoneThe telephone number for the Company.TIdentificationRequired+1 (202) 289-7800
CategoryThe classification for the Company.
This data field value comes from one of the values in COBie.PickList.Company.Category data field.
TClassificationIf Specified
(Reference)
34-10 11 Owner
Ro_10_20_14 Client
n/a
WebsiteThe website address for the Company.TLocationIf Specifiedwww.abccorp.com
https://www.abccorp.com/project12
n/a
StreetThe street address for the Company.TLocationIf Specified1090 Vermont Avenue NW, Suite 700
n/a
PostalBoxThe postal box address for the Company.TLocationIf SpecifiedP.O. Box 1234
n/a
TownThe city or town address for the Company.TLocationIf SpecifiedWashington
n/a
StateRegionThe state or regional address for the Company.TLocationIf SpecifiedDC
n/a
PostalCodeThe zip, or postal code, address for the Company.TLocationIf Specified20005
n/a
CountryThe country where the Company is located.TLocationIf SpecifiedU.S.A.
U.K.
Germany
n/a
ExtIdentifierThe unique identifier of the identified ExternalObject that would allow COBie data to be matched back to the data from which it was developed in the named ExternalSystem.
This might be a GUID or ElementID.
TExternalExternal4ec17585-c36e-4cc3-8301-61df48a06d7e-000c89be
ExtObjectThe name of the data object within the computer system that holds the data provided in a given record of COBie data. The default values are the associated IFC entities that are mapped (and those that are excluded) when transforming IFC data to a given record of COBie data.TExternalExternalIfcSpace
ExtSystemThe name of the computer system generating the record of COBie data.TExternalExternalAutodesk Revit 2023, Build: 20220429_1500(x64)
ArchiCAD 19 Full (USA) / Build: 5005
CertificationsThe assurance by an independent governing body that a building component, service, or system meets specific requirements.TOptionalIf SpecifiedLicensed electrician
Certified Lead Based Paint Abatement Company
n/a
DepartmentThe name of the department for the Company.TOptionalIf SpecifiedDesign & Construction
Operations
n/a
OrganizationCodeThe organizational code for the Company.TOptionalIf SpecifiedABC
XYZ
n/a

FACILITY

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Facility for this COBie deliverable.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredBuilding204
American_Legion_Bridge_and_Facilities
DescriptionA general text description of the facility, structure, or group of structures as part of this COBie deliverable.TIdentificationIf SpecifiedMedical-Dental Clinic
n/a
TypeThe type of facility, structure, or group of structures as part of this COBie deliverable.
This data field value comes from one of the values in COBie.PickList.Facility.Type data field.
TClassificationRequired
(Reference)
Facility
Project
Site
CategoryThe classification for the Facility.
This data field value comes from one of the values in COBie.PickList.Facility.Category data field.
TClassificationIf Specified (Reference)11-27 25 19 Office-Retail Building
En_20_15_10 Multiple occupation office
n/a
AddressThe city or town address of the project in Facility.TLocationRequired1090 Vermont Avenue NW, Suite 700, Washington, DC 20005
LatitudeThe specific latitude for the facility, structure, or group of structures as part of this COBie deliverable.TLocationRequired38°54’12.438″N
LongitudeThe specific longitude for the facility, structure, or group of structures as part of this COBie deliverable.TLocationRequired77°2’1.0314″W
ElevationThe specific elevation above sea level for the facility, structure, or group of structures as part of this COBie deliverable.TLocationRequired2,432
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem

LEVEL

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Level.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredLevel_1
Mezzanine
DescriptionA general text description of the Level.TIdentificationIf SpecifiedFirst floor
n/a
CategoryThe classification for the Level.
This data field value comes from one of the values in COBie.PickList.Level.Category data field.
TClassificationRequired (Reference)Roof
Floor
Site
PartOfA reference to another COBie.Level.Name item on this data table to represent that this item is a subset of that one.
For example, a facility on a sloped grade that has a single “Level 1” floor per the signage, but that is separated within by a few steps, so the model has two different levels defined to manage the elements.
TClassificationIf Specified (Reference)Mezzanine
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
ElevationThe elevation at the top of the level structure. If allowable values are not specified by contract, the default value is measured as a relative value compared to the facility’s datum.ROptionalIf Specified12
150
0
HeightThe distance between the top of level structure to bottom of structure above.
This is typically applicable to records having the COBie.Level.Category data field value of “Floor”.
ROptionalIf Specified96
150
0

SPACETYPE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Space Type.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredOffice-Medium
DescriptionA general text description of the Space Type.TIdentificationIf SpecifiedOffice of 60SF – 99SF
n/a
CategoryThe classification for the Space Type.
This data field value comes from one of the values in COBie.PickList.SpaceType.Category data field.
TClassificationIf Specified (Reference)13-55 11 Office Spaces
SL_20_15_27 Enclosed offices
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem

SPACE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Space.
This is the primary key for this data table and each value must be unique and must not contain a comma.
This is often the room number in the construction documents.
TIdentificationRequired1A01
Room217
DescriptionA general text description of the Space.
This is often the room name in the construction documents.
TIdentificationRequiredOffice
Communication Room
RoomTagThe signage provided for each Space.
Signage applied to doors, if different, is identified as Attribute records related to each applicable door.
The information here is equivalent to that found in construction signage submittals.
TIdentificationIf Specified6-1A01
n/a
SpaceType.NameA reference to an item from the SpaceType data table (a COBie.SpaceType.Name value).TClassificationRequired (Reference)Office-Medium
Level.NameA reference to an item from the Level data table (a COBie.Level.Name value).TLocationRequired (Reference)Level_1
PartOfA reference to another COBie.Space.Name item on this data table to represent that this item is a subset of that one.
For example, a large open room that has cubicles within. Each cubicle space would be part of the large open space.
TLocationIf Specified (Reference)WorkArea500
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
GrossAreaThe total space area as specified in the design contract and calculated by the identified COBie.Instruction.AreaMeasurementStandard value.ROptionalIf Specified415
0
NetAreaThe usable space area as specified in the design contract and calculated by the identified COBie.Instruction.AreaMeasurementStandard value.ROptionalIf Specified325
0
UsableHeightDistance from top of finished level to bottom of ceiling. If there is no ceiling, then this value must match COBie.Level.Height.ROptionalIf Specified120
0

ZONE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Zone.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredAdministration
Circulation
DescriptionA general text description of the Zone.TIdentificationIf SpecifiedAdministration Department
Circulation Area
n/a
CategoryThe classification for the Zone.
This data field value comes from one of the values in COBie.PickList.Zone.Category data field.
TClassificationIf Specified (Reference)Circulation Zone
Occupancy Zone
n/a
Space.Name

A reference to an item from the Space data table (a COBie.Space.Name value).

This is a comma separated list of values.

TLocationRequired (Reference)1A01, 1A02, 1A03
2E16, 2E24
PartOfA reference to another COBie.Zone.Name item on this data table to represent that this item is a subset of that one.
For example, a large zone for the west wing of a facility could be divided up into smaller zones that are part of the west wing zone.
TLocationIf Specified (Reference)logistics
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem

TYPE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the asset Type.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredBoilerType1
Door_Type_A
DescriptionA general text description of the asset Type.TIdentificationRequiredInduced Heat Draft, Natural Gas Fired, Copper Tube, Hot Water Boiler
Single Panel Flush Solid Core Wood
CategoryThe classification for the asset Type.
This data field value comes from one of the values in COBie.PickList.Type.Category data field.
TClassificationIf Specified (Reference)23-33 11 22 Electric Boilers
Pr_60_60_08_27 Electric Boilers
n/a
AssetTypeThe type of asset.
This data field value comes from one of the values in COBie.PickList.Type.AssetType data field.
TClassificationIf Specified (Reference)Fixed
Moveable
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
ManufacturerThe name of the company that manufactures the asset.
This data field value comes from one of the values in COBie.Company.Name data field.
TRequiredIf Specified (Reference)ABC_Corp
n/a
ModelNumberDuring the construction and handover phases, this is the manufacturer’s model number of the installed product.
During planning and design phases, this data field is not applicable.
TRequiredRequiredCBN1435
M-Series
WarrantyGuarantorPartsDuring the construction and handover phases, this is the name of the company that is responsible for replacement parts during the warranty period.
During planning and design phases, this data field is not applicable.
This is a reference to an item from the Company data table (a COBie.Company.Name value).
TRequiredIf Specified (Reference)ABC Corp.
n/a
WarrantyDurationPartsDuring the construction and handover phases, this is the length of the warranty period for replacement parts provided by the product manufacturer.
During planning and design phases, this data field is not applicable.
TRequiredRequired3
36
WarrantyGuarantorLaborDuring the construction and handover phases, this is the name of the company that is responsible for labor costs during the warranty period.
During planning and design phases, this data field is not applicable.
This is a reference to an item from the Company data table (a COBie.Company.Name value).
TRequiredIf Specified (Reference)ABC_Corp
n/a
WarrantyDurationLaborDuring the construction and handover phases, this is the length of the warranty period for labor repairs provided by the product manufacturer.
During planning and design phases, this data field is not applicable.
TRequiredRequired1
12
WarrantyDurationUnitThe unit of measure associated with values found in COBie.Type.WarrantyDurationParts and COBie.Type.WarrantyDurationLabor.
If allowable values are not specified by contract, the default values are “Month” and “Year”.
This data field value comes from one of the values in COBie.PickList.Units.Duration data field.
TRequiredRequired (Reference)Month
Year
ModelReferenceDuring the construction and handover phases, this is the manufacturer’s catalog or reference resource, such as a website, where information about the installed asset may be found.
During planning and design phases, this data field is not applicable.
TOptionalIf Specified8200HI
n/a
NominalHeightAn approximate measure based on the bounding box of the asset before it is modified to fit into the space.
Height is measured vertically from the bottom up.
ROptionalIf Specified96
0
NominalLengthAn approximate measure based on the bounding box of the asset before it is modified to fit into the space.
Length is measured horizontally and is typically the longer of the two values (length and width).
ROptionalIf Specified72
0
NominalWeightAn approximate measure of the overall weight of the product before it is modified to fit into the space.ROptionalIf Specified60
0
NominalWidthAn approximate measure based on the bounding box of the asset before it is modified to fit into the space.
Width is measured horizontally and is typically the shorter of the two values (length and width).
ROptionalIf Specified30
0
PurchaseCostDuring the construction and handover phases, this is the purchase cost of the asset.
During planning and design phases, this data field is not applicable.
ROptionalIf Specified5200
0
WarrantyDescriptionA general description of the warranty for the asset.TOptionalIf Specified3 years parts, 1 year labor
n/a

COMPONENT

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the asset Component.
This is the primary key for this data table and each value must be unique and must not contain a comma.
TIdentificationRequiredBLR1-6
DR206
DescriptionA general text description of the asset Component.TIdentificationRequiredGas Boiler
Single Door
AssetIdentifierAn alternative identifier for the specific component to be used as defined by associated contract.TIdentificationIf SpecifiedABC123
n/a
BarCodeDuring the construction and handover phases, this is the barcode found on the installed product name plate.
During planning and design phases, this data field is not applicable.
TIdentificationIf Specified012345678901
n/a
SerialNumberDuring the construction and handover phases, this is the serial number found on the installed product name plate.
During planning and design phases, this data field is not applicable.
TIdentificationIf SpecifiedC02NQCC6FY17
n/a
TagNumberDuring the construction and handover phases, this is the value of tag affixed to the installed asset.
During planning and design phases, this data field is not applicable.
TIdentificationIf SpecifiedABC123
n/a
Type.NameThis is a reference to an item from the Type data table (a COBie.Type.Name value).TClassificationRequired (Reference)BoilerType1
Door_Type_A
Space.NameThis is the name of the space in which this asset is located.
This is a reference to an item from the Space data table (a COBie.Space.Name value).
TLocationRequired (Reference)1A01
Room217
Space.SecondaryNameThis is the name of the secondary space in which this asset is located. This may be used if the asset spans across more than one space and can be a comma separated list.
This is a reference to an item from the Space data table (a COBie.Space.Name value).
TLocationIf Specified (Reference)1A01
Room217, Room219
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
InstallationDateDuring the construction and handover phases, this is the date on which this asset was placed in its final location.
During planning and design phases, this data field is not applicable.
DOptionalIf Specified2022-12-31
n/a
WarrantyStartDateDuring the construction and handover phases, this is the date on which the asset’s warranty period begins.
During planning and design phases, this data field is not applicable.
DOptionalIf Specified2022-12-31
n/a

SYSTEM

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the System.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredHVAC-01
FireProtection
DescriptionA general text description of the System.TIdentificationIf SpecifiedHVAC System 01
Fire Protection System
n/a
CategoryThe classification for the System.
This data field value comes from one of the values in COBie.PickList.System.Category data field.
TClassificationIf Specified (Reference)21-04 20 10 Domestic Water Distribution
EF_55_70 Water supply
n/a
PartOfA reference to another COBie.System.Name item on this data table to represent that this item is a subset of that one.
For example, a sanitary vent system may be part of an overall sanitary waste system.
TLocationIf Specified (Reference)SANVENT-02
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
Component.Name

A reference to an item from the Component data table (a COBie.Component.Name value).

This is a comma separated list of values.

TRequiredReferenceBLR1-6, BLR1-7
DR204, DR205, DR206, DR207

RESOURCES

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Resource that is required to be used on the Job. This Resource may be shared across multiple Jobs.
This is the primary key for this data table and each value must be unique and must not contain a comma.
TIdentificationRequiredCleaningMaterials
Boiler_Chemicals
DescriptionA general text description of the Resource.TIdentificationIf SpecifiedChemicals and tools needed to clean areas and equipment
Chemicals needed to maintain boilers
n/a
CategoryThe classification for the Resource.
This data field value comes from one of the values in COBie.PickList.Resource.Category data field.
TClassificationRequired (Reference)Labor
Material
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem

JOB

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Job.
This value does not need to be unique.
TIdentificationRequiredAHUType01-AnnualMaintenance
BoilerType1LockOut
Inspection_10-06-2023
DescriptionA general text description of the Job.
There are typically three ways to populate this field.
  1. A general description of the Job, with all steps outlined in an associated document.
  2. The complete set of all numbered steps. To assist CMMS/CAFM vendors, these steps should be delimited with a semi-colon.
  3. A description of one of several linked steps using the COBie.Job.TaskNumber and COBie.Job.Priors data fields.
TIdentificationRequiredSeries of maintenance tasks related to the Air Handling Units as detailed in the preventative maintenance manual from the manufacturer.
TaskNumberIf COBie.Job.Description contains a series of individual operations, this is the identification (non-negative integers) used to reference each step.
The first COBie.Job.TaskNumber in the series shall have a value of “0” and provide the general information about the job whose tasks follow.
TIdentificationIf Specified0
1
n/a
CategoryThe classification for the Job.
This data field value comes from one of the values in COBie.PickList.Job.Category data field.
TClassificationRequired (Reference)Inspection
ShutDown
StatusThe status of the Level.
This data field value comes from one of the values in COBie.PickList.Job.Status data field.
TClassificationRequired (Reference)Not Yet Started
Completed
TableReference to another data table related to this Job.TLocationRequired (Reference)Package
Risk
Type
Component
Table.NameThe primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Job.Table data field.TLocationRequired (Reference)WindowReplacement2023
Missing_Data
BoilerType1
BLR1-6
PartOfA reference to another COBie.Job.Name item on this data table to represent that this item is a subset of that one.
For example, a “Filter Replacement” Job could be part of an overall “AHU Annual Maintenance” Job.
TLocationIf Specified (Reference)AHUType01-AnnualMaintenance
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
DurationThe length of time required to perform the Job.RRequiredRequired180
1
DurationUnitThe unit of time associated with the COBie.Job.Duration data field.
This data field value comes from one of the values in COBie.PickList.Unit.Duration data field.
TRequiredRequired (Reference)Minute
Hour
IntervalThe planned time interval between occurrence events for this Job.RRequiredRequired1
2
IntervalUnitThe unit of time associated with the COBie.Job.Interval data field.
This data field value comes from one of the values in COBie.PickList.Unit.Duration data field.
TRequiredRequired (Reference)Year
Month
PriorsThe Tasks that must be completed before this Job.
If COBie.Job.Description contains a series of individual operations, this is a comma separated list of the COBie.Job.TaskNumber for all previous jobs. The first in the series shall have a value of “0”.
TRequiredIf Specified (Reference)0
, 1, 2
7
n/a
Resource.NameA comma separated list of the Resources needed for this Job.
This data field value comes from one of the values in COBie.Resource.Name data field.
TRequiredIf Specified (Reference)Cleaning Materials, Boiler Chemicals
n/a

EVENT

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Event.
This value does not need to be unique.
TIdentificationRequiredLift_Inspection_2023
DescriptionA general text description of the Event.TIdentificationRequiredStatutory type 2 inspection
CategoryThe classification for the Event.
This data field value comes from one of the values in COBie.PickList.Event.Category data field.
TClassificationRequired (Reference)One Time
Planned
Repeating
Company.NameThe name of the company that is responsible for this Event.
This is a reference to an item from the Company data table (a COBie.Company.Name value).
TLocationRequired (Reference)ABC_Corp
xyzconstruction-com
Job.NameThe name of the Job of which this Event is a part.
This is a reference to an item from the Job data table (a COBie.Job.Name value).
TLocationRequired (Reference)AHUType01-AnnualMaintenance
BoilerType1LockOut
TableReference to another data table related to this Event.TLocationRequired (Reference)Job
Document
Table.NameThe primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Event.Table data field.TLocationRequired (Reference)AHUType01-AnnualMaintenance
ManufacturersEquipmentInformation-Boiler1
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
StartDateThe date on which this Event begins.DRequiredRequired2022-12-31
2022-12-31T13:00:00
EndDateThe date on which this Event endsDOptionalIf Specified2022-12-31
2022-12-31T13:00:00
n/a

PACKAGE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Package.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredWindowReplacement2023
DescriptionA general text description of the Package.TIdentificationRequiredPlanned replacement of openings
CategoryThe classification for the Package.
This data field value comes from one of the values in COBie.PickList.Package.Category data field.
TClassificationIf Specified (Reference)22-01 93 13 – Facility Maintenance Procedures
n/a
Company.NameThe name of the company that is responsible for this Package.
This is a reference to an item from the Company data table (a COBie.Company.Name value).
TLocationRequired (Reference)ABC_Corp
xyzconstruction-com
Event.NameA comma separated list of the Events associated with this Package.
This is a reference to an item from the Event data table (a COBie.Event.Name value).
TLocationRequired (Reference)Lift inspection 2023-02-03
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
StartDateThe date on which this Package begins.DRequiredRequired2022-12-31
2022-12-31T13:00:00
EndDateThe date on which this Package endsDOptionalIf Specified2022-12-31
2022-12-31T13:00:00
n/a

RISK

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Risk.
This is the primary key for this data table and each value must be unique.
TIdentificationRequiredMissingData
Product_Substitution
DescriptionA general text description of the Risk.TIdentificationRequiredBalcony railing failure
CategoryThe classification for the Risk.
This data field value comes from one of the values in COBie.PickList.Risk.Category data field.
TClassificationRequired (Reference)Environmental
Safety
SpatialTableThis is a reference to another data table related to the location of this Risk. This value could be from the Facility, Space, or Zone data tables.TLocationIf Specified (Reference)Facility
Space
Zone
n/a
SpatialTable.NameThis is the data field of the SpatialData data table referenced. This value could be from the COBie.Facility.NameCOBie.Space.Name, or COBie.Zone.Name data fields.TLocationIf Specified (Reference)Building204
1A01
Administration
n/a
PhysicalTableThis is a reference to another data table related to the location of this Risk. This value could be from the Facility, Type, Component, or System data tables.TLocationIf Specified (Reference)Facility
Type
n/a
PhysicalTable.NameThis is the data field of the PhysicalData data table referenced. This value could be from the COBie.Type.Name or COBie.Component.Name data fields.TLocationIf Specified (Reference)Building204
BoilerType1
n/a
ProcessTableThis is a reference to another data table related to the location of this Risk. This value could be from the Facility, Job, Event, or Package data tables.TLocationIf Specified (Reference)Facility
Job
n/a
ProcessTable.NameThis is the data field of the ProcessData data table referenced. This value could be from the COBie.Job.Name or COBie.Event.Name data fields.TLocationIf Specified (Reference)Building204
AHUType01-AnnualMaintenance
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
Company.NameThe name of the company that is responsible for this Risk.
This data field value comes from one of the values in COBie.Company.Name data field.
TLocationRequired (Reference)ABC_Corp
ConsequenceThe consequence of this Risk.
This data field value comes from one of the values in COBie.PickList.Risk.Consequence data field.
TRequiredRequired (Reference)Moderate
Unknown
LevelOfRiskThe level of this Risk.
This data field value comes from one of the values in COBie.PickList.Risk.LevelOfRisk data field.
TRequiredRequired (Reference)High
Low
LikelihoodThe likelihood of this Risk.
This data field value comes from one of the values in COBie.PickList.Risk.Likelihood data field.
TRequiredRequired (Reference)Has Occurred
Moderate
MitigationA general text description on how to this Risk will be mitigated.TOptionalIf SpecifiedWarning signs pending repairs
n/a

DOCUMENT

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Document.
This value does not need to be unique.
TIdentificationRequiredManufacturersEquipmentInformation-Boiler1
Medical_Gas_System-Normal_Operating_Instructions
DescriptionA general text description of the Document.TIdentificationIf SpecifiedEquipment information reference sheet
User Manual
n/a
CategoryThe classification for the Document.
This data field value comes from one of the values in COBie.PickList.Document.Category data field.
TClassificationRequired (Reference)Contract Drawings
Specifications
StageA value of the type of information contained.
This data field value comes from one of the values in COBie.PickList.Document.Stage data field.
TClassificationRequired (Reference)Approved
As Built
TableReference to another data table related to this Document that can include any other data table.TLocationRequired (Reference)System
Type
Table.NameThe primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Document.Table data field.TLocationRequired (Reference)HVAC-01
BoilerType1
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
ApprovalByA value of the type of approver for this document.
This data field value comes from one of the values in COBie.PickList.Document.AprovalBy data field.
TRequiredRequired (Reference)Owner Approval
Contractor Certified
PathThe path to the document. Can accommodate:
  • Full file path (drive and folders)
  • Relative file path (folders)
  • Web URL
This value may include the file name as well, in which case the COBie.Document.File data field will be “n/a”.
URequiredRequiredX:\Folder\Subfolder\
https://www.abc.com/file.ext
FileThe name of the file, with file extension, that contains the associated information.
The file name may also be included in the COBie.Document.Path data field.
TOptionalIf Specified123Main_Arch_R23.rvt
ComissioningReport.pdf
n/a
ReferenceIf different from the COBie.Document.Path and COBie.Document.File data fields, this is a reference to documents provided from manufacturers’ catalogs or websites.TOptionalIf Specifiedhttps://www.abc.com/doclibrary/
n/a

ATTRIBUTE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Attribute.
This value does not need to be unique.
TIdentificationRequiredFanMaxSpeed
Volts
DescriptionA general text description of the Attribute.TIdentificationIf SpecifiedMaximum fan speed
Nominal Voltage
n/a
CategoryThe classification for the Attribute.
This data field value comes from one of the values in COBie.PickList.Attribute.Category data field.
TClassificationRequired (Reference)Approved
As Built
TableThis is a reference to another data table to where this Attribute applies.TLocationRequired (Reference)Type
Component
Table.NameThe primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Attribute.Table data field.TLocationRequired (Reference)Required (Reference)
BoilerType1
BLR1-6
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem
ValueThe value of the Attribute.TRequiredRequired123
1200.56
UnitThe unit defining the Value of the Attribute.TRequiredRequiredFeet
Amps
AllowedValuesA comma separated list of one or more allowed values for the “Value” data field of a particular item on the “Attribute” data table.TOptionalIf SpecifiedInlet, Outlet
5kVA, 10kVA, 15kVA
Fixed, Variable
n/a

COORDINATE

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
NameThe name of the Coordinate.
This value does not need to be unique.
TIdentificationRequiredLight_LC-1_box-upperright
DR206_box-lowerleft
CategoryThe classification for the Coordinate.
This data field value comes from one of the values in COBie.PickList.Coordinate.Category data field.
TClassificationRequired (Reference)Point
Line-end-one
TableReference to another data table that can include: COBie.FacilityCOBie.LevelCOBie.SpaceCOBie.Type, or COBie.Coordinate.TLocationRequired (Reference)Level
Space
Table.NameThe primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Coordinate.Table data field.TLocationRequired (Reference)Level_1
1A01
CoordinateXAxisThe relative coordinate of the referenced asset along the X-axis.RLocationRequired28.75
-108.50
CoordinateYAxisThe relative coordinate of the referenced asset along the Y-axis.RLocationRequired42.25
-80.00
CoordinateZAxisThe relative coordinate of the referenced asset along the Z-axis.RLocationRequired0.00
96.50
ClockwiseRotationRotation of the asset around the Z-axis of the identified point.RLocationRequired0.00
90.00
ElevationalRotationRotation of the asset around the X-axis of the identified point.RLocationRequired0.00
180.00
YawRotationRotation of the asset around the Y-axis of the identified point.RLocationRequired0.00
90.00
RelativeToA reference to another COBie.Coordinate.Name item on this data table.
If used, this coordinate is relative to that one.
Leaving this data field as “n/a” will imply the coordinate is relative to the coordinate system called out in the COBie.Instruction.CoordinateSystemDescription data field.
TLocationIf Specified (Reference)Light_LC-1_box-upperright
n/a
ExtIdentifierSee the “Company” data table section above for details about these data fields.
ExtObject
ExtSystem

PICKLIST

DATA FIELDDESCRIPTIONTYPEORGANIZATIONSTATUSEXAMPLES
Attribute.CategoryThe pre-determined values allowed for assigning a category to the attributes in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Approved
  • As Built
  • Exact Requirement
  • Maximum Requirement
  • Minimum Requirement
  • Requirement
  • Submitted
Coordinate.CategoryThe pre-determined values allowed for categorizing the coordinates in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Point
  • Line-end-one
  • Line-end-two
  • Box-lowerleft
  • Box-upperright
Coordinate.TableNameThe pre-determined values allowed for assigning a data table to which the coordinates in a COBie deliverable apply.Tn/aIf SpecifiedOnly the following values are allowed:
  • Component
  • Level
  • Space
Document.ApprovalByThe pre-determined values allowed for assigning an approver for the documents in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Owner Approval
  • Contractor Certified
  • Information Only
Document.CategoryThe pre-determined values allowed for categorizing the documents in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Certificates
  • Client Requirements
  • Closeout Submittals
  • Contract Drawings
  • Contract Modifications
  • Contract Specifications
  • Design Data
  • Design Review Comment
  • Manufacturer Field Reports
  • Manufacturer Instructions
  • Operation and Maintenance
  • Preconstruction Submittals
  • Product Data
  • Punch List Items
  • Request for Information
  • Requests for Information
  • Samples
  • Shop Drawings
  • Specifications
  • Test Reports
Document.StageThe pre-determined values allowed for assigning a stage to the documents in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Approved
  • As Built
  • Exact Requirement
  • Maximum Requirement
  • Minimum Requirement
  • Requirement
  • Submitted
Event.CategoryThe pre-determined values allowed for categorizing the events in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Approved
  • One Time
  • Planned
  • Repeating
Facility.CategoryThe pre-determined values allowed for categorizing the facility in a COBie deliverable.Tn/aIf SpecifiedTypically, the values shown for this in the U.S. are those from OmniClass Table 11, while Uniclass Table En is used in the U.K.
Facility.TypeThe pre-determined values allowed for the facility type in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Facility
  • Project
  • Site
Job.CategoryThe pre-determined values allowed for categorizing the jobs in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Adjustment
  • Calibration
  • Emergency
  • Inspection
  • Operation
  • Project Management
  • Safety
  • ShutDown
  • StartUp
  • Testing
  • Trouble
Job.StatusThe pre-determined values allowed for the status of your jobs in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Not Yet Started
  • Started
  • Completed
Level.CategoryThe pre-determined values allowed for categorizing the levels in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Floor
  • Roof
  • Site
Package.CategoryThe pre-determined values allowed for the category of your packages in a COBie deliverableTn/aIf SpecifiedTypically, the values shown for this in the U.S. are those from OmniClass Table 22, while Uniclass Table Ss is used in the U.K.
Resource.CategoryThe pre-determined values allowed for categorizing the resources in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Labor
  • Material
  • Tools
  • Training
Risk.CategoryThe pre-determined values allowed for categorizing the risks in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Change
  • Claim
  • Coordination
  • Environmental
  • Function
  • IndoorAirQuality
  • Installation
  • RFI
  • Safety
  • Specification
Risk.ConsequenceThe pre-determined values allowed for the risk consequences in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Very High
  • High
  • Moderate
  • Low
  • Unknown
Risk.LevelOfRiskThe pre-determined values allowed for the levels of risk in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Very High
  • High
  • Moderate
  • Low
  • Unknown
Risk.LikelihoodThe pre-determined values allowed for the likelihood of risks in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Has Occurred
  • High
  • Moderate
  • Low
  • Unknown
SpaceType.CategoryThe pre-determined values allowed for categorizing the space types in a COBie deliverable.Tn/aIf SpecifiedTypically, the values shown for this in the U.S. are those from OmniClass Table 13, while Uniclass Table SL is used in the U.K.
System.CategoryThe pre-determined values allowed for categorizing the systems in a COBie deliverable.Tn/aIf SpecifiedTypically, the values shown for this in the U.S. are those from OmniClass Table 21, while Uniclass Table EF is used in the U.K.
TableA list of the COBie data tables.Tn/aIf SpecifiedOnly the following values are allowed:
  • Attribute
  • Company
  • Component
  • Coordinate
  • Document
  • Event
  • Facility
  • Job
  • Level
  • Package
  • Resource
  • Risk
  • Space
  • SpaceType
  • System
  • Type
  • Zone
Type.AssetTypeThe pre-determined values allowed for designating the type of asset each component type is in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Fixed
  • Moveable
Type.CategoryThe pre-determined values allowed for categorizing the component types in a COBie deliverable.Tn/aIf SpecifiedTypically, the values shown for this in the U.S. are those from OmniClass Table 23, while Uniclass Table Pr is used in the U.K.
Zone.CategoryThe pre-determined values allowed for categorizing the zones in a COBie deliverable.Tn/aIf SpecifiedOnly the following values are allowed:
  • Circulation Zone
  • Fire Alarm Zone
  • Historical Preservation Zone
  • Lighting Zone
  • Occupancy Zone
  • Ventilation Zone
Units.AreaThe pre-determined values allowed for data fields that represent area measurements.
The overall value is captured in the COBie.Instruction.AreaUnit data field.
Tn/aIf SpecifiedOnly the following values are allowed:
  • Square Inches
  • Square Feet
  • Square Miles
  • Square Millimeters
  • Square Meters
  • Square Kilometers
Units.CurrencyThe pre-determined values allowed for data fields that represent currency.
The overall value is captured in the COBie.Instruction.CurrencyUnit data field.
Tn/aIf SpecifiedThe values shown should be from the ISO 4217 Currency codes.
Units.DurationThe pre-determined values allowed for data fields that represent duration.
The overall value is captured in the COBie.Instruction.DurationUnit data field.
Tn/aIf SpecifiedOnly the following values are allowed:
  • As required
  • Day
  • Minute
  • Month
  • Quarter
  • Week
  • Year
Units.LinearThe pre-determined values allowed for data fields that represent linear measurements.
The overall value is captured in the COBie.Instruction.LinearUnit data field.
Tn/aIf SpecifiedOnly the following values are allowed:
  • Inches
  • Feet
  • Miles
  • Millimeters
  • Meters
  • Kilometers
Units.VolumeThe pre-determined values allowed for data fields that represent volume measurement.
The overall value is captured in the COBie.Instruction.VolumeUnit data field.
Tn/aIf SpecifiedOnly the following values are allowed:
  • Cubic Feet
  • Cubic Meters
Units.WeightThe pre-determined values allowed for data fields that represent weight measurements.
The overall value is captured in the COBie.Instruction.WeightUnit data field.
Tn/aIf SpecifiedOnly the following values are allowed:
  • Ounces
  • Pounds
  • Tons
  • Grams
  • Kilograms
  • Metric Tons

National BIM Standard-United States® (NBIMS-US™) Version 4

The NBIMS-US™ v4 is a consensus-based national-level standard focused on defining standard approaches and guidelines to defining requirements, planning BIM adoption, and exchanging information between project team members. MORE

What content are you interested in?
Topics of Interest