The field map screen is used to configure the look and feel and behavior of various screens throughout the application.

The 'screen' represents a certain view in the application, which could be a tab in the ticket view, or a window such as the search form or form for creating new tickets.

A 'field' might represent a column, a form field, or a field displayed in the view.

The screens listed are described briefly below:

Screen	Description
project_close ticket_close	The screen which is displayed when the 'close' button is pressed while viewing a ticket. Any ticket field may be added to this view and displayed on the close screen for entry. The special fields 'hours' and 'comments' always appear in the close ticket screen and are entered into the log.
project_create ticket_create	The screen displayed when the 'New Ticket' or 'New Project' button is pressed. Used to create new tickets.
project_edit ticket_edit	The screen displayed when the 'edit' button is pressed while viewing a ticket. A special comments field can be added to this view by the Configuration Setting edit_reason_required.
project_list ticket_list	The screen displayed when the 'Projects' or 'Tickets' tab at the top of the browser is selected. This map controls the actual columns that appear in the list. This view is read only.
project_list_filters ticket_list_filters	This view configures the fields which are displayed above the ticket_list. They are used to filter the contents of the list window below. Note that adding searchbox or label fields in this view is not very practical or useful.
project_tab_* ticket_tab_*	This controls the contents of the various tabs which appear while viewing a ticket. Note that each tab can load special helper scripts (preload and postload) and can also have access permissions set. It is also possible to make the fields in any tab editable using the "view_only" property for the view. (more on these below)
project_view_top ticket_view_top	This configures the top area that is displayed above the tabs when viewing a ticket. Fields here are configured the same as the project_tab_* views.
project_tasks	Controls the columns displayed in the project view when the special preload/postload window "tasks" is enabled. (more on these below)
search_form	Controls the fields which are displayed on the search form. Note that the fields in the search form are divided into special sections based on the field type. For instance, date fields have a start/end range rather than just a single field.
search_list	Controls the columns which are displayed in the search results window.
search_export	Controls the columns which are exported when the "export results" feature is used from the search results.
searchbox_project searchbox_ticket	Controls which fields are used in the special searchbox windows that appear for ticket and project fields.

The use of Sections:

Sections are special dividers which can appear in certain views (such as ticket_create and ticket_edit). You may add or remove sections as you see fit.

Note that some special sections (like 'elapsed') may not be removed, but you may uncheck the 'Show' box to hide them. This is done because they provide special functionality that you cannot recreate by any other method.

Special view properties appear for some screens, they are described here:

View Property	Description
access_level	This specifies the access level that is required to use this screen. Note that this feature is only editable in some views, such as ticket tabs.
any_option	Some views allow "any" to be selected as a choice for certain fields. This option controls whether the "any" option is shown. Note that only some views are capable of allowing the administrator to configure this property.
columns	The columns property specifies how many fields will be shown on each line. If the number of fields exceeds this number, then multiple lines will be shown.
has_behaviors	This property simply tells the administrator whether behaviors are implemented in the corresponding view.
label	Provides a title for the view or a label to appear in tabs.
preload postload	These enable special features for a ticket tab and are described in detail below.
show_totals	In some lists of tickets, columns can be totaled (even over multiple pages). This feature displays/hides the total information.
view_only	Certain views allow fields to be edited or to simply appear as text. This feature controls whether the fields are editable. Note that only some views, such as ticket tabs, can be used for either.
visible	Unchecking this will disable certain views by removing them from the interface.
width	This is used with ticket tabs to specify how wide each field will be in the display. Use this together with 'columns' to get a good display set based on your fields' optimal width.

The columns listed for each field are described here:

Column Name	Description
Options	Provides options to reorder fields and to delete/add sections. Note that it is not advisable to reorder and edit fields at the same time!
Name	The field name as it appears in the database
Label	The field name as it should appear in the screen
Show	Unchecking this box removes the field from the view. Note that for forms the field becomes hidden, so that it can still be used by behaviors, but cannot be edited.
Required	Checking this box means that the field must contain a value in order to submit a form in this screen.
Default	Supply a default value for the field. This has no affect in view only screens. For custom_menu fields, this field is used to select a "Data Group" which contains the values to appear in the dropdown. The default value is always the first one in the list.
Type	The types of fields are described below
Columns	The columns specifies the maximum width of input fields, and the length of columns in view only screens. Note that the input fields will only expand up to a certain width, but the number of characters which can be entered in total always matches this value.
Rows	For menus and textareas, this determines the height of the field. It has no affect on any other fields.

The field types are:

Field Type	Description
Checkbox	Shows a checkbox for the field, the value entered is always 1 if checked and 0 if not. If more than one entry is allowed, then this will show a list of possible values. Note that this feature will only work with certain fields.
Date	Displays the field with a date picker icon.
Hidden	The field is not displayed to the user. For forms, this is the same as unchecking the "Show" box. For view only screens, this completely removes the field.
Label	Display the field as text only. For forms, the value is still provided in a hidden field for use in behaviors.
Menu	A list of choices is provided in a dropdown menu.
Options	Provides options to reorder fields and to delete/add sections. Note that it is not advisable to reorder and edit fields at the same time!
Radio	Shows a list of radio buttons for all of the possible choices.
Searchbox	Provides a search window and displays the chosen records in a special table.
Section	Displays a special divider between areas of a form. Note that some special fields are also provided as type "section".

The special options preload/postload are used to display special data in the ticket view. Here are some of the choices and what they do:

Loader	Description
Attachments	Display a table of attachments which are linked to the ticket. Attachments can be added/removed from this table.
Contacts	Display a list of contacts which have been linked to the ticket. Contacts can be added or removed using this table.
Details	Display the "details" field of the ticket with special formatting. URLs are converted to links, white space is preserved, and a scrollbar is included for maximum screen usage. The size of the box is set using the Configuration Setting max_textbox_height
Log	Displays log entries in sortable, filterable, scrolling box. The size of the box is configured using the Configuration Setting max_textbox_height.
Notify	Displays the notify list for the ticket. Contacts and users can be added/removed from this table.
Project	Displays the title of the parent project (if any) and provides a link to that project.
Related	Displays related tickets in a table with links.
Tasks	Displays the list of tickets which are attached to a project in a sortable, paging table. The format of the columns in this list is configured using the project_tasks field map.