Form Templates | Category Tables |
---|---|
defined by topics | defined in a template file |
multiple forms per web | one category per web |
data saved in Meta variables | data saved as HTML |
[Change] form and [Add Form] contol buttons | UseCategory radio button |
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 fieldFLD=value or for checkboxes fieldFLDcheckbox=1 in URL
- 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 e.g.
- 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 lead to a screen that enables _no form_ to be selected or one of those specified by `WEBFORMS`.
A default form template (i.e. 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 here.
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 checkboxs - nameFLD e.g. ?BugPriorityFLD=1
- Checkbox - nameFLDvalue=1 e.g. ?ColourFLDRed=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 after pressing [Change] on the Edit page
- A template topic can use any form template
- New topics with a form get instantiated by simple HTML forms asking for a topic name. If there is a SubmitExpenseReport topic were you can create new expense reports, a SubmitVacationRequest topic and so on. These can specify the required template topic and hence form. **_HUH?_**
### Form Template Data Storage
The Form Template topic name, fields and values are stored in the topic [[Meta Data|Main/TWikiDocumentation#TWikiMetaData]]. The order of field/value pairs in the Meta Data is the same as in the Template. The Form name is required for [Edit] and [Save]. -- [[JohnTalintyre]] - 16 Aug 2001