Concept Sets

This page documents a feature in SanteDB 3.0

Introduction

In SanteDB's concept dictionary, a concept set is a collection of concepts which are used for a particular purpose. Concept sets are used for:

  • Data Validation - Whether a particular value belongs on a particular data field or relationship

  • Drop Downs - In the user interface to drive selections of concepts

  • Grouping of related concepts for export/import

Concepts are administered through the Concept Set administration page. Concept sets existing in one of three ways:

  • As an explicit list of concepts which are members of the set

  • As a composition of other concepts sets via "include" or "exclude"

  • As a mix of direct inclusions and compositions

Concept Set

When an administrator visits the Concept Sets page in SanteDB, they are presented with a list of concept sets which are registered with their SanteDB instance.

Administrators may use this page to:

  • Create a new concept set

  • Delete an existing concept set

  • View details of a concept set

  • Search concept sets

Creating a Concept Set

Administrators can create a concept set by selecting the Create option. This will display a form of minimal properties for establishing a new concept set.

The fields are as follows:

FieldDescriptionExample

Name

Human readable name for the concept set

Species of non-human Patients

Mnemonic

A unique mnemonic for the concept set. This is what is used in the user interface and database triggers to reference the concept set by a non-changing name.

NonHumanSpeciesConcepts

OID

A unique object identifier in dotted form which is used to expose the concept set to other systems. This value must be globally unique.

2.25.302938201056853924218

URL

The URL of the concept set which is used when the concept set is exposed on FHIR interfaces.

urn:myproject:conceptset

Managing Concept Sets

Viewing a concept set will allow administrators see members of the set and modify the core properties.

Administrators can export the concept into any formats (XLSX, CSV, HTML) for consumption in third party systems. The concept set can also be download into a dataset format file for import into another SanteDB instance.

Concept properties can be eited using the concept set properties grid edit option.

Adding Concepts to Set

Concepts can be added to the concept set using the Add option in the Concept Set Expansion panel. The interface will show a modal allowing the administrator to add an existing concept to the set or define a new concept.

Concepts may be added one at a time, or multiples using the expanded add button action.

Once done adding, the concept set is displayed with the concept and the owning set.

Composing Concept Sets

A concept set can also be composed from other concept sets. Concept set composition is performed using the Compose option.

Composition of a concept set is either:

  • Include: All concepts in the specified concept set are considered members of the concept set in which they're composed

  • Exclude: All concepts in the specified concept set are forbidden for use in the current concept set.

The example above the example concept set will include all concepts in the Act Status set with the exclusion of Concept Status. When saving, the concept set expansion window is updated.

Included concepts from other sets will have their Member of Set column populated with the set from which the concept is drawn and cannot be manually removed from the set. Additionally the Composition field will be updated to include all registered concept set compositions.

Uploading Concept Sets

For bulk uploads, administrators may create a concept of many concepts in a CSV sheet and may upload using the provided template:

Last updated