v4.1.13

App Designer
Change Type
Description
Feature
New Blocks added:
​Azure Digital Twin Hierarchy - An interactive UI component that visualizes a large amount of time-oriented data. It allows the user to compare data at run-time based on asset ID by dropping markers on the chart, as well as panning and zooming, and can show or hide specific assets or parameters via the hierarchy panel.
​Image Map - allows you to render dynamic and static content onto an Image. You can drag on content such as indicators or text and these render on top of the image at runtime, at the specified coordinates.
A new Unity Block was added to support Unity 2020 and above. The previous Unity Block was renamed Unity (Legacy) and continues to support Unity 2019.
Feature
​Connector Logs allow the composer of an App, the developer writing a new Connector, or an Administrator to view messages generated by a Connector when it is in use as a Connection in an App.
Feature
Alerts for selected Recommendations can be added as markers to time series data:
​Azure Digital Twin Hierarchy​
​Time Series Chart​
Time Series Insights (Edit: subsequently deprecated)
Enhancement
A new property, Store User Selection, has been added to the Dropdown Grid and Select Box Blocks. Enable it to remember the user's selection when the page loads on these blocks that take more than one value.
Enhancement
Extend the Tree Grid with the following:
​Allow Drag & Drop is now independent of Allow Updating, so you can choose whether users can amend the hierarchy, the data, or both.
Added Hyperlink, Lookup, and Indicator column types
Added Store User Selection, to remember the user's selection when the page loads
Enhancement
​Format numeric output in the Data Grid and Tree Grid as currency or percentage.
Enhancement
Extend the Tab Block to allow for App page reuse with the new Hide Tab Navigation property
Enhancement
​Time Series Chart hierarchy selection pop-up widened to avoid truncating parameter names.
Enhancement
Consolidated Data Stream Connection mapping added the App Import to simplify moving Apps between environments.  
Enhancement
SVG file types are supported for all image properties. See here for a full list of supported image file types.
Enhancement
The current app page URL parameters (appId, appVersion, pageId, categoryId and categoryName) were added to the expression editor so that a back URL can be passed to a drill-down when using the Navigate To property. 
Enhancement
Renamed 'Open in New Window' to 'Open in New Tab/Window' under Navigate To property and expanded the documentation.   
Enhancement
Add a tooltip to the Text Block and the Fieldset Block's Field Label. This is useful to keep the text short and use a tooltip for longer descriptions.
The Fieldset's padding and margin now default to 0 (previously 20 and 30px). The styling is now consistent with other Blocks with the padding coming from the container e.g. Stacked Layout.
Enhancement
Extend the Map Block to overlay an image or Geo Json pattern on Google Maps.
Enhancement
The height of the Quick Expression Editor was increased from 1 to 4 lines and scrollbars were added too.
Enhancement
Added font-size support for relative css units vh and vw to the Typography option.
Fix
Recommendation Block not refreshing results when using dynamic Entity Id.
Implement auto refresh when using a dynamic Entity Id.
Fix
Unable to Navigate To URL from Chart Block.
Exposed Chart's Show Drilldown property. Enable this when using Actions such as Navigate To. 
Fix
Keyboard input is disabled at runtime after rendering Unity.
Follow this guide to prevent the keyboard input from being locked to the Unity model.
Fix
Time Series Chart fixes:
The timestamp dropdown doesn't scroll when there are more than 30 columns and can no longer be filtered with text.
The cause was 2 columns with the same name, but different capitalization. A Connector configuration now warns about case sensitivity and prevents duplicated column names. 
Clicking the Internal Size unit dropdown caused a logic dialog to open too
Only the unit dialog opens
When specifying many selections, the header does not wrap so not all of the series names are visible and long names are truncated.
A scrollbar has been added to the individual names as well as the chart header. 
The Pan & Zoom mode affects this panel only.
The displayed data now expands to fill space created by a compacted Pan & Zoom panel. 
Parameters are not passed when reading the max timestamp.
Parameters defined on the data source are now passed for both the min and max timestamps. 
A hidden chart (Visible is dynamically bound) makes an unexpected data call.
This affects all Blocks: the data source is now refreshed when the control becomes visible rather than on initialization.  
Fix
Tree Grid is stuck loading once expanded and several levels are clicked.
There may be a delay while the controls are refreshed, but the App will not freeze.  
Data Stream Designer
Change Type
Description
Enhancement
A visual indicator that a Data Stream has started successfully has been added to the Stream Metrics. In the past, you would've had to publish your Data Stream and wait for events in the Live View - or utilize a console Stream Host and view its log - as confirmation there were no errors when publishing.
Enhancement
The Agent single and bulk upload now prepopulates the Agent category - when specified in the .xmp file. 
The Agent upload process is now a single file per tier because the category is clear for Agent families like CSV and SQL.   
Fix
Cannot upload Tier 5 Agents
The Agent bulk upload file size was increased.
Fix
The Refresh button on the Logs blade clears the table but doesn't reload the logs.
The Refresh button reloads the logs. 
Subscription Manager
Change Type
Description
Enhancement
Optional functionality to sync the user's Business Role to a corresponding Azure AD Claim each time they log in. SSO using Azure AD is a pre-requisite.
Package Manager
Change Type
Description
Enhancement
You can run multiple instances of Package Manager at the same time. This side-by-side comparison is helpful when developing a new Agent or Connector that is similar to another or different versions of the same Agent. 
Enhancement
When packaging an Agent or Connector, you can opt to export the configuration as a JSON file too. This is useful either to compare packages or for source control and version management.
Enhancement
You can package the Agent's Category so that it is prepopulated when uploading to Data Stream Designer. The Agent name defaults to the preferred format [Category]_[Name]_v[Version].xmp
Fix
Package Manager crashes when adding a Group with no contents.
An empty Group type caused the issue and is now defaulted.
Fix
Package Manager crashes when adding an option to a Drop Down for a Connector.
Drop Down options can now be added to Connectors too.
Common
Change Type
Description
Enhancement
The App Designer and Data Stream Designer landing page styling has been refreshed, including labeling the category card statistics.
When selecting a category in App Designer, the Applications can be filtered by status and tag. Yes, you can now tag Applications too.
When selecting a category in Data Stream Designer, the Data Streams can be filtered by status, tag, and/or collection; and Stream Metrics can be switched on for those which are published.
Enhancement
The description text height on Application and Data Stream imports has been increased so that it can be read without scrolling. 
Fix
Special characters broke the Azure deployment script.
The Azure deployment script was updated to specify the few unsupported special characters for passwords.
Fix
Single Sign Out Issue when a user signs out of one company to switch to another company, the previous company name and categories were still visible in tabs open for other products.
Signing out of one product completely signs a user out of all products.
v4.1.13.1
Change Type
Description
Fix
​Optional properties were treated as required when adding or upgrading a Connector.
Optional properties behave as expected and don't require values.
Fix
The tab selection was not caching correctly on the first tab of a Tab Block. So another tab stayed selected, even after refreshing - or navigating away and returning to the App page.
The first tab would fail to cache, this has now been resolved.
Fix
Widening the Time Series Chart hierarchy selection pop-up in v4.1.13 - to avoid truncating parameter names - caused the list to shift out of view if a resource icon is clicked.
Reverted the hierarchy prompt to its original size, but made the size adjustable. You can now click on either the resource icon or name.
v4.1.13.2
Change Type
Description
Enhancement
The Beta tag indicates incremental functionality, added to prepare for a future feature.

For example, the factors added to Recommendations in preparation for a future Scoring enhancement.
Enhancement
The Time Series Chart now supports dynamic range and initial selection, which determines the starting date for the Pan & Zoom and the time interval that is initially selected.
Enhancement
Azure AD SSO now allows for Guest User access across tenants.
Fix
Data Source expressions were not available for selection in the Time Series Chart configuration.
Data stream expressions now appear correctly in the Time Series Chart.
Fix
Alerts were navigable without run access.
Restricted access to alerts for which the user does not have run access.
v4.1.13.3
Change Type
Description
Enhancement
Released an early access Database Migration tool for automating new database installs and upgrades.
Fix
Time Series Chart fix: the Initial Selection's Unit of Time was using hours when dynamic, despite being set as another option in the static value.
The Initial Selection's Unit of Time is correctly applied.
v4.1.13.4
XMPro has changed its product URLs. A redirect is in place for the sign-in page, but we recommend that you bookmark the new URLs for future reference:
​https://xmpro-sm.azurewebsites.net/​
​https://xmpro-ds.azurewebsites.net/​
​https://xmpro-ad.azurewebsites.net/​
Change Type
Description
Enhancement
​Hyperlink columns in a Data or Tree Grid now have the option to open in the same or a new tab/window.
We recommend opening XMPro URLs in the same tab/browser if the app design means it is likely a user will drill down into multiple tabs in a single sitting. A large number of XMPro tabs open at the same time is likely to cause performance-related issues.
Enhancement
The Time Series Chart's initial selection's unit of time is now a standalone property (here) for intuitive configuration.
Update
We've reduced our Linux-based Stream Host offering to support Ubuntu only, to increase our test coverage and ability to release often. 
Linux RHEL and Debian Stream Hosts are no longer supported. 
Fix
The detailed view of a Recommendation Alert - including its event data  - is visible to users with run access, whether it was accessed through manipulation of URL string parameters or not. An error message advising they do not have access is displayed.
Fix
The parent blade name (or menu item on primary blades) was used as the default tooltip in blades across all products.
Tooltips are only showing where intended.
v4.1.13.5
Change Type
Description
Fix
The Help blade across all products showed the major version i.e. 4.1.0.0.
The Help blade now shows the public release version e.g. 4.1.13.5.
Fix
An issue was introduced in 4.1.13.4, where Recommendation Category names were not editable. 
Recommendation Category names can be amended.

Change Type	Description
Feature	New Blocks added: Azure Digital Twin Hierarchy - An interactive UI component that visualizes a large amount of time-oriented data. It allows the user to compare data at run-time based on asset ID by dropping markers on the chart, as well as panning and zooming, and can show or hide specific assets or parameters via the hierarchy panel. Image Map - allows you to render dynamic and static content onto an Image. You can drag on content such as indicators or text and these render on top of the image at runtime, at the specified coordinates. A new Unity Block was added to support Unity 2020 and above. The previous Unity Block was renamed Unity (Legacy) and continues to support Unity 2019.
Feature	Connector Logs allow the composer of an App, the developer writing a new Connector, or an Administrator to view messages generated by a Connector when it is in use as a Connection in an App.
Feature	Alerts for selected Recommendations can be added as markers to time series data: Azure Digital Twin Hierarchy Time Series Chart Time Series Insights (Edit: subsequently deprecated)
Enhancement	A new property, Store User Selection, has been added to the Dropdown Grid and Select Box Blocks. Enable it to remember the user's selection when the page loads on these blocks that take more than one value.
Enhancement	Extend the Tree Grid with the following: Allow Drag & Drop is now independent of Allow Updating, so you can choose whether users can amend the hierarchy, the data, or both. Added Hyperlink, Lookup, and Indicator column types Added Store User Selection, to remember the user's selection when the page loads
Enhancement	Format numeric output in the Data Grid and Tree Grid as currency or percentage.
Enhancement	Extend the Tab Block to allow for App page reuse with the new Hide Tab Navigation property
Enhancement	Time Series Chart hierarchy selection pop-up widened to avoid truncating parameter names.
Enhancement	Consolidated Data Stream Connection mapping added the App Import to simplify moving Apps between environments.
Enhancement	SVG file types are supported for all image properties. See here for a full list of supported image file types.
Enhancement	The current app page URL parameters (appId, appVersion, pageId, categoryId and categoryName) were added to the expression editor so that a back URL can be passed to a drill-down when using the Navigate To property.
Enhancement	Renamed 'Open in New Window' to 'Open in New Tab/Window' under Navigate To property and expanded the documentation.
Enhancement	Add a tooltip to the Text Block and the Fieldset Block's Field Label. This is useful to keep the text short and use a tooltip for longer descriptions. The Fieldset's padding and margin now default to 0 (previously 20 and 30px). The styling is now consistent with other Blocks with the padding coming from the container e.g. Stacked Layout.
Enhancement	Extend the Map Block to overlay an image or Geo Json pattern on Google Maps.
Enhancement	The height of the Quick Expression Editor was increased from 1 to 4 lines and scrollbars were added too.
Enhancement	Added font-size support for relative css units vh and vw to the Typography option.
Fix	Recommendation Block not refreshing results when using dynamic Entity Id. Implement auto refresh when using a dynamic Entity Id.
Fix	Unable to Navigate To URL from Chart Block. Exposed Chart's Show Drilldown property. Enable this when using Actions such as Navigate To.
Fix	Keyboard input is disabled at runtime after rendering Unity. Follow this guide to prevent the keyboard input from being locked to the Unity model.
Fix	Time Series Chart fixes: The timestamp dropdown doesn't scroll when there are more than 30 columns and can no longer be filtered with text. The cause was 2 columns with the same name, but different capitalization. A Connector configuration now warns about case sensitivity and prevents duplicated column names. Clicking the Internal Size unit dropdown caused a logic dialog to open too Only the unit dialog opens When specifying many selections, the header does not wrap so not all of the series names are visible and long names are truncated. A scrollbar has been added to the individual names as well as the chart header. The Pan & Zoom mode affects this panel only. The displayed data now expands to fill space created by a compacted Pan & Zoom panel. Parameters are not passed when reading the max timestamp. Parameters defined on the data source are now passed for both the min and max timestamps. A hidden chart (Visible is dynamically bound) makes an unexpected data call. This affects all Blocks: the data source is now refreshed when the control becomes visible rather than on initialization.
Fix	Tree Grid is stuck loading once expanded and several levels are clicked. There may be a delay while the controls are refreshed, but the App will not freeze.

Change Type	Description
Enhancement	A visual indicator that a Data Stream has started successfully has been added to the Stream Metrics. In the past, you would've had to publish your Data Stream and wait for events in the Live View - or utilize a console Stream Host and view its log - as confirmation there were no errors when publishing.
Enhancement	The Agent single and bulk upload now prepopulates the Agent category - when specified in the .xmp file. The Agent upload process is now a single file per tier because the category is clear for Agent families like CSV and SQL.
Fix	Cannot upload Tier 5 Agents The Agent bulk upload file size was increased.
Fix	The Refresh button on the Logs blade clears the table but doesn't reload the logs. The Refresh button reloads the logs.

Change Type	Description
Enhancement	Optional functionality to sync the user's Business Role to a corresponding Azure AD Claim each time they log in. SSO using Azure AD is a pre-requisite.

Change Type	Description
Enhancement	You can run multiple instances of Package Manager at the same time. This side-by-side comparison is helpful when developing a new Agent or Connector that is similar to another or different versions of the same Agent.
Enhancement	When packaging an Agent or Connector, you can opt to export the configuration as a JSON file too. This is useful either to compare packages or for source control and version management.
Enhancement	You can package the Agent's Category so that it is prepopulated when uploading to Data Stream Designer. The Agent name defaults to the preferred format [Category]_[Name]_v[Version].xmp
Fix	Package Manager crashes when adding a Group with no contents. An empty Group type caused the issue and is now defaulted.
Fix	Package Manager crashes when adding an option to a Drop Down for a Connector. Drop Down options can now be added to Connectors too.

Change Type	Description
Enhancement	The App Designer and Data Stream Designer landing page styling has been refreshed, including labeling the category card statistics. When selecting a category in App Designer, the Applications can be filtered by status and tag. Yes, you can now tag Applications too. When selecting a category in Data Stream Designer, the Data Streams can be filtered by status, tag, and/or collection; and Stream Metrics can be switched on for those which are published.
Enhancement	The description text height on Application and Data Stream imports has been increased so that it can be read without scrolling.
Fix	Special characters broke the Azure deployment script. The Azure deployment script was updated to specify the few unsupported special characters for passwords.
Fix	Single Sign Out Issue when a user signs out of one company to switch to another company, the previous company name and categories were still visible in tabs open for other products. Signing out of one product completely signs a user out of all products.

Change Type	Description
Fix	Optional properties were treated as required when adding or upgrading a Connector. Optional properties behave as expected and don't require values.
Fix	The tab selection was not caching correctly on the first tab of a Tab Block. So another tab stayed selected, even after refreshing - or navigating away and returning to the App page. The first tab would fail to cache, this has now been resolved.
Fix	Widening the Time Series Chart hierarchy selection pop-up in v4.1.13 - to avoid truncating parameter names - caused the list to shift out of view if a resource icon is clicked. Reverted the hierarchy prompt to its original size, but made the size adjustable. You can now click on either the resource icon or name.

Change Type	Description
Enhancement	The Beta tag indicates incremental functionality, added to prepare for a future feature. For example, the factors added to Recommendations in preparation for a future Scoring enhancement.
Enhancement	The Time Series Chart now supports dynamic range and initial selection, which determines the starting date for the Pan & Zoom and the time interval that is initially selected.
Enhancement	Azure AD SSO now allows for Guest User access across tenants.
Fix	Data Source expressions were not available for selection in the Time Series Chart configuration. Data stream expressions now appear correctly in the Time Series Chart.
Fix	Alerts were navigable without run access. Restricted access to alerts for which the user does not have run access.

Change Type	Description
Enhancement	Released an early access Database Migration tool for automating new database installs and upgrades.
Fix	Time Series Chart fix: the Initial Selection's Unit of Time was using hours when dynamic, despite being set as another option in the static value. The Initial Selection's Unit of Time is correctly applied.

Change Type	Description
Enhancement	Hyperlink columns in a Data or Tree Grid now have the option to open in the same or a new tab/window. We recommend opening XMPro URLs in the same tab/browser if the app design means it is likely a user will drill down into multiple tabs in a single sitting. A large number of XMPro tabs open at the same time is likely to cause performance-related issues.
Enhancement	The Time Series Chart's initial selection's unit of time is now a standalone property (here) for intuitive configuration.
Update	We've reduced our Linux-based Stream Host offering to support Ubuntu only, to increase our test coverage and ability to release often. Linux RHEL and Debian Stream Hosts are no longer supported.
Fix	The detailed view of a Recommendation Alert - including its event data - is visible to users with run access, whether it was accessed through manipulation of URL string parameters or not. An error message advising they do not have access is displayed.
Fix	The parent blade name (or menu item on primary blades) was used as the default tooltip in blades across all products. Tooltips are only showing where intended.

Change Type	Description
Fix	The Help blade across all products showed the major version i.e. 4.1.0.0. The Help blade now shows the public release version e.g. 4.1.13.5.
Fix	An issue was introduced in 4.1.13.4, where Recommendation Category names were not editable. Recommendation Category names can be amended.

Last modified 18d ago