Following are the different field edit types
that may be selected from the Edit Type attribute’s list. All field edit
types include the Common Field Attributes as a part of their definition.
Many edit types also include additional attributes related to their
edit type-specific behavior. These edit types are denoted as such
with an asterisk(*) in this list. Look to the additional information
provided for these field edit types for information on their type-specific
attributes.
- Default: Selecting this edit type
option will force the field to take on the edit type matching the data
type of the property it targets. If a field has a default edit type
and does not target a property, the field will be a string field.
- Barcode Scan*: The barcode scan
field edit type receives input from a barcode scanner. Use of
this field type requires the device to have a barcode scanner, and
for the parent detail screen to be used by a platform that supports
scanning. This type of field may also accept manual input from the
user, depending on how it is defined.
- Button*: The button field
edit type defines a detail screen field with button behaviors to
execute actions and capture values. This
field type will draw a button control on the detail screen in any position
where a field can be placed. For object screens this button may
execute an action. For wizard screens the button can set the value
of a property. The type of button displayed may be a push button,
check box, or radio button. Check boxes and radio buttons may be
grouped (meaning only one can be selected at a time) by all targeting
the same property. A value can be defined for this field that will
be set to the property the Field targets when the user clicks this
button. There are three types of buttons: Radio Button; Check Box;
and Push Button. This is the default for displaying a Boolean
Property.
- Calendar View*: The calendar
view field edit type provides an interactive calendar to display
an object collection property, with each object treated as a calendar
event. The
objects in the collection property displayed by this field must
include properties for start and end date and times, as well as
other calendar related values.
- Complex Table Drop Down*: The complex
table drop down field edit type displays unique values from a defined
record field from a complex table in a drop down list. Using
a succession of fields with this edit type can create a cascade.
This is a representation of parent-child values where the users
will be required to select a parent value first, and then select
from only those values that are children of the selected parent.
Use of this edit type requires the supporting structure be first
defined in the complex table the field displays. A cascade can also
be created using a combination of this field edit type and Complex
Table List fields.
- Complex Table List*: The complex
table list field edit type displays the records of a complex table
in a list control on the detail screen. Using
a succession of fields with this edit type can create a cascade.
This is a representation of parent-child values where the users
will be required to select a parent value first, and then select
from only those values that are children of the selected parent. Use
of this edit type requires the supporting structure be first defined
in the complex table the field displays. A cascade can also be created
using a combination of this field edit type and Complex Table Drop
Down fields.
- Complex Table Search*: The complex
table search field edit type displays the records of a complex table
in a searchable list of records. This
screen is displayed when the user clicks the associated button for
this field type. This is a built-in screen within the Client and
will display the records of the complex table in rows and columns.
The user may select any index for a string field and enter search
text to locate a record within the table.
- Complex Table Tree*: The complex
table tree field edit type displays the records of a complex table
in a tree control, providing a parent-child relationship to the
records. This
screen is displayed when the user clicks the associated button for
this field type. This is a built-in screen within the Client and
will display the records of the complex table in a tree control.
The records are organized in this tree using the parent-child index
relationships defined in the complex table.
- Data Table Selection*: The data table
selection field edit type lists the records of a data table in a
drop down list control on the detail screen. The
code value of the record selected by the user is returned to the
field. If the number of records is too large to fit in a drop down
control, a popup dialog will display the records in a list box.
- Date: The date field edit
type allows the user to enter a date value selected from a calendar
control. The
user may also manually type a date value into this field. When using
the calendar control, the user clicks the ellipsis button drawn
to the right of the field on the detail screen. This will display
the calendar where the user can select a date by scrolling through
the months. It is recommended that this edit type only be used with
properties defined to be date values.
- Date And Time: The date and
time field edit type allows the user to enter a date and time value
selected from calendar and time controls, respectively. In
this type of field, the user can enter a date value by selecting
it from a calendar and enter a time value in the time portion of
the field. It is recommended this field edit type only be used with
date and time properties.
- Decimal Number: The decimal number
field edit type captures decimal values, allowing only numeric values, a
single decimal value, and a negative sign. Any
other characters will not be accepted by this field type.
- Duration: The duration
field edit type allows the user to enter a duration value in hours,
minutes and seconds. This
field displays a control similar to a time entry, but the values
entered represent a duration of time, rather than a time of day.
- Embedded Image*: The embedded image
field edit type displays an image definition on the detail screen
that can be interactive. A
transparent grid can overlay this image and each section, or “cell”
within this grid can have an action associated with it. When a given
cell is clicked on the Client that action will be executed. Fields
with this edit type have a child definition called Cell that represents
each cell in the grid overlaying the image.
- External Data: The external
data field edit type displays controls to show the Windows File
Dialog on the client to allow a file to be selected for an external
data property.
- External Field - Active X Control*: The external
field-ActiveX Control field edit type is defined to call out from
a field to an active X control, passing values to the control. Use
of this Edit Type also requires use of the Active X interface available
with the Agentry Mobile Platform.
- HTML: The HTML field edit
type supports the formatted display of HTML markup text, or the display
of a defined URL for internet navigation.
- Identifier: The identifier field
edit type requires the user to enter only positive integers. This
edit type is intended to support the capture and storage of values
intended to uniquely identify some business entity.
- Image Capture*: The image
capture field edit type provides integration with the client device’s
built-in digital camera, allowing for images to be captured and
stored in properties of the application.
- Integral Number: The integral
number field edit type allows the user to enter only whole numeric
values and an optional negative sign. Any
other characters will not be accepted in this field.
- Label: The label field
edit type displays only the label portion of a field definition,
excluding any actual field control. The
Label edit type prevents any editing, and no field is drawn on the
detail screen. As will be readily apparent in the Agentry Editor,
many of the common field attributes are disabled for fields with
an edit type of Label.
- List Selection*: The list selection
field edit type displays a drop down list of values, the source
of which may be an object collection, data table, or complex table. Using
an include rule, you can also list a sub-set of the source items.
The values listed in this field edit type are treated as a temporary
data table that exists only in working memory and only for as long
as the field is displayed.
- List Tile View: The list
tile view field edit type displays an object collection property
in a tiled view allowing for add and edit interaction with the collection
through the field. This
field type will use other screen sets containing detail screens
within the same module to display each object in the collection
in a list with each object displayed in it’s own tile. This can
include different screen sets to display, add, or edit objects within
the collection.
- List View*: The list view
field edit type displays an object collection property in a list
control on a detail screen with the same functionality as provided by
a list screen. A
field of this edit type contains the child definition column, matching
the column child definition to the list screen definition.
- Location: The location
field edit type is intended to display the value of a location property,
displaying the latitude and longitude in degrees for the location.
This field can be read-only or editable, allowing the user to manually
enter latitude and longitude values. When the field targets a transaction
property, it will automatically retrieve the latest location value
from the GPS unit. When
this field edit type displays an object property, or if it does
not target any property, a rule can be written to update the field
using the @GPS_LOCATION rule function to update the field.
- Password Validation*: The password
validation field edit type requires users to enter their client
password and validates the value entered against the password for
the client. This
entered value is hidden with character placement, displaying asterisks
in place of each entered character. Includes the ability to define
a message to the user when the password entered is not valid.
- String: The string field
edit type allows the user to enter any printable character values. This
field type can be used to provide a large text field to capture
user input by spanning multiple columns and rows on the detail screen.
- Signature Capture: The signature
field edit type allows for the entry of a signature on a client’s
screen that is stored as a bitmap image. The
signature edit type cannot be selected from the edit type list.
This is, rather, the default edit type for a field when that field
targets a property with a data type of Signature. To display such
a property the correct edit type selection is “Default.” No other edit
type should be used when targeting a signature property as the behavior
of such a combination is undefined.
- Tile Edit*: The tile edit
field type displays object properties in a tiled view allowing for
add and edit interaction without starting a wizard screen.
- Tile Display*: The tile
display edit type displays an object instance in a tiled view.
- Time: The time field edit
type allows the user to enter a time of day value using a time control. This
edit type will display three controls for the field to display and
capture the hours, minutes, and seconds portions of the time value.
It is recommended that this field edit type only be used with time
property types.