ART-DECOR® – Release 3.10.2

Release notes 12 June 2026

Introduction

We are happy to announce ART-DECOR® Release 3.10.2. This maintenance release builds upon Release 3.10.1 and addresses a total of 62 resolved tickets. These consist of new features, improvements, and bug fixes across the platform.

The highlights of this release are:

• Continued advancement of Transaction Building Blocks (TBB) — including frontend tree display, edit and constrain support
• Obligation support in transactions — a new mechanism to express element-level obligations relative to actors, aligned with FHIR Obligations Framework
• Questionnaire improvements including LHCForms update to version 41.0.0, enableWhen rule persistence fix, and removal of the 50-item limit on panels
• Terminology enhancements: CodeSystem purpose support, derived name from displayName for CodeSystems and value sets
• Added download option for datasets and scenario/transactions as FHIR Logical models in FSH format
• FHIR fixes for external dataset links, value set expansion display language, and questionnaire element rendering in development releases
• Migrated DECOR services modules from legacy art library functions to modern api module counterparts

NOTE

Release 3.10.2 is a cumulative update and fully replaces 3.10.1. Existing installations should upgrade directly to this version.

General Remarks

As announced in the previous release notes, this release includes further previews.

Preview: Implementation Guide Processing

Implementation Guide management has received an enhancement. ART-DECOR publication management is now able to handle requests for publishing an implementation guide. Expect more details in upcoming releases.

Transaction Building Blocks

The Transaction Building Blocks (TBB) feature set continues to advance in this release, building on work delivered in 3.10.1.

Frontend TBB tree display (AD30-2385): The transaction tree now renders TBB child concepts inline. Users can view and edit cardinality and conformance of child concepts directly within the transaction editor, using the normal transaction editing workflow.

Frontend TBB constrainment (AD30-2315, AD30-2399): The transaction tree now displays constrainment cardinality and conformance for TBB concepts. The detail panel shows both the original and overriden values side by side, giving users full visibility into the constraint chain.

Editing TBB concepts (AD30-2420, AD30-2444, AD30-2468): Child concepts beneath the top-level TBB concept can now also be edited. Changes are now processed recursively, so overrides at any nesting depth are correctly persisted. When writing changes: override validation rules are applied relative to the resolved original concept.

API support for TBB (AD30-2424): The concept API now accepts an additional containedTransactionId parameter, enabling the detail panel to display and edit isOverride, originalConcept, and finalConcept for concepts within a TBB context.

Compile filter to exlude TBB transactions (AD30-2393): Projects containing TBB transactions can now be compiled/published, provided the TBB transaction is excluded from the transaction filter. Previously, the presence of any TBB blocked compilation and publication entirely.

Obligation Support in Transactions

This release introduces (backend) Obligation support in transactions (AD30-2365), aligned with the HL7 FHIR Obligations Framework extension. Obligations allow specifying element-level conformance statements directed at specific actors (e.g. sender vs. receiver), going beyond the traditional @conformance and @isMandatory attributes.

Backend support (AD30-2369): The DECOR schema and API JSON schema have been updated. Obligations are stored under transaction/representingTemplate/concept and support read (GET), write (PUT/PATCH), compilation, and HTML view rendering. FHIR R4 export now produces StructureDefinition resources with obligation extensions and ActorDefinition resources for referenced actors. A new demo project (demo16) demonstrates the full obligation workflow. Business rules enforce that obligation actors must be part of the transaction or contained transaction.

Questionnaires

Several improvements and fixes have been made to the Questionnaire subsystem.

LHCForms update (AD30-2400, AD30-2412): LHCForms has been updated from version 36.3.2 to 41.0.0 in both DECOR services and ART-DECOR frontend. The DECOR services rendering has been refactored to use a single source of truth via the FHIR R4 server, and the LHCForms initialisation is now consistent between ART-DECOR 2 and ART-DECOR 3. This update is in preparation of questionnaire score calculation support in Release 3.11. For now questionnaire score calculation is supported for read and write actions via the backend API.

enableWhen rule persistence (AD30-2474): enableWhen rules for integer-type questions were not being persisted when saving a Questionnaire. The serialisation logic has been corrected so that enableWhen rules are now reliably stored.

questionnaire-unitOption extension (AD30-2475): The questionnaire-unitOption extension was incorrectly applied to integer-type items, causing LHCForms rendering to fail. The backend now maps .unitOption to the correct FHIR extension based on item type: questionnaire-unit for integer/decimal and questionnaire-unitOption for quantity. DECOR.sch validation rules have been updated accordingly, and the legacy .unit element has been retired.

Questionnaire panel 50-item limit (AD30-2470): The questionnaire list panel was limited to 50 items by a hardcoded backend maximum. The maxResults parameter pattern from the code system API has been applied to the Questionnaire API: when the frontend does not specify a maximum, the full list is returned.

Questionnaire elements in development release (AD30-2486): Questionnaire name and other elements were returned as raw #text content instead of structured elements when querying a development release. The serialisation has been corrected so that the project index displays questionnaire names properly.

Terminology

code system purpose support (AD30-2446): The purpose element was missing from the code system API response. It is now included and visible in the frontend detail view.

Derived name from displayName : A new function generates URL-safe names from display names (e.g. "Referral Setting" → "vs-referral-setting"). This function is now applied to templates (AD30-2449), valuesets (AD30-2320), and codesystems (AD30-2321) on write operations, preventing name clashes after cloning and providing consistent canonical URL segments.

Code system report persistance (AD30-2383): The code system report overview was only showing reports for the currently selected code system. It now lists all available code system reports regardless of selection.

CodeSystem-to-CADTS conversion (AD30-2447): A new Project Maintenance function has been added to the Artifact Management tab, allowing project administrators to convert all project code systems to CADTS for expansion. This is useful when code systems are added manually outside the normal import flow.

FHIR

External dataset FHIR links (AD30-2465): FHIR R4 links for datasets inherited or referenced from external projects were returning HTTP 404 errors. The project index now correctly resolves the source project for external datasets.

value set expansion display language (AD30-2451): FHIR value set expansions were not respecting the requested display language. The expansion logic now honours the language parameter.

FSH download in AID dialog (AD30-2101): The AID (Artifact Information & Download) dialog for datasets and scenarios/transactions now includes an FSH download option, building on the backend FSH extract support established in earlier releases.

FHIR constraint co-occurrence (AD30-2473): FHIR constraint elements with @key attributes in demo project data were triggering false co-occurrence violations in DECOR.sch. The Schematron rules and template merge logic now recognise @key as a distinguishing attribute.

Templates

Duplicate template names (AD30-1996): The name derivation fix in AD30-2041 and AD30-2449 prevents duplicate template names from occurring. The template @name attribute was not being properly maintained during clone and "New Template from Prototype" operations. Cloned templates could end up with identical @name values, causing Schematron compilation errors (duplicate ID values). The name is now automatically derived from the displayName on any PATCH, PUT, or POST action. Additionally, the full-screen title bar now shows the displayName instead of the internal name.

Template association tree view (AD30-2431): The tree view in the Template-Associations panel was not showing names for items (only groups). This has been corrected.

Empty template examples (AD30-2433): Empty example element were returned when there are no example elements in the original template at all. It now correctly returns an empty sequence.

Template example refresh (AD30-2440): After editing and saving a template example, the edit screen was not reflecting the change until "save and close" was used. The view now refreshes immediately after save.

Transactions and Datasets

Scenario cardinality "OTHER" (AD30-2353): The "OTHER" cardinalities (n..m with n ≤ m) for scenario conditions were missing. This has been resolved.

Transaction editability (AD30-2299): Transactions were editable in the frontend even when the parent transaction or scenario was final. ART-DECOR now refuses illegal updates, and status flips are allowed only to restore invalid situations.

Multi-attribute properties fix (AD30-2443): Editing properties with multiple attributes was failing. This is now resolved.

Value set association retrieval (AD30-2467): Opening associations for certain valuesets caused a cardinality error when the target object resolved to multiple elements. The API now handles this correctly.

RetrieveTransaction failed in some cases (AD30-2341): RetrieveTransaction service was failing with "element has more than one attribute 'xml:dummy-1'" on certain template chains. This has been corrected.

PDF Export

PDF export blocked by mixed content (AD30-2426): PDF export was blocked on HTTPS sites because the exporter was requesting content over HTTP, triggering browser mixed-content restrictions. The exporter now uses HTTPS consistently.

PDF dialog artefact (AD30-2391): The PDF download dialog left a scrollable div behind that could not be closed. This has been fixed.

Project and Administration

Governance group details (AD30-2428): The governance group detail page was missing basic project information (id, prefix, name, default language), causing the page to fail to load.

ART-DECOR 2 RetrieveConceptDiagram (AD30-2427): The ART-DECOR 2 ProjectIndex link to RetrieveConceptDiagram failed to load. The ART-DECOR 2 service now correctly routes to the ART-DECOR 3 service.

ART-DECOR 3 ProjectIndex reference datasets (AD30-2404): The ART-DECOR 3 ProjectIndex was not including the &project= parameter on calls for referenced datasets in development releases. The parameter is now included on all calls.

Project Development tab layout (AD30-2448): The Project Development tabs have been realigned to match the layout of the System Admin Function tabs.

Artifact Management error (AD30-2432): The "Add template element and attribute IDs" function in the Artifact Management tab threw an error when called without a specific template ID. The function now correctly processes all templates in the project when no ID is specified.

Artifact Select version info (AD30-2392): The artifact selection dialog now shows version and version label alongside the artifact name, helping users identify the correct version.

Community ADA links (AD30-2452): ADA community links are now generated as relative paths when creating or updating ADA definitions. The example project post-install script also fixes existing paths.

Cache refresh fix (AD30-2463): The "Truly refresh" cache option failed with HTTP 404 when a 3.10.2 client attempted to call the RedirectCache service on a 3.10.1 server.

Cache workaround for TLS 1.3 / ALPN (AD30-2419): Some Building Block Repository servers require TLS 1.3 with ALPN, which eXist-db's Apache HttpClient 4.x cannot support. A workaround using nginx rewrite rules has been established to serve cached files via simple GET requests.

Software Development and Internal

De-art DECOR services and compilation (AD30-2374): All DECOR services modules have been migrated from legacy art library functions to modern api module counterparts. This includes ProjectIndex, GovernanceGroupList, IssueIndex, OIDIndex, TerminologyReport, and over 30 other modules. The compilation library has been unified so that only one codebase needs to be maintained. There is no user-visible change in behaviour.

ProjectIndex cache migration (AD30-2331): The decor-cache.xqm module no longer calls the ART-DECOR 2 RetrieveProject service for local project caching. It now uses an internal function with equivalent output, completing the de-art migration for this module.

ConceptMap edit via POST (AD30-2185): The conceptmap/$edit endpoint threw a "variable '$template' is not set" error. The function has been corrected. Note that the though the frontend currently uses api/$lock instead.

Publications

Publication subtitle on subpages (AD30-2405): The publication subtitle is now included on all subpages, not just main pages, with a parameter to toggle display.

Documentation

Docs dark mode (AD30-2411): The datatype overview image on the documentation site was illegible in dark mode due to a transparent background. The image has been updated.

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. For cliens that run their own installations, this section includes hints for upgrading your installation.

npm build vulnerabilities (AD30-2454): Critical security vulnerabilities in axios (< 1.15.1) and 10 high-severity module vulnerabilities have been resolved by updating dependencies in both the art-decor and http-proxy packages. For clients that running the vue frontend, please update to our newest vue frontend version.

XSLT Saxon compilation failure (AD30-2421): A critical bug in Saxon 9 caused XSLT transformations to fail with UnsupportedOperationException: Cannot enumerate an infinite set during stylesheet compilation. This affected all sites using Saxon < 12.0, including ADRAM. The recommended fix is to upgrade ADRAM and/or ADAWIB which include the upgraded version Saxon-HE 12.9. Only clients that are running ADRAM, or ADAWIB are effected by this change.

Please Note

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.3 as well as towards 3.11 which focuses on further enhancements and features for Questionnaire Management, including score calculation support. We plan to have intermediate minor releases to tackle remaining improvements appropriately but stepwise. We are also working hard on our new FHIR Profile Editor utilizing FHIR Shorthand (FSH).

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.

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