Update Notices for Teamscale 2024.8
Download Teamscale 2024.8
Teamscale 2024.8 is now available for download here.
2024.8 Disabled Legacy API: Update .NET Profiler, ADO Plugin & REST API calls
From version 2024.8 the Legacy API has been disabled by default, and we plan to completely remove it with 2025.1 (or later).
Action required: Make sure you update the Teamscale .NET Profiler, Teamscale Plugin for Azure Dev Ops or scripts that interact with Teamscale's Legacy REST API to their newest versions.
To temporarily re-enable the Legacy API (in case you cannot upgrade a part of your setup yet), you can set the system property com.teamscale.legacy-api.enabled to true.
Teamscale will show a warning banner to administrators if usages of the Legacy API have been detected since the last instance restart. You will find the used legacy services in the System -> Service Log view.
2024.7 Deprecated feature: "Pretty Print" file action in code view
From version 2024.7.0 the ability to generate a pretty-printed representation of a file was removed. The feature was not working reliably for all programming languages and at the same time was rarely used.
2024.7 Bitbucket Server Integration: Support for "Source branch updated" webhook event
From version 2024.7, Source branch updated has been added to the list of the webhook events needed for Teamscale's Bitbucket Server integration to work.
Action required: If you create the Bitbucket repository webhooks manually, then please update your current webhooks to include the Source branch updated event as described here. If not, then the webhooks will be updated automatically by Teamscale.
2024.7 Updated Minimum Bitbucket Server Version
From version 2024.7, the minimum required Bitbucket version for Teamscale's Bitbucket Server integration has been updated and raised to 7.0.0. Teamscale's pull request integration features are no longer available for Bitbucket Server instances older than 7.0.0.
9.8 Removed feature: bgRFC protocol for background full sync with SAP ABAP systems
The option to execute full syncs with SAP ABAP systems in the background using the bgRFC protocol has been deprecated since version 9.6 and is no longer available with Teamscale 9.8. Please use the default option of scheduling a batch (BTC) job instead. For further information please refer to the documentation
9.6 Renamed some Prometheus Monitoring Service metrics
Some of the metrics exposed by our Prometheus Metrics Service have been renamed in version 9.6, in order to be compliant with the best practices regarding naming. For further information on how you might need to change your configuration, please have a look at our documentation.
9.5 Security: Reverse proxy related feature toggle was removed
Reverse proxy configurations have to be updated for version 9.5. From version 9.5, Teamscale is stricter in handling path rewrites from reverse proxies to ensure consistent behavior for all exported links. The feature toggle -Dcom.teamscale.proxy.https-termination=true was removed. Use X-Forwarded-Proto: https in the reverse proxy configuration instead. For further information on how you might need to change your nginx configuration, please have a look at our documentation on Configuring Reverse Proxy.
9.4 Updated system requirements
As of version 9.4, the minimal system requirements for web browsers have been updated to:
- Chrome version 108+
- Firefox version 101+
- Edge version 108+
- Safari version 15.4+
The oldest supported version for the IntelliJ plugin has been updated to version 2020.3.
9.4 Deprecated feature: XPath-based entity selection
From version 9.4, custom checks using XPath selection should be updated since using XPath for selecting entities has been deprecated. The entity selection in the custom checks should be replaced by Java code. Please contact Teamscale support if you need help with updating your custom checks.
9.4 Content Security Policy changed
From version 9.4, Teamscale's Content Security Policy (CSP) prevents embeddings in an <iframe> element of unknown origins by default. This is a proactive security measure to prevent clickjacking. To allow embeddings from other origins, you can set the com.teamscale.server.csp-frame-ancestors JVM property to a valid "frame-ancestors" CSP value. The default is 'self' https://dev.azure.com https://cqsegmbh.gallerycdn.vsassets.io https://*.visualstudio.com The last three origins ensure that the embedded parts of Teamscale's Azure DevOps Extension continue to work. Note that the JVM flag will completely overwrite this setting, including the defaults.
9.4 Permissions to create dashboard templates might be missing
In Teamscale 9.4 the CREATE_DASHBOARD permission was removed along with the "Dashboard Creator" role. Now all users have the permission to create dashboards by default again. Users might lose the permission to create dashboard templates, in this case it can be readded in the Admin > Roles view.
Re-Analysis when Upgrading
- When updating from 2024.8.x, drop-in.
- When updating from 2024.7.x or earlier, a full re-analysis via backup is required.
For more info see: How to update Teamscale
What's New for Teamscale 2024.8
Merge Request Integration
Bitbucket Server: Test-related Build Statuses
We are excited to announce a new feature in Teamscale that enhances test quality reporting within Bitbucket Server pull requests, allowing developers to more effectively monitor and manage test coverage and test gaps.
Recognizing the need for more granular control in testing practices, we are introducing two separate build statuses, aiming at making the testing process more transparent and actionable, directly within the pull request interface.
Test Coverage Build: This build status focuses specifically on the line coverage of new or changed code. It will pass or fail based on whether the line coverage meets or falls below a predefined threshold, providing immediate feedback on the adequacy of test coverage in the pull request.
Test Gap Build: This build status is designed to identify and report test gaps within the pull request. It will fail if test gaps are detected, signaling the need for further testing before merging. An additional option allows for ignoring test gaps in changed methods, making this feature flexible to different project needs and testing strategies.
Merge Request Metrics Visualization
In our continuous effort to enhance the usability and functionality of the Teamscale merge request integration, we are excited to introduce a significant update designed to improve how metric changes within a merge request are understood and analyzed.
With this new feature, currently supported only for GitHub and Bitbucket Server, users will now see a change treemap directly below the metrics table in the Metrics section , providing a clear and immediate visual representation of metric changes, specifically for metrics for which merge requests are configured to post badges.
Overall, this feature is aimed at providing teams with a more intuitive way to track and make sense of changes in code quality within merge requests, ultimately facilitating better-informed decisions and a smoother development cycle.
Key enhancements include:
- Selectable Metrics: Users can choose which metric to display in the treemap via a new drop-down menu that lists all configured metrics.
- Visualization of Absolute Changes: The treemap highlights the absolute changes in metrics, showing increases or decreases with clear, easy-to-interpret values.
- Focused View and Navigation: Only the first layer of the tree is shown for simplicity, with an option to drill down into deeper layers for detailed analysis.
- Flexible Display Options: Users can switch between the treemap and a detailed table view. The table displays the elements with the most significant changes, based on relative, as well as, absolute values, and it is sortable by ascending or descending order.
Web Interface
This new release includes several improvements to make Teamscale's Web UI more accessible and user-friendly.
- The "Enable color-blind mode" setting in user preferences now includes a tooltip explaining its effects, thus enhancing accessibility and usability for color-blind users.
- Updated the default colors used in the Stacked Bar Chart Widget to enhance accessibility, while still allowing users to customize colors as needed.
- The Check Explorer has been enhanced for better usability when multiple languages or tools are selected. Now, the interface succinctly displays one selected item with a
+xlabel for additional selections and includes checkboxes in the dropdown to easily see which options are active.
Dashboard Widgets
Method-based Treemap Widget
Starting this release, a new dashboard widget "Method-based Treemap Widget" is available. This widget allows users to visualize the correlation between method-based metrics and defect hotspots within the codebase, helping to effectively identify the association between Teamscale findings and files impacted by issues or bugs.
Key features include:
- Comprehensive Method Visualization: The treemap displays all methods across the codebase, enriching the usual issue treemap but with a focus on method-level details.
- Detailed Tooltips: Each node on the treemap includes the method name and the number of findings associated with that method.
- Configurable Issue Queries: Users can specify issue queries to filter methods affected by particular issues, with customizability in displaying non-affected methods either in gray or excluding them entirely.
- Advanced Filtering Options: The treemap supports filtering by findings category, quality group, and type, allowing users to tailor the data display to specific analysis needs.
- Dynamic Coloring and Metrics: Nodes can be colored based on the number of findings, severity of findings, or number of matched issues, with additional options for displaying calculated metrics such as average-based, method-based, or area-based metrics.
Issue-based Metric Treemap Widget
- Introduced new aggregation options for the issue-based metric treemap widget, including average-based, file-based, and area-based methods, allowing users greater flexibility in analyzing metrics data with enhanced visual feedback and default settings optimized for immediate insights.
Administration & Operation
- New Recent Backup Exports tab under the Admin > Backup > Backup Export, provides an overview of recent backup exports, offering admins easy access to downloadable links for past exports directly in the UI.