FuelTypeSustnUom in SFDX

Architectural Overview#

FuelTypeSustnUom is an essential mathematical and operational metadata component within Salesforce Net Zero Cloud. Global enterprises manage real estate and manufacturing operations across dozens of countries, each utilizing disparate regional units of measure (UOM) for utility and energy reporting. For example, natural gas may be billed in therms in the United States, cubic meters in Germany, and megawatt-hours in the United Kingdom.

To calculate greenhouse gas emissions accurately, Net Zero Cloud must normalize these disparate raw consumption units into standardized scientific energy units—primarily gigajoules (GJ) or kilowatt-hours (kWh). FuelTypeSustnUom defines the conversion multipliers and standard unit mappings for each FuelType. Managing these mathematical constants via Salesforce DX guarantees transparent, auditable conversion factors across multinational ESG pipelines.

Directory and File Conventions#

In Salesforce DX source format (apiVersion 68.0), FuelTypeSustnUom metadata files are stored in the fuelTypeSustnUoms/ directory.

Key Metadata Fields#

The XML schema declares the conversion factors, target fuel types, and standard unit definitions:

Declarative XML and Package Manifest Examples#

Below is a declarative FuelTypeSustnUom converting US Therms of natural gas into Gigajoules:

<?xml version="1.0" encoding="UTF-8"?>
<FuelTypeSustnUom xmlns="http://soap.sforce.com/2006/04/metadata">
    <developerName>Natural_Gas_Therms_to_GJ</developerName>
    <masterLabel>Natural Gas Therms to Gigajoules</masterLabel>
    <fuelType>Natural_Gas</fuelType>
    <unitOfMeasure>Therms</unitOfMeasure>
    <conversionFactor>0.105506</conversionFactor>
    <standardUom>Gigajoules</standardUom>
</FuelTypeSustnUom>

Package Manifest (package.xml)#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>Natural_Gas_Therms_to_GJ</members>
        <name>FuelTypeSustnUom</name>
    </types>
    <version>68.0</version>
</Package>

CLI Retrieval and Deployment Commands#

Manage unit conversion metadata via the Salesforce CLI:

# Retrieve all fuel unit conversion records
sf project retrieve start --metadata FuelTypeSustnUom

# Deploy conversion mappings alongside parent fuel types
sf project deploy start --metadata FuelTypeSustnUom:Natural_Gas_Therms_to_GJ --metadata FuelType:Natural_Gas

Architect Best Practices and Gotchas#

• Strict Upstream Dependency: Deploying FuelTypeSustnUom without the referenced fuelType already existing or included in the same payload triggers a fatal metadata dependency failure.
• Conversion Factor Precision: Standardize conversion factors against international standards (such as GHG Protocol or IPCC guidelines) and document the source methodology in code review comments.
• Energy Balance Validation: Run automated validation tests in scratch orgs to verify that round-trip conversions (e.g., liters to gallons to gigajoules) do not introduce mathematical drift.

Frequently asked questions

What calculation role does FuelTypeSustnUom play in carbon accounting?

It normalizes raw utility billing units into standardized energy metrics such as gigajoules or megawatt-hours for uniform emissions calculations.

Can multiple UOM mappings be assigned to a single FuelType?

Yes. Different global operating facilities can report consumption in local units, which this metadata converts into uniform reporting standards.

What deployment dependency order must be followed for FuelTypeSustnUom?

The parent FuelType must be deployed in the same transaction or committed earlier in the target org to satisfy metadata referential constraints.