Terminology

Terminology (/terminology) lists the FHIR ConceptMaps in the engine’s terminology store. Models use them to translate coded values during a conversion. Here you upload, create, edit and delete them. How a mapping uses a ConceptMap is in Translate codes; managing them step by step is in Manage ConceptMaps.

The list

The Terminology page with the upload panel open and four ConceptMaps

The ConceptMaps of the demo data, with Upload ConceptMaps open.

1 Terminology

The page title.

2 Help

Opens this page.

3 + New ConceptMap

Opens the editor on an empty ConceptMap.

4 Upload ConceptMaps

Opens and closes the upload panel. It stays open while an upload runs or has a result to show.

5 Drop zone

Drop one or more .json FHIR ConceptMap files here, or click browse. Only resources with resourceType: "ConceptMap" are accepted; other files get Only .json FHIR ConceptMap files are accepted. The result lists each file with “N uploaded · N skipped · N failed” and Clear.

6 URL

The ConceptMap’s canonical URL, followed by its Description. Click a row to open it in the editor.

7 # groups

How many groups (source system → target system pairs) it has.

8 # mappings

How many source codes it maps, over all groups.

9 Used by

The models whose terminology names this ConceptMap, or —.

10 Delete

Asks Delete this ConceptMap? (“This permanently removes the ConceptMap from the engine. This cannot be undone.”).

With no ConceptMaps, the page says No ConceptMaps yet. “Create one to map source codes to target codes for your mappings.”

A link of the form /terminology?conceptmap=<canonical URL> opens that ConceptMap’s editor directly; the Workspace uses it to open the ConceptMap of a mapping. When no ConceptMap has that URL, the page says “No ConceptMap found for url: url”. See Links you can share.

The editor

The ConceptMap editor with the first group expanded and an unsaved change

The adverse-reaction_event ConceptMap with an edited description.

1 Title

The ConceptMap’s canonical URL (New ConceptMap for a new one).

2 Save status

Unsaved changes, Saving…, Saved or Save failed. When a save fails, the reason shows in a red line under the header.

3 Save

Saves the ConceptMap to the engine. Enabled while there are unsaved changes.

4 Close

Closes the editor. With unsaved changes it asks Leave without saving? (“You have unsaved changes to this ConceptMap. If you leave now they will be lost. Leave anyway?”) with Leave and Keep editing. Clicking outside the panel does the same.

5 Canonical URL

The URL models refer to.

6 Description

What the ConceptMap translates.

7 Collapse all / Expand all

Folds or unfolds every group. Groups start folded when you open an existing ConceptMap.

8 + Add group

Adds a group, unfolded and ready to fill in. Without groups: “No groups yet. Add one to start mapping codes.”

9 Fold / unfold

Next to the group’s summary, “source → target”.

10 Remove group

11 Source system and Target system

The code systems the group maps from and to. Typing suggests the code systems of the loaded FHIR packages and of core FHIR (systems the ConceptMap already names first, badge in use). The line below says where the system comes from and how many of its codes Atlas knows (“From package · 12 codes”, “FHIR core · 3 codes”), Packages still loading…, Not in any loaded package, or openEHR terminology id for a value such as local. See Suggested systems and codes.

12 + Add element

Adds a source code.

13 Code and Display

The source code and its display text, suggested from the source system’s codes. Picking a code fills an empty display, picking a display fills an empty code.

14 Remove element

15 + Add target

Adds a target for the source code: Code, Display and Equivalence, each row with a remove button. Code and Display are suggested from the target system’s codes.

16 Equivalence

How the target relates to the source: relatedto, equivalent, equal, wider, subsumes, narrower, specializes, inexact, unmatched or disjoint.

17 + Add unmapped rule

What happens to a source code the group doesn’t list: Mode (provided, fixed or other-map), Code and Display (suggested from the target system), and for other-map Other map: the ConceptMap to look the code up in, picked from the engine’s ConceptMaps.

18 Element count

On a folded group: how many source codes it holds.