Releases: IHTSDO/snowstorm-x
LOINC Fix Release 9.0.1
This release is based on Snowstorm 9.0.0 but with a fix to load LOINC packages using the new format from 7.23 and above.
Beta Release 8.3.0 - Postcoordination
This SnowstormX beta release introduces SNOMED CT postcoordination support in the FHIR API.
This is the reference implementation to accompany the newly published SNOMED CT Practical Guide to Postcoordination from SNOMED International.
Features
- SNOMED CT postcoordination support
- Validate SNOMED CT postcoordinated expressions
- Check the syntax and Machine Readable Concept Model rules
- Transform common expressions to an MRCM compliant and classifiable form
- Test subsumption with postcoordinated expressions using incremental classification
- Build an expression repository using a FHIR code system supplement
- ECL support
- Expression repository uses expression refsets and other RF2 structures to support backup and restore
- Validate SNOMED CT postcoordinated expressions
See new SnowstormX Postman collection that includes postcoordination examples:
Postcoordination Setup
- Setup Snowstorm in the normal way. See Getting Started Guide
- Import the International Edition snapshot onto the MAIN branch
- Create a folder called
releases
, in the same folder as the Snowstorm jar, and put the RF2 zip into the folder. Rename the zip file to900000000000207008_20230731_snapshot.zip
replacing the datestamp if needed. - Follow the Postman collection link above and import that into your local Postman application.
The remaining steps are all within Postman... - In the top right corner of Postman change the environment from "No Environment" to "Localhost FHIR, Port 8080".
- Use the operation POST "Create a SNOMED CT Postcoordinated Expression CodeSystem Supplement - SnowstormX" - check in the body tab that effective time within the
supplements
parameter matches the version that was imported. - Use the operation PATCH "Insert Postcoordinated Expression into CodeSystem - SnowstormX" to insert expressions one at a time, or in bulk. The body tab has an array of add concept operations, each with a code that is the close to user form expression. To get good bulk performance it should be possible to add around 100 concepts at once by sending them as a batch using this array.
- Use expand operation GET "Run an ECL query against Postcoordinated Expression CodeSystem Supplement - SnowstormX" to run ECL against the expressions. This is the normal ValueSet expand operation with an extra system-version parameter to select the expression codesystem supplement.
Beta Release 8.2.0
All of these features and fixes have now been merged into the official Snowstorm release version 8.1.0 and later.
This beta release further enhances the FHIR multiple codesystems feature.
Features
- Add HTML formatting to FHIR API responses when in a web browser
- Add import of ValueSets via FHIR package (previously only CodeSystems were persisted)
- Add support for nested ValueSets, not including SNOMED CT
- Add ValueSet filters 'is-a' and 'descendant-of' for generic hierarchical CodeSystems
Improvements
- FHIR package import:
- Resources are automatically replaced when the URL and version matches
- Less verbose logging
Beta Release 8.1.1 - FHIR Multiple Code Systems and Packages (fix)
This beta release follows Beta 8.1.0 and contains fixes needed when importing all the CodeSystems within a FHIR package that contains
potentially duplicate CodeSystem versions. This is required to import some HL7 packages, for example hl7.terminology.r4-3.1.0.tgz
.
Fixes
- ISTO-61 More lenient FHIR package import
- Use the package index file as the source of truth for the url and version of CodeSystems imported. This avoids some duplicates in the HL7 package.
- Automatically skip importing a duplicate CodeSystem version if it has "content:not-present". This case is logged at INFO level.
- Make logging less noisy during FHIR package import
Beta Release 8.1.0 - FHIR Multiple Code Systems and Packages
This beta release builds on Beta 8.0.0, adding support for loading code systems from FHIR packages.
See Loading FHIR Packages documentation for details of how to load HL7 code systems and others.
Features
- Add support for loading CodeSystem resources from FHIR packages
Fixes
- Fix total count when listing all ValueSet resources
Beta Release 8.0.0 - FHIR Multiple Code Systems
(This beta release is exactly the same as the one published on the main Snowstorm repository)
This beta release has an overhaul of the FHIR API 🔥 and adds support for multiple code systems!
Previously Snowstorm only supported SNOMED CT but this beta adds FHIR support for LOINC, ICD-10 (International), ICD-10-CM (US) and any other "custom" code system.
The "custom" code system format allows any other local or national code system to be supported. These need to be transformed into the custom code system format before being loaded.
Please refer to the updated v8 FHIR API documentation for details of how to load non-SNOMED code systems. You will also find a link to the updated Postman collection for v8 there.
Breaking
- FHIR API no longer defaults to the SNOMED CT code system
- Renamed FHIR Elasticsearch indices with
fhir_
prefix
Features
- Add FHIR Support for LOINC
- Add FHIR Support for ICD-10
- Add FHIR Support for ICD-10-CM
- Add FHIR Support for Custom code systems
Improvements
- Improve FHIR code system version resolution
- Resolved code system version included in FHIR responses
- Improved FHIR error catching and reporting
Fixes
- Minor fixes for FHIR specification conformance