BCIS Analyses XML Schema - Overview of Data


This document describes, in very general terms, the information which is encoded by the analyses schema.

Top Level Structure

The assumption is that one or more analysis will be exchanged within an Analyses file.

         {  Analysis (1)
            Analysis (n)

At the analyses level the number of Analysis elements included is given and the date the set was created.

The data within an analysis is broken down as follows:

        {   Identification {1...n}
            Complex Contract {0, 1}
            Building Description {0...10}
            Dates {0...10)
            Size {0...10}
            Functional Units {0...10}
            Location {0...10}
            Contractual Information {0...10}
            Contract Breakdown {0..2}
            Average Storey Height {0..3}
            Design Shape {0..10}
            Credits {0...10}
            Elements {1}
            Adjustments {0...2}

Information Content

The currency employed throughout the analysis will be declared either at the beginning or as part of appropriate sections.


Analysis Number Uniquely identifies a particular building analysis from BCIS or other source.
Analysis Reference Reference for the job. May not be unique. May be more than one reference applicable to a job.
Job Title Title of the job.
Publication Status Whether this analysis has been published, is in draft, is available for publication, etc.

Complex Contract

An indication that the analysis is only a part of a complex contract. May also identify the analyses which form part of the same contract.

Building Description

Strings which may be supported by a code.

Type of Work Code ie new building, rehabilitation, extension etc.
Building Function Description of the function of the building.
BCIS Construction Code Codes are A, B, C or D for Steel, Concrete, Brick or timber
Description of Total Project A brief description of the project which this analysis forms a part.
Market Conditions Describes prevailing market conditions and special contractual arrangements.
Accommodation and Design A general description of the accommodation and construction.


Dates, but the day may be suppressed.

Date for Receipt of Tender The date on which the tender documents were due to be returned. (Day of month may be missing). While strictly optional, the inclusion of this date is strongly recommended.
Date of Tender/Base Month If the cost/fluctuations provision included in the contract are formula price adjustment then this field holds the Base Month (MM/YY) otherwise the contractual date for pricing the job is held (month, year may only be known).
Date of Acceptance Date of acceptance of the tender. (Month, year may only be known).
Date of Possession Date of possession of the site. (Month, year may only be known).
Date of Input/Amendment The date of input of the analysis information, or the date on which it was last modified.


Different measures of aspects or the whole building or buildings analysed. Units should be metric.

Gross Internal Floor Area The gross internal floor area of the building(s).
Gross Floor Area Basements The gross internal floor area of all basement floors of the building(s).
Gross Floor Area Ground similar
Gross Floor Area Uppers similar
Net Floor Area - usable the net usable floor area
Net Floor Area - circulation similar
Net Floor Area - ancillary similar
Net Floor Area -internal divisions similar
Floor Spaces not Enclosed the covered areas outside the external vertical envelope.
Area of External Walls the total area of external vertical envelope (external walls, including windows and doors).
Internal Cube the volume of the building.
Primary Number of Storeys the number of storeys of the majority of the building.
Secondary Number of Storeys the second most significant number of storeys of the building analysed.
Number of Basement Floors the number of storeys below ground floor of the building analysed.
Number units the number of discrete units in the building(s) analysed eg 34 houses; 24 flats (even if in three blocks); 5 factory units.

Functional Units

Functional Unit Quantity: Current BCIS usage allows for up to three pairs of fields where each is an alternative measure of the size of the whole analysis - not a measure of a part of the building analysed. The first field contains the functional unit. The second field contains the unit quantity and is a measure of the size of the project related to the function of the building.

An alternative use would be for functional unit pairs to be grouped so that together they represent the building analysed. While this is not currently supported by BCIS the schema should allow for this approach.


Generally text, but some more structured information.

Location Text text describing the location of the building.
Location District The location in a more structured form. Typically the Local Government area in which the site is situated. May be supported by a code.
Landranger Grid Reference May be only partially available eg XX, XX9 9 or XX9999.)
Site description details as accessibility of the site, proximity to other buildings etc.
Site Conditions Structured description of the site. Text specific to facets of the site.

Specification Codes

This information is available within BCIS but is omitted from this version of the schema for simplicity.

Contractual Information

Type of Contract standard description of the form of contract the project was let under.
Cost Fluctuations Code standard description of the fluctuation provisions in the contract documents.
Tender Documentation standard description of the documentation used to tender for a contract eg Bill of Quantities, Schedule of Rates.
Selection of Contractor standard description of the means by which the contractor was selected eg Open Competition, Serial Contract etc.
Client Type standard description of the type of client commissioning the work.
Client Name the name of the client commissioning the work.
Tender Amended whether the tender was adjusted prior to the preparation of the analysis.

Project Index

The tender price index derived from the project at the published base.

Index Base: the base of the project tender price index where available.

Tender List

Number of Tenders: Two figures giving the number of tenders issued and received.

Competitive Tenders: The tenders received.

Contract Period

Up to three contract periods: required by client; stipulated by the contractor; agreed (ie as contract). Default to months.

Contract Breakdown

Two versions of the contract breakdown are possible: contract figures and building (or buildings) analysed figures. The building analyses figures are only applicable if this is a complex contract.

Measured Work
Provisional Sums
Prime Cost Sums
Contract Sum

Average Storey Height

Basement The average storey height below ground in metre.
Ground floor The average height at ground level in metres
Upper floors The average storey height above ground floor level in metres.

Design Shape

Ten pairs of fields - a floor number and the percentage of gross floor area for different storey heights. A negative storey height indicates the number of basement floors.


The title and name of the client, consultant or contractor.


Level of Analysis indicates the maximum level of analysis available.

A - amplified analysis E -elemental analysis G - group elemental analysis T - total building figures Blank - no cost breakdown

Element Library Version which specifies the edition of the Standard Form of Cost Analysis which was used when preparing the analysis.

Basis of analysis - warn if the analysis is based on the final account.


Element Key

Total Element Cost Excluding Preliminaries

Total Element Cost Including Preliminaries

Element Unit Code - eg "m2" "No".

Element Unit Quantity

Included Elsewhere/Miscellaneous Other Costs a flag to indicate that the cost of this element has been included in another element or that the element has the cost of one or more other elements included in it.

Cross Reference Element Key: references the element to which this element has been added if appropriate.

Elemental Specification Text: Specification Text


Indices needed to adjust the pricing level of the analysis (rebase).

Return to analyses XML introduction.

Click this link to return to The BCIS Homepage

Revised 27-Jan-2015

© BCIS 2015

This information may not be republished without the written permission of BCIS.

The schema and supporting documents on this site are provided so that others can develop applications which make use of the schema and the material on this site can be used for that purpose provided that it is understood that BCIS cannot accept any responsibility for losses directly or indirectly resulting from such use.