Page tree
Skip to end of metadata
Go to start of metadata

Fields

A field is both a place to input a specific type of information, and the information itself that is then stored in that part of a record.

Agiloft supports fields of many different data types, such as text, single choice list, multi-choice list, integer, floating decimal point, telephone, email, URL, attached file, date, time, date/time, elapsed time, currency, and so on, and each field can be provided with validation rules appropriate to its type. For instance an integer field might require a value between 1 and 100. A full list of field types is provided in List of Data Types.

Each field has a "field name" and a "field label". The field name is the name of the column in the database, and may not contain spaces or most special characters. The field label is the value that users see through the GUI. Labels can contain spaces, for example Customer Name.

Agiloft provides full National Language Support, meaning that field labels can be translated into multiple foreign languages so the user will see labels in the language specified by their browser settings.

Adding and Modifying Fields

To review the fields for a particular Table and add, modify, or delete fields, go to Setup > Tables, select the Table to edit, then select the Fields tab.

To add a field:

Hover over New to view the drop-down of all available data types. A new progress window with progress indicators will pop-up when an administrator adds a new column to a table to indicate how long the operation will take. Adding database columns is usually quick, but can take longer in certain circumstances and on some systems.

To modify a field:

To change the settings for a specific field, click the Edit icon next to the field name. This opens the Field wizard where you can set default values, basic permissions, visibility or edit conditions, and other options based on the type of field.

Mass editing field properties

The Set Field Properties item on the action bar lets you set certain properties for multiple fields at once.

The following properties can be mass-edited: Set Visibility Dependence - sets visibility dependence on another field, Set Edit Dependency - conditional editing requirements, Set Requirement Dependency - whether the field is required under some conditions, and Enable/Disable Quick Edit - whether Quick Edit is enabled. 

The Set Field Properties option

To do this:

  1. Select one ore more fields to edit.
  2. Hover over Set Field Properties and choose which property to change.
  3.  Use the pop-up window the change the settings, then click Finish to save.

Field property confirmation dialog

The settings window shows the names of the selected fields. The dialog will list any fields which can not be modified; this is usually due to a data type incompatibility. For example, The changes won't be applied to the following fields: cell_phone.

 Click here to see the full list of mass editable field properties.
 Data TypeVisibility Dependency ConditionsRestricted Editing ConditionsRequirement ConditionsIn-Table Editing
Auto-IncrementX   
Remote Access/ChatX   
Action buttonXX  
Append Only TextXXXX
Short TextXXXX
TextXXXX
Billing FieldXX  
Calculated ResultX   
CompoundX   
Credit Card   X
ChoiceXXXX
Multi-ChoiceXXXX
CurrencyXXXX
DateXXXX
Date/TimeXXXX
Elapsed TimeXXXX
TimeXXXX
Telephone/FaxXXXX
EmailXXXX
Email PagerXXXX
Floating PointXXXX
IntegerXXXX
Long Integer FieldXXXX
Linked Logical NameXXX 
PasswordXXXX
PercentageXXXX
URLXXXX
Variable FormulaXXX 
Question Description FieldXXX 
Survey Definition FieldXXX 
Survey Presentation FieldXX  
Linked FieldsXXXX
Linked Data from Another TableX   
Embedded Search ResultX   
Communications Search ResultX   
Calculation on Multiple Linked RecordsX   
WMI FieldXX  
File with VersioningXXX 
Image with VersioningXXX 

Default Fields

Each table comes with a set of default fields:

  • ID
  • Created By
  • Creator Login
  • Creator Team
  • Date Created
  • Date Updated
  • Updated By
  • Updater Login
  • Updater Team
  • History
  • Deletable
  • Demo Data
  • Communications - search result of emails linked to the record
  • Type.

Fields tab and default field list

Field Cleanup

For a new table some general field cleanup is likely to be necessary:

  • Correct the History field that is automatically created - it must have the following changes made to it: 
    • General tab: change the field label to upper case: History. This way we know it has been touched. 
    • Permissions tab - give admin all permissions. 
    • Display tab - check all the boxes for the columns to display. Be sure to put the history field on a tab on the layout, usually on its own tab displays the best.
  • Change the tab name for Communications in the layout to Emails to make it take less space.

Field Design Considerations

  • Editing the linked field settings for a subtable in a hierarchical table setup will change the settings for all other subtables in that hierarchy.
  • Fields cannot be converted from one data type to another. However, it is usually possible to create a new field of the desired data type and use the Mass Edit "Formula" feature to assign the old field's values to the new one.
  • The "Type" field is only a label. When building dependent choice fields the "Type" field can not be the parent for a dependent choice field. For example, you can not have some options display if the subtable is SubTableA, and display other options if it's SubTableB.
  • It is possible to set dynamic field defaults based on occurrence of results of changes in other fields values, for example a date field might be set to the date that another field value changed. However, these are sometimes counter-intuitive and better handled via rules instead.
  • You can delete any fields or tables not marked as undeletable. Often it is safest to just hide fields via permissions or layout instead, because deleting fields used by searches or reports may break them. If you try to delete a field used by linked fields you will get a warning wizard from the Integrity Manager that walks you through the deletion process.
  • For a Related Table data type, be sure to edit the label on the first screen and on the display tab, check the box to left justify it. This makes a better display.
  • Always when creating a linked set that includes ID field, edit the display characteristics for the ID field itself on the Display tab to make it 10 characters or less in width, otherwise it has a bad default and takes up about 70 characters, which looks bad.
  • Never use the data type for a Link to Single Field in Other Table, except when multiple values must be enabled. It is inevitable that when you do this, the customer decides they want to include a second or 3rd field in the set, and it has to be completely redone. Always use link to selected fields, whether or not it is specified.
  • When creating a linked field set, on the Mapping tab, never choose Do Not Update while leaving the box that enables non-source values empty. This will cause errors. Always Update should be selected in 99% of cases. If you enable non-source values you can use update matching fields instead.
  • For a linked field with a default value, on the Options tab, always choose one of the two radio buttons that define whether to update when the underlying condition changes.

  • When setting up date/time fields that will never be entered by user, don't use calendar and popup display, use simple text box 22 wide.
  • When doing choice fields with only 2 choices, typically radio buttons look better, on the display tab explicitly set it to 2 per row.
  • When creating a text or short text field, don't skip the Display tab - you will almost always need to set the size of the display box away from the 70 default value.
  • Wide text fields should all have the same display width to look neat, unless you use the "expand all fields to the same width" option on the alignment tab of the layout. Typically 90 or 95 is a good width that works on most screens.

Agiloft