Semaphore Settings

Knowledge Model Management (KMM) comes with a predefined set of Semaphore Settings (label settings). This set can be extended at runtime via the SPARQL endpoint. Through that mechanism it is possible to both add a new optional value to an existing Semaphore Setting or add a completely new Semaphore Setting.

Those settings will automatically be shown in the user interface but their functional behaviour, i.e. how they affect classification, user interaction etc should be implemented in the Publisher configuration, rulebase template or consuming downstream system. Don’t forget to update those after instating the new settings!

Adding a new value to an existing Semaphore Setting

To add a new value to an existing label setting you simply need to add a new instance of that setting to the list of possible values. For instance to add a new “New rulebase behaviour” option to the “Rulebase behaviour” Semaphore Setting you can issue the following update statement via SPARQL endpoint:

INSERT {
sem:RulebaseBehaviourNew rdf:type sem:RulebaseBehaviour.
sem:RulebaseBehaviourNew rdfs:label "New rule behaviour"@en .
sem:RulebaseBehaviour skos:memberList sem:RulebaseBehaviourNew .
}
WHERE {}

Manually registering a new Semaphore Setting

Adding a completely new Semaphore Setting requires more SPARQL but follows the same principle. Adding a new toggle setting called “Custom toggle” will first require creating the new setting type, then creating the possible values as instances. The following SPARQL illustrates the details:

INSERT {
sem:customToggle
  rdf:type owl:ObjectProperty ;
  rdfs:domain skosxl:Label ;
  rdfs:label "Custom Toggle"@en ;
  rdfs:range sem:CustomToggle ;
  rdfs:subPropertyOf sem:classificationSetting ;
.
sem:CustomToggle
  rdf:type owl:Class ;
  rdfs:label "Custom toggle"@en ;
  rdfs:subClassOf sem:ClassificationSetting ;
  rdfs:subClassOf sem:SimpleSetting ;
  rdfs:subClassOf sem:ToggleSetting ;
  skos:definition "Custom toggle setting."@en ;
.
sem:CustomToggleOff
  rdf:type sem:DisabledSetting ;
  rdf:type sem:CustomToggle ;
  rdfs:label "Off"@en ;
  skos:definition "Toggle Off."@en ;
.
sem:CustomToggleOn
  rdf:type sem:EnabledSetting ;
  rdf:type sem:CustomToggle ;
  rdfs:label "On"@en ;
  skos:definition "Toggle On."@en ;
}
WHERE {}

Note that in this case the setting is a subclass of sem:SimpleSetting so it will be presented in the top section of the Semaphore Settings dialog. To only show the setting in the expanded dialog you should use sem:AdvancedSetting.

Also note that toggle settings have 3 values: On, Off and Default. On and Off are expressed value for the label, Default is the implied value when the setting is not explicitly set and the behaviour is then down to the configuration of the Publisher or the consuming downstream system.