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.
Terminology
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.