Refset Service

Refset Service

Overview

The refset service is responsible for operations related to managing Refsets.

Internal API - RefsetServiceJpa (extends ReleaseServiceJpa)

Lower level calls of the internal API include: 

  • Add/update/remove/get/find Refset(s)

  • Add/update/remove/get/find ConceptRefsetMember(s)

  • Add Refset or ConceptRefsetMember notes

  • Add a "staged refset change" - used to manage staging operations

  • Get "staged refset change" from "staged" or "origin" sides

  • Count/resolve an expression or Refset definition

  • Find Refset releases

  • Get current Refset ReleaseInfo

  • Get export/import handlers

  • Get Refset revisions (from the past)

  • Recover Refset (from prior revision)

  • Lookup member names

  • Lookup progress (for long running refset operations)

  • Stage a refset

  • Synchronize Refset (with a prior version)

REST API - RefsetServiceRest

This is a very large REST API because it supports many of the application functions.

The public facing methods of the security service include:

  • Add/update/remove/get/find Refset(s)

  • Add/update/remove/get/find ConceptRefsetMember(s)

  • Add Refset inclusion/exclusion

  • Add/remove Refset (or ConceptRefsetMember) note

  • Add/remove ConceptRefsetMember(s) for an expression

  • begin/cancel/resume/finish import ConceptRefsetMember(s)

  • begin/validate/cancel/resume/finish Refset migration (to a new edition, or new version)

  • Clone Refset

  • Compare Refsets (members in common, old-not-new, new-not-old, etc)

  • Count/resolve an expression or Refset definition

  • Import/export Refset definition

  • Import/export ConceptRefsetMembers

  • Extrapolate definition (not currently implemented)

  • Get import/export Refset handlers

  • Get field filters (for filtering picklist in directory UI).

  • Lookup members 

  • Get lookup progress (for long running operations)

  • Get origin Refset for a staged Refset

  • Get Refset types (for a UI picklist)

  • Optimize definition

  • Recover Refset

References/Links

  • n/a

Copyright © 2025, SNOMED International