This documentation supports the 20.08 version of BMC Helix Platform. 
To view an earlier version, select 20.02 from the Product version menu.

Foundation data library and data model

BMC Helix Platform Foundation library provides a Foundation Common Data Model (CDM), also referred to as Foundation data. The Foundation data model is a way for applications in BMC Helix Innovation Studio to represent common data elements, such as person, organization, location, categorization, and geography. The Foundation library uses out-of-the-box data elements along with the extended data elements to store Foundation data. Each data element is represented by a record definition in the Foundation library.

Foundation record definitions

Foundation data is the data created within the following record definitions and their extended record definitions:

Out-of-the-box record definitions

Extended record definitions


No extended record definitions

  • Primary Organization
  • Secondary Organization
    • Business Unit
    • Department
    • Support Group
  • Region
  • Site
  • Site Area
  • Operational category
  • Product category
  • Resolution category
  • Root Cause
  • Country
  • State/Province/District
  • City
  • Postal Code
  • Time Zones


You cannot delete the out-of-the-box data elements, the fields provided in the out-of-the-box data elements, and the out-of-the-box association definitions.

When to use the extended Foundation record definitions

The Foundation CDM consists of out-of-the-box record definitions and the extended record definitions that you can use to build your application. 

Best practice

BMC recommends that you use the extended record definitions that are provided in Foundation library.

You should only create an extended record definition for the following situations:

  • You cannot use a type value to further classify the out-of-the-box data elements. 
    Example: The Department record definition uses the Type field to distinguish between the business and support departments.
  • The new record definition has distinct attributes that cannot be shared with any out-of-the-box data elements. 
  • The data within the extended record definitions will not have to coexist with other extended record definition from the same base record definition.

You can create new record definitions or create new extended record definitions to suit your business needs. For more information, see Defining record definitions to store and manage data.

Related topic

Foundation data reference

Was this page helpful? Yes No Submitting... Thank you