22.4 Release Notes

This topic describes feature enhancements, resolved issues, and important information for Composer 22.4.

To purchase this product, contact US Sales or UK Sales.

• Feature Enhancements
• API Updates
• Resolved Issues
• Deprecated Features
• Removed Features
• Composer 8.4 and Earlier Updates

See also Important Notices, Deprecated Features, and Removed Features.

 We have changed Composer to a quarterly release schedule, and adopted a new version numbering system. Composer v8 is now Composer 22.4. Composer version names for Composer 7 and earlier remain unchanged. See Composer Release Vehicles.

Support for Composer 5.9 ends on June 27, 2022. Composer 6.9 will soon enter the Passive Support phase. Our Passive Support release receives only critical patches and security updates until its end-of-life date. We describe critical patches in the Passive Support Release Notes page at the discretion of Product Management. Security updates are not applicable to the third-party dependencies. If you are using Composer 5.9, you should contact Sales and upgrade to the most current LTS release. We no longer publish documentation for any Composer products prior to version 6.9. Contact Customer Support if you need content for an unsupported release.

Feature Enhancements

Title	Description
Composer 22.4.6 Enhancements
None.	None.
Composer 22.4.5 Enhancements
Hierarchy Support Update	Hierarchical field support is now enabled by default in Composer. Work with technical support to enable or disable as needed. See Hierarchical Fields and Structures.
Context Menu Updates	VisualAPI is now available for visual-clicked, visual-right-clicked, series-clicked, and series-right-clicked events. You can also use VisualAPI API in custom options in the context menu.
InitialFilters for Dashboards	The functionality of the initialFilters object has been expanded. Use the applyFiltersStrategy property and the value overrideSamePath to override existing filters along the same path, or the value replaceExisting to remove all filters and use only defined initialFilters. See Embedded Dashboard Properties and Objects.
Composer 22.4.4 Enhancements
None.	None.
Composer 22.4.3 Enhancements
None.
Composer 22.4.2 Enhancements
None.
Composer 22.4.1 Enhancements
None.
Composer 22.4 Enhancements
Hierarchies Support for Pivot Tables	Composer now supports common hierarchical structures you can use to visualize and organize your data. Hierarchies create parent-child tree-based, and field-level hierarchical structures using your source data. Transform your data further by applying hierarchical row filters to your data. When you organize your data in Composer in hierarchies, it's easier to access for analytical processing, for data traversal, and keyword searching. To view your data in a hierarchical format, create a data source that defines a adjacency list hierarchy, add one or more hierarchy fields to your data source, then optionally define hierarchical groups or filters to apply to pivot table visuals, or hierarchical filters to your other visuals. See Hierarchical Fields and Structures.
Self Service Sharing of Dashboards	You can now allow your users to share dashboards more easily among themselves in a user-friendly manner that doesn't require a complex process of defining granular permissions. Your users can now grant and revoke VIEWER access level to a dashboard, along with its underlying visuals and sources. Control the visibility of this feature in Composer Embed mode by enabling or disabling Share Dashboard in Dashboard Interactivity Settings. See Share a Dashboard with Users Inside Your Account.
Widget Settings	Use Composer's Widget Settings sidebar menu to manage the appearance of your visuals and rich text snippets on a dashboard. Access by selecting Settings from the More menu, then changing the Display Name, Description text, or Header options. See Use the Visual Sidebar Menu. The More menu option Edit Visual is renamed the Settings for visuals and rich text snippets.
Rich Text Snippet Support	You can now add Rich Text Snippet snippets to your Composer dashboards. Annotate your dashboard, describe data on your dashboard in context, and link external resources, such as user guides, or images. Add during dashboard creation, or at any time using the Composer UI, or using the dashboard API. See Manage Rich Text Snippets.
Alerts Updates	Alerts are no longer an experimental feature of Composer. Create alert definitions, determine a schedule to evaluate the alert condition, and define how notifications are handled when an alert condition is met. You can use the API or Composer UI to define and update these conditions, so you can alert your users when a metric reaches a specific threshold. See Create an Alert Definition and Alerts API.
Context Menu	The Context Menu provides your users a way to view more information about specific data points in visuals. This menu replaces the functionality of the radial menu, providing streamlined options for working with data. Define how to embed the context menu in your Composer instance by specifying default options for right and left mouse selection. If needed, you can also add custom controls to the context menu for embedded visuals. See Use the Context Menu.
Bulk Update Field Capabilities	You can now update field capabilities for fields at the source level in bulk. Select Update Field Capabilities in the Fields tab to open the Bulk Update Field Capabilities work area. Search and sort fields as needed, then optionally enable or disable settings for one or more fields. Enable or disable Details, Filtering, Grouping, Metrics, and Playing. See Field Capabilities. and Update Field Capabilities.
Conditional Formatting Options for Pivot Tables	You can now format Pivot Table visuals by adding color and text formats based on conditional rules. See Define Conditional Formatting for a Pivot Table Visual.
Stored Procedure Support For Microsoft SQL	You can now create Microsoft SQL sources that include the use of stored procedures. Use exec or execute in your custom SQL during source creation, with or without parameters. Supported stored procedures return raw data only.
Fields Statistics Update	You can now use an additional subordinate field of statistics, lookup, in the Fields API to set dynamic filter values overrides for a specific field. See API Updates and Filter Values Entity Support.
Elasticsearch Updates	Composer includes expanded support for several Elasticsearch features. Elasticsearch 7 and 8 connectors recognize the numeric field types scaled_float, half_float, and unsigned_long for use in visuals. Multi valued fields detection: When enabled, Composer uses automated field type detection to mark nested fields as multi_valued fields. Add the property elasticsearch.describe.mark-all-nested-fields-as-multi-valued to your Elasticsearch configuration files to treat all nested fields as multi_valued fields, then create a new source to connect to your data. Recreate existing sources to use multi valued fields. Elasticsearch connectors work with GeoPoint field types, supporting the use of location fields as location.latitude and location.longitude in map visuals.
KPI Chart Label Positions	You can now adjust the position of labels in KPI Chart visuals. Use the options in the Position section of the Settings sidebar menu to rename your labels and adjust the position of the labels as needed. See KPI Charts.
Filter Values Entity Support	Composer now supports filter values entities you can use to provide an alternative source of metadata values. Use these entities in a dynamic override on Filter Values Tab in Fields to improve the filter experience of heavy data entities. See Filter Values Menu - Fields Tab. Control the interactivity by adding Filter Values Entity and Filter Values tab for your users as needed.
Composer Web Graceful Shutdown Support	Composer Web now includes a graceful shutdown option to close the active web sockets. The default shutdown period is 25 seconds, encompassing a 5 second propagation and 20 seconds to shutdown active tasks.
Tracing Improvements	Composer now supports tracing for Zoomdata-Web and Query Engine combined in the same trace ID. All requests to connectors are traced using a common trace ID. Zoomdata-Web supports tracing of: the REST API, Spring service, DAO service calls, and WebSocket messages. Query Engine supports tracing of: REST API calls and WebSocket Messages.
Date and Time Format	You can now format your time fields at the source to show or hide the day of the week. By default, Composer hides the day of the week field. See Configure Date and Time Formatting.

API Updates

API documentation is provided with your Composer installation at this link: https://<composer-URL>/composer/swagger-ui.html.

Endpoint	Method	Description
Composer 22.4.6 API Updates
None.
Composer 22.4.5 API Updates
None.
Composer 22.4.4 API Updates
None.
Composer 22.4.3 API Updates
None.
Composer 22.4.2 API Updates
None.
Composer 22.4.1 API Updates
None.
Composer 22.4 API Updates
/api/sources/{sourceId}/fields/	POST, PUT	Use lookup to set a dynamic field statistics overwrite. Specify dataEntityId and originalFieldName as a custom source of filter values.
/api/sources/{sourceId}/fields/{fieldName}	POST, PUT	Use lookup to set a dynamic field statistics overwrite. Specify dataEntityId and originalFieldName as a custom source of filter values.
/api/alerts/{id}	GET	Returns a specific alert definition, identified by its ID. In a multi tenancy environment, respects Recipients rules.
/api/inventory/{type}/{id} /api/inventory /api/user/permissions/dashboards/{id}	GET	A new field, accessLevel, has been added to these endpoints to return users' access to a dashboard. These access levels can be OWNER, EDITOR, or VIEWER.

Resolved Issues

Title	Description
Composer 22.4.6 Resolved Issues
Table Visual Data	We’ve improved the push down for complex filters on fused sources that contain data entities from different connections.
Scroll Bars on Pivot Tables	Composer now correctly renders and displays horizontal scroll bars for Pivot Tables that include data wide enough to require scroll bars when the cells are maximized.
Composer 22.4.5 Resolved Issues
Legends and Visual Legends	Corrected an issue where some color codes in legends and visual legends did not refresh properly after a change was made to the visual.
Composer 22.4.4 Resolved Issues
Derived Field Editor Update	When you create a derived field with a function that supports only specific values in a parameter and do not include a supported value, Composer now displays an error message that lists supported values.
Composer 22.4.3 Resolved Issues
Health Status for Query Engine	Corrected an issue that incorrectly reported the Query Engine service status as Critical instead of Warning when Composer can’t open a connection to the internal database.
Composer 22.4.2 Resolved Issues
Field Sort Order Updates	After upgrading to this version of Composer, any visuals you create displays fields in the order they are retrieved from the source. If you create a source using custom SQL, your field data is shown in the order you specify. On upgrade, the order of fields for existing visuals are not changed from the previous default sort, alphabetical. If you create a source using the API, you can send a list of native fields or the entire list of fields in a sort order that meets your needs. If you add a single field using the API or on the fields tab, it is added to the end of the fields list.
Composer 22.4.1 Resolved Issues
Dashboard Export/Import	Updated the dashboard export and import APIs to include source cache settings for the data and statistics caches in the payload.
Composer 22.4 Resolved Issues
Visual Attributes	Corrected an error that prevented some horizontal (x-axis) attributes and vertical (y-axis) attributes from updating when you change a visual’s type and save it.
Line Trend Visual	Corrected an error that cut off X-axis labels.
Account Switching	Switching between Composer user accounts no longer returns a undefined error message.
Pivot Tables	Composer now correctly displays scroll bars for pivot tables that are larger than the viewable area of the visual.
Pivot Tables	Composer no longer exports extraneous Volume metrics for pivot tables.

Deprecated Features

Title	Description
Composer 22.4.6 Deprecated Features
None.
Composer 22.4.5 Deprecated Features
None.
Composer 22.4.4 Deprecated Features
None.
Composer 22.4.3 Deprecated Features
None.
Composer 22.4.2 Deprecated Features
None.
Composer 22.4.1 Deprecated Features
None.
Composer 22.4 Deprecated Features
Tracing Microservice Support	The Composer Tracing Microservice (zoomdata-tracing-server) is deprecated. This service will be removed in a future release, replaced by an alternative feature.
Edit Visual Menu Options	The More menu option Edit Visual is renamed the Settings for visuals and rich text snippets.

Removed Features

Title	Description
Composer 22.4.6 Removed Features
None.
Composer 22.4.5 Removed Features
None.
Composer 22.4.4 Removed Features
None.
Composer 22.4.3 Removed Features
None.
Composer 22.4.2 Removed Features
None.
Composer 22.4.1 Removed Features
None.
Composer 22.4 Removed Features
Radial Menu	Radial menu functionality has been streamlined into and replaced by the Context Menu.

Composer 8.4 and Earlier Updates

Be sure to back up your metadata store (see Back Up the Metadata Store ) before you upgrade.

The following sections provide you with a summary of enhancements in the previous version 8 releases, all of which are present in the latest rapid release of Composer v8.

• v8.4 Enhancements
• v8.3 Enhancements
• v8.2 Enhancements
• v8.1 Enhancements
• v8.0 Enhancements
• Removed Features From Composer v7
• API Updates in Composer v8

v8.4 Enhancements

The following enhancements were made to Composer v8.4. Select the links for more information.

• Embedded Source Editor
• Custom Values and Custom Ranges Support
• Fields API Updates
• Format Dates on Visuals
• Logging Updates
• Connect to Amazon OpenSearch
• Field and Custom Metric Labels Updates

v8.3 Enhancements

The following enhancements were made to Composer v8.3. Select the links for more information.

• Schedule Reports From the Dashboard
• Expanded Time and Date Options
• Conditional Formatting Options for Tables
• Configuration Updates
• Raw Data Table Sorting
• Initial Filters for Dashboards

v8.2 Enhancements

The following enhancements were made to Composer v8.2. Select the links for more information.

• Composer Logging To Console
• Log File Name Updates
• Waterfall Visual
• Format Numbers on Visuals
• Pivot Table Sorting Updates
• Null Values in Time Groups
• Visual Gallery Updates
• Visual and Display Name Updates
• Visual Rendering Updates
• Locale-Dependent Date and Time Formatting
• Modified Date Updates
• Import and Export Dashboard Updates
• Visual Interactivity Menu Parameters

v8.1 Enhancements

The following enhancements were made to Composer v8.1. Select the links for more information.

• Report Scheduler Updates
• Group Privilege Update
• Visual Gallery Embed Actions
• Visual Gallery Favorites
• Visual Gallery Embedding
• Expanded Inventory Support
• Expanded Date and Time Format Support
• Scheduled Reports API Updates
• Extend API to Support URL Format for Attribute, Number, Time
• Expanded Fields API Endpoints
• API Interpolation Support
• Presto / Trino Support Update
• Microsoft SQL Server Support Updates
• Elasticsearch Support Updates

v8.0 Enhancements

The following enhancements were made to Composer v8.0. Select the links for more information.

• Composer Custom Chart CLI
• Dashboard Report Updates
• Cumulative Sum Option for Visuals
• Expanded List Settings in Dashboards
• Subtotals for Pivot Tables
• Inventory Visual API Support
• Elasticsearch Support Update

Removed Features From Composer v7

The following features were removed from Logi Composer v7 to make way for improvements in Composer 22.4.

Composer 22.4

Title	Description
Composer 22.4.6 Removed Features
None.
Composer 22.4.5 Removed Features
None.
Composer 22.4.4 Removed Features
None.
Composer 22.4.3 Removed Features
None.
Composer 22.4.2 Removed Features
None.
Composer 22.4.1 Removed Features
None.
Composer 22.4 Removed Features
Radial Menu	Radial menu functionality has been streamlined into and replaced by the Context Menu.

Composer v8.4

Title	Description
Composer 8.4.1 Removed Features
None.
Composer 8.4 Removed Features
None.

Composer v8.3

Title	Description
Composer SDK	The Composer SDK is no longer supported.

Composer v8.2

Title	Description
Visual Info Sidebar Menu Update	The field Default Title has been removed from the Info sidebar menu of visuals.
Visual Gallery Updates	The Usage column has been removed.

Composer v8.1

Title	Description
Scheduled Reports	The Send to me toggle is removed, replaced by a field you can use to add report recipients, prepopulated with the current user’s information.

Composer v8.0

Title	Description
WebSocket Authentication	Authentication of WebSocket connections in embedded mode using trusted access tokens in the WebSocket URL, deprecated in Composer v7.10, is now removed. Authentication is handled by the Embed Manager.

API Updates in Composer v8

This table provides a breakdown of all reported updates in Composer v8.

Composer 22.4

Endpoint	Method	Description
Composer 22.4.6 API Updates
None.
Composer 22.4.5 API Updates
None.
Composer 22.4.4 API Updates
None.
Composer 22.4.3 API Updates
None.
Composer 22.4.2 API Updates
None.
Composer 22.4.1 API Updates
None.
Composer 22.4 API Updates
/api/sources/{sourceId}/fields/	POST, PUT	Use lookup to set a dynamic field statistics overwrite. Specify dataEntityId and originalFieldName as a custom source of filter values.
/api/sources/{sourceId}/fields/{fieldName}	POST, PUT	Use lookup to set a dynamic field statistics overwrite. Specify dataEntityId and originalFieldName as a custom source of filter values.
/api/alerts/{id}	GET	Returns a specific alert definition, identified by its ID. In a multi tenancy environment, respects Recipients rules.
/api/inventory/{type}/{id} /api/inventory /api/user/permissions/dashboards/{id}	GET	A new field, accessLevel, has been added to these endpoints to return users' access to a dashboard. These access levels can be OWNER, EDITOR, or VIEWER.

Composer v8.4

Endpoint	Method	Description
Composer 8.4.1 API Updates
None.
Composer 8.4 API Updates
None.

Composer v8.3

Endpoint	Method	Description
None.

Composer v8.2

Endpoint	Method	Description
/api/sources/		Actions taken using these endpoints trigger a source modifiedDate update: POST /api/sources/{sourceId} POST /api/sources/{sourceId}/fields PUT, DELETE /api/sources/{sourceId}/fields/{fieldName} POST /api/sources/{sourceId}/custom-metrics PUT, DELETE /api/sources/{sourceId}/custom-metrics/{customMetricName} PUT /api/sources/{sourceId}/global-settings PUT /api/sources/{sourceId}/cache-settings
/api/connections/{id}	POST	When you create a connection, use the ?connectionTypeMatching=BY_TYPE_AND_PARAMETERS URL parameter to omit the matching by connectionTypeId; instead, use matching by combining type + subStorageType + Connection Parameter Keys.

Composer v8.1

Endpoint	Method	Description
/api/sources/	PUT, GET, DELETE	Use the Composer API to remove a field or change a field type for a field in your source if it is not in use by a global filter. PUT /api/sources/{sourceId} PUT /api/sources/{sourceId}/fields/{fieldName} DELETE /api/sources/{sourceId}/fields/{fieldName} GET /api/sources/{sourceId}/fields/{fieldName}/usage API documentation is provided with your Composer installation at this link: https://<composer-URL>/composer/swagger-ui.html.
/api/user/interpolate	POST	Use /api/user/interpolate to send custom attribute names and get custom attribute values.
/api/favorites/	POST	Favorite a visual Specify an inventoryItemId and visual in inventoryItemType.
/api/favorites/{favoriteID}	DELETE	Remove the favorite indication from the specified {favoriteID}.

Composer v8.0

Endpoint	Method	Description
api/inventory?type=VISUAL	GET	Returns information about visuals for which the user has READ permission. If the user has no READ access to any visuals, an empty list is returned.