View Forms and Preview
On this page
The Web App lays out a record's flyout form from the class's Web App view form: the flyout takes its caption and sections from the view form and lays the sections out on its General tab. A view form is an ordered list of fields, texts, and sections. A class's preview template is an HTML template with a horizontal and a vertical variant.
You edit view forms in the Admin Center, on the View Forms page, and in the Settings App, under View Forms (Web App); where both applications expose a setting, they edit one stored value. You edit preview templates in the Admin Center, on the Preview page; the Settings App has no node for preview templates.
What technicians see in the Web App
A reference field's details command opens the referenced record's flyout, laid out from the class's view form. If the technician may not view the record, a message says so instead. If the class has no view form, the server reports that the view form is not defined.
For how technicians use a lookup's ... menu, see Open and Edit a Record.
On the view form:
- Edit opens the record's ordinary edit form. The view form itself has no edit mode.
- Print prints only the record content, without the view form's toolbar or tabs.
- A Related Objects tab is shown beside General.
In the Admin Center
Edit a view form
The View Forms page lists the object classes; choose a class to see its view form as a table of elements.
To add an element:
- Select the row after which the table should insert the new element. If you select nothing, the table inserts it after the first row.
- Click Add and choose Field, Text, or Section.
- Fill in the element form and submit it.
A Text or Section element is anchored to a field row. Reordering the list changes which field row it is anchored to, and a Text or Section element that becomes the last row has no anchor. After you save, the field row an element is anchored to decides where the element finally appears, so the saved order can differ from the order the table showed.
The toolbar's Edit button is disabled for a virtual field. To reopen a virtual field, click the link in its Name column or double-click its row. The Value column shows a field's value, clamped to three lines unless the row carries its own display text.
A new Text element gets a localization key of eight random letters and digits.
If a Section carries a condition, the Admin Center shows the condition as read-only text, under a warning that it can be edited only in the Settings App.
Object-bound and virtual fields
A Field element is either bound to a field of the object or virtual. Switching between the two clears the element's name, caption, type, and value.
A virtual field's Type offers the eighteen workflow field types, including an Unknown entry. When its value is not calculated, the value editor depends on the type:
| Type | Value editor |
|---|---|
| Integer, Float, Duration | A number box, from -2147483648 to 2147483647 |
| Currency | A currency box, from -2147483648 to 2147483647 |
| Logical | A False/True list |
| Date, Date/Time | A date or date-and-time picker |
| Lookup | A list built from the field's own lookup values |
| Multi-select | A multi-select list |
| Reference | A reference field; the Reference to tree is enabled only for this type |
| String, Memo, Encrypted, HTML | The expression or text value field |
If you leave a virtual field's internal name blank, a unique name is generated when you submit the element.
Lookup values of a virtual field
For a virtual Lookup or Multi-select field, choose where its allowed values come from:
| Field type | Sources | Default |
|---|---|---|
| Lookup | Static list of values (Drop Down), Static list of values (Radio Buttons), Dynamic list based on custom SQL | Static list of values (Drop Down) |
| Multi-select | Static list of values, Dynamic list based on custom SQL | Static list of values |
A dynamic list takes a free-text SQL query. A static list is a table of value and label rows:
- Click New to add a row; rows are edited in a nested drawer.
- Deleting a row asks for no confirmation. Reorder rows with Move Up, Move Down, or by dragging.
- As you type a new row's Value, it is copied into Label until you edit Label yourself.
- Value is required and must not repeat a value already in the list.
Edit a preview template
The Preview page lists the object classes and opens the first one when no class is chosen. A class's template has a Horizontal and a Vertical tab, each with an HTML editor.
- Save appears only after you change something.
- While the Vertical tab is empty and the Horizontal tab has HTML, the Vertical tab is filled with the Horizontal tab's HTML.
- Each editor shows the template with the styles of the matching preview pane target (horizontal or vertical) of CSS Styles.
- When a template opens, the editor normalizes its stored HTML by passing it through the editor's own processing.
In the Settings App
Open the Web App view forms
- Under General, View Forms (Web App) lists every visible object class alphabetically, and each row edits that class's Web App view form.
- An object class's node also has a View Form (Web App) child, which opens the same editor for that class only. The All Configuration Items, All Tickets/My Tickets, Software Catalog, and Stock Rooms nodes have no such child.
The editor, captioned Web App Forms, loads a class's view form into the field grid the first time you select the class's row.
Edit a view form
The field grid offers New with Field, Text, and Section, then Edit, Delete, Move Up, and Move Down. In a view form, the Mandatory and Read Only columns are hidden.
- Press Enter or double-click a row to edit it. Ins adds a field, Ctrl+Up and Ctrl+Down move the row, and Ctrl+Alt+C copies the row's ID.
- The pop-up menu adds Copy and Paste for Section and Text rows.
- Delete asks "Are you sure you want to delete the selected item?".
Field opens the Form Field dialog. Choose Object Field to pick one of the class's fields, or Virtual Field to give the field its own name and type. A virtual field's name must be unique among the form's virtual fields. For a Reference-type virtual field, OK stays disabled until you choose a Lookup Object.
Text opens the Text window: a Text box with Insert Placeholder..., a URL: box whose button inserts a placeholder, and SSP Localization Key:, which takes letters and digits and is upper-cased. A new Text element gets its key generated.
Section opens the section dialog. A section can carry an optional visibility condition, shown as read-only generated SQL.
How rows and sections move
The grid is one ordered list of rows. Move Up and Move Down swap the selected row with its neighbor, and Delete removes only that row. Moving or deleting a Section therefore moves or removes only its heading row: its fields stay where they are, under whichever Section row is now above them. When the form is saved, each Section and Text row is attached to the first field row below it.
Save view forms
Apply is enabled while any loaded view form has changes, and saves every changed view form at once. Refresh or Cancel discards the unsaved changes of every loaded view form.
Exporting the View Forms (Web App) node exports the Web App view forms; exporting a class's row exports only that class's Web App view form.