Workflow Option element

The option element is only used in combination with Workflow Select field. The option value represents a list of distinct values to choose from.

AttributeDescriptionRequired

label

The text shown as a label in the user interface.

true

value

A unique value identifier.

Two options can't have the same value. The value must be unique.

true

parentValue

When present, it specifies the option's parent.

The parent must be present in the other select.

false
selected

When present, it specifies that an option should be pre-selected when the form is rendered.

false

cssClass

CSS class.

More information about creating your own styles can be found at: CSS.

false

Parent:

Basic select with selected option

  • The attribute selected=true, when present, specifies that an option should be pre-selected when the page loads.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE workflow-forms PUBLIC "-//OpenKM//DTD Workflow Forms 2.6//EN"
                                "http://www.openkm.com/dtd/workflow-forms-2.6.dtd">
<workflow-forms>
  <workflow-form task="textarea test">
    <select label="select label"  name="test" type="simple">
        <option label="one" value="001" />
        <option label="two" value="002" selected="true"/>
        <option label="three" value="003" />
    </select>
  </workflow-form>
</workflow-forms>

Hierarchical relationship

  • The field option value of "children" has a parent relation with "parent". It is defined by parentElement="parent".
  • The option value "benefits" of the field "children" has the parent value "directives" from the field "parent".

Tree relationships:

  • directives
    • benefits
    • eligibility
    • services
  • handbook
    • basic
    • normal
    • advanced
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE workflow-forms PUBLIC "-//OpenKM//DTD Workflow Forms 2.6//EN"
                                "http://www.openkm.com/dtd/workflow-forms-2.6.dtd">
<workflow-forms>
  <workflow-form task="textarea test">
    <select label="Provincia" name="parent" type="simple">
        <option value="directives" label="Directives" />
        <option value="handbook" label="Handbook Paragraphs" />
    </select> 
    <select label="Provincia" name="children" type="simple" parentElement="parent">
        <option value="benefits" label="Benefits" parentValue="directives" />
        <option value="elegibility" label="Eligibility" parentValue="directives"/>
        <option value="services" label="Services" parentValue="directives"/>
        <option value="basic" label="Basic" parentValue="handbook" />
        <option value="normal" label="Advanced" parentValue="handbook"/>
        <option value="advanced" label="Normal" parentValue="handbook"/>
    </select>
  </workflow-form>
</workflow-forms>