Page tree

Date 20:00 UTC on Tuesday 22 February 2022 - 90 minutes.   

Objectives

  • FHIR Terminology Services and Resources

Discussion items

ItemDescription

Mins

OwnerNotes & Actions
1Welcome and introductions2

Recording, notes & attendance.

Great date!   Please remark when it's 20220222-20:22

2Previous Meetings


3Other Meetings


Recent events:

HL7 Jan 2022 Virtual meeting: Aim for testing ConceptMap on the Connectathon (Jan 10-12).

HL7 May 2 - 4 (running in Eastern Time) 2022 Dallas  Virtual .  9 - 13 Working Group Meetings

Upcoming events:

10:00 UTC from Wednesday 16 February 2022 every 4 weeks (the "off" week from this call). TB & TS.

April 2 -7 SNOMED International Business Meeting (London / Hybrid) 

PJ 24 Aug  No Nov Dev Days 2021.   Next will be US Edition in June 2022 (Cleveland / Hybrid)

New HL7 Group TSMG (meeting Wed PM ET every other week) - Terminology Service Management Group (HTA Thursday AM is now a subgroup of the TSMG)

2022-02-22:

Registration for April Business meetings open, as is call for abstracts for the SNOMED Expo fall 2022.

Upcoming SNOMED on FHIR session at the business meeting needs planning. Both TS and TB. Ideas for topics:

  • SNOMED+FHIR education
  • What should be in the Implementation Guide? (missing/to be added)
  • SNOMED+FHIR in multilanguage settings
  • ...
4Cardinality on Designation.use

https://jira.hl7.org/browse/FHIR-29821

Expected to be part of R5.

RH - can we look at combining this with the Designation Context of Use Extension?

2022-02-22:

Add HL7 Jira ticket about designation use context and designation.additionalUse. For discussion on HL7 Vocab call March 3.

5SNOMED CT guidance around Allergy and Hypersensitivity

20

Asked group for review of FHIR specific elements in "

Implementation Guide for Use of SNOMED CT in Documentation of Allergy, Non-allergic Hypersensitivity and Intolerance" 

The SNOMED Allergy CRG have developed guidelines for representing allergies in EHRs and messages. It contains a section on the use of FHIR AllergyIntolerance resource which refers to the two SNOMED on FHIR AllergyIntolerence profiles.

The current (R4, and future R5) FHIR resource does not have sufficient detail to allow mapping to the SNOMED allergy model. Could be raised by the HL7 Patient Care WG.

8 Feb 2022 - MAL reported meeting DK and he's put some of the examples (see here) in the document into JSON.  Other minor corrections.   

2022-02-22:

AllergyIntolerance detailedType extension, check allowed cardinality is 0..1.

http://build.fhir.org/ig/IHTSDO/snomed-ig/branches/allergy_guide/StructureDefinition-allergy-intolerance-detailed-type.html

6Post-coordination on FHIR

2022-02-22:

Presentation: https://docs.google.com/presentation/d/1Kz-8N6UQsGZ8C1xsC8TZT6LEbeyr6elrgMt2FI-whjU

Proposal might include using side-effects which some might be sensitive to.

7Upcoming R5 changes

Discussion about proposed federation.  ML Doesn't work so well with SNOMED CT because there's not a single authoritative source due to country extensions (and multiple versions being released).  Use case for this is mainly in creation of IGs.  Agreement that what a conformant server should be able to state in Capability Statement is helpful.   ML Touchstone test script artefacts need investment.  See https://touchstone.aegis.net/touchstone/

See also https://inferno.healthit.gov/

16 Nov Update RH: Updates in for next ballot (not January now).

8 Feb RH: Next ballot confirmed May (deadline March 6)

8

"url" field returned in implicit ValueSets

Field is not mandatory.



Ontoserver examples: https://r4.ontoserver.csiro.au/fhir/ValueSet?_format=json

Implicit: https://r4.ontoserver.csiro.au/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=isa/410607006&count=5&_format=json

Gives url = "http://snomed.info/sct/32506021000036107/version/20211130?fhir_vs=isa%2F410607006"

Snowstorm examples: https://snowstorm.ihtsdotools.org/fhir/ValueSet

Implicit example: https://snowstorm.ihtsdotools.org/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=isa/410607006&system-version=http://snomed.info/xsct&count=5   here we just return the url parameter that was specified in the GET request.

SNOMED International follows published URI spec in this matter, see 2.7 URIs for SNOMED Resources  for pre-defined ValueSets. Hmm, we agreed that valueSet was a thing that existed independently of it's implementation (Kuala Lumpur discussion) but that hasn't made it to the spec.

Query is about what version gets used in the parameter field.   The spec says "The server decides which parameters to include here, but at a minimum, the list SHOULD include all of the parameters that affect the $expand operation. If the expansion will be persisted all of these parameters SHALL be included. If the codeSystem on the server has a specified version then this version SHALL be provided as a parameter in the expansion (note that not all code systems have a version)."


PJ suggests that we should populate the system-version here instead and that "version" would really be the version of the ValueSet itself which, given that it's being generated at runtime, could be the current timestamp.

9New change proposals for $validate-code

G Grieve have created new HL7 Jira tickets: https://chat.fhir.org/#narrow/stream/179202-terminology/topic/Change.20Proposals.20for.20.24validate-code.20post.20Connectathon

Grahame Grieve: https://jira.hl7.org/browse/FHIR-33941: $validate-code should return system | version | code when display is returned

Grahame Grieve: https://jira.hl7.org/browse/FHIR-33943: $validate-code should return an operation outcome with the full details of issues found, including paths

Grahame Grieve: https://jira.hl7.org/browse/FHIR-33944: $validate-code and $expand should have a parameter for related value sets and code systems

Grahame Grieve: https://jira.hl7.org/browse/FHIR-33946: $validate-code and $expand need a session parameter (as optimisation where ValueSet may need to be uploaded for a series of calls)

Grahame Grieve: https://jira.hl7.org/browse/FHIR-33947: Clarify the use of fragment  (this is a discovered issue from the same session, relating to the first of the tasks above)

ML - general principle that services should echo back the details they've been sent to process.

PJ - CodeableConcept (with multiple codings) will require multiple responses.  ML - call multiple times with single codes as a workaround.

10AND / OR  in ValueSet Filter
Peter G. Williams

Normally when a filter is applied eg "Size 12" + "green" we expect both qualities to be true at the same time and this is held true by the FHIR Spec that says "If multiple filters are specified, they SHALL all be true."  (see http://build.fhir.org/valueset-definitions.html#ValueSet.compose.include.filter)  However  http://hl7.org/fhir/R4/valueset-substance-code.json.html  has two filters that pick up substances PLUS products   and obviously they can't both be true at the same time.    So it seems like sometimes we use conjunction and sometimes disjunction?  

Snowstorm GitHub issue #285 changes behaviour from AND to OR when multiple filters are applied.

Answer is: the separate includes are disjunctive and objects within the same filter array are conjunctive.

Text here is clearer: http://build.fhir.org/valueset.html#compositions

SideNote:   Wildcard for versions in $expand, see https://jira.hl7.org/browse/FHIR-15998   Note that "version" here would mean multiple editions.

11Definition of GPS
Rob Hausam

Request that SI make the GPS ValueSet available as an extensional definition.

SI are (I think - PWI) in agreement to do this.

  • Peter G. Williamsticket and progress.   MAINT-1740 Target October 15 into production (need SearchAfter functionality for Refset Members).   Also check date for next GPS publication.

16 Nov Update:   "Search After" functionality will be available in Prod 1 Dec.

12Topics for Terminology Binding Stream

Collecting topics for TB stream here, with a view to having a call when there's sufficient material

FamilyMemberHistory - how is "no family history of X" best represented?

FreshDesk ticket question on Allergy substance cross field validation.  DK: Mappings to other information models, is that helpful?

Oct 5 2021 Request for input from nutrition CRG.

8 Feb 2022 MAL Patient Care group proposing the use of an extension (specified by Daniel) to represent Allergy Type to add non-allergic hypersensitivity.  MAL wondered about allowing a Codeable Concept there rather than a Code to allow for greater expressivity.   Resource not planning on being Norminative in R5.


13Publishing SNOMED codes in IGs and licencing conditions.

Licensing issues for IGs referring to SNOMED codes. Is this written down anywhere with some sort of rigour?

Consider the licence statement that is presented when accessing the browser. Should something similar be mandated for inclusion in any document published? What if a patient's medical record were to be published?

Update 12 Jan - "One Page Policy" to be discussed internally.   HL7 agreement indicates other parties would require affiliate licence unless they restricted their usage to the Global Patient Set.

26 Jan Question from PJ about inclusion of COVID Vaccine concepts in the GPS (advised that it is only released yearly)  FYI Rory Davidson See also MF discussion here.  SuzyR will follow up.  See also early preview page.

06 April: SR covid vaccines have been/will be incorporated into July release. They will be in GPS when ready. 

8 Feb 2022 This was discussed at a CSRM meeting - Peter G. Williamsfollow up with Suzy RoyDK Also do we specify boilerplate copyright statement?  This should also be specified in our IG (or referenced).

14Language Reference Sets in FHIR
All

Mechanisms for working with Languages

Designation extension

Update 19 May: Suggestion that we work an example for SNOMED to discuss with Regenstrief (LOINC)

Update 2 June: Started worked example Designation Extension Example

Update 17 Nov:  Proposal to add more values into designation use https://jira.hl7.org/browse/UP-107

Update 1 Dec: Latest build: http://build.fhir.org/ig/IHTSDO/snomed-ig/branches/duc/StructureDefinition-designation-use-context.html   Ticket: https://jira.hl7.org/browse/UP-155 being replaced by https://jira.hl7.org/browse/FHIR-29821   ML suggested we need an additional value for 'Not Acceptable' that would need an additional value to be explicit, rather than relying on the absence of a 'row'.   Designation Use codeset, or the infrastructure codesystem?  See also http://build.fhir.org/languages.html##term

Update 15 Dec:  Discussing cardinality - when a designation can be applied to multiple roles, do we have repeated elements in a single extension block, or multiple extension blocks?  PJ Checking use case.    Use Case:  To allow tell the client what all use contexts (roles) are available so that it can a) select one making an informed choice and b) gradual degradation where the best available terms are used where they exist, falling back to a less preferable term where they do not.  Worked example from MLhttps://gist.github.com/pgwilliams/8c742d68878b1fda0638a798668e42f2    also http://build.fhir.org/ig/IHTSDO/snomed-ig/branches/lawley-patch-1/CodeSystem-CodeSystemDesignationUseExample1.html 
On question if this should be part of core spec or remain in SNOMED IG we can consider if this is of use to any other Terminology eg LOINC or RxNorm.

12 Jan Update: Rob Hausam looking for clarity to take forward with Vocab group.   How to align this with other in-flight trackers (eg https://jira.hl7.org/browse/UP-107) that propose expanding designation use which - we think - seeks to overload designation use in a way that wouldn't ( ?) allow more than one value at the same time and these features of designations can vary independently.

12 Jan Proposal:   All 3 elements (including designation type) should be included in our proposed extension.   SNOMED implementations would then pick the most appropriate designation.use value from whatever set is offered in the spec   eg FSN where it is an FSN (because - although also considered 'preferred' - these are seldom used for user interfaces), PreferredForLanguage where we have the preferred term for a given language/dialect and Synonym for anything else.

26 Jan: RH update - is ongoing discussion.  Attempting "best of both worlds" approach.  Not on the Vocab group's agenda, won't be in R4B.    Question from ML about display vs preferredForLanguage here.  Proposed extension to list of designation use will necessitate repetition of designations where they have multiple uses.   See DK example here:  http://build.fhir.org/ig/IHTSDO/snomed-ig/branches/duc/ValueSet-DrugValueSetExample1.json.html

RH: Suggestion that Ontoserver and/or Snowstorm could try an implementation of our extension.   Clients are expected to ignore extensions that they don't understand.

9 Feb 2021 ML Experience with NL and LOINC.  Could we explore using Language tag with a private X language (eg nl-x-sctlang-87587989-78574801 BCP 47: privateuse = "x" 1*("-" (1*8alphanum)) ) and the language reference set id - ie allows for things like Patient Friendly Terms.   The preferred term would be mapped to the display element.   Language tags allows for weighted preferences (ie fall back options).  Pros:  avoids an extension and re-uses an existing part of the specification.  DK "No reason not to implement this, the two approaches are not in conflict".   Question: is "Preferred for Language" definitely happening?   RH: Yes

23 Feb 2021 RH brought up discussion with Vocab group.  Check in on tracker UP-107. DK Still a requirement to present results (eg expansion) with the language refsets visible (to know which designation was in which langrefset) - better to use extension or overload core spec?   Querying is fine, issue is making clear what is being returned. Suggested possible to use the BCP47 refset form in the language element.   Difficulty when returning fall back options as display term is that we can't say what we fell back to.

9 March 2021 DK An implementation is now needed.   DK tried out with Snowstorm:  BCP-47 works but not for extension language referencesets (also for designation)  ( note dialect alias configured in application.properties is a separate solution which could also be improved: https://github.com/IHTSDO/snowstorm/blob/master/src/main/resources/application.properties#L217 ).  SM NL BCP-47solution getting great feedback.

23 March 2021 DK Testing Snowstorm which looks at designation and language headers.   Just needs attention especially for extension content.  

20 April 2021 RH Looking to target next ballot round.   Could we host this extension ourselves in the meantime and target May connectathon? Peter G. Williams

27 July RH & ML:- Still a work in progress. DK will return Aug 1; we should follow up with him next time.

ML:- Potentially fall into R5 on Ontoserver.

24 August DK Added pull request to Snowstorm  here

Implementation by ML using existing fields and specifying LangRefset in displayLanguage parameter with "preferredForLanguage" code and wildcard  Eg https://r4.ontoserver.csiro.au/fhir/ValueSet/$expand?displayLanguage=*-x-sctlang-20581000-087109&_format=json&url=http://snomed.info/sct/20611000087101?fhir_vs=ecl/160303001&includeDesignations=true

Oct 5 Release of Ontoserver 6.5.0 which includes support for language reference sets as above.

Next Steps:   How to promote - could we present at a Vocab call?   (1530 ET Thursdays - may clash with SI Languages call)

8 Feb 2022 DK  added Designation Extension into the SNOMED on FHIR IG see http://build.fhir.org/ig/IHTSDO/snomed-ig/StructureDefinition-designation-use-context.html

15SNOMED FHIR Implementation Guide

Implementation Guide for using SNOMED CT with FHIR.

IG Documentation: http://build.fhir.org/ig/FHIR/ig-guidance/index.html

Also look at the sample IG https://github.com/fhir/sample-ig see build http://build.fhir.org/ig/FHIR/sample-ig/

TODOS 

  • Check build issues http://build.fhir.org/ig/IHTSDO/snomed-ig/qa.html
  • Rerun with latest tooling (also sushi)
  • Run with local snowstorm provided as Tx
  • See Mark Kramer presentation 
  • CONTENT!  (PWI speak to PTB)
  • Merge in DUC branch (Designation Use Context) with a view to implementing in a branch of Snowstorm and making available via connectathon.ihtsdotools.org
  • Clean up other branches
  • Check templates are up to date - should now be self updating, see https://github.com/FHIR/sample-ig (fsh may ask to update this structure).   Sushi sending out information about new format (PJ says leading whitespace is now significant).
  • ReadMe should provide links for Publisher tooling
  • Add discussion on Refset / IN (see above)
  • Provide link to it in http://build.fhir.org/snomedct.html and discuss further socializing.
  • TerminologyCapabilities caching is overly aggressive.
16

Expanding ValueSets across multiple Editions.



Discussion on * version wildcard. (relates to a Zulip discussion on expanding a ValueSet against multiple editions to give a superset?)  DK How could we specify the latest version of multiple modules.   Answer http://snomed.info/sct/*   (ie not specifying the version) or http://snomed.info/sct/*/version/*  to include concepts from previous versions.

For use in the module / version URI.   Existing workaround is to use multiple include elements for each version.

7 Sept ML Sticking point - what do we do with incompatible properties eg active/inactive between two different versions - the most recent?

Use case: primarily being able to validate codes that might exist in different editions.   Secondarily, being able to validate code received in a historical record ie where codes were valid at time of data entry.

25 Jan 2022: Snowstorm will already look across all Editions loaded when a codesystem version is not specified, eg:  https://browser.ihtsdotools.org/fhir/CodeSystem/$validate-code?coding=http://snomed.info/sct|443971000124108 only exists in the US Edition.

(See also the History proposals for ECL)

17Long Term Home for Terminology Information

Rob Hausam (primarily Vocab WG)

Long Term Home for Terminology Information that can be maintained independently of FHIR versions.

See https://chat.fhir.org/#narrow/stream/179202-terminology/topic/Why.20does.20the.20spec.20contain.20a.20SNOMED.20CodeSystem.20resource.3F

7 Sept Relates to problematic page https://www.hl7.org/fhir/r4/codesystem-snomedct.html   PWI discuss internally - done.

Update 21 September 2021 - General agreement that that page can be removed.  Is out of date and not serving useful purpose.

Update 25 Jan 2022 - HL7 intend to make The THO https://terminology.hl7.org/ a home for all terminologies and valuesets.

Next Time: Move to archived discussion, make note in IG

18Any Other Business

Quick Questions:   Which International Monthly release should an extension base itself from.  Answer: that would be something for the country to decide.

Six monthly releases will (at a technical level) have no special significance.   Deltas are no longer being generated (as we can't know when the last 'consumed' point would be) but can be created on demand using  https://github.com/IHTSDO/delta-generator-tool

Question for Nick Egarhosout of curiosity are there any vendors out there who implement just the International Edition in their software?  Do we have vendors using some country extension in other unrelated countries?

Peter G. Williams: There are definitely vendors that only implement the International Edition depending on the type of application (i.e. fairly generic content) and geographic extent of their market.  There are very few examples of vendors using a country's extension in another country, one that comes to mind was Saudi Arabia's interest in using Australian codes.

Next time:   


Potential Items for Discussion

Description
OwnerNotes & Actions
SNOMED Family of Languages

Impact of proposed changes (eg text searching in ECL) on FHIR. Questions around which language reference sets to use when there are multiple, especially partial/overriding context (referred to MAG for discussion)

8 Sept The FHIR specification does not specify a particular version of ECL, so we assume the latest.  Any enhancements added to ECL will be immediately relevant and available in FHIR.   Note that these latest additions while targeting descriptions are a concept filter, so display options (language etc) will affect the output of those concepts.   How about the filter parameter though, especially since ECL would allow multiple filters in multiple/different languages.

  • Michael Lawley Suggested ticket: Parent and Child properties to (optionally?) support the Coding type.
Specify CodeSystem in FSH
FSH apparently has no way of specifying the version of a CodeSystem. Daniel checking the ANTLR spec. https://github.com/FHIR/sushi/issues/473
API for FHIR Resource ↔ Post coordinated expression mapping

API for FHIR Resource to SNOMED Expression

  • Daniel Karlsson Thought there might be some documentation from CIMI on this. Also notes from DMarkwell about constructor bindings.
  • Peter G. Williams Pull these notes into confluence - can we mention it in the IG?
Looking up an SCTID in an unknown module

Problems when dependencies do not align. Multiple code system resources represent multiple editions / versions.

ML: See code parameter to code system search. Should return code systems (ie versions) where that code is defined. International concepts would appear in every edition known to the server.

eg /CodeSystem?system=htp://snomed.info/sct&code=12345678&_elements=version

GPS

See Discussion on Global Patient Set (GPS)
FHIR Shorthand

https://github.com/HL7/fhir-shorthand/wiki

https://build.fhir.org/ig/HL7/fhir-shorthand/FSHQuickReference.pdf

Tooling: https://github.com/FHIR/sushi

$lookup operation - properties returned

Using http://ontoserver.csiro.au/vstool/  I noticed that both Ontoserver and SnowStorm return a SNOMED CT $lookup property for effectiveTime, which I don't see listed, as one of the SNOMED CT properties in the FHIR R4 specification at http://hl7.org/fhir/snomedct.html. Should we create a Jira TIcket to add this?

Completed - https://jira.hl7.org/browse/FHIR-26555

Use of url parameter15

CodeSystem "class vs instance" in url parameter between CodeSystem and ValueSet operations.

CodeSystem is understood.

In Valueset, url is the ValueSet url for example url = http://snomed.info/sct?fhir_vs= allows for the version URI to be used as stated in https://build.fhir.org/snomedct.html The base URL is either http://snomed.info/sct , or the URI for the edition version, in the format specified by SNOMED International in the SNOMED CT URI Specification.

The ValueSet version valueSetVersion is just some string identifier eg a timestamp or 0.1.0

ECL in the Valueset Expression Extension10

Check whether SNOMED ECL is (or should be) registered as a MIME type (as per RFC 4289/BCP 13), or alternatively added to the expression-language code system and value set, for use in the valueset-expression extension used with the ValueSet resource.

For example, HL7 have registered application/json+fhir

This is useful for a ValueSet extension which allows any language to be used to define the selection criteria for an intensional definition using a MIME type. This group has no current reason to use that extension given the existing core specification support for implicit ValueSet definition and the support within the compose element.

RDF community may have an interest.

Update 2 June RH: Existing small valueset extended in BCP13 (existing known codes could be published as a CodeFragment). Vocab Working Group discussion ongoing.

Behaviour on Lookup10

What properties are returned?

Discussion: Both Ontoserver and Snowstorm are returning EffectiveTime which is not listed here (unlike other SNOMED specifics): https://build.fhir.org/snomedct.html

Point of interest: Grahame's server returns a copyright property.

Update 7 April - Question about whether this is required / desirable?

Concluded Discussion

See also FHIR Terminology Services Discussions

Description
OwnerNotes & Actions
Terminology Capabilities

Terminology Capabilities: Default SNOMED Edition for a Server. Suggestion to invite Graham for a wider discussion. Resource is still at maturity 0.

11 August The resource is based on instances of code systems. Difficult to make statements about code systems generally, or specific SNOMED editions, etc. Will start a Zulip discussion on this. Michael Lawley Then potentially invite Grahame for a future discussion?

25 August It has been agreed that this resource will now have maturity level 1

New parameters proposed for streamlining operation of expand and validate code
Grahame Grieve

See https://chat.fhir.org/#narrow/stream/179202-terminology/topic/tx.2Efhir.2Eorg.20New.20parameters.20for.20.24expand.20.26.20.24validate-code

8 Sept 20 Is there a Jira ticket ?   Rob says Grahame implemented this.

12 Jan:  RH update made to GG Server.   Documentation (assuming required) still outstanding.

FHIR Server Federation10

Use case for fall back lookup when server does not know the answer to any particular question eg a façade server which has knowledge of all services it could potentially delegate to.

Aug 25: New capabilities in HAPI to allow delegation to an external terminology server.

Meeting Files

  File Modified
File jerry_ipu.tsv 2022-Feb-17 by Peter G. Williams
Microsoft Word Document Allergy Guide v20220111.docx 2022-Feb-17 by Peter G. Williams
Microsoft Word Document ClinicalStatusValuesDiscussion_v1.1.docx 2022-Feb-17 by Peter G. Williams
PNG File image2021-11-30_20-18-16.png 2022-Feb-17 by Peter G. Williams