# 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 {doc}`/codes-and-profiles/translate-codes`; managing them step by step is in {doc}`/codes-and-profiles/conceptmaps`. ## The list ```{figure} ../../images/screens/terminology.png :class: screenshot :alt: The Terminology page with the upload panel open and four ConceptMaps The ConceptMaps of the demo data, with **Upload ConceptMaps** open. ``` [1]{.callout} **Terminology** : The page title. [2]{.callout} Help : Opens this page. [3]{.callout} **+ New ConceptMap** : Opens the editor on an empty ConceptMap. [4]{.callout} **Upload ConceptMaps** : Opens and closes the upload panel. It stays open while an upload runs or has a result to show. [5]{.callout} 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]{.callout} **URL** : The ConceptMap's canonical URL, followed by its **Description**. Click a row to open it in the editor. [7]{.callout} **# groups** : How many groups (source system → target system pairs) it has. [8]{.callout} **# mappings** : How many source codes it maps, over all groups. [9]{.callout} **Used by** : The models whose terminology names this ConceptMap, or **—**. [10]{.callout} 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=` 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 {doc}`/reference/deep-links`. ## The editor ```{figure} ../../images/screens/terminology-editor.png :class: screenshot :alt: The ConceptMap editor with the first group expanded and an unsaved change The `adverse-reaction_event` ConceptMap with an edited description. ``` [1]{.callout} Title : The ConceptMap's canonical URL (**New ConceptMap** for a new one). [2]{.callout} Save status : **Unsaved changes**, **Saving…**, **Saved** or **Save failed**. When a save fails, the reason shows in a red line under the header. [3]{.callout} **Save** : Saves the ConceptMap to the engine. Enabled while there are unsaved changes. [4]{.callout} 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]{.callout} **Canonical URL** : The URL models refer to. [6]{.callout} **Description** : What the ConceptMap translates. [7]{.callout} **Collapse all** / **Expand all** : Folds or unfolds every group. Groups start folded when you open an existing ConceptMap. [8]{.callout} **+ Add group** : Adds a group, unfolded and ready to fill in. Without groups: "No groups yet. Add one to start mapping codes." [9]{.callout} Fold / unfold : Next to the group's summary, "*source* → *target*". [10]{.callout} **Remove group** [11]{.callout} **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 {ref}`Suggested systems and codes `. [12]{.callout} **+ Add element** : Adds a source code. [13]{.callout} **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]{.callout} **Remove element** [15]{.callout} **+ 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]{.callout} **Equivalence** : How the target relates to the source: `relatedto`, `equivalent`, `equal`, `wider`, `subsumes`, `narrower`, `specializes`, `inexact`, `unmatched` or `disjoint`. [17]{.callout} **+ 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]{.callout} Element count : On a folded group: how many source codes it holds. ## Related - {doc}`/codes-and-profiles/conceptmaps` - {doc}`/codes-and-profiles/translate-codes` - {doc}`/reference/deep-links`