Release notes Vonk

Release 0.4.0.1

Database

  1. Long URL’s for absolute references are now supported, but that required a change of the SQL Server database structure. If you have AutoUpdateDatabase enabled, Vonk will automatically apply the changes. As always, perform a backup first if you have production data in the database.
  2. Datetime elements have a new serialization format in MongoDB. After installing this version, you will see warnings about indexes on these fields. Please perform Re-indexing for new or changed SearchParameters, for all parameters with <vonk-endpoint>/administration/reindex/all. You don’t have to restart Vonk afterwards, but if you do, the warnings should be gone.

Features and fixes

  1. Fix: SearchParameters with a hyphen (‘-‘, e.g. general-practitioner) were not recognized in (reverse) chains.
  2. Fix: CapabilityStatement is more complete, including (rev)includes and support for generic parameters besides the SearchParameters (like _count). Also the SearchParameters now have their canonical url and a description.
  3. Improvement: Preloading a set of resources gives more informative warning messages.
  4. Fix: Re-indexing for new or changed SearchParameters did not handle contained resources correctly. If you have used this feature on the 0.3.3 version, please apply it again with <vonk-endpoint>/administration/reindex/all to correct any errors.
  5. Improvement: Loading profiles from Simplifier now also works for the Memory implementation.
  6. Improvements on Validation:
  • profile parameter can also be supplied on the url
  • if validation is successful, an OperationOutcome is still returned
  • it always returns 200, and not 422 if the resource could not be parsed
  1. Feature: support for Conditional Read, honouring if-modified-since and if-none-match headers.
  2. Fix: Allow for url’s longer than 128 characters in Reference components.
  3. Fix: Allow for an id in a resource on a Create interaction (and ignore that id).
  4. Fix: Allow for an id in a resource on a Conditional Update interaction (and ignore that id).
  5. Fix: Include Last-Modified header on Capability interaction.
  6. Fix: Format Last-Modified header in httpdate format.
  7. Fix: Include version in bundle.entry.fullUrl on the History interaction.
  8. Fix: Update _sort syntax from DSTU2 to STU3. Note: _sort is still only implemented for _lastUpdated, mainly for the History interaction.
  9. Improvement: If the request comes from a browser, the response is sent with a Content-Type of application/xml, to allow the browser to render it natively. Note that most browsers only render the narrative if they receive xml.

Release 0.3.3.0

Attention

We upgraded to .NET Core 2.0. For this release you have to install .NET Core Runtime 2.0, that you can download from dot.net.

Hosting

The options for enabling and configuring HTTPS have moved. They are now in appsettings.json, under ‘Hosting’:
"Hosting": {
  "HttpPort": 4080,
  "HttpsPort": 4081, // Enable this to use https
  "CertificateFile": "<your-certificate-file>.pfx", //Relevant when HttpsPort is present
  "CertificatePassword" : "<cert-pass>" // Relevant when HttpsPort is present
},

This means you have to adjust your environment variables for CertificateFile and CertificatePassword (if you had set them) to:

VONK_Hosting:CertificateFile
VONK_Hosting:CertificatePassword

The setting ‘UseHttps’ is gone, in favour of Hosting:HttpsPort.

Database

There are no changes to the database structure.

Features and fixes

  1. Feature: Subscription is more heavily checked on create and update. If all checks pass, status is set to active. If not, the Subscription is not stored, and Vonk returns an OperationOutcome with the errors.
  • Criteria must all be supported
  • Endpoint must be absolute and a correct url
  • Enddate is in the future
  • Payload mimetype is supported
  1. Feature: use _elements on Search
  2. Feature: load profiles from your Simplifier project at startup.
  3. Feature: Content-Length header is populated.
  4. Fix: PUT or POST on /metadata returned 200 OK, but now returns 405 Method not allowed.
  5. Fix: Sometimes an error message would appear twice in an OperationOutcome.
  6. Fix: _summary is not yet implemented, but was not reported as ‘not supported’ in the OperationOutcome. Now it is. (Soon we will actually implement _summary.)
  7. Fix: If-None-Exist header was also processed on an update, where it is only defined for a create.
  8. Fix: Set Bundle.entry.search.mode to ‘outcome’ for an OperationOutcome in the search results.
  9. UI: Display software version on homepage.

Release 0.3.2.0

  1. Fix: _include and _revinclude could include too many resources.

Release 0.3.1.0

  1. IP address restricted access to Administration API functions.
  2. Fix on Subscriptions:
  1. Accept only Subscriptions with a channel of type rest-hook and the payload (if present) has a valid mimetype.
  2. Set them from requested to active if they are accepted.

Release 0.3.0.0

  1. Database changes

If you have professional support, please consult us on the best way to upgrade your database.

  1. The schema for the SQL Database has changed. It also requires re-indexing all resources.
  2. The (implicit) schema for the documents in the MongoDb database has changed.
  3. The Administration API requires a separate database (SQL) or collection (MongoDb).
  1. New features:
  1. Custom Search Parameters
  2. Support for Subscriptions with rest-hook channel
  3. Preload resources from a zip.
  4. Reset database
  5. Conditional create / update / delete
  6. Support for the prefer header
  7. Validation on update / create (can be turned on/off)
  8. Restrict creates/updated to specific profiles.
  9. Configure supported interactions (turn certain interactions on/off)
  1. New search features:
  1. _has
  2. _type (search on system level)
  3. _list
  4. _revinclude
  1. Enhancements
  1. :exact: Correctly search case (in)sensitive when the :exact modifier is (not) used on string parameters.
  2. Enhanced reporting of errors and warnings in the OperationOutcome.
  3. Custom profiles / StructureDefinitions separated in the Administration API (instead of in the regular database).
  4. Full FHIRPath support for Search Parameters.
  5. Fixed date searches on dates without seconds and timezone
  6. Fixed evaluation of modifier :missing
  7. Correct total number of results in search result bundle.
  8. Fix paging links in search result bundle
  9. Better support for mimetypes.
  1. DevOps:
  1. New Vonk Administration API
  2. Enabled logging of the SQL statements issued by Vonk (see Log settings)
  3. Migrations for SQL Server (auto create database schema, also for the Administration API)
  1. Performance
  1. Added indexes to MongoDb and SQL Server implementations.