Author: Arjun

  • July 2025 Release Updates

    We’re excited to announce that the July 2025 Release of Takaunify is now live! This update brings several impactful enhancements, bug fixes, interface improvements, and backend optimizations to ensure smoother experiences across the platform. Here’s what’s new:

    🔄 Feature & Product EnhancementsAfbeeldingen over New Feature Icon – Blader in stockfoto's, vectoren en video's over 42,150 | Adobe Stock

    UBMS & Consumption Table Enhancements

    • New fields added to the Consumption table: solar meter ID, solar production, and fuel unit.
    • UTC offset added to both the consumption and meter export URLs to ensure timezone-aware reporting.
    • Export enhancements also apply to the Account Comparison Export, now including all available metadata.

    New Portfolio Report in Takaunify Reports

    • A new Portfolio Consumption Report has been introduced with the following features:
      • Dynamic fuel type and year selection
      • Executive summary generation in downloadable DOCX
      • Fuel mapping support with dropdown selection
      • Smart report inputs with improved payload formatting

    Project Edit Enhancements

    • A new Project Owner field is now available in the Edit Project screen.
      • This is especially useful in Fault Reports to assign responsibility and ownership of fault rectification and will be included in the Weekly Fault Reports.

    New Daily Fault Report in Takaunify Reports

    • The first version of the Daily Fault Report is now available under Takaunify Reports.

    • Users can select a project from a drop-down list and run reports for a Day, or a Pre-defined period (Today or Previous Day).

      • Today runs from the start of the day until the current time.

      • Previous Day covers the entire previous day.

      • Custom allows selecting a start date.

    • The report includes all faults with details such as equipment, Active time, current status, Duration, Mean time to Respond and more.

    • Weekly Fault Summary Reports will be introduced shortly, featuring a second table summarizing unique faults by equipment and number of occurrences.

    Solar Module Enhancements

    • A new dark theme toggle has been added to the Solar Plant Monitor.
    • Improved data visualizations:
      • Solar charts now plot null for missing database values instead of defaulting to zero.

    User Management & Roles

    • Users table now includes:
      • Email-based filtering
      • Active user counts per role
    • Role deletion is now restricted if users are still assigned.
    • Improved user-project access mapping logic and refactored role service queries.

    New Export & Reporting Enhancements

    • Chart and Table Exports across the platform have been upgraded:
      • Standardized export file names for consistency
      • All exports now include relevant metadata for deeper analysis
      • Filters applied to charts/tables are now reflected accurately in the export output
      • Special characters like commas in filters are now properly escaped in CSV
    • These upgrades are available on:
      • Project dashboards
      • OMV and Solar dashboards
      • Meter and Consumption tables
      • Account Comparison reports

    🔧 UI/UX & Dashboard Enhancements

    • Enhanced dark theme UI for:
      • Solar Plant Dashboard
      • OMV Dashboard
      • Date picker components
    • Chart and table export alignment and styling improvements
    • Performance section of dashboards now displays fuel units clearly
    • Tooltip updates and improved table rendering on Project Dashboard

    🚪 Bug Fixes

    • Fixed bug where unit labels (e.g., fuel unit) were not displaying correctly in performance sections.
    • Fixed tooltip positioning and readability in dark themes.
    • Corrected meter filtering by solar meter ID and status in Meters table.
    • Fixed export errors when commas existed in filter values.
    • Consumption table export logic corrected to ensure proper sorting and division of additional and other charges.
    • Addressed password field not being marked as “touched” on login submission.
    • DOCX export alignment and FDD rendering issues fixed.

    ⚙️ Backend & Performance Optimizations

    • Refactored consumption tables API to reduce payload size and improve performance
    • Updated export services with cleaner handling of filters, metadata, and dynamic mappings
    • Updated project access control: Regular users now lose company mapping if no projects are linked
    • Optimized Knex-based queries for improved role management
    • Enhanced validation and user feedback for missing/no-data responses in reports
    • Dockerfile and environment variable updates for better deployment hygiene & overall smoother experience

    🌐 Ready to Explore?

    Log in to your Takaunify portal and take advantage of these updates:

    • Use the new Portfolio Report to track fuel-type performance across the year
    • Explore the Daily Fault Report for real-time fault monitoring
    • Export smarter with metadata-rich downloads
    • Manage roles and projects more effectively
    • Switch to dark theme and enjoy the refreshed Solar Plant dashboard

    As always, we’re here to help! If you need support or want to learn more, visit the Taka Help Center or contact our team.

  • Portfolio Dashboard

    📁 Portfolio Dashboard – Full User Guide

    To access the Portfolio Dashboard, navigate to the left sidebar and click on ‘Portfolio’ under the Dashboards section.

    The dashboard includes four tabs:

    1. Consumption – Fuel Type Analysis
      Analyze energy consumption based on different fuel types.
    2. Cost – Financial Analytics
      Access and review financial data related to energy consumption.
    3. Heatmap – Meter-wise Consumption Visualization
      Visualize consumption data at the meter level through an interactive heatmap.
    4. Information – Project Details
      View detailed information about individual projects.

    To view the fuel-wise analysis, click on the Consumption tab.

    1. Consumption Analysis Tab

    -The Consumption Analysis page provides a comprehensive overview of energy usage across different areas, offering both monthly and yearly breakdowns by fuel type.

    -At the top of the page, individual cards summarize the total consumption for each fuel type, clearly labeled with the corresponding units.

    -A filter option is available for users to select a specific zone. Upon clicking ‘Apply’, the data updates accordingly to reflect the selected zone’s consumption details.

    -The year filter is located next to the zone filter, allowing you to change the year and view data from previous years as well

    Below the cards, you can view various detailed charts related to consumption analysis.

    -All values displayed on the cards represent Year-to-Date (YTD) data. The specific date range for the YTD calculation is revealed when you hover over the info icon located next to the statistic

    -The red and green arrows represent the previous year’s consumption values. The color logic is as follows: if the current year’s consumption is higher than the previous year’s, a red arrow is displayed   

    1.1 Monthly Consumption vs. Baseline
    This chart compares monthly consumption against predefined baseline values for each fuel type (e.g., electricity, water, chilled water).

    -This chart displays the total monthly consumption and baseline for each fuel type.

    -You can select different fuel types using the dropdown menu available within the chart.

    -A three-line menu icon is available beside the chart.
     Clicking this icon allows you to:

    • Print the chart 
    • Download it as a PNG image
    • Save it as a PDF document

                                                                 

    1.2 Annual Energy Use Intensity (EUI)
    Formula: EUI = Total Energy Consumption ÷ Total Area (kWh/m²). Data is sourced from electricity and chilled water values.

    This calculation follows the formula:

    – Electricity and Chilled Water represent the combined energy consumption values of  both. The Intensities Metadata values are available on the Information page

    -This chart displays the Energy Usage Intensity (EUI) on a yearly basis

    1.3 Monthly Energy Use Intensity (EUI)
    This chart provides a month-by-month EUI value. It reflects operational trends and variations using the same formula as above.

    This chart displays the monthly Energy Usage Intensity (EUI). Electricity and Chilled Water represent the combined energy consumption values, while the Intensities Metadata values can be found on the Information page

    -All created metadata are available in the dropdown on the side.

    1.4 Monthly Water Use Intensity (WUI)
    Formula: WUI = Total Water Consumption ÷ Total Area (IG/m²). This helps track consumption efficiency over time.

    This chart displays the monthly Water Usage Intensity (WUI). Water represent the Raw consumption values, while the Intensities Metadata values can be found on the Information page

    —     All created metadata are available in the dropdown on the side.

    1.5 Utility Consumption by Years
    This chart displays raw utility consumption data by fuel type, compared year-wise.

    This chart displays raw consumption values on a monthly basis for each year, along with the appropriate unit. If you change the unit, the values will update accordingly to reflect the selected unit For all Fuel Types

    A three-line menu icon is available beside the chart.
     Clicking this icon allows you to:

    • Print the chart
    • Download it as a PNG image
    • Save it as a PDF document

    1.6 Carbon Footprint vs. Baseline (TCO₂e)
    This chart shows total emissions per month compared to baseline. Emissions are calculated using official conversion factors.

    -This chart displays addition of carbon footprint vs Baseline of all fuel types for the particular  month 

    1.7 Energy and Water Intensity by Zone
    Shows both EUI (for electricity/chilled water) and WUI (for water), broken down by zone for benchmarking.

    This chart presents Energy Usage Intensity (EUI) segmented by zone. .Electricity and Chilled Water represent the combined energy consumption values, while the Intensities Metadata values can be found on the Information page 

    This chart displays the Water Usage Intensity (WUI)segmented by zone. Water represent the Raw consumption values, while the Intensities Metadata values can be found on the Information page

    1.8 Utility Consumption Share by Zone
    Displays the proportional share (%) of electricity consumption by each zone.

    It represents the percentage of electricity consumption by each zone, with the total  across all zones adding up to 100%.

    • Click on the ‘Cost & Finance’ tab, which is the second tab on the Portfolio page
    1. Cost and Finance Tab

    The Cost/Finance page provides a comprehensive overview of Total utility cost across different areas, offering both monthly and yearly breakdowns by fuel type.

    -At the top of the page, individual cards summarize the total utility cost for each fuel type, clearly labeled with the corresponding units.

    -A filter option is available for users to select a specific zone. Upon clicking ‘Apply’, the data updates accordingly to reflect the selected zone’s consumption details.

    Below the cards, you can view various detailed charts related to consumption analysis.

    All values displayed on the cards represent Year-to-Date (YTD) data. The specific date range for the YTD calculation is revealed when you hover over the info icon located next to the statistic  

    2.1 Monthly Cost vs. Baseline
    Compares actual monthly utility cost with planned baseline values for each fuel type.

    -This chart displays the total monthly cost and baseline for each fuel type.

    -You can select different fuel types using the dropdown menu available within the chart.

    -A three-line menu icon is available beside the chart.
     Clicking this icon allows you to:

    • Print the chart
    • Download it as a PNG image
    • Save it as a PDF document

    2.2 Annual Energy Cost Intensity (AED/m²)
    Formula: Total Utility Cost ÷ Total Area. Helps assess energy cost efficiency.

    –Electricity and Chilled Water represent the combined Total Utility cost values of  both. The Intensities Metadata values are available on the Information page

    -This chart displays the Energy Usage Intensity (EUI) on a yearly basis

    -The WUI (Water Use Intensity) is calculated using the total utility cost of water. The relevant metadata can be obtained from the Information page

    2.3 Monthly Energy Cost Intensity (AED/m²)
    Charts monthly trends in energy cost per square meter.

    -This chart displays the monthly Energy Usage Intensity (EUI). Electricity and Chilled Water represent the combined Total utility cost values, while the Intensities Metadata values can be found on the Information page

    -All created metadata are available in the dropdown on the side.

    2.4 Monthly Water Cost Intensity (AED/m²)
    Displays how water utility costs evolve over time.

    This chart displays the monthly Water Usage Intensity (WUI). Water represent the Total Utility cost values, while the Intensities Metadata values can be found on the Information page

    —   All created metadata are available in the dropdown on the side.

    2.5 Utility Cost by Year
    Illustrates monthly cost data year-wise for every utility/fuel type.

    This chart displays Total utility cost values on a monthly basis for each year, along with the appropriate unit. If you change the unit, the values will update accordingly to reflect the selected unit For all Fuel Types

    A three-line menu icon is available beside the chart.
     Clicking this icon allows you to:

    • Print the chart
    • Download it as a PNG image
    • Save it as a PDF document

    1.6 Carbon Footprint vs. Baseline (TCO₂e)
    This chart shows total emissions per month compared to baseline. Emissions are calculated using official conversion factors.

    This chart displays addition of carbon footprint vs Baseline of all fuel types for the particular  month 

    1.7 Energy and Water Intensity by Zone
    Shows both EUI (for electricity/chilled water) and WUI (for water), broken down by zone for benchmarking.

    This chart presents Energy Usage Intensity (EUI) segmented by zone. .Electricity and Chilled Water represent the combined total utility cost values, while the Intensities Metadata values can be found on the Information page 

    This chart displays the Water Usage Intensity (WUI)segmented by zone. Water represent the total utility cost values, while the Intensities Metadata values can be found on the Information page

    2.8 Zone-Wise Utility Cost Share (%)
    Shows each zone’s contribution to overall electricity cost.

    It represents the percentage of electricity cost by each zone, with the total  across all zones adding up to 100%.

    Click on the ‘Budget’ tab, which is the Third tab on the Portfolio page

    This page displays the budget allocated for each fuel type for a specific month of   the current year

    At the top of the page, individual cards summarize the total utility cost for each fuel type, clearly labeled with the corresponding units.

    -For example, the ‘Utility Total Cost’ represents the combined total utility cost across all fuel types, including Water, Chilled Water, and Electricity

    3.1 Year-to-Date Utility Costs vs Budget
    Displays actual utility spending vs. planned budgets with forecasted trends if enabled.

    -This chart displays the Total Budget, Cumulative Cost, and Forecast Cumulative Cost  all based on the Total Utility Cost for a specific fuel type

    -There is a Forecast toggle button. When enabled, the chart displays the Forecasted Cumulative Cost for a particular fuel type. For example, selecting March will show the cumulative total utility cost from January through March (i.e., January + February + March)

    -A three-line menu icon is available beside the chart.
     Clicking this icon allows you to:

    • Print the chart
    • Download it as a PNG image
    • Save it as a PDF document

    Click on the ‘Information’’ tab, which is the Fourth tab on the Portfolio page

    – First click on Utility to see below information

    -The Information page provides details on total energy consumption value for a selected year and fuel type, along with baseline comparisons.

    • For the current year, the data is based on a Year-to-Date (YTD) date range.
    • For all previous years, the data reflects the full calendar year

                All created intensities metadata are display on information page 

    Below the consumption section, the cost details are displayed. It shows the Total Utility Cost for the selected year and fuel type, along with a baseline comparison.

    • For the current year, the data is based on a Year-to-Date (YTD) date range.
    • For all previous years, the data reflects the full calendar year

     -All intensity metadata saved for a particular zone below the cost section is displayed along with the appropriate units for the respective year

    -After utility whatever metadata are saved that all are displayed on information with autocalculation for particular year of particular fuel type

    -These metadata values are used to calculate all EUI/WUI charts

    When you click on the first intensity metadata, all values including consumption and cost are updated accordingly. For the consumption calculation, the energy consumption value is used, while the cost calculation uses the total utility amount for the selected fuel type. The intensity metadata is retrieved from the metadata ch

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.

  • April 2025 HotFix Updates

    🔧 Enhancements

    1. Dashboard Intensity Metadata Panel Update
    • (TTD-1420): Refactored the dashboard side panel to display intensity metadata by year. A new section called “Metadata Intensities” is now live on Portfolio, Zone, and Project Dashboards.

    • Current year + last 5 years’ intensity values now display clearly per utility/fuel type.

    • Removed old “Area” tab from Edit Project and replaced it with a clean metadata approach.

    2. Building Intensity Metadata View Improvements
    • (TTD-1438): Enhanced the layout for the Building Intensity Meta View, and added red warning indicators where values are missing.

    • A new prompt now reminds users to enter values for all added intensities and years, preventing calculation errors.

    3. Chilled Water and Demand Charge Chart Update
    • (TTD-1446): The Utility Cost by Year chart now reflects Demand Charges only in the actual billed months (usually quarterly), rather than distributing them evenly. This ensures more accurate financial visibility.


    🐞 Bug Fixes

    1. Incorrect Unit Display & Value Overwrites
    • (TTD-1448): Fixed an issue where intensity metadata value updates for one year (e.g., 2025) were incorrectly applied to all years.

    • Also corrected unit display on dashboards (e.g., ft² now appears correctly) and removed redundant logic for “closest year” value extraction.

    2. Fuel Conversion Logic Error
    • (TTD-1449): Fixed an issue in Project baseline, fuel consumption was not converting correctly to organizational fuel units.

    3. Export Error for Consumption Table
    • (TTD-1444): Fixed a network error occurring when using Export All on the Consumption table without filters. Files now download completely without interruption.


    ⚙️ Performance & Stability Improvements

    1. Backend Refactor for Dashboard Sidebar
    • (TTD-1420): Reworked the fuel type value extraction process and ID filter keys used for retrieving building intensities. This backend refactor improves loading accuracy and system responsiveness.

    2. Removed Redundant Calculations
    • (TTD-1448): Streamlined backend calculations by removing unnecessary logic across intensity and dashboard panels. Reduces overhead and enhances consistency.

  • March 2025 Release Updates

     NEW FEATURES Afbeeldingen over New Feature Icon – Blader in stockfoto's, vectoren en video's over 42,150 | Adobe Stock

    🔁 Updated Dashboards for Deeper Insights

    (Portfolio, Zone, Project & Executive Dashboards)

    We’ve rolled out a powerful update to your dashboards, designed to give you smarter insights and year-over-year comparisons that matter. Whether you’re managing a portfolio, overseeing zones, or drilling down into project-level performance, the new views help you track energy and water efficiency like never before.


    📊 Portfolio Dashboard – Holistic Utility Tracking

    The Portfolio Dashboard now comes with four intuitive tabs:

    • Consumption Analysis

    • Cost & Finance

    • Budget

    • Information

    Portfolio_Dashboard

    Key Highlights:

    • Monthly & Annual Performance: Stats are auto-compared with the same period in the previous year (Year-To-Date).

    • Usage Intensity: Focuses on Electricity and Water usage intensity based on selected metadata (e.g., area, occupancy).

    • Customizable Year Start: By default, the year runs January–December, but you can adjust your organization’s fiscal year start month in Organization Settings.

    • Smart Baselines: Baselines reflect your project-defined baseline period.

    • Visual Performance Indicators:

      • 🟢 Green arrow = improved performance

      • 🔴 Red arrow = deteriorated performance

    • Metadata Matters:

      • Ensure you’ve entered annual metadata values (e.g., sqft, hours, occupancy) in Project Settings.

      • These values drive accurate intensity calculations.

    • Cost & Finance Tab: Mirrors your consumption but shows cost in your local currency (default is AED).

    • Budget Tab:

      • Compare YTD utility spend vs. annual budget.

      • Use the Forecast Toggle to project end-of-year performance.

    • Information Tab:

      • Opens a sidebar with a tabular view of YTD and past 2 years for consumption, cost, and metadata—compared to your baseline.


    🗺️ Zone Dashboard – Visualize Utility Patterns

    Everything you love from the Portfolio Dashboard, now available by Zone—plus a powerful new tab:

    🔥 Heatmap Tab:

    • Visualize Monthly Data for all meters in the zone.

    • Color gradient:

      • 🟩 Green = minimum usage

      • 🟥 Red = maximum usage

      • ⬜ White = no data uploaded for that month

    • Instantly spot data gaps and performance extremes.

    • Filter your Heatmap by:

      • Fuel Type (Electricity, Water, etc.)

      • Project


    🧪 Project Dashboard – Granular + Realtime Analysis

    Like the Zone Dashboard, but tailored to individual projects—with two exclusive features:

    ⚡ Realtime Tab:

    • Dive into live data and billing reconciliation

    • Helps you monitor consumption as it happens.

    Learn more in the Realtime Dashboard Help Guide                                              (Stay tuned! a complete Help Guide will be launched soon!)

    📐 M&V Tab:

    • Visible for projects with Option C M&V enabled.

    • Review Measurement & Verification performance and savings.

    Full details in the M&V Dashboard Help Guide 

    (Stay tuned! a complete Help Guide will be launched soon!)


    👔 Executive Dashboard – High-Level Insights at a Glance

    Designed for leadership and decision-makers, the Executive Dashboard offers quick, strategic insights into your portfolio’s performance. It includes two powerful tabs:

    📈 Consumption Overview

    Get a bird’s-eye view of your entire portfolio’s utility performance across:

    • Electricity

    • Water

    • Chilled Water

    • Carbon Emissions

    • Budget

    See year-over-year savings or increases (%) at a glance.
    Easily switch between years and filter by zone to pinpoint areas of improvement or success across the organization.

    💸 Cost Card View

    Dive deeper into cost performance with a clean, card-style layout.
    Quickly assess how each utility is performing financially, helping you identify where action is needed and where you’re on track.

    With the Executive Dashboard, management can make data-backed decisions, faster—without needing to dig through multiple tabs.


    🔍 Need Help?
    Don’t forget to check your Organization Settings and Project Settings to make sure all metadata is up to date—this powers the insights you see on the dashboards!

  • Developer Documentation

    Built for technical teams:

    • 📡 API Reference and Authentication

    • 🔄 Data Integration Guides

    • 💡 Custom Script Examples

    • 📚 Webhooks, Callbacks, and Data Endpoints

  • Fixes & Improvements

    🛠️ Fixes & Improvements

    Stay updated with:

    • 🐞 Latest bug fixes and resolved issues

    • 🌟 Feature enhancements and UI updates

    • ⚙️ Performance and backend stability changes

    Every monthly release is documented with clear labels for bug, enhancement, and system-level improvements.

    April 2025 HotFix Updates

    March 2025 Release Updates

  • Platform Guides

    In-depth documentation on how to:

    • 🔄 Upload Data: via CSV or manual input

    • 🧠 Configure CO2 Emissions and ECI charts

    • 📤 Automate Data Imports and Alerts

    • 📊 Use Analysis Tools and Custom Reports

    This section grows with each release and user feedback!

  • Dashboards

    Explore interactive dashboards across all levels:

    • 📁 Portfolio Dashboard

      • Dive into Consumption, Cost, Heatmap, Information, and Budget views

      • Includes EUI/WUI (monthly and yearly), Carbon Footprint trends, and Zone-wise breakdowns

    • 🌍 Zone Dashboard

      • Analyze zone-level performance by fuel type, including heatmaps and utility intensity charts

      • Forecast budgets and track actual vs. planned costs

    • 🏢 Project Dashboard

      • Deep dive into building-level performance

      • Monthly/Yearly views of Energy & Water consumption, cost, carbon intensity, and baseline comparisons

    • 📘 Executive Dashboard

      • Compare Year-on-Year utility consumption across your portfolio

      • View Electricity Usage Intensity, Monthly Consumption vs. Baseline, and summarized Cost Cards

    • 📊 Solar Plant Dashboard

      • The solar plant dashboard shows uploaded production data with zone-wise and plant-wise generation, facility consumption, and a data grid

      • Includes summary cards for Solar Production, Consumption, Accumulated Credits, and Estimated Savings

    • ⚡Consumption Table
      • Displays all UBMS data captured from uploaded invoices

      • including detailed consumption metrics per utility provide

    All dashboards support filtering, downloading, and interactive analytics 🖥️📉

  • Project Setup

    Structure your energy management hierarchy:

    • 🗂️ Create Portfolios, Zones, Projects, and Buildings

    • 🔌 Add and map utility meters to buildings

    • 📎 Tag equipment and assign fuel types

    • 📈 Define baselines and configure intensity metadata for reporting