Developer

Detail Screen Field Edit Types

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 - OpenUI Control*: The external field-OpenU Control field edit type is defined to call out from a field to an OpenUI control, passing values to the control. Use of this Edit Type also requires use of the OpenUI interface available with the Agentry Mobile Platform.

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