Release History​

[1.23.0]​

Breaking Changes​

• None.

New Features​

• Add Sincal Timeseries feature, this allows users to exporter Sincal model embedded with loads.
• Added a functionality to view the affected customers for a selected trace from the Traces Info panel.

Enhancements​

• Can now enable Forecasts and Timeseries when exporting a Sincal model.

Fixes​

• Fix loadControlStartDate format issue, now Sincal Exporter time settings are sent to the backend as-is.
• Sincal exporter time settings are sent to the backend as-is. This is because user selected timestamp are assumed to in the timezone the physical network is in.
• Fixed an issue where the Power Factory Options modal would flash when saving or updating changes.
• Fix an issue where temporary modifications to the Default export preset were not included in the export request. Changes are now preserved during the current export session but reset when the side panel is collapsed or the model is exported.
• In the Work Packages page, sort criteria and sorted results are now preserved when users refresh the page or navigate back from other pages.
• Fix an issue when editing a Power Factory export options preset, where the Update button was only enabled when users were viewing the Forecast tab. The Update button will now be enabled as appropriate on any tab.
• Fix an issue where the Show Low Voltage toggle value would be reset when exporting a model quickly on first page load. The toggle value is now retained.
• Fix an issue where the Show Low Voltage toggle value was not preserved when switching presets in the Sincal Exporter. The toggle value is now retained and included in the exported configuration.
• Fixed an issue where the Power Factory “Request Information” popup in the results list didn’t show full details.
• Allow horizontal scrolling on the Work Packages page table to handle potential overflow caused by long data entries.
• In the Sincal Preset modal, the Update and Delete buttons are now disabled for users who either lack the DELETE or UPDATE permissions, or are not the creator of the selected preset.
• Improvements to off supply layer management:
  • When the OFF_SUPPLY network level is selected, off-supply or partially-off-supply assets from un-selected network levels will no longer show on the map.
  • When the OFF_SUPPLY network level is deselected, partially-off-supply assets from selected network levels will now show on the map.

Notes​

• None.

[1.22.0]​

Breaking Changes​

• Remove auth0 and self authentication methods.

New Features​

• None.

Enhancements​

• None.

Fixes​

• Fix an issue where users could click “Export Model” without selecting a network. An error message is now displayed when no network is selected.
• Fix Powerfactory export modal so that regenerating a model now applies forecast configuration if previously applied.
• Fix the Admin EWB network switcher where switching a network model would always show an error even on success

Notes​

• None.

Breaking Changes​

• Updated the version of network-map used internally, which now requires use of EAS/EWB v2 map tile routes.
• Show accurate source data date in the EWB models admin interface using new functionality available in EAS.
  • All related requests are now routed through EAS to support other admin backends
• Study functionality now requires the user permission STUDY:READ, STUDY:CREATE, STUDY:DELETE.

New Features​

• Added a new work package info page. In the Work Packages page, users can click the View Info button on a work package in the list to navigate to a dedicated page displaying detailed information about that specific work package. The page includes:
  • An editable name and description.
  • The config the package was created with.
  • A navigable ancestry of this and parent packages.
• Added new routes for different components of the app. The new routes are:
  • /profile/user-tokens - Create User Token page for generating personal access tokens.
  • /admin/machine-tokens - For admins to create machine tokens and listing all machine token users.
  • /admin/ewb-models - For admins to explore the EWB models.
• In the Work Packages page, added the ability to generate a Comparison between two work packages.
  • Includes dynamic suggestions for input fields (feeders, scenarios, years).
  • Displays additional fields for "Enhanced" type: time of year and time of day options.
  • Enhanced the Work Package Info page by adding a new section to display the list of diffs associated with the work package.
  • Added new "diffs" page, available at /diffs/:id, which provides detailed information about particular diffs.
• Added a new Network State control to the Layers overlay on the map. Network State control allows switching between viewing the normal and current state of the network.
  • Requires an updated Network Explorer and EWB servers to support the new APIs.
  • Requires enabling the ui.enableNetworkStateControl feature flag in Network Explorer config.
• Added a new Sincal Exporter Configuration tab in the Admin page. This sub-page allows viewing and changing the configuration files used by the Sincal Exporter within Network Explorer.
  • Viewing this page requires the user to have the SINCAL_GLOBAL_CONFIG:READ permission.
  • Updating the configuration files requires the user to have the SINCAL_GLOBAL_CONFIG:UPDATE permission.
• Added a new Hosting Capacity Configuration tab in the Admin page. This sub-page allows changing the configuration files used by Hosting Capacity within Network Explorer.
  • Viewing and using this page requires the user to have the HC_GLOBAL_CONFIG:UPDATE permission, and the server to have the ui.hostingCapacityConfigurationEnabled feature flag set to true.
• Added a new "Forecast" tab to export options in the Power Factory Exporter. The forecast tab allows exporting a feeder representing a future year, based on a provided forecast scenario.
• Added LV support to the Sincal Exporter. When Show Low Voltage is enabled in the sincal exporter, any selected LV Feeders will be included in the exported model.
• Added a new Unknown Assets layer type to the map. This layer highlights assets on the map that aren't identifiable as a known asset type. This is usually an issue with the network model's source data - meaning that ideally, this layer would highlight no assets. It can be useful for debugging issues with new network models.
• Added a new feature to navigate between connected equipment from a selected asset. Two new buttons in the asset info popup allow navigating.
  • Requires enabling the connectedEquipmentNavigationEnabled feature flag in the Ui config.

Enhancements​

• On the map, the layers control tab now no longer takes up the full height of the page when open.
• On the map, the search box is now wider and will not cut off search results that have long names.
• Improved error messages when things go wrong in the sincal exporter.
• Updated internal GraphQL libraries.
• offSupply and partiallyOffSupply busbars are now styled the same as offSupply/partiallyOffSupply AC line segments.
• Added a Poles option to the map search box. This searches for pole assets in the network.
• Asset names now remain in the search box after selection. Searches can now be refined easily.

Fixes​

• Fix config parser to when handling integer config values.
• Fixed a bug in the asset info panel where assets with only one terminal/phase did not show any "nominal phases".
• Fixed menu items in the page header not collapsing, which would leave content cut off the side of the page.
• Fixed the app always showing a "public" map when public access was not configured in the server. Users are now always redirected to login if no public access is configured.
• Fixed incorrect formatting of error message when uploading studies of an unsupported file format.
• Fixed the sincal exporter getting stuck loading when there was an error exporting a sincal model.
• Fixed the app not respecting the auth.useRefreshTokens option in config.json.
• Fixed authentication not being automatically refreshed after the app has been open for a long time. This meant the app would fail to load some resources until it was reloaded.
• Fixed existing asset highlights being removed when selecting >500 assets to be exported in the Power Factory and Sincal exporters.
• Fixed Admin page side menu not expanding or collapsing in large/narrow width windows.
• Fixed the app getting stuck in a logged-out state after being open for more than 24h. Users will not be re-authenticated correctly when required.

Notes​

• Corrected version numbers for Node.js and NPM in README.md.
• Removed the list of selected equipment mRIDs from the Sincal Exporter modal, since it was an unnecessary repeat of information and large lists made for a poor user experience.
• Removed the Distributed Energy Resources (DER) related functionality from the project.
• Upgraded UI Library to Antd V5.25.3

[1.21.0]​

Breaking Changes​

• Updated the version of network-map used internally, which now requires use of EAS/EWB v2 map tile routes.
• Show accurate source data date in the EWB models admin interface using new functionality available in EAS.
  • All related requests are now routed through EAS to support other admin backends
• Study functionality now requires the user permission STUDY:READ, STUDY:CREATE, STUDY:DELETE.

New Features​

• Added a new work package info page. In the Work Packages page, users can click the View Info button on a work package in the list to navigate to a dedicated page displaying detailed information about that specific work package. The page includes:
  • An editable name and description.
  • The config the package was created with.
  • A navigable ancestry of this and parent packages.
• Added new routes for different components of the app. The new routes are:
  • /profile/user-tokens - Create User Token page for generating personal access tokens.
  • /admin/machine-tokens - For admins to create machine tokens and listing all machine token users.
  • /admin/ewb-models - For admins to explore the EWB models.
• In the Work Packages page, added the ability to generate a Comparison between two work packages.
  • Includes dynamic suggestions for input fields (feeders, scenarios, years).
  • Displays additional fields for "Enhanced" type: time of year and time of day options.
  • Enhanced the Work Package Info page by adding a new section to display the list of diffs associated with the work package.
  • Added new "diffs" page, available at /diffs/:id, which provides detailed information about particular diffs.
• Added a new Network State control to the Layers overlay on the map. Network State control allows switching between viewing the normal and current state of the network.
  • Requires an updated Network Explorer and EWB servers to support the new APIs.
  • Requires enabling the ui.enableNetworkStateControl feature flag in Network Explorer config.
• Added a new Sincal Exporter Configuration tab in the Admin page. This sub-page allows viewing and changing the configuration files used by the Sincal Exporter within Network Explorer.
  • Viewing this page requires the user to have the SINCAL_GLOBAL_CONFIG:READ permission.
  • Updating the configuration files requires the user to have the SINCAL_GLOBAL_CONFIG:UPDATE permission.
• Added a new Hosting Capacity Configuration tab in the Admin page. This sub-page allows changing the configuration files used by Hosting Capacity within Network Explorer.
  • Viewing and using this page requires the user to have the HC_GLOBAL_CONFIG:UPDATE permission, and the server to have the ui.hostingCapacityConfigurationEnabled feature flag set to true.
• Added a new "Forecast" tab to export options in the Power Factory Exporter. The forecast tab allows exporting a feeder representing a future year, based on a provided forecast scenario.
• Added LV support to the Sincal Exporter. When Show Low Voltage is enabled in the sincal exporter, any selected LV Feeders will be included in the exported model.
• Added a new Unknown Assets layer type to the map. This layer highlights assets on the map that aren't identifiable as a known asset type. This is usually an issue with the network model's source data - meaning that ideally, this layer would highlight no assets. It can be useful for debugging issues with new network models.
• Added a new feature to navigate between connected equipment from a selected asset. Two new buttons in the asset info popup allow navigating.
  • Requires enabling the connectedEquipmentNavigationEnabled feature flag in the Ui config.

Enhancements​

• On the map, the layers control tab now no longer takes up the full height of the page when open.
• On the map, the search box is now wider and will not cut off search results that have long names.
• Improved error messages when things go wrong in the sincal exporter.
• Updated internal GraphQL libraries.
• offSupply and partiallyOffSupply busbars are now styled the same as offSupply/partiallyOffSupply AC line segments.
• Added a Poles option to the map search box. This searches for pole assets in the network.
• Asset names now remain in the search box after selection. Searches can now be refined easily.

Fixes​

• Fix config parser to when handling integer config values.
• Fixed a bug in the asset info panel where assets with only one terminal/phase did not show any "nominal phases".
• Fixed menu items in the page header not collapsing, which would leave content cut off the side of the page.
• Fixed the app always showing a "public" map when public access was not configured in the server. Users are now always redirected to login if no public access is configured.
• Fixed incorrect formatting of error message when uploading studies of an unsupported file format.
• Fixed the sincal exporter getting stuck loading when there was an error exporting a sincal model.
• Fixed the app not respecting the auth.useRefreshTokens option in config.json.
• Fixed authentication not being automatically refreshed after the app has been open for a long time. This meant the app would fail to load some resources until it was reloaded.
• Fixed existing asset highlights being removed when selecting >500 assets to be exported in the Power Factory and Sincal exporters.
• Fixed Admin page side menu not expanding or collapsing in large/narrow width windows.
• Fixed the app getting stuck in a logged-out state after being open for more than 24h. Users will not be re-authenticated correctly when required.

Notes​

• Corrected version numbers for Node.js and NPM in README.md.
• Removed the list of selected equipment mRIDs from the Sincal Exporter modal, since it was an unnecessary repeat of information and large lists made for a poor user experience.
• Removed the Distributed Energy Resources (DER) related functionality from the project.
• Upgraded UI Library to Antd V5.25.3

[1.20.0]​

Breaking Changes​

• Upgraded UI Library to Antd V5

• Switched to using day.js from Moment.js for date formatting and manipulation.

• UI will now fetch the authType from its own config, rather than EAS auth endpoint. The new config option is nested in auth and is called authType.

• Revamped the translation file to provide greater clarity on how translated strings are used and to support future "type safe" translations. If you have customised a translation, you will need to update it to match the new schema.

• Renamed all instances of "net model" to "power factory model":

  • NetModel → PowerFactoryModel
  • netModel → powerFactoryModel
  • net-model → power-factory-model
  • net_model → power_factory_model
  • NET_MODEL → POWER_FACTORY_MODEL
  • netmodel → powerfactorymodel

  This includes the URLs for downloading PowerFactory models and the GraphQL query/mutation identifiers.

• The Power Factory Exporter now allows selecting the Load Configuration method for the exported model (Spread max demand, Timeseries connection). The default value for new models, or existing models without an explicit setting, is Timeseries connection.

• The app can now run in a "public mode". This mode is enabled and configured in the EAS config (see EAS documentation). When public mode is enabled, users can load the map and view minimal assets (currently AC line segments and Opportunities (if enabled)). Users will no longer be redirected to login when loading the app. Users can manually login via the Login button in the top navbar.

New Features​

• Add support for logging in using Microsoft EntraID.
• Added a new Admin page, available at /admin, that allows managing the network models run by Energy Workbench server. This page will only be available for users with at least one of the following permissions: EWB:SWITCH, EWB:LOCK, EWB:UNLOCK.
• Added a new "About EWB" button to the header bar, that shows basic information about the currently running Energy Workbench network model.
• Added a new Metrics page, available at /metrics, that shows all metrics for the current network. This page will only be available for users with all of the following permissions: METRICS:READ.
• Added a new Optional Feature of "Sincal Exporter" which can be enabled by the Admin. This feature will allow users to export the network model to a Sincal file.
• Added Network Opportunities, a new layer type on the map. Network Opportunities are derived primarily from the constraints table of the hosting capacity module. To display Network Opportunities, the server config must have the ui.networkOpportunityAnalysisEnabled: true flag, and the user must have the OPPORTUNITIES:READ permission.
• Added new "Work Packages" page, available at /work-packages, which lists and provides information on all work packages. This page also includes pagination and a mechanism for running new comparisons between work packages.

Enhancements​

• Added support for designTemperature and designRating fields to the conductor asset information panel.
• Added support for using boundingBox in tracing queries and functions.
• Improved warning messages when unable to contact the EWB server, to suggest EWB may be reloading a new network model.

Fixes​

• Fixed the map being slightly tilted by default.
• Empty rows are now correctly hidden when "Hide Blank Fields" is enabled in the Feature Info side panel (when viewing info for a selected asset).
• Fixed issues with Tracing Functionality not working due to changes in the backend API.
• Fixed an issue where Tracing Panel Sidebar was not appearing when we have many trace results.
• Fixed an issue where the map is not zooming to the newly added trace.
• Fixed various translation errors.

Notes​

• None.

[1.19.0]​

Breaking Changes​

• None.

New Features​

• None.

Enhancements​

• None.

Fixes​

• None.

Notes​

• None.

[1.18.0]​

Breaking Changes​

• None.

New Features​

• None.

Enhancements​

• None.

Fixes​

• None.

Notes​

• None.

[1.3.0]​

• Initial release