Zoomed Image
USA
800 691 9120
UK
01225 704844

Editing a Form

xAssets Configuration Guide
Forms

Editing a Form

This page explains how to open a form for editing and describes each field in the Form Editor. The Form Editor controls the form's identity, sizing, profile assignment, and category linkage.

Opening a Form for Editing

There are several ways to open the Form Editor:

  1. Click the form name in the Forms List -- the most direct method.
  2. Select a form in the list and click Edit button
, or choose **Edit Form** from the Forms menu.
  1. Use the Find dialog -- click Edit button
without selecting a form first, then search for the form, select it, and click ![OK button](../../images/button-ok.png) .
  1. Edit the last form -- click Edit Last Form button
to reopen the last form you edited. This is useful when making iterative changes.
  1. Ctrl-click a field on screen -- while viewing any page, hold Ctrl and click on a form field. This opens the Field Editor for that field, from which you can click Edit Form link
to open the Form Editor for the containing form. This is the fastest method when you can see the form on screen.

The Form Editor

The Form Editor dialog showing fields: ID, Form Name, Width, Height, Profile, Subject, Form Type, Category Group, Category, Querystring

Form Editor Fields

Field Description Notes
ID A unique number assigned by the system Read-only. Cannot be changed. Used internally to reference the form.
Form Name The internal name of the form Not displayed to end users, but used to identify the form in the Admin screens and in subform references. Choose a clear, descriptive name.
Width Width of the form in pixels Leave blank to let the system size the form automatically based on its content. Set a value only if you need a fixed width (e.g., for dialog forms).
Height Height of the form in pixels Leave blank for automatic sizing. Only set this for forms that need a fixed height, such as dialogs or embedded subforms.
Profile The profile this form belongs to Links the form to a functional area (e.g., IT Asset Management). If blank, the form is available across all profiles.
Subject The data subject of the form Determines which database fields are available to insert. For example, a form with Subject "Asset" offers asset-related fields; a form with Subject "Task" offers task fields.
Form Type The function of the form Controls where and how the system uses the form. Common values: Editor, Dialog, Subform, Lookup, Page.
Category Group The asset category group this form applies to Only relevant when Subject is "Asset". Allows the form to be used automatically when editing assets in this category group.
Category The specific asset category this form applies to Only relevant when Subject is "Asset". More specific than Category Group -- the system prefers a Category match over a Category Group match.
Form Querystring Advanced configuration parameters For expert users. Accepts querystring-format parameters, such as specifying the number of columns for automatic field layout.

Tips

Tip: The Subject field is the most important setting for a new form. If it is set incorrectly, the wrong fields will be available for insertion and the form may not display data correctly.

Warning: Changing the Form Name of an existing form can break references from other forms that embed it as a subform via a Form Container field. Before renaming, check the Form References tab to see what depends on this form.

Tip: Leave Width and Height blank unless you have a specific reason to set them. Automatic sizing adapts to the user's browser window and works well in most cases.