(v23) Composer Version 23 Summary of Changes

Composer Version 23 Summary of Changes

This is a summary of the major changes made in version 23 of Composer. It is provided so you can quickly identify new and changed Composer features before upgrading from Composer 22 to Composer 23.

Composer is now offered on a quarterly release schedule, and updated our version numbering system to reflect this. The first quarterly Composer release is v22.4, and the current major release of Composer is v23.4.

Important:  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.

Upgrade Considerations

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

Upgrading to Composer v23.2 or later includes an upgrade of Java runtime from 11 to 17, installed and configured automatically during upgrade.

To ensure services start properly after upgrade in a Linux environment:

1. Verify all of your JVM setting overrides are defined in the /etc/zoomdata directory (not /opt/zoomdata/conf).

2. The .jvm files in /etc/zoomdata/ only contain parameters that are different from default ones, typically Xms/Xms settings, javaagent settings.

   If you have copied the entire .jvm file from /opt/zoomdata/conf for placement into /etc/zoomdata, that configuration is not overwritten after upgrade. Properties such as XX:+UseConcMarkSweepGC can prevent services from starting on Java 17 runtime.

For more information on configuration setups and overrides, see Configure Memory Settings and Connector Properties and Property Files.

Note: If you are upgrading from an earlier version of Composer, this may be a breaking change: the introduction of the system attribute User.timeZone may cause a conflict if you used this as a custom attribute. See Upgrade Workflow.

Enhancements

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

• v23.4 Enhancements
• v23.3 Enhancements
• v23.2 Enhancements
• v23.1 Enhancements
• Removed Features From Composer v22
• API Updates in Composer v23

v23.4 Enhancements

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

• 23.4.13 Feature Enhancements

• 23.4.4 Feature Enhancements

• 23.4.1 Feature Enhancements

• Tenant Administration and Content Creation/Distribution Enhancements

• Enhanced Content Migration Flow

• Breaking Changes Management

• Data Gateway Service

• Azure SQL Data Warehouse (Azure Synapse)

• Expanded Search Options for Managing and Adding Visuals

• Descriptions for Visuals

• Add URLs and Images to Table Visuals

• Hierarchical Fields in Filter Snippets

• Content Tags for Visuals, Sorting, Filtering

• Multi-Grouping for Box Plot Visuals

• Sunburst Visuals

• Export Multiple Sources and Copy Sources

• Other Bucket Grouping Options

• Improved Analytical Capabilities

• Toggle Static Legends

• Refresh Data in Embedded Environments

v23.3 Enhancements

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

• Fiscal Calendars
• Interpolation in Expressions
• Display Source Data in Users' Custom Timezones
• Support for OAuth 2.0 connections to BigQuery and Snowflake
• Dashboard and Source Tags
• Expanded Map Visual Functionality
• Cloudmade for Map Visuals
• Hierarchical Pivot Improvements
• Improved Object Deletion
• Security for Connection Types
• Filter Snippet Expanded Options
• Improved Data Types Conversion in the Python Connector
• Restrict Dashboard Report Scheduling to External Users
• Removed LDAP Query Symbols Limit
• Arc Gauge Improvements
• Extended Sources API Validation Response Payload and Introduced suppressWarnings
• Delete File Uploads
• Mobile-Friendly User Interface Updates

v23.2 Enhancements

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

• 23.2.7 Feature Enhancements
• Python Connector Support
• Accessibility Support (WCAG)
• Services Memory Updates
• Widget Level Comments
• Improved Analytical Capabilities
• Data Source Import and Export
• Java 17 Support
• Embedded Source Inventory List
• Raw Data Field Capability
• Export Dashboards to XSLX
• Send Scheduled Dashboard Reports in XLSX
• Filter Snippet Improvements
• Conditional Formatting for KPI Visuals
• Dashboard Layout Improvements
• Mobile Friendly Dashboard Layout
• Interactivity Profiles Expansion
• Commenter Access for Dashboards
• Search by Description
• Expanded Ubuntu Support
• Extended Microsoft SQL Connections
• Pivot Table Improvements
• Table Visual Improvements
• Data Upload Enhancements
• Embed Manager NPM Package
• Configure Data Schemas for Connectors
• Extended Integer to Datetime Conversion in Timezone Offsets
• Convert Dashboards to Responsive Layout - API
• Embedded Visual Events

v23.1 Enhancements

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

• 23.1.11 Feature Enhancements
• 23.1.1 Feature Enhancements
• Simplified Product Evaluation
• Scalable Kubernetes Support
• Structured Logging Support
• Dashboard View Mode
• Self Service Sharing Updates
• Local Visuals
• New and Responsive Dashboard Layouts
• Dashboard Export/Import Enhancements
• Data Export in XLSX Format
• Localization Support for Source Metadata
• Schedule Dashboard Reports for Non-Composer Users
• Group Labels Position
• Expanded Combo Chart Label Settings
• Show and Hide Axis Pickers for Visuals
• Dynamic Legends
• Visual Date and Number Formatting
• Context Menu Updates
• Jira and Salesforce Connectors
• Dashboard Filter Snippet
• InitialFilters for Dashboards
• Expanded Visuals Interactivity Settings
• Expanded Dashboard Interactivity Settings
• Interactivity Updates
• Embedded Events Updates
• Distributed Tracing
• License Key Provisioning
• Hierarchy Support Update

Removed Features From Composer v22

The following features were removed from Composer v22 to make way for improvements in Composer v23.

Composer 23.4

Title	Description	Alternative
23.4.13 Removed Features
None.
23.4.12 Removed Features
None.
23.4.11 Removed Features
None.
23.4.10 Removed Features
None.
23.4.9 Removed Features
None.
23.4.8 Removed Features
None.
23.4.7 Removed Features
None.
23.4.6 Removed Features
None.
23.4.5 Removed Features
None.
23.4.4 Removed Features
None.
23.4.3 Removed Features
None.
23.4.2 Removed Features
None.
23.4.1 Removed Features
None.
23.4 Removed Features
None.

Composer 23.3

Title	Description	Alternative
Composer 23.3.14 Removed Features
None.
Composer 23.3.13 Removed Features
None.
Composer 23.3.12 Removed Features
None.
Composer 23.3.11 Removed Features
None.
Composer 23.3.10 Removed Features
None.
Composer 23.3.9 Removed Features
None.
Composer 23.3.8 Removed Features
None.
Composer 23.3.7 Removed Features
None.
Composer 23.3.6 Removed Features
None.
Composer 23.3.5 Removed Features
None.
Composer 23.3.4 Removed Features
None.
Composer 23.3.3 Removed Features
None.
Composer 23.3.2 Removed Features
None.
Composer 23.3.1 Removed Features
None.
Composer 23.3 Removed Features
api/trusted-access/token	The API /api/trusted-access/token, deprecated in an earlier release (Composer v7.5), is now removed.	Use /api/trusted-access/push/tokens or /api/trusted-access/pull/tokens instead. See Trusted Access API Endpoints.
/api/visualizations/* and API for Visualizations components	All APIs in the control /api/visualizations/*, deprecated in an earlier release (Composer v7), are now removed. The complete list of removed APIs: GET /api/visualizations/{id} PUT /api/visualizations/{id} DELETE /api/visualizations/{id} GET /api/visualizations POST /api/visualizations POST /api/visualizations/import GET /api/visualizations/export/{visId} POST /api/visualizations/thumbnail GET /api/visualizations/{visId}/thumbnail/{thumbnailId} GET /api/visualizations/{visualizationId}/source/{componentId}	Use the APIs /api/visual-types/* instead: GET /api/visual-types/{id} PUT /api/visual-types/{id} DELETE /api/visual-types/{id} GET /api/visual-types POST /api/visuals-types Export and import visual types: GET /api/visual-types/export/{visTypeId} POST /api/visual-types/import Thumbnail management: POST /api/visual-types/thumbnail GET /api/visual-types/{visTypeId}/thumbnail/{thumbnailId} Visualizations components: GET /api/visual-types/components/{componentId}
/api/system/systemInfo	The API api/system/systemInfo, deprecated in an earlier release, is now removed.	Use /api/version to see the current Composer application version and system information.
The userId and disabledMessage fields	The fields userId and disabledMessage used in the connections-related endpoints and deprecated in an earlier release are now removed. Affected APIs: All APIs in the connections control (including GET, POST, PUT/api/connections etc.) All APIs in the dashboard-migration control (GET/api/dashboards/export and POST/api/dashboards/import) Use createdByUserID and lastModifiedByUserID as references instead of userId.	Use createdByUserID and lastModifiedByUserID as references instead of userId.
Filter Snippet Source Field	The Field column, used to select a data field from a linked source, has been removed.	Select a data field in Value Column, and if available, add a Display Column.

Composer 23.2

Title	Description
Composer 23.2.15 Removed Features
None.
Composer 23.2.14 Removed Features
None.
Composer 23.2.13 Removed Features
None.
Composer 23.2.12 Removed Features
None.
Composer 23.2.11 Removed Features
None.
Composer 23.2.10 Removed Features
None.
Composer 23.2.9 Removed Features
None.
Composer 23.2.8 Removed Features
None.
Composer 23.2.7 Removed Features
None.
Composer 23.2.6 Removed Features
None.
Composer 23.2.5 Removed Features
None.
Composer 23.2.4 Removed Features
None.
Composer 23.2.3 Removed Features
None.
Composer 23.2.2 Removed Features
None.
Composer 23.2.1 Removed Features
None.
Composer 23.2 Removed Features
Legends for KPI Visuals	Legends have been removed from KPI visuals.
hasRawData, hasRawDataOnly	Support for these fields are removed for the endpoint /api/sources/{sourceId}/visual-types/variables-values/. Use RAW_DATA instead.
Media Type application/vnd.composer.dashboard.v2+json	The media type application/vnd.composer.dashboard.v2+json for api/dashboards, deprecated in an earlier release, is now removed.
page and size Parameters	The parameters page and sizefor the Users autocomplete endpoint GET /api/users/autocomplete, deprecated in a previous release, have been removed.

Composer 23.1

Title	Description
Composer 23.1.14 Removed Features
None.
Composer 23.1.13 Removed Features
None.
Composer 23.1.12 Removed Features
None.
Composer 23.1.11 Removed Features
None.
Composer 23.1.10 Removed Features
None.
Composer 23.1.9 Removed Features
None.
Composer 23.1.8 Removed Features
None.
Composer 23.1.7 Removed Features
None.
Composer 23.1.6 Removed Features
None.
Composer 23.1.5 Removed Features
None.
Composer 23.1.4 Removed Features
None.
Composer 23.1.3 Removed Features
None.
Composer 23.1.2 Removed Features
None.
Composer 23.1.1 Removed Features
None.
Composer 23.1 Removed Features
Tracing Microservice	The Composer Tracing Microservice (zoomdata-tracing-server), deprecated in a previous release, is now removed. See Distributed Tracing for Composer.

API Updates in Composer v23

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

Composer 23.4

Endpoint	Method	Description
23.4.13 API Updates
None.
23.4.12 API Updates
None.
23.4.11 API Updates
None.
23.4.10 API Updates
None.
23.4.9 API Updates
None.
23.4.8 API Updates
None.
23.4.7 API Updates
None.
23.4.6 API Updates
None.
23.4.5 API Updates
None.
23.4.4 API Updates
None.
23.4.3 API Updates
None.
23.4.2 API Updates
None.
23.4.1 API Updates
/api/sources/	POST	When using the sources endpoint, Composer returns the parameter fields of the collection you request, both for /preview and /describe.
23.4 API Updates
/api/recently-accessed-elements	GET	Use to return items recently used, such as dashboards, visuals, and data sources by the logged in user in Composer. Limit the number of items returned by sending /api/recently-accessed-elements?listSize={number}.
/api/accounts/{id}	PUT	Use /api/accounts/{id} to update existing user accounts, or create new ones.
/api/sources/{sourceId}/clone	PUT	Use to clone an existing source in your environment with a new name. Mandatory fields include sourceID and name. Optionally add tags and description.

Composer 23.3

Endpoint	Method	Description
Composer 23.3.14 API Updates
None.
Composer 23.3.13 API Updates
None.
Composer 23.3.12 API Updates
None.
Composer 23.3.11 API Updates
None.
Composer 23.3.10 API Updates
None.
Composer 23.3.9 API Updates
None.
Composer 23.3.8 API Updates
None.
Composer 23.3.7 API Updates
None.
Composer 23.3.6 API Updates
None.
Composer 23.3.5 API Updates
None.
Composer 23.3.4 API Updates
None.
Composer 23.3.3 API Updates
None.
Composer 23.3.2 API Updates
None.
Composer 23.3.1 API Updates
None.
Composer 23.3 API Updates
/api/connection/{id} /api/sources/{id} /api/sources/ {sourceId}/fields/{fieldId} /api/visuals/{id} /api/dashboard/{id}	DELETE	When you attempt to delete an object that has dependent object, Composer returns a robust response that includes the item’s id, name, and type to make decoupling of dependent objects easier.
/api/connection/types/{id}/accounts	PUT, GET	Use to allow access to specific connection types to users of appropriate permissions in specific Accounts. If no Accounts are specified for a connection type, all uses with appropriate permissions in all accounts can create new or edit existing connection types.
/api/sources	POST	If a request through the API returns a 400 response code, you now see two levels of validation issues, ERROR and WARNING. Optionally, include the query parameter suppressWarnings to determine the behavior of the request. Send suppressWarnings=true to make the request ignore all warning violations and return success if there are no error violations. Send suppressWarnings=false to make the request fail if there is at least one error or warning. The default value is false.
/api/sources/${sourceId}	PUT
/api/sources/${sourceId}/fields	POST, PUT
/api/sources/${sourceId}/fields/${fieldName}	PUT, DELETE

Composer 23.2

Endpoint	Method	Description
Composer 23.2.15 API Updates
None.
Composer 23.2.14 API Updates
None.
Composer 23.2.13 API Updates
None.
Composer 23.2.12 API Updates
None.
Composer 23.2.11 API Updates
None.
Composer 23.2.10 API Updates
None.
Composer 23.2.9 API Updates
None.
Composer 23.2.8 API Updates
None.
Composer 23.2.7 API Updates
None.
Composer 23.2.6 API Updates
Various		We’ve added clarification to our provided Swagger API documentation to specify the security level required to perform each available operation. API documentation is provided with your Composer installation at this link: https://<composer-URL>/composer/swagger-ui.html.
Composer 23.2.5 API Updates
None.
Composer 23.2.4 API Updates
None.
Composer 23.2.3 API Updates
None.
Composer 23.2.2 API Updates
None.
Composer 23.2.1 API Updates
None.
Composer 23.2 API Updates
/api/sources/export /api/sources/import	GET, PUT	Use these new endpoints with parameter ids to specify one or more source for export and import: /api/sources/export?ids=sourceId1,sourceId2,sourceId3 or /api/sources/export?ids=sourceId1&ids=sourceId2&ids=sourceId3. Source payload includes: source object fields custom metrics global settings cache settings related connections
/api/dashboards/{id}/comments /api/dashboards/{id}/comments/{id}	GET, POST, PUT, DELETE	Use the comments API to manage comments associated with a dashboard and its widgets: GET /api/dashboards/{id}/comments GET /api/dashboards/{id}/comments/{id} POST /api/dashboards/{id}/comments/ PUT /api/dashboards/{id}/comments/{id} DELETE /api/dashboards/{id}/comments/{id}
/api/sources/{source_id}/unique-key	GET, PUT	Use to define and retrieve a unique key for non-hierarchical fields in data sources. The key can be a field or an array.
/api/start-vis	POST	Use to execute START_VIS query via REST and get a resulting data set in the response. Important: This is an experimental API.
/api/dashboards/convert-layout/	POST	Use to convert dashboards to responsive layout. On success, returns an array of dashboard ids converted. See Dashboard Layouts. Important: This is an experimental API.

Composer 23.1

Endpoint	Method	Description
Composer 23.1.14 API Updates
None.
Composer 23.1.13 API Updates
None.
Composer 23.1.12 API Updates
None.
Composer 23.1.11 API Updates
None.
Composer 23.1.10 API Updates
None.
Composer 23.1.9 API Updates
None.
Composer 23.1.8 API Updates
None.
Composer 23.1.7 API Updates
None.
Composer 23.1.6 API Updates
None.
Composer 23.1.5 API Updates
None.
Composer 23.1.4 API Updates
None.
Composer 23.1.3 API Updates
None.
Composer 23.1.2 API Updates
None.
Composer 23.1.1 API Updates
None.
Composer 23.1 API Updates
/api/dashboards/{dashboard_id}/reports	PATCH	Use to share, revoke, or change user access to a dashboard and its visuals. as a VIEWER or EDITOR.
/api/dashboards/{dashboard_id}/reports	POST	Use the new field, {"email": "[e-mail]"}, to schedule dashboard reports for non-Composer users. Removed the deprecated field sendOnlyToMe .
/api/dashboards/{dashboard_id}/reports/{report_id}	GET
/api/dashboards/{dashboard_id}/reports /api/dashboards/{dashboard_id}/reports/{id}	PUT
/api/export/rawdataforvisual	POST	Use to generate raw data export CSV and XLSX of your raw data for visuals. Replaces /api/export/raw.
/api/export/visualdata	POST	Use to generate visual data export CSV and XLSX of your raw data for visuals. Replaces /api/export/chartdata/{file_name}.
/api/sources/{id}/dictionaries	PUT	Create and update your metadata dictionary for a source. Use MediaType /multipart/form-data. Example: Field Label,ua_UK,en_GB city,місто,city county,округ,county zip code,поштовий індекс,postcode
/api/sources/{id}/dictionaries	GET	Returns a list of dictionaries with field labels for a source.
/api/sources/{id}/dictionaries/{language}	GET	Returns a dictionary by the specified language for a source.
/api/sources/{id}/dictionaries/{language}	PUT	Create and update a dictionary for the specified language for a source.
/api/sources/{id}/dictionaries	DELETE	Delete all dictionaries for a specified source.
/api/sources/{id}/dictionaries/{language}	DELETE	Delete the dictionary for the specified language for a source.