Concept resource has similar structure as Coding and CodeSystem.concept element. When you upload code system into Aidbox, we split CodeSystem resource into concepts. But for your convenience CRUD operations are allowed as well on Concept resource directly. To create and manage simple dictionary/terminology you can create set of Concepts using Create operation.
resourceType: Concept# id of concept; usually short name for terminology + codeid: loinc-17861-6# inactivity flagdeprecated: truesystem: http://loinc.orgcode: 17861-6display: Calcium [Mass/volume] in Serum or Plasma# pre-expanded list of valueset ids/urlsvaluset:- labsdefinition: <Definition string>hierarchy:- parent-code-1- parent-code-2designation:display:ge: der Calciumes: el calciumru: Кальцийdefinition:ge: der Calciumes: el calciumproperty:LOINC:long_common_name: ...relatednames2: ...
This is boolean flag, which can be used to deactivate (but not delete) concept. This is a best-practice for terminology management - never delete concepts, but deprecate
It's symbolic link on CodeSystem
Hierarchy element contains codes of parent concepts for hierarchical terminologies from top to bottom. This element is used for Subsumption Operation - where you test that some code isA another code.
Designation element is copy semantic of CodeSystem.concept.designation - Additional representations for the concept - other languages, aliases, specialised purposes, used for particular purposes, etc. In Aidbox it is represented in more database friendly format.
In CodeSystem.concept.designation is a collection of complex elements:
designation:- use:system: http://...designation-usagecode: displaylanguage: gevalue: eigenclass- use:system: http://...designation-usagecode: displaylanguage: esvalue: el eigenclass// to access it you need something like this// designation.where(use='display' and language='ge').value
In Aidbox it's grouped by use.code and after that by language attributes:
designation:display:ge: der Calciumes: el calciumru: Кальцийdefinition:ge: der Calciumes: el calcium// much more easy with this format// designation.display.ge
Property element is polymorphic element, which contains additional properties for concept like axis of classification etc. In Aidbox we use more database oriented encoding instead of FHIR generic property constructor.