ART-DECOR® – Release 3.9.2

Release notes 1 October 2025

Introduction

We are delighted to announce Release 3.9.2. As we are continuously busy to offer / deliver high quality software, we decided to have another intermediate release that fixes 6 issue we found during intense regression testing and due to client/user reports.

In total, 6 tickets were handled. This is the Release Note with more details.

Fixed issues

DECOR services

• RetrieveTemplate call with inline=true: ticket [AD30-2161] addresses a high-priority bug in the RetrieveTemplate service call with inline=true causing errors in old ART-DECOR 2, and documents its identification, fix, testing, and release.

  • A Nictiz user reported an error in RetrieveTemplate calls with inline=true causing incompatible primitive types exception in old ART-DECOR 2.
  • The issue affected multiple decor services but not the API; reproduction and error details were provided with URLs.
  • The team committed a hotfix deployed to multiple branches and live on decor.nictiz.nl.
  • Testing confirmed the fix resolved the issue; versions 2.3.14 and 2.3.15 of decor services were broken, 2.3.16 fixed.
  • Mitigation: clients should update to decor services stable 2.3.16 to avoid the bug in production.
  • The ticket was moved to release 3.9.2, and the issue closed after verification.

• Parameter seetype fixes: ticket [AD30-2162] addresses the bug related to the "seetype" parameter in ART-DECOR services, focusing on its inconsistent support and impact on link generation across AD2, AD3, and publication contexts.

  • The "seetype" parameter, intended to direct links to the correct UI context (AD2, AD3, publication), is currently ignored or fixed to "live-services-vue," causing incorrect link routing.
  • Regression occurred after moving to the API, losing "seetype" support, which affects RetrieveTemplate and other decor services links.
  • Fixes include updating decor services and API to handle "seetype" properly, ensuring links point to actual pages, avoiding localhost or incorrect AD3 links.
  • The default "seetype" values are "live-services" for decor services and "live-services-vue" for API; publications use "generated."
  • Additional fixes addressed double ?format parameters in URLs and improved handling of non-HTML links (xml/json/sql/svs).

Terminology Browser behavior

• Missing display of concept designations in terminology browser if a selected project does not contain en-US language: ticket [AD30-2166] addresses a bug where the terminology browser fails to display en-US designations if the selected project lacks en-US as a language, and documents the fix and related discussions.
  • Fix: en-US is now always selected as fallback display language in the terminology browser and code system languages dialog.
  • Testing: Verified on acceptance environment, showing English terms correctly even for non-logged-in users.
  • Discussion: Login status irrelevant; issue depends on project language context, not user authentication.
  • Future: A related ticket (AD30-2170) created for improved design in release 3.10 or later.
  • Consideration: Potential API-level solution to return supported language designations instead of frontend fallback.
  • Deployment: Fix included in release branch 3.9.2, pending merge into master for live release.

ART-DECOR Release and Archive Manager ADRAM

• ART-DECOR Wiki Bot Update for newer Mediawiki API calls: this ticket [AD30-2169] simply updated the Mediawiki part of out ART-DECOR Release and Archive Manager ADRAM to serve properly on newer Mediawiki environments/software and uses the new Mediawiki API now with corrected calls.

Templates in AD2

• AD2 for template ref: id is missing: ticket [AD30-2167] fixes an javax.servlet.ServletException error by correcting link format in the old ART-DECOR 2 Template Panel.
• Dataset concept information incomplete for comments: ticket [AD30-2168] fixes a problem in the JGZ dataset version 4.2.0.
  • A concept's comment field is expected to inherit 3 comments from version 3.2.7.
  • However, the API response returns 3 empty inheritedComment objects (only with "language": "nl-NL") instead of the expected comments with actual text content.
  • Now each inheritedComment includes both the language and the comment text.

Hints for Updating an ART-DECOR® Release for local installations

For all our hosted servers we do planned and announced updates of the server software regarding backend and frontend, comprised of ART-DECOR Vue and ART-DECOR http-proxy.

TIP

When you have a local installation of ART-DECOR and want to update to this release, please consider reading our Updating an ART-DECOR® Release documentation.

Thank you

A BIG thank you!

We are always thankful for any comments and suggestions.

Special thanks for the feedback regarding the Template Viewer and Editor to the colleagues from ELGA (Austria) and HL7 Italy / Ernst&Young (EY) and for Dataset and Questionnaire editor to the Berlin Institute of Health @ Charité team.

Especially in the terminology and questionnaire sector we got great feedback from the Dutch ICT Institute in Health Care (Nictiz). Thanks to Gunter Haroske working for the Deutsche Gesellschaft für Pathologie / German Association of Pathology pointing to shortcomings and missing features in our Questionnaire functions and to the Dutch Uitkomstgerichte Zorg Program for contributions in the same area.

Special thanks also to the mio42 GmbH team, Agence du Numérique en Santé (ANS) and our partners at Kereval / IHE Europe for testing, feature suggestions and bug fix requests.

Please don't hesitate to write us with suggestions for improvements or feature requests to our email address provided for this purpose: feedback@art-decor.org, also easily reachable through the Services Card at our ART-DECOR landing page (the link with the bulb 😃).

Outlook

Current development is heading towards Release 3.10 which focuses on further enhancements and features for Questionnaire Management. We might have an intermediate minor release 3.9.2 in between.

At the same time we are currently also working on the ART-DECOR Release 4 series. This will imply a big update on the frontend as we switch to Vue 3, also the backend will make use of the new eXist-db Database Release v6.4.0.

As you can see: more on that to come. Thank you for your patience. Stay tuned.