Document Renderer Service - Improvements/changes

• We changed the default font from Arial to Roboto and included the TrueType font files needed for that to work out of the box. Although Arial and Roboto are quite similar, your generated PDF documents might be different if you use the defaults.
• In order to improve the performance (RAM usage) of the Document Renderer Service we added a font allowList to the service configuration. If you don't rely on the default configuration you must add one or more entries to the font allowList, depending on the actual fonts you use in your documents.

Material Theme - @blueriq/dashboard

In order to connect to the new API of the DCM Dashboard Service, we have introduced a new Module in the @blueriq/dashboard  package which is released in version 0.18.8. The main changes for the Material Theme, for version 1.4.0, can be found in this commit on github.com. With the introduction of the new BlueriqDashboardModule we have moved a lot of the implementation from Material Theme to the @blueriq/dashboard package. Refer to the getting started documentation, on how to use the new Module in comparison to the legacy DashboardBackendModule.

In version 1.4.2 of the Material Theme we have made a small change regarding the routes of the Dashboard Application, these changes can be found in this commit.

DCM Dashboard Service

Context path

In version 2.2 of the DCM Dashboard Service we have added a new default context path: /dcm-dashboard. This could have impact on your current services which connect to the DCM Dashboard Service. 

Gateway Service configuration

In the Gateway Service configuration a route is configured to connect to the DCM Dashboard Service. This route configuration needs to be updated to the following, for the legacy API of the Dashboard Service to still work.

spring:
  cloud:
    gateway:
      routes:
        - id: dashboard
          uri: http://<host>:<port>
          predicates:
            - Path=/dcm-dashboard/**
        - id: legacy-dashboard
          uri: http://<host>:<port>
          predicates:
            - Path=/dashboards/**
          filters:
            - PrefixPath=/dcm-dashboard

The legacy endpoint will still use '/dashboards' route but it will send a context path prefix of /dcm-dashboard so the DCM Dashboard Service understands what is happening.

Dashboard project data source properties

In DCM Dashboard Service 2.2, we introduced properties for enabling Dashboard project data sources and we renamed the blueriq.dcm.dashboard.definitions.location property. Please review the new and renamed properties below and update your configuration accordingly.

Nullability in REST services

With the capability of modelling whether a Domain Schema property is nullable, various changes in REST request processing in support of nullable properties. Models are automatically migrated such that Domain Schema properties remain nullable (aligning with the behavior in prior versions), there are cases where behavior differences may be observed:

1. Array and object values (corresponding with multivalued properties and inline or referenced domain schema properties, respectively) used to be entirely ignored when they had an explicit null  value. Now, this results in assigning a user-set unknown into the Blueriq profile, as well as triggering the field validations of those properties.
2. Serliazation to and from XML has been changed to set xsi:nil="true"  on XML elements that represent a null  value. Previously there was a discrepancy where this resulted in an empty element tag, which would get parsed into an empty string instead of unknown when received by Blueriq.
3. JSON parsing did not properly handle commas within arrays and objects. This has been addressed, resulting in parse errors when trailing commas are present. Such trailing commas are not valid JSON and are now reported as such.

Known issues

For an overview of known issue please refer to: Known issues.