This wiki has undergone a migration to Confluence found Here

Unified Terminology Governance Tooling Documentation

From HL7Wiki
Jump to navigation Jump to search

Getting the tools

Got to


  • *FHIR Toolkit*
  • *HL7 Vocab* Server
  • A Snomed Distribution of your choice (International, unless you have a license for a country specific one)

Windows: use the installers, and install to your choice of location OSX: Copy the download file into your Applications folder

unzip to the snomed file to somewhere local

Getting the Terminology content

The source is If you know how to use Git, use Git to get a copy of it. if you don't, you can download a zip file, and unzip it somewhere local

Running the terminology Server

  • Run the VocabPoCServer
  • set the folder to the location of the Terminology Content
  • set the port you want to run on. This must be a number from 1 to 65535. Generally, chose a number of 1024 (recommended: 10000)
  • choose the snomed file you downloaded above
  • start the server. It should just start up and you'll get a series of log messages about loading resources


  • you can run more than one server at a time but they have to have different port numbers
  • you can check that the server is running ok by clicking on the browser button, and checking that you see the server home page. That also shows you the base URL for the server (you'll use that below)

Running the value set editor

  • Start the FHIR toolkit
  • add the URL from above as known server
  • choose settings, and go to terminology servers, and add the URL to the server list. Make it the default option
  • now, choose open a file, and then choose any value set from the one of the folders in the Terminology content
  • you'll see the content of the value set
  • choose 'expand', make sure that you have your local terminology server (not - it doesn't know about the terminology content *yet*), and then choose go - you'll get the expansion as specified