Skip to content

Beta Release 8.3.0 - Postcoordination

Latest
Compare
Choose a tag to compare
@kaicode kaicode released this 14 Apr 18:33
· 387 commits to master since this release

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
    • 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

See new SnowstormX Postman collection that includes postcoordination examples:

Run in Postman

Postcoordination Setup

  1. Setup Snowstorm in the normal way. See Getting Started Guide
  2. Import the International Edition snapshot onto the MAIN branch
  3. 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 to 900000000000207008_20230731_snapshot.zip replacing the datestamp if needed.
  4. Follow the Postman collection link above and import that into your local Postman application.
    The remaining steps are all within Postman...
  5. In the top right corner of Postman change the environment from "No Environment" to "Localhost FHIR, Port 8080".
  6. 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.
  7. 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.
  8. 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.