# Concepts

The `Concepts` page in the SanteDB administration panel allows data administrators to manage the core concepts which are registered in SanteDB. Concepts are used as a canonical form of structured terminology internally within SanteDB's CDR.&#x20;

For example, when registering a patient and setting the gender to "Male" the database record carries the canonical concept of "Male" (uuid: `f4e3a6bb-612e-46b2-9f77-ff844d971198`) . This UUID is consistent for all males between all installations of SanteDB permitting data portability. This concept would then be mapped to a wire-level reference term:

* `M` if the patient is being expressed in HL7v2
* `male` if the patient is being expressed via FHIR

This architecture isolates the SanteDB CDR from changes in wire-formats.

{% hint style="info" %}
Users should familiarize themselves with SanteDB's [concept dictionary architecture ](https://help.santesuite.org/santedb/data-and-information-architecture/conceptual-data-model/concept-dictionary)prior to administering the concept dictionary.
{% endhint %}

The concept dictionary installed in your copy of SanteDB is displayed when the concept page is opened.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2Fof8po5djgli9x2ZbCydE%2Fimage.png?alt=media&#x26;token=8125115c-8d43-41cc-99e8-6a471300d285" alt=""><figcaption></figcaption></figure>

## Creating Concepts

Creating a new concept is done via the `Create` button on the concept summary page.&#x20;

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2Fdip2MtpKqTpjaftDZBHT%2Fimage.png?alt=media&#x26;token=ca7850ba-218c-4142-aafb-dbf57ad27094" alt=""><figcaption></figcaption></figure>

Each concept has the following components:

* `Mnemonic` - A globally unique human readable label for the concept. This mnemonic is used by programmers and humans to reference the mnemonic using a more friendly name than the UUID
* `Classification` - Used for internal model validation, the classification lets the CDR understand the overall categorization under which the concept falls.
* `Name(s)` - Human readable descriptions of the concept which appear in SanteDB's user interface.
* `Set Membership` - Groupings of concepts within a concept set.
* `Reference Terms` - Wire level manifestations of the concept in a particular code system.

After creating the concept the administrator will be taken to the edit concept page.

## Viewing/Editing Concepts

Administrators can change concepts that have been registered in the SanteDB concept dictionary by clicking the View option.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FdtD0b51s4JCLNxxCXahX%2Fimage.png?alt=media&#x26;token=3c8ec847-bf95-48cb-87a8-8aa0fbdeb311" alt=""><figcaption></figcaption></figure>

The `Concept Properties` panel allows for the editing of the core properties of the concept including the removal of concept set memberships, names, and the mnemonic.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FNMzMt5DA47lmQ2XUhWDt%2Fimage.png?alt=media&#x26;token=4f69b79f-b96b-4f23-a3eb-84137a5a8069" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Editing the `Mnemonic` of the concept is not recommended if the concept has been used in a user interface or referenced programmatically (in reports, business rules, etc.). Editing the `Mnemonic` should only occur to correct typo's and errors immediately after creation.
{% endhint %}

## Reference Term Management

The user interface on the concept editing screen only permits the removal of a concept from a reference term. To add an association to a reference term, edit the Reference Terminology directly in the [Code Systems ](https://help.santesuite.org/operations/cdr-administration/santedb-administration-panel/concept-dictionary-administration/code-systems)management screen.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FLz32lUdAxVqXZRn0Ea4R%2Fimage.png?alt=media&#x26;token=fd008cc8-abcc-4381-b259-9eec29d7105d" alt=""><figcaption></figcaption></figure>

## Concept Status

The status of the concept can be set by clicking the state button in the concept header. This action will prohibit use of the concept in user interfaces, while maintaining referential integrity with existing data in the database and allowing data integrations to continue to use the concept.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FbLKFia3PSXe6gKLKhNOw%2Fimage.png?alt=media&#x26;token=f64e297a-75c3-429d-bd63-7436f6573eaf" alt=""><figcaption></figcaption></figure>
