COBie
4.3Data 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:
- Names do not contain any spaces.
- The first letter is always capitalized, and all subsequent letters are lower case.
- 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”).
- 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 FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Title | The title of this deliverable standard, which is always COBie. | T | n/a | Required | COBie |
| Version | The version of the COBie standard you are submitting. | T | n/a | Required | 3 |
| Release | The release of the COBie version. | T | n/a | Required | 1 |
| Status | The version IFC with which this COBie deliverable aligns. | T | n/a | Required | IFC4 |
| Region | The language in which this COBie deliverable is written... Format is ISO 639-1 two letter language code. |
T | n/a | Required | en-US en-GB |
| ExportDateTime | The date or date and time this COBie deliverable was generated. Format is ISO 8601 (YYYY-MM-DD), with the exact time optional. |
D | n/a | Required | 2022-12-31 2022-12-31T13:00:00 |
| Milestone | A description of the project milestone for which this COBie deliverable represents. | T | n/a | If Specified | 50% DD 90% CD Handover n/a |
| OriginatingCompany | The name of the company that generated this COBie deliverable, referencing a COBie.Company.Name value. | T | n/a | Required (Reference) | ABC_Corp |
| AreaUnit | The units for area measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Area value. | T | n/a | Required (Reference) | Square Feet Square Meters |
| CurrencyUnit | The units for currency in this COBie deliverable, referencing a COBIe.PickList.Units.Currency value. | T | n/a | Required (Reference) | Dollars Euros |
| DurationUnit | The units for duration in this COBie deliverable, referencing a COBIe.PickList.Units.Duration value. | T | n/a | Required (Reference) | Month Year |
| LinearUnit | The units for linear measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Linear value. | T | n/a | Required (Reference) | Feet Meters |
| VolumeUnit | The units for volume measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Volume value. | T | n/a | Required (Reference) | Cubic Feet Cubic Meters |
| WeightUnit | The units for area measurements in this COBie deliverable, referencing a COBIe.PickList.Units.Weight value. | T | n/a | Required (Reference) | Pounds Kilograms |
| AreaMeasurementStandard | The associated measurement method used to calculate spatial area measurements applied to all COBie information other than that found in the Attribute data table. | T | n/a | Required | BOMA 2017 for Office Buildings: Standard Methods of Measurement (ANSI/BOMA Z65.1—2017) |
| CoordinateSystemDescription | A 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. |
T | n/a | Required | WGS 84 GRS80 |
| CoordinateSystemOrigin | Typically 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. | T | n/a | Required | The furthest Southeast intersection of the column grid of Building 206 38°54'12.438"N, 77°2'1.0314"W |
| ClassificationSystem.Company | The 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. |
T | n/a | Required | OmniClass Table 34 Uniclass Table Ro |
| ClassificationSystem.Facility | The 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. |
T | n/a | Required | OmniClass Table 11 Uniclass Table En |
| ClassificationSystem.SpaceType | The 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. |
T | n/a | Required | OmniClass Table 13 Uniclass Table SL |
| ClassificationSystem.Type | The 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 |
T | n/a | Required | OmniClass Table 23 Uniclass Table Pr |
| ClassificationSystem.System | The 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 |
T | n/a | Required | OmniClass Table 21 Uniclass Table EF |
COMPANY
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Company. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | ABC_Corp xyzconstruction-com |
| Phone | The telephone number for the Company. | T | Identification | Required | +1 (202) 289-7800 |
| Category | The classification for the Company. This data field value comes from one of the values in COBie.PickList.Company.Category data field. |
T | Classification | If Specified (Reference) |
34-10 11 Owner Ro_10_20_14 Client n/a |
| Website | The website address for the Company. | T | Location | If Specified | www.abccorp.com https://www.abccorp.com/project12 n/a |
| Street | The street address for the Company. | T | Location | If Specified | 1090 Vermont Avenue NW, Suite 700 n/a |
| PostalBox | The postal box address for the Company. | T | Location | If Specified | P.O. Box 1234 n/a |
| Town | The city or town address for the Company. | T | Location | If Specified | Washington n/a |
| StateRegion | The state or regional address for the Company. | T | Location | If Specified | DC n/a |
| PostalCode | The zip, or postal code, address for the Company. | T | Location | If Specified | 20005 n/a |
| Country | The country where the Company is located. | T | Location | If Specified | U.S.A. U.K. Germany n/a |
| ExtIdentifier | The 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. |
T | External | External | 4ec17585-c36e-4cc3-8301-61df48a06d7e-000c89be |
| ExtObject | The 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. | T | External | External | IfcSpace |
| ExtSystem | The name of the computer system generating the record of COBie data. | T | External | External | Autodesk Revit 2023, Build: 20220429_1500(x64) ArchiCAD 19 Full (USA) / Build: 5005 |
| Certifications | The assurance by an independent governing body that a building component, service, or system meets specific requirements. | T | Optional | If Specified | Licensed electrician Certified Lead Based Paint Abatement Company n/a |
| Department | The name of the department for the Company. | T | Optional | If Specified | Design & Construction Operations n/a |
| OrganizationCode | The organizational code for the Company. | T | Optional | If Specified | ABC XYZ n/a |
FACILITY
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Facility for this COBie deliverable. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | Building204 American_Legion_Bridge_and_Facilities |
| Description | A general text description of the facility, structure, or group of structures as part of this COBie deliverable. | T | Identification | If Specified | Medical-Dental Clinic n/a |
| Type | The 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. |
T | Classification | Required (Reference) |
Facility Project Site |
| Category | The classification for the Facility. This data field value comes from one of the values in COBie.PickList.Facility.Category data field. |
T | Classification | If Specified (Reference) | 11-27 25 19 Office-Retail Building En_20_15_10 Multiple occupation office n/a |
| Address | The city or town address of the project in Facility. | T | Location | Required | 1090 Vermont Avenue NW, Suite 700, Washington, DC 20005 |
| Latitude | The specific latitude for the facility, structure, or group of structures as part of this COBie deliverable. | T | Location | Required | 38°54'12.438"N |
| Longitude | The specific longitude for the facility, structure, or group of structures as part of this COBie deliverable. | T | Location | Required | 77°2'1.0314"W |
| Elevation | The specific elevation above sea level for the facility, structure, or group of structures as part of this COBie deliverable. | T | Location | Required | 2,432 |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
LEVEL
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Level. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | Level_1 Mezzanine |
| Description | A general text description of the Level. | T | Identification | If Specified | First floor n/a |
| Category | The classification for the Level. This data field value comes from one of the values in COBie.PickList.Level.Category data field. |
T | Classification | Required (Reference) | Roof Floor Site |
| PartOf | A 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. |
T | Classification | If Specified (Reference) | Mezzanine n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| Elevation | The 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. | R | Optional | If Specified | 12 150 0 |
| Height | The 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”. |
R | Optional | If Specified | 96 150 0 |
SPACETYPE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Space Type. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | Office-Medium |
| Description | A general text description of the Space Type. | T | Identification | If Specified | Office of 60SF - 99SF n/a |
| Category | The classification for the Space Type. This data field value comes from one of the values in COBie.PickList.SpaceType.Category data field. |
T | Classification | If Specified (Reference) | 13-55 11 Office Spaces SL_20_15_27 Enclosed offices n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
SPACE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The 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. |
T | Identification | Required | 1A01 Room217 |
| Description | A general text description of the Space. This is often the room name in the construction documents. |
T | Identification | Required | Office Communication Room |
| RoomTag | The 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. |
T | Identification | If Specified | 6-1A01 n/a |
| SpaceType.Name | A reference to an item from the SpaceType data table (a COBie.SpaceType.Name value). | T | Classification | Required (Reference) | Office-Medium |
| Level.Name | A reference to an item from the Level data table (a COBie.Level.Name value). | T | Location | Required (Reference) | Level_1 |
| PartOf | A 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. |
T | Location | If Specified (Reference) | WorkArea500 n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| GrossArea | The total space area as specified in the design contract and calculated by the identified COBie.Instruction.AreaMeasurementStandard value. | R | Optional | If Specified | 415 0 |
| NetArea | The usable space area as specified in the design contract and calculated by the identified COBie.Instruction.AreaMeasurementStandard value. | R | Optional | If Specified | 325 0 |
| UsableHeight | Distance from top of finished level to bottom of ceiling. If there is no ceiling, then this value must match COBie.Level.Height. | R | Optional | If Specified | 120 0 |
ZONE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Zone. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | Administration Circulation |
| Description | A general text description of the Zone. | T | Identification | If Specified | Administration Department Circulation Area n/a |
| Category | The classification for the Zone. This data field value comes from one of the values in COBie.PickList.Zone.Category data field. |
T | Classification | If 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. |
T | Location | Required (Reference) | 1A01, 1A02, 1A03 2E16, 2E24 |
| PartOf | A 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. |
T | Location | If Specified (Reference) | logistics n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
TYPE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the asset Type. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | BoilerType1 Door_Type_A |
| Description | A general text description of the asset Type. | T | Identification | Required | Induced Heat Draft, Natural Gas Fired, Copper Tube, Hot Water Boiler Single Panel Flush Solid Core Wood |
| Category | The classification for the asset Type. This data field value comes from one of the values in COBie.PickList.Type.Category data field. |
T | Classification | If Specified (Reference) | 23-33 11 22 Electric Boilers Pr_60_60_08_27 Electric Boilers n/a |
| AssetType | The type of asset. This data field value comes from one of the values in COBie.PickList.Type.AssetType data field. |
T | Classification | If Specified (Reference) | Fixed Moveable n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| Manufacturer | The name of the company that manufactures the asset. This data field value comes from one of the values in COBie.Company.Name data field. |
T | Required | If Specified (Reference) | ABC_Corp n/a |
| ModelNumber | During 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. |
T | Required | Required | CBN1435 M-Series |
| WarrantyGuarantorParts | During 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). |
T | Required | If Specified (Reference) | ABC Corp. n/a |
| WarrantyDurationParts | During 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. |
T | Required | Required | 3 36 |
| WarrantyGuarantorLabor | During 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). |
T | Required | If Specified (Reference) | ABC_Corp n/a |
| WarrantyDurationLabor | During 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. |
T | Required | Required | 1 12 |
| WarrantyDurationUnit | The 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. |
T | Required | Required (Reference) | Month Year |
| ModelReference | During 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. |
T | Optional | If Specified | 8200HI n/a |
| NominalHeight | An 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. |
R | Optional | If Specified | 96 0 |
| NominalLength | An 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). |
R | Optional | If Specified | 72 0 |
| NominalWeight | An approximate measure of the overall weight of the product before it is modified to fit into the space. | R | Optional | If Specified | 60 0 |
| NominalWidth | An 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). |
R | Optional | If Specified | 30 0 |
| PurchaseCost | During the construction and handover phases, this is the purchase cost of the asset. During planning and design phases, this data field is not applicable. |
R | Optional | If Specified | 5200 0 |
| WarrantyDescription | A general description of the warranty for the asset. | T | Optional | If Specified | 3 years parts, 1 year labor n/a |
COMPONENT
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The 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. |
T | Identification | Required | BLR1-6 DR206 |
| Description | A general text description of the asset Component. | T | Identification | Required | Gas Boiler Single Door |
| AssetIdentifier | An alternative identifier for the specific component to be used as defined by associated contract. | T | Identification | If Specified | ABC123 n/a |
| BarCode | During 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. |
T | Identification | If Specified | 012345678901 n/a |
| SerialNumber | During 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. |
T | Identification | If Specified | C02NQCC6FY17 n/a |
| TagNumber | During 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. |
T | Identification | If Specified | ABC123 n/a |
| Type.Name | This is a reference to an item from the Type data table (a COBie.Type.Name value). | T | Classification | Required (Reference) | BoilerType1 Door_Type_A |
| Space.Name | This 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). |
T | Location | Required (Reference) | 1A01 Room217 |
| Space.SecondaryName | This 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). |
T | Location | If Specified (Reference) | 1A01 Room217, Room219 n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| InstallationDate | During 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. |
D | Optional | If Specified | 2022-12-31 n/a |
| WarrantyStartDate | During 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. |
D | Optional | If Specified | 2022-12-31 n/a |
SYSTEM
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the System. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | HVAC-01 FireProtection |
| Description | A general text description of the System. | T | Identification | If Specified | HVAC System 01 Fire Protection System n/a |
| Category | The classification for the System. This data field value comes from one of the values in COBie.PickList.System.Category data field. |
T | Classification | If Specified (Reference) | 21-04 20 10 Domestic Water Distribution EF_55_70 Water supply n/a |
| PartOf | A 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. |
T | Location | If Specified (Reference) | SANVENT-02 n/a |
| ExtIdentifier | See 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. |
T | Required | Reference | BLR1-6, BLR1-7 DR204, DR205, DR206, DR207 |
RESOURCES
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The 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. |
T | Identification | Required | CleaningMaterials Boiler_Chemicals |
| Description | A general text description of the Resource. | T | Identification | If Specified | Chemicals and tools needed to clean areas and equipment Chemicals needed to maintain boilers n/a |
| Category | The classification for the Resource. This data field value comes from one of the values in COBie.PickList.Resource.Category data field. |
T | Classification | Required (Reference) | Labor Material |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
JOB
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Job. This value does not need to be unique. |
T | Identification | Required | AHUType01-AnnualMaintenance BoilerType1LockOut Inspection_10-06-2023 |
| Description | A general text description of the Job. There are typically three ways to populate this field.
|
T | Identification | Required | Series of maintenance tasks related to the Air Handling Units as detailed in the preventative maintenance manual from the manufacturer. |
| TaskNumber | If 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. |
T | Identification | If Specified | 0 1 n/a |
| Category | The classification for the Job. This data field value comes from one of the values in COBie.PickList.Job.Category data field. |
T | Classification | Required (Reference) | Inspection ShutDown |
| Status | The status of the Level. This data field value comes from one of the values in COBie.PickList.Job.Status data field. |
T | Classification | Required (Reference) | Not Yet Started Completed |
| Table | Reference to another data table related to this Job. | T | Location | Required (Reference) | Package Risk Type Component |
| Table.Name | The primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Job.Table data field. | T | Location | Required (Reference) | WindowReplacement2023 Missing_Data BoilerType1 BLR1-6 |
| PartOf | A 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. |
T | Location | If Specified (Reference) | AHUType01-AnnualMaintenance n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| Duration | The length of time required to perform the Job. | R | Required | Required | 180 1 |
| DurationUnit | The 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. |
T | Required | Required (Reference) | Minute Hour |
| Interval | The planned time interval between occurrence events for this Job. | R | Required | Required | 1 2 |
| IntervalUnit | The 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. |
T | Required | Required (Reference) | Year Month |
| Priors | The 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”. |
T | Required | If Specified (Reference) | 0 , 1, 2 7 n/a |
| Resource.Name | A 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. |
T | Required | If Specified (Reference) | Cleaning Materials, Boiler Chemicals n/a |
EVENT
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Event. This value does not need to be unique. |
T | Identification | Required | Lift_Inspection_2023 |
| Description | A general text description of the Event. | T | Identification | Required | Statutory type 2 inspection |
| Category | The classification for the Event. This data field value comes from one of the values in COBie.PickList.Event.Category data field. |
T | Classification | Required (Reference) | One Time Planned Repeating |
| Company.Name | The 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). |
T | Location | Required (Reference) | ABC_Corp xyzconstruction-com |
| Job.Name | The 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). |
T | Location | Required (Reference) | AHUType01-AnnualMaintenance BoilerType1LockOut |
| Table | Reference to another data table related to this Event. | T | Location | Required (Reference) | Job Document |
| Table.Name | The primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Event.Table data field. | T | Location | Required (Reference) | AHUType01-AnnualMaintenance ManufacturersEquipmentInformation-Boiler1 |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| StartDate | The date on which this Event begins. | D | Required | Required | 2022-12-31 2022-12-31T13:00:00 |
| EndDate | The date on which this Event ends | D | Optional | If Specified | 2022-12-31 2022-12-31T13:00:00 n/a |
PACKAGE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Package. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | WindowReplacement2023 |
| Description | A general text description of the Package. | T | Identification | Required | Planned replacement of openings |
| Category | The classification for the Package. This data field value comes from one of the values in COBie.PickList.Package.Category data field. |
T | Classification | If Specified (Reference) | 22-01 93 13 – Facility Maintenance Procedures n/a |
| Company.Name | The 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). |
T | Location | Required (Reference) | ABC_Corp xyzconstruction-com |
| Event.Name | A 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). |
T | Location | Required (Reference) | Lift inspection 2023-02-03 |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| StartDate | The date on which this Package begins. | D | Required | Required | 2022-12-31 2022-12-31T13:00:00 |
| EndDate | The date on which this Package ends | D | Optional | If Specified | 2022-12-31 2022-12-31T13:00:00 n/a |
RISK
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Risk. This is the primary key for this data table and each value must be unique. |
T | Identification | Required | MissingData Product_Substitution |
| Description | A general text description of the Risk. | T | Identification | Required | Balcony railing failure |
| Category | The classification for the Risk. This data field value comes from one of the values in COBie.PickList.Risk.Category data field. |
T | Classification | Required (Reference) | Environmental Safety |
| SpatialTable | This 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. | T | Location | If Specified (Reference) | Facility Space Zone n/a |
| SpatialTable.Name | This is the data field of the SpatialData data table referenced. This value could be from the COBie.Facility.Name, COBie.Space.Name, or COBie.Zone.Name data fields. | T | Location | If Specified (Reference) | Building204 1A01 Administration n/a |
| PhysicalTable | This 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. | T | Location | If Specified (Reference) | Facility Type n/a |
| PhysicalTable.Name | This 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. | T | Location | If Specified (Reference) | Building204 BoilerType1 n/a |
| ProcessTable | This 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. | T | Location | If Specified (Reference) | Facility Job n/a |
| ProcessTable.Name | This 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. | T | Location | If Specified (Reference) | Building204 AHUType01-AnnualMaintenance n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| Company.Name | The 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. |
T | Location | Required (Reference) | ABC_Corp |
| Consequence | The consequence of this Risk. This data field value comes from one of the values in COBie.PickList.Risk.Consequence data field. |
T | Required | Required (Reference) | Moderate Unknown |
| LevelOfRisk | The level of this Risk. This data field value comes from one of the values in COBie.PickList.Risk.LevelOfRisk data field. |
T | Required | Required (Reference) | High Low |
| Likelihood | The likelihood of this Risk. This data field value comes from one of the values in COBie.PickList.Risk.Likelihood data field. |
T | Required | Required (Reference) | Has Occurred Moderate |
| Mitigation | A general text description on how to this Risk will be mitigated. | T | Optional | If Specified | Warning signs pending repairs n/a |
DOCUMENT
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Document. This value does not need to be unique. |
T | Identification | Required | ManufacturersEquipmentInformation-Boiler1 Medical_Gas_System-Normal_Operating_Instructions |
| Description | A general text description of the Document. | T | Identification | If Specified | Equipment information reference sheet User Manual n/a |
| Category | The classification for the Document. This data field value comes from one of the values in COBie.PickList.Document.Category data field. |
T | Classification | Required (Reference) | Contract Drawings Specifications |
| Stage | A value of the type of information contained. This data field value comes from one of the values in COBie.PickList.Document.Stage data field. |
T | Classification | Required (Reference) | Approved As Built |
| Table | Reference to another data table related to this Document that can include any other data table. | T | Location | Required (Reference) | System Type |
| Table.Name | The primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Document.Table data field. | T | Location | Required (Reference) | HVAC-01 BoilerType1 |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| ApprovalBy | A 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. |
T | Required | Required (Reference) | Owner Approval Contractor Certified |
| Path | The path to the document. Can accommodate:
|
U | Required | Required | X:\Folder\Subfolder\ https://www.abc.com/file.ext |
| File | The 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. |
T | Optional | If Specified | 123Main_Arch_R23.rvt ComissioningReport.pdf n/a |
| Reference | If different from the COBie.Document.Path and COBie.Document.File data fields, this is a reference to documents provided from manufacturers’ catalogs or websites. | T | Optional | If Specified | https://www.abc.com/doclibrary/ n/a |
ATTRIBUTE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Attribute. This value does not need to be unique. |
T | Identification | Required | FanMaxSpeed Volts |
| Description | A general text description of the Attribute. | T | Identification | If Specified | Maximum fan speed Nominal Voltage n/a |
| Category | The classification for the Attribute. This data field value comes from one of the values in COBie.PickList.Attribute.Category data field. |
T | Classification | Required (Reference) | Approved As Built |
| Table | This is a reference to another data table to where this Attribute applies. | T | Location | Required (Reference) | Type Component |
| Table.Name | The primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Attribute.Table data field. | T | Location | Required (Reference) | Required (Reference) BoilerType1 BLR1-6 |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
| Value | The value of the Attribute. | T | Required | Required | 123 1200.56 |
| Unit | The unit defining the Value of the Attribute. | T | Required | Required | Feet Amps |
| AllowedValues | A comma separated list of one or more allowed values for the “Value” data field of a particular item on the “Attribute” data table. | T | Optional | If Specified | Inlet, Outlet 5kVA, 10kVA, 15kVA Fixed, Variable n/a |
COORDINATE
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Name | The name of the Coordinate. This value does not need to be unique. |
T | Identification | Required | Light_LC-1_box-upperright DR206_box-lowerleft |
| Category | The classification for the Coordinate. This data field value comes from one of the values in COBie.PickList.Coordinate.Category data field. |
T | Classification | Required (Reference) | Point Line-end-one |
| Table | Reference to another data table that can include: COBie.Facility, COBie.Level, COBie.Space, COBie.Type, or COBie.Coordinate. | T | Location | Required (Reference) | Level Space |
| Table.Name | The primary key (value in the “Name” data field) of the data record on the data table referenced in COBie.Coordinate.Table data field. | T | Location | Required (Reference) | Level_1 1A01 |
| CoordinateXAxis | The relative coordinate of the referenced asset along the X-axis. | R | Location | Required | 28.75 -108.50 |
| CoordinateYAxis | The relative coordinate of the referenced asset along the Y-axis. | R | Location | Required | 42.25 -80.00 |
| CoordinateZAxis | The relative coordinate of the referenced asset along the Z-axis. | R | Location | Required | 0.00 96.50 |
| ClockwiseRotation | Rotation of the asset around the Z-axis of the identified point. | R | Location | Required | 0.00 90.00 |
| ElevationalRotation | Rotation of the asset around the X-axis of the identified point. | R | Location | Required | 0.00 180.00 |
| YawRotation | Rotation of the asset around the Y-axis of the identified point. | R | Location | Required | 0.00 90.00 |
| RelativeTo | A 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. |
T | Location | If Specified (Reference) | Light_LC-1_box-upperright n/a |
| ExtIdentifier | See the “Company” data table section above for details about these data fields. | ||||
| ExtObject | |||||
| ExtSystem | |||||
PICKLIST
| DATA FIELD | DESCRIPTION | TYPE | ORGANIZATION | STATUS | EXAMPLES |
|---|---|---|---|---|---|
| Attribute.Category | The pre-determined values allowed for assigning a category to the attributes in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Coordinate.Category | The pre-determined values allowed for categorizing the coordinates in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Coordinate.TableName | The pre-determined values allowed for assigning a data table to which the coordinates in a COBie deliverable apply. | T | n/a | If Specified | Only the following values are allowed:
|
| Document.ApprovalBy | The pre-determined values allowed for assigning an approver for the documents in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Document.Category | The pre-determined values allowed for categorizing the documents in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Document.Stage | The pre-determined values allowed for assigning a stage to the documents in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Event.Category | The pre-determined values allowed for categorizing the events in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Facility.Category | The pre-determined values allowed for categorizing the facility in a COBie deliverable. | T | n/a | If Specified | Typically, 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.Type | The pre-determined values allowed for the facility type in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Job.Category | The pre-determined values allowed for categorizing the jobs in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Job.Status | The pre-determined values allowed for the status of your jobs in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Level.Category | The pre-determined values allowed for categorizing the levels in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Package.Category | The pre-determined values allowed for the category of your packages in a COBie deliverable | T | n/a | If Specified | Typically, 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.Category | The pre-determined values allowed for categorizing the resources in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Risk.Category | The pre-determined values allowed for categorizing the risks in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Risk.Consequence | The pre-determined values allowed for the risk consequences in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Risk.LevelOfRisk | The pre-determined values allowed for the levels of risk in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Risk.Likelihood | The pre-determined values allowed for the likelihood of risks in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| SpaceType.Category | The pre-determined values allowed for categorizing the space types in a COBie deliverable. | T | n/a | If Specified | Typically, 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.Category | The pre-determined values allowed for categorizing the systems in a COBie deliverable. | T | n/a | If Specified | Typically, 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. |
| Table | A list of the COBie data tables. | T | n/a | If Specified | Only the following values are allowed:
|
| Type.AssetType | The pre-determined values allowed for designating the type of asset each component type is in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Type.Category | The pre-determined values allowed for categorizing the component types in a COBie deliverable. | T | n/a | If Specified | Typically, 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.Category | The pre-determined values allowed for categorizing the zones in a COBie deliverable. | T | n/a | If Specified | Only the following values are allowed:
|
| Units.Area | The pre-determined values allowed for data fields that represent area measurements. The overall value is captured in the COBie.Instruction.AreaUnit data field. |
T | n/a | If Specified | Only the following values are allowed:
|
| Units.Currency | The pre-determined values allowed for data fields that represent currency. The overall value is captured in the COBie.Instruction.CurrencyUnit data field. |
T | n/a | If Specified | The values shown should be from the ISO 4217 Currency codes. |
| Units.Duration | The pre-determined values allowed for data fields that represent duration. The overall value is captured in the COBie.Instruction.DurationUnit data field. |
T | n/a | If Specified | Only the following values are allowed:
|
| Units.Linear | The pre-determined values allowed for data fields that represent linear measurements. The overall value is captured in the COBie.Instruction.LinearUnit data field. |
T | n/a | If Specified | Only the following values are allowed:
|
| Units.Volume | The pre-determined values allowed for data fields that represent volume measurement. The overall value is captured in the COBie.Instruction.VolumeUnit data field. |
T | n/a | If Specified | Only the following values are allowed:
|
| Units.Weight | The pre-determined values allowed for data fields that represent weight measurements. The overall value is captured in the COBie.Instruction.WeightUnit data field. |
T | n/a | If Specified | Only the following values are allowed:
|
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
