Importing epSOS Terminologies and Value Sets

This section describes the FHIR import of terminologies and value sets that have been prepared for usage in the context of the epSOS project.

Preliminaries

The terminological artifacts have been provided in the form of a data base dump which reflects the Portuguese Local Terminology Repository (LTR). Since these structures cannot be consumed directly, FHIR definition files had to be built first.

Code Systems

The LTR comprises 26 code system, each defining only the concepts needed to build the relevant value sets. Concepts which are marked as Retired or Non-Current are not imported.

Find below an exemplary FHIR definition file of the code system ActSite.

<?xml version="1.0" encoding="UTF-8"?>
<ValueSet xmlns="http://hl7.org/fhir">
  <extension url="ext:groupName">
    <valueString value="epSOS" />
  </extension>
  <name value="ActSite" />
  <description value="ActSite" />
  <status value="draft" />
  <define>
    <system value="2.16.840.1.113883.5.1052" />
    <extension url="ext:language">
      <valueCode value="pt-PT" />
    </extension>
    <concept>
      <code value="RA" />
      <display value="Braço direito">
        <extension url="ext:altDesignation">
          <valueString value="Right arm (ActSite)" />
        </extension>
      </display>
    </concept>
    <concept>
      <code value="LA" />
      <display value="Braço esquerdo">
        <extension url="ext:altDesignation">
          <valueString value="Left arm (ActSite)" />
        </extension>
      </display>
    </concept>
  </define>
</ValueSet>

The code system ActSite defines 2 concepts Braço direito and Braço esquerdo. For each conceot a code, a display name (preferred term) and an alternative designation are given. The terminology is displayed in the web interface as shown in the following figure.

Value Sets

Within the LTR, several value sets have been defined and are mapped to the FHIR structure. For example, the below snippet depicts the FHIR representation of the value set epSOSActSite_pt-PT which references concepts from the code system with the oid 2.16.840.1.113883.5.1052.

<?xml version="1.0" encoding="UTF-8"?>
<ValueSet xmlns="http://hl7.org/fhir">
  <extension url="ext:groupName">
    <valueString value="epSOS" />
  </extension>
  <identifier value="epSOSActSite_pt-PT" />
  <name value="epSOSActSite_pt-PT" />
  <description value="epSOSActSite_pt-PT" />
  <status value="draft" />
  <compose>
    <include>
      <system value="urn:oid:2.16.840.1.113883.5.1052" />
      <code value="LA" />
      <code value="RA" />
    </include>
  </compose>
</ValueSet>

The navigator displays the value set according to the below figure.