WorkView Dataset component
The WorkView Dataset Form Component allows options from a WorkView Dataset to be presented to the user to select from, during a form submission.
The Dataset must be used by an Attribute of a WorkView Class, in order for it to be used within the form.
Settings
When adding the component to a page template, the following settings will need to be configured:
| Name | Description |
|---|---|
| Application | The WorkView Application in which the Dataset is used |
| Class | The WorkView Class in which the Dataset is used |
| Attribute | The WorkView Attribute which uses the Dataset |
If the Dataset has a parent Dataset, when adding the page into the form, you can optionally map a parent value, to allow the selected options to be restricted to only those related to that value in the parent Dataset. Note: the parent value is case-sensitive.
Return values.
Under usual circumstances, the component will return the value of the selected option, however there are scenarios where the user would not be presented with Dataset values to choose from:
- if the Dataset contains no values, or there are no values for the given parent value, the component will present a single option to the user: "My answer is not listed" with a value of
[none] - if there is an error fetching the values from the Dataset, the component will present a single option to the user: "My answer is not listed" with a value of
[error]
It is important that you use branching and/or logic to handle these scenarios appropriately.
