Name: | Type: | Size: | Values: | Tooltip message: |
---|---|---|---|---|
[[Know/TopicClassification]] | select | 1 | [[Know/NoDisclosure]], [[Know/PublicSupported]], [[Know/PublicFAQ]] | blah blah... |
[[Know/OperatingSystem]] | checkbox | 3 | [[Know/OsHPUX]], [[Know/OsLinux]], [[Know/OsSolaris]], [[Know/OsWin]] | blah blah... |
[[Know/OsVersion]] | text | 16 | blah blah... |
Name: | >Type: | >Size: | >Values: | >Tooltip message: | >
---|---|---|---|---|
[[Know/TopicClassification]] | >select | >1 | >> | blah blah... | >
[[Know/OperatingSystem]] | >checkbox | >3 | >> | blah blah... | >
[[Know/OsVersion]] | >text | >16 | >> | blah blah... | >
Name: | >Type: | >Tooltip message: | >
---|---|---|
[[Know/NoDisclosure]] | >option | >blah blah... | >
[[Know/PublicSupported]] | >option | >blah blah... | >
[[Know/PublicFAQ]] | >option | >blah blah... | >
[[...|/WebHome]]
can be used for force a link, at present [[...|/WebHome]]
format is not supported.
- - The "Tooltip message:" column is used as a tool tip for the field name (only if field name is a [[WikiName]]) - you only see the tooltip on edit.
- - The first item in the list is the default item. Alternative initial values can be given in a topic template such as `WebTopicEditTemplate` or using field=value or for checkboxes field=1.
- - The topic definition is not read when a topic is viewed.
## Enabling Forms by Web
Forms are enabled on a per web basis. The **WEBFORMS**
variable in [[WebPreferences]] is optional and defines a list of possible Form Templates. Example:
- Set WEBFORMS = BugForm, FeatureForm, BookLoanForm
- With `WEBFORMS` enabled, an extra button is added to the edit view. If the topic doesn't have a Form, an **Add Form** button appears at the end of the topic. If a Form is present, a **Change** button appears in the top row of the Form. The buttons open a screen that enables selection of a form specified in `WEBFORMS`, or the **No form** option.
- A default Form Template (new topics get this default form) can be provided by creating the `WebTopicEditTemplate` topic in a web and adding a form to it. Initial Form values can be set there.
- Addtionaly a new topic can be given a form using the `formtemplate` parameter in the URL. Initial values can then be provided in the URLs or as form values. Names being:
- Not checkboxes - name e.g. ?BugPriority=1
- Checkbox - namevalue=1 e.g. ?ColourRed=1. Note that all boxes with a tick must be specified.
## Creating New Topics with Forms
When you create a new topic in a web that has the WEBFORMS Preferences variable set, an **Add Form** button appears at the bottom of the page. If the [[WebTopicEditTemplate]] topic has a form added, the form will appear with values set; press **Change** to remove the template or to switch to a different one.
A form embedded in a topic also appears in a new topic. This is done by specifying the `formtemplate` parameter in the URL.
## Setting Up Multiple Form Options
- The optional **WEBFORMS**
variable defines alternative Form Templates that can be selected by pressing **Change** in edit mode.
- A Template topic can use any Form Template.
- New topics with a Form are created by simple HTML forms asking for a topic name. For example, you can have a `SubmitExpenseReport` topic where you can create new expense reports - a `SubmitVacationRequest` topic and so on. These can specify the required template topic with its associated Form.
## Form Template Data Storage
The Form Template topic name, fields and values are stored as [[Meta Data|Main/TWikiDocumentation#TWikiMetaData]]. The order of field/value pairs in the Meta Data is the same as in the Template.
-- [[JohnTalintyre]] - 16 Aug 2001