Release Notes Incorta 2024.7.7
Release date: February 17, 2026
Release highlights
The 2024.7.7 maintenance pack extends the capabilities delivered in the 2024.7 release series with the following new features and enhancements:
- Custom null representation in KPIs and data returned by the Business View Query endpoint
- Enhancements to query interruption to include sorting processes
- Tracking data delivered to BigQuery with enhanced request identification
- Enhanced security by bundling Apache Tomcat 9.0.112
- Configurable JWT signature validation for Public API
- A new Inspector report to identify duplicate session and global variables
- An optional parameter in the Schema Status endpoint to return schema and table load errors
- Critical fixes across the platform
Upgrade considerations
Upgrade considerations for previous 2024.x releases also apply to this release unless stated otherwise.
Behavior changes
Null values in KPIs
Starting with this release, KPI insights now honor the Null Value Representation setting configured in the CMC > Tenant Configurations > Customizations, ensuring consistent handling of null values in KPI and tabular insights.
Stricter permissions for single insight delivery
Users must now have at least Share access to a dashboard and the appropriate roles to send or schedule the delivery of single dashboard insights via email or send them to data destinations. Those without the required access can no longer perform these actions, aligning insight-level permissions with the existing rules that govern dashboard sharing and delivery.
Data agent considerations
This release uses the Data Agent version 9.2.6. Please upgrade to this version.
New features
- Custom null value representation in the Query endpoint
- Query interruption enhancements
- Tracking Incorta’s BigQuery usage
- Configurable JWT signature validation for Public API
- A new Inspector report for duplicate variables
- Enhanced Schema Status endpoint
- Bundling Apache Tomcat 9.0.112
Custom null value representation in the Query endpoint
The Query Business View endpoint, /{tenant}/query, now supports customizable null value representation through the nullValueAs parameter. This parameter defines how null values are returned in endpoint responses.
This parameter accepts one of the following values (case-insensitive):
"empty": Returns empty strings"null": Returns the JSONnullvalue"dash": Returns a double hyphen (--)
- If the
nullValueAsparameter is missing, the response defaults tonull. - If a non-supported value is provided, the endpoint returns an error.
Query interruption enhancements
The query interruption mechanism has been enhanced to interrupt running sorting processes, enabling the immediate termination of long-running operations.
Interrupting sorting operations during sync processes requires explicitly enabling this functionality in the engine.properties file. For configuration details, refer to Query Interruption > Interrupting queries blocking sync operations.
Tracking Incorta’s BigQuery usage
Incorta now includes a unique User-Agent identifier in request headers when delivering data to Google BigQuery schema destinations. This enhancement enables tracking, attribution, and reporting of Incorta-generated queries within BigQuery. The User-Agent identifier follows the format IncortaConnect/<IncortaVersion> (GPN:Incorta), providing version-level visibility to Incorta’s contribution to BigQuery. For example, IncortaConnect/2024.7.7 (GPN:Incorta;).
Configurable JWT signature validation for Public API
Incorta now introduces a new option, Disable token signature validation, that allows CMC administrators to disable JWT token signature validation, facilitating seamless integration with external gateways that already guarantee token authenticity. When enabled, Incorta skips signature verification and validates incoming JWTs based on the issuer and audience (aud )claim only, addressing scenarios where customers use a symmetric signing algorithm or tokens without a kid claim in the header. This option is disabled by default to maintain the current behavior of enforcing full signature validation.
For more details, refer to Configure Server > API Security.
Disabling token signature validation is not recommended unless it is explicitly required by your business or security model.
A new Inspector report for duplicate variables
To help ensure data integrity, a new duplicateVariableNames report is now available via the Inspector Tool. This report helps you identify any duplicate session and global variable names that can lead to inaccurate insights.
You must run this report and resolve any identified duplicate variable names to maintain data accuracy.
The Inspector schema does not include this report. To access it, manually edit your existing Inspector schemas and dashboards to add the duplicateVariableNames report.
Enhanced Schema Status endpoint
The Schema Status endpoint, /schema/{schemaName}/status, now features an optional includeErrors parameter (default: false). When set to true, it enriches the endpoint response with detailed loading errors for the schema and its tables. This enhancement provides developers and administrators with granular diagnostic visibility directly through the API, eliminating the need to manually cross-reference logs or navigate the UI to identify and troubleshoot schema loading failures.
Bundling Apache Tomcat 9.0.112
In this release, Incorta bundles Apache Tomcat 9.0.112 to catch up with the security enhancements and fixes in this version, ensuring a more secure and up-to-date runtime environment.
Fixed issues
The following table includes the fixed issues in this release.
| Fixed issue | Area |
|---|---|
Content folder query handling caused an OutOfMemoryError in the Analytics service after the upgrade. | Analytics Service |
The Analytics service remained in a processing state when the data_catalog_audit directory could not be created for an unused tenant | Analytics Service |
The Between prompt filter was not applied when dashboards were sent as XLSX or CSV via data alerts. | Dashboard Filter |
| Insight titles were not retained when the personalized dashboards were reopened. | Dashboards |
| Direct dashboard download as PDF or HTML was impacted after upgrading to 2024.7.6. | Dashboards |
| Prompt filter changes during query processing caused filtering errors due to cached undeleted result sets. | Dashboards |
| Scheduled reports were intermittently emailed later than their scheduled time. | Dashboards |
| Scheduling or sending a single insight from a dashboard in CSV or XLSX format delivered the first insight in the dashboard instead of the selected insight. | Dashboards |
| When selecting a data destination while scheduling a dashboard, all tabs were selected instead of the chosen tab. | Data Destination |
| The Insight Query endpoint returned a 500 Internal Server Error when the insight included an empty formula defined as an individual filter. | Public API |
| In specific cases, scheduling aggregated tables to be sent as Excel-delivered emails without attachments. | Scheduler |
| Fixed an issue where string column length changes in source systems were not reflected in Incorta schemas when revalidating tables, which could cause data truncation or validation errors. | Schema |
| Resolved an issue where failed SQL application connections caused infinite retry loops with continuous error logging. The fix limits retries to 5 attempts and ensures graceful shutdown and automatic restart after repeated failures. | SQL Interface |
| Subtotal font color could not be edited when Subtotals were set to Mixed. | Visualizations |
Known Issues
For all of the known issues and workarounds in Incorta’s latest releases, refer to Known Issues.