Skip to content
Stand with Ukraine flag

Custom Translation in Data Post-Processing

This recipe shows how to use custom translation keys in a data post-processing function of an Entities table widget. The i18n keys returned by the function are resolved to the user’s interface language.

  • A ThingsBoard PE instance with custom translation configured
  • A device sending temperature telemetry

Navigate to White labeling > Custom translation and add the following keys for the target language (e.g., German):

Term keyEnglishGermanDescription
custom.my-dashboard.titleMy DashboardMein DashboardDashboard title
custom.my-widget.telemetry-key.temperatureTemperatureTemperaturTelemetry key label
custom.my-widget.telemetry-value.rangeValue rangeWertebereichColumn header
custom.my-widget.telemetry-value.low-temperatureLow temperatureNiedrigtemperaturLow temperature
custom.my-widget.telemetry-value.high-temperatureHigh temperatureHochtemperaturHigh temperature
custom.my-widget.telemetry-value.normal-temperatureNormal temperatureNormaltemperaturNormal temperature
  1. Open the dashboard in edit mode and click Add widget.

  2. Select the Entities table widget from the Tables widgets bundle.

  3. Specify the device as the data source. Add three columns:

    • Name (default entity name column)
    • Temperature — telemetry key temperature, label: {i18n:custom.my-widget.telemetry-key.temperature}
    • Temperature range — telemetry key temperature, label: {i18n:custom.my-widget.telemetry-value.range}
  1. Open the configuration for the last column’s telemetry key.

  2. In the data post-processing function field, paste the following code:

if(value>=25){
return "{i18n:custom.my-widget.telemetry-value.high-temperature}";
}else if(value<=19){
return "{i18n:custom.my-widget.telemetry-value.low-temperature}";
}else{
return "{i18n:custom.my-widget.telemetry-value.normal-temperature}";
}
  1. Click Save, then Add the widget to the dashboard. Save the dashboard.

The “Temperature range” column value updates dynamically based on the incoming telemetry: