Required attributes for the Cloud for Sustainability waste data model (preview)

Important

Some or all of this functionality is available as part of a preview release. The content and the functionality are subject to change.

This article provides information about the required attributes and rules for the Microsoft Cloud for Sustainability waste data model (preview).

Note

The July 2024 release introduced significant flexibility with the Cloud for Sustainability data model by making previously mandatory attributes optional and providing default values in some cases. We relaxed constraints on some required attributes where we determined their impact on data quality and stability to be insubstantial. For more information, go to Required attributes for the Cloud for Sustainability data model.

General rules

  • The Name value must always be unique.
  • The Origin Correlation ID value must be unique if specified. However, it isn't typically required.

Notation

The table that follows provides a partial list of the attributes in each entity. It includes only required attributes and attributes that influence the requirement of other attributes via logical dependency rules. The following notation is used in the Required? column:

Notation Meaning
Y Required
N Optional
<--<attribute> Required only if <attribute> is specified
Y | <attribute>... Required unless <attribute> is specified
Y <--<attribute> == <value> Required if <attribute> contains <value>

Entity/attribute rules

You can download a Microsoft Excel spreadsheet that lists entities and attributes for the Microsoft Cloud for Sustainability data model. For more information, go to Data model spreadsheet downloads.

This table lists additional attributes that are required based on the values in other attributes.

Entity Attribute Required?
Waste quality test result Description N
Unit <--Measured value
Waste quantity Cost N
Cost unit <--Cost
Waste volume unit <--Waste volume

Other constraints

Waste quantity diversion method

The value must be one of the values from the following enumeration:

  • Waste diverted from disposal by recovery
  • Waste directed to disposal
  • Others

Waste quantity diversion method subtype

The value must be one of the values from the following enumeration:

  • Recycling
  • Reuse
  • Incineration (with energy recovery)
  • Incineration (without energy recovery)
  • Landfilling
  • Other

Waste quantity waste diversion site type

The value must be one of the values from the following enumeration:

  • Onsite
  • Offsite

Article history

Date Description
July 23, 2024 Updated with a note about relaxed required attributes, first mentioned in Enter data more quickly with fewer required attributes in our release plan documentation.