Using the Local Code System Editor, Local Code Systems can be further configured by defining the properties for its Local Codes. For adding and defining these Additional Properties click on this button at the right end side of the Additional Properties section bar.
Local Code properties can be defined by the following attributes (* are mandatory):
Name*: unique name of the property
Type*: type of the property
Cardinality*:
Default value: Initial value of the property.
Description: String attribute to capture the description of the given property.
Validation expression: JavaScript validation expression to evaluate when value is assigned to the property.
Validation message: Validation message in case invalid property value entered (the validation expression evaluates to a false).
Hovering over the name or its field of the property definition attributes brings up a tooltip, about the descriptions of the attributes.
As a concrete example, the following definitions would need to be created for a Local Code System that groups codes related to medicinal products:
tradeName
Type: String
Cardinality: 1..*
Description: Trade name of the medicinal product.
Validation expression: _this.value == _this.value.toUpperCase()
Validation message: Trade name '%s' needs to be all uppercase.
isVaccine
Type: Boolean
Cardinality: 1..1
numberOfBlisters
Type: Integer
Cardinality: 0..1
Default value: 6
Description: The number of blisters in the product.
Validation expression: _this.value > 0
Validation message: Number of blisters '%s' needs to be a positive number.
URI property types do not support validation expressions. In case of trying to enter something in the Validation expression field of a URI-type property, an error message will be present in the editor.
Certain property names are reserved and cannot be used as names for additional properties. The following property names fall under the reserved category: Code, Term, Alternative Terms, Is active, and Parent Concept Code. Entering one of the reserved property names will trigger an error message in the editor.
The icon warns the user that if the value of cardinality is reduced, properties may be deleted from that terminology. Hovering over the icon reveals the warning message.
Property types
Description
Boolean
true|false
String
text type
Integer
integer numbers
Decimal
decimal numbers
Date
date with time part
URI
Values
Description
0..1
Optional
1..1
Mandatory
0..*
Any
1..*
Minimum one mandatory
