SustnUomConversion Metadata Type in SFDX

Architectural Overview#

The SustnUomConversion metadata type represents declarative unit of measure conversion rules within Salesforce Net Zero Cloud. Enterprise carbon accounting mandates standardized reporting in carbon dioxide equivalent (tCO2e), yet operational consumption data arrives in disparate regional units—such as liters, US gallons, Imperial gallons, therms, cubic meters, and kilowatt-hours across distinct fuel categories like diesel, natural gas, jet fuel, and biomass.

Architecturally, SustnUomConversion defines the multiplier (conversionFactor) that normalizes a source unit (sourceUom) into a target calculation unit (targetUom) for a designated fuelType. Packaging these conversion rules as metadata guarantees that environmental engineers and DevOps teams can deploy auditable conversion matrices across scratch orgs, sandboxes, and production environments, maintaining complete consistency for external ESG financial audits.

Directory and File Conventions#

In SFDX source projects, SustnUomConversion components are stored in the sustnUomConversions directory:

Key Metadata Fields#

The SustnUomConversion metadata type schema contains mathematical conversion rules and fuel classifications:

Declarative XML and Package Manifest Examples#

Below is a declarative SustnUomConversion defining the mathematical factor converting kilograms to liters for mobile diesel fuel:

<?xml version="1.0" encoding="UTF-8"?>
<SustnUomConversion xmlns="http://soap.sforce.com/2006/04/metadata">
    <fullName>Diesel_KG_to_Liters</fullName>
    <masterLabel>Diesel KG to Liters</masterLabel>
    <conversionFactor>1.19</conversionFactor>
    <fuelType>Diesel</fuelType>
    <sourceUom>kG</sourceUom>
    <targetUom>Liters</targetUom>
    <uomsKey>Diesel_kG_Liters</uomsKey>
    <isProtected>false</isProtected>
</SustnUomConversion>

Add the component to the package manifest:

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

Retrieval and Deployment#

Use Salesforce CLI commands to manage sustainability conversions:

# Retrieve all conversion components
sf project retrieve start --metadata "SustnUomConversion:*"

# Deploy specific conversion factor to Net Zero Cloud target org
sf project deploy start --metadata "SustnUomConversion:Diesel_KG_to_Liters" --target-org nzc-prod

# Query deployed conversion factors using Tooling API
sf data query --query "SELECT Id, DeveloperName, FuelType, ConversionFactor FROM SustnUomConversion" --use-tooling-api

Senior Architect Considerations#

1. Precision and Rounding: When defining conversionFactor values, maintain maximum decimal precision (up to 8 decimal places) to eliminate compounding rounding errors in high-volume utility bill calculations.
2. Bidirectional Rules: Conversion factors are directional (sourceUom to targetUom). If your business process records consumption in both directions, configure reciprocal conversion records explicitly.
3. Regulatory Auditing: Conversion coefficients are often mandated by regulatory bodies like the EPA or DEFRA. Document the official regulatory citations in your team’s Git commit messages when updating conversionFactor metadata.

Frequently asked questions

What is the role of SustnUomConversion in Net Zero Cloud?

SustnUomConversion specifies the mathematical conversion factor to translate fuel volumes and energy metrics from a source unit of measure to a target unit.

Which folder stores SustnUomConversion files in SFDX?

They are stored in force-app/main/default/sustnUomConversions with the .sustnUomConversion-meta.xml file extension.

What are the mandatory fields on SustnUomConversion?

The mandatory fields are conversionFactor, sourceUom, and targetUom, along with a masterLabel or fullName.

Does SustnUomConversion support wildcards in package manifests?

Yes, SustnUomConversion supports wildcard asterisk members in package.xml manifests.