We have rolled out another release for 2022—it will be our final large release for the 6.x series (6.3.5, 6.3.6+ are expected to be much smaller) as we shift our efforts toward v7.0.
6.3.4 focuses on extending the capabilities of the content Import/Export Utility, Portal Pages (both UI and functional changes), and Publishing Workflows (now even easier to use and configure).
We've kept improving Glossary (released in 6.3.3), both from the UI and functional perspective. Aside from introducing three new Plugins, TIBCO WebFOCUS, Microsoft SharePoint Server 2019, and Amazon QuickSight, we have also been working on our major existing ones, such as MicroStrategy, IBM Cognos, and Tableau. Keep reading to learn more.
Major Features in 6.3.4 (released August 1, 2022)
- The main change for the Import/Export Utility is the extended list of supported objects. We have added Groups, Business Units, Dimensions, and Privilege Sets. Some of the new dependent objects can now be migrated too.
- Both Portal Pages and Portal Page Templates Editors have been optimized UI-wise to bring about better usability. A new Version Identifier provides more details about the Page, such as Page version and change history.
- Power Users can now be granted access to Publishing Workflows in a more straightforward way. We have improved the look and feel of related Editors overall.
- TIBCO WebFOCUS, along with SharePoint Server 2019 and Amazon QuickSight, has been included to the list of Metric Insights Plugins.
- Object Prompts is another type of the supported Prompts in MicroStrategy.
- The default system language can be set on a Group level via the Group Editor, while for the newly-added Groups there is the new System Variable, SYSTEM_LANGUAGE_DEFAULT, that sets the default language for them automatically.
- Custom Attributes have been added to support User and Group attributes' synchronization from different identity management systems.
The primary Docker images used for standard deployments are:
- web – docker.metricinsights.com/metric-insights/release_6_3/189
- dataprocessor – docker.metricinsights.com/dataprocessor/release_6_3/24
- seed – docker.metricinsights.com/seed/release_6_3/13
- data-analyzer – docker.metricinsights.com/data-analyzer/release_6_3/47
- monitoring – docker.metricinsights.com/monitoring/release_6_3/43
Optional images:
- logger – docker.metricinsights.com/logger/release_6_3/44
- mysql – docker.metricinsights.com/mysql:release_6_3
Major Fixes in 6.3.4a (released August 12, 2022)
We dedicated this release to fixing bugs and inconsistencies:
- Microsoft has changed “Name” to “name” for Power BI Report tabs/pages in the API call return, which created a discrepancy because Metric Insights used to explicitly parse for “Name”. In light of this recent change by Microsoft, starting this release, Metric Insights will be parsing for both “Name” and “name”.
- Power BI embedding issues that were occurring due to the improper operation of the intermediary page have been fixed.
- We have addressed incorrect Portal Page Template Tag mapping affecting a Template and its Portal Pages on a target system that were not involved in migration.
The primary Docker images used for standard deployments are:
- web – docker.metricinsights.com/metric-insights/release_6_3/191
- dataprocessor – docker.metricinsights.com/dataprocessor/release_6_3/25
- seed – docker.metricinsights.com/seed/release_6_3/14
- data-analyzer – docker.metricinsights.com/data-analyzer/release_6_3/47
- monitoring – docker.metricinsights.com/monitoring/release_6_3/43
Optional images:
- logger – docker.metricinsights.com/logger/release_6_3/44
- mysql – docker.metricinsights.com/mysql:release_6_3
Publishing Workflows
- In the Workflow Stage Editor, Fields that are not selected as those that will be involved in a Stage will no longer be displayed in the short Editor on the Publishing Board. This will help avoid creating clutter.
- When a Group is assigned to a Publishing Workflow Stage, the Group’s Power Users are granted View Access to the Publishing Workflow associated with the selected Stage and can access the Stage via the Publishing Workflow Board.
- From now on, the Name and Category Fields are always required when editing a Stage, with no possibility to leave them blank if they are configured to be editable.
- There is a new Folder Selection control in short Element Editors, which reduces the number of clicks to select a Folder.
Glossary
- Glossary Terms are now available for Datasets. The feature has also been added to the Dataset Bulk Editor.
- The Glossary Section Editor includes a new “+ New Term” button on the Terms tab that allows for a direct creation of a new Term related to the Section being edited.
- To avoid confusion, all term references are expressed as "Section Name: Term Name" since Term Names are not required to be unique among all sections.
- The system can now remember what view, Expanded or Condensed, the User last used on the Glossary List page.
- For consistency purposes, we have made some text changes in the Glossary, Glossary Auto
- The new System Variable, SYSTEM_LANGUAGE_DEFAULT, sets the default language for new Groups, which is English. New Users, in turn, will pick up whatever has been configured via “New User Defaults”. At the same time, there is now a possibility to set a default language for each specific Group via the Group Editor.
Custom Attributes
- There is a new Editor to be used to add Custom User or Group Attributes, which is available from the Admin page under the Users & Groups section of Administration. Custom Attribute Values are limited to 1000 characters.
- The Name of the Attribute must exactly match the Metric Insights' Group's Name in order to be able to configure it in OKTA sync.
- In User Editor and Group Editors, there is now a new Custom User Attributes section on the Info tab.
- Tables are populated by: - 
mi-ldap-usersyncormi-okta-usersync
- Related API
 
- 
- We have implemented a mapping between External ID and the corresponding field in the ldap/okta/o365 usersyncscript to order to apply the correct value to the Custom Attribute.
- Custom Attributes are synchronized upon user login.
Plugin Improvements
MicroStrategy
- MicroStrategy Plugin now supports Object Prompts.
- There is a new Optional Parameters in MicroStrategy, Intelligence Server, which allows for specifying the iServer value.
- Previously collected as one type of object, Dossiers and Documents are now distinguished by MicroStrategy Plugin as separate ones.
- Beginning in this version, MicroStrategy objects will be using one universal URL template. This change won’t affect earlier versions of Metric Insights.
Microsoft Power BI
- The External Report Type Editor for Power BI now includes a setting that controls if the Action Bar will be displayed for embedding in Metric Insights.
- We have implemented the ability to refresh the External Report Viewer based on actual Power BI token expiration time, but not every 30 minutes as in earlier versions.
Tableau
- When collecting objects, Tableau Plugin skips objects from Personal Spaces.
- Users will be seeing warning messages while working with the Plugin in case they are using http URLs.
- By default, Tableau Server URL Template will be used when creating new External Reports.
New Plugins
- Metric Insights’ list of Plugins have been expanded with TIBCO WebFOCUS Plugin. The Plugin supports creating External Reports.
- We have created a new SharePoint Plugin, SharePoint 2019, that can connect to SharePoint 2019 Server to pull data and create External Content from it.
- The new Amazon QuickSight Plugin also provides the ability to create External Reports.
Other Plugin Improvements
- Both Microsoft SharePoint Plugin and Microsoft SharePoint Server 2019 can create Datasets from Excel Workbooks. The data will be pulled from the first sheet of the selected Workbook.
- IBM Cognos Plugin can filter objects by both Packages and Folders by using a single Parameter, Folder Filter. A user needs to specify the full name of a Package or Folder.
- There is now a separate IBM Cognos URL Template for clustered servers.
- The QlikView Plugin version can be found in logs.
- Metric Insights displays an extended error message in UI when a user does not have the required permissions to get the objects list for Dropbox Paper Plugin.
JDBC Drivers
SAP HANA JDBC driver has been added to Metric Insights.
Security
We have enabled Regular User "Use Access" to User Maps when access is performed from a Portal Page via our API. On the Sharing tab of the Portal Page Editor, the user must be added and also user must be in the User Map itself. If these conditions are satisfied, the Regular User is able to view the Portal Page's information about User Maps.
Bursts
- There is a new grid on the Subscription tab of the Burst Editor that lists Users who unsubscribed from receiving a Bursts. As long as a User is listed there, they won’t receive this Burst.
- We have expanded logging to show when a User is subscribed/unsubscribed from a Burst.
Access Request and Discoverability
- Other External Content, Metrics, Multi-Metrics, and Dataset Reports can now be set to be discoverable to users without access. The setting is under the Content Access section on the Advanced tab of the corresponding Editor.
- A new Config Variable, RESTRICT_DISCOVERABLE_CONTENT, allows for restriction of Discoverable content via the Category Editor. If enabled and configured correspondingly in the Category Editor, only Groups listed in the Category Editor will be able to see discoverable content for that Category.
Folders
- Editing of child Folders from the Homepage is no longer available. The edit gear has been removed to avoid confusion.
- There is a new section in Element Editors on the Associations tab, Folders, that lists Folders that include this Element and with how many users it is shared.
- Deleted Folders can now be restored by Admins from <hostname>/admin/foldertrash.
- We have improved the current Folder update logic to achieve better performance on high-volume instances.
Homepage
- Homepage Tiles can be grouped by "Content Last Updated" which can be helpful if there are numerous file-based Elements created from Microsoft SharePoint and Local Filesystem. For grouping, Metric Insights will rely on the “File Last Modified” timestamp.
- On Tile Hover and Tile Preview, Tags, Glossary Terms, and Custom Fields can display a tooltip with their full name. This can come in handy for long ones.
API
- Tokens from Microsoft Power BI Cloud can be received using a new endpoint api/data_source_pluginin the API toolkit.
- Elements from Favorites can be accessed, updated or deleted using two new API endpoints:- 
<MI hostname>/api/favorite_element/- returns all Favorites
- 
<MI hostname>/api/favorite/id/<Favorite element ID>- returns an element from Favorites by ID
 
- 
- A response from API endpoint <MI hostname>/api/external_report/id/<Element ID>now includesdata_last_refreshedparameter containing information about last element refresh.
- Tile information can be accessed via API using two new methods:- 
MI.PortalPageView.openPreview(info_id)renders a preview of a tile with ID =info_id
- 
MI.PortalPageView.buildElementInfoPopup(info_id)returns the HTML of tile info for a tile with ID =info_id
 
- 
DevOps & Installation
- Ubuntu 22.04 LTS is supported by Metric Insights installer.
- Custom user and group attributes can be synced from Okta via mi-okta-usersyncscript. Corresponding Custom Attributes must be created in MI where External ID matches the attribute's variable name in Okta. Three new parameters have been added to the installer:- 
--custom-user-attribute: provide a comma-separated list of custom attributes for user sync
- 
--custom-group-attribute: provide a comma-separated list of custom attributes for group sync
- 
--map-attr-to-group: provide a user attribute. Each User who has this attribute is put into a Group whose name exactly matches this attribute's value. If the Group does not exist in MI, use the--auto-create allparameter to create it. Note:--map-attr-to-groupcannot be used with--target-groupparameter
 
- 
- ECS infrastructure is now flexibly autoscaled by ECS capacity providers.
- Users from subgroups can be synced via  mi-o365-usersyncby providing the--process-child-groupsparameter.
- Two new parameters  --remove-orphansand--disable-orphanshave been added tomi-ldap-usersync provisionscript to remove or disable users that are not attached to any LDAP group.
- Metric Insights can now be deployed on Google Kubernetes Engine.
- Bash history now displays date and time for each executed command.
- The Patcher can be used to install features that expand MI functionality. To apply a feature put it into the /opt/mi/featuresdirectory and restart the container. The logs are stored in/opt/mi/log/features.log.
Other Improvements
- If there are Filter Defaults set for a Report and Sticky Filters are also enabled, the system will respect both, with the Filter Defaults prioritized.
- To avoid Element duplication in the system upon restore, we wipe out the source_system_name and source_system_element_id fields from the database.
- From now on, users will see a success/fail message when changing storage for a Dataset.
- Selenium has been upgraded to version 4.1.3.
Issues Fixed
- The issue with failed aliases applied to columns when running DAX queries has been fixed.
- Errors with bind variables :measurement_time and :last_measurement_time are no longer occurring in the system.
- Dimensioned Elements can be migrated even if their Dimensions do not exist on a target system.
- The Import Details popup had been failing to show the list of the exported objects while Import History had been displaying all of these objects. This inconsistency has been fixed and records about the
- Problems with duplicate Elements and updating Data Collection Triggers upon
- Issues with updating Datasets after successful
- Import/Export Utility now supports including static images in External Content and External Report migration.
- Content Center loading performance has been improved for shorter loading times.
- The image generation issue for Power BI External Reports has been fixed by upgrading Chromium and the Chrome driver.
- The Qlik Sense Dataset column type mismatch causing the "column not found" error has been fixed. We have reverted some previous changes that were not properly supported by Qlik Sense.
- From now on, RDP can be installed on any given disk, not just the default disk C.
- Downloading large files from Viewers no longer locks up the UI. Previously, the system had been locking the UI until the file download was completed. Now, before downloading the file, the application closes the user session, which allows users to continue working with the UI while downloading the file.
- The Bulk Add External Reports feature works as expected for MicroStrategy.
- Users were receiving the 504 gateway time-out errors because .xml files were not supposed to generate .pdf files. This issue is fixed and .xml files are being displayed as unavailable for download.
- Broken Power BI user tokens will be auto-refreshed so that they do not cause issues with Data Sources and External Reports.
- Special characters, such as apostrophes, in particular, are now supported in names of CSV files to be used as Dataset sources.
- Conditional Filter Values do not break the rendering of Dataset Report in Bursts. Burst Previews and emails are displaying without issues.