This documentation supports the 22.1 version of Action Request System.
To view an earlier version, select the version from the Product version menu.

Field Properties

For each field on a form, use the Properties tab in Developer Studio  to set properties that determine the look and behavior of the field during operations performed in a browser. The properties listed in the Properties tab vary depending on the type of field you create or modify.

See also Customizing field properties by using overlays.

Field properties A to C

PropertyField typeDescriptionIs this field supported in progressive views?
Active Link(s)ButtonSee Creating button fields.(tick)
Navigation field menu itemSee Creating navigation fields.(tick)
Active Link On ClearCharacter

Specifies the name of the active link that gets executed when you select Clear from a drop-down menu at runtime after you've already selected an option. This property is displayed only when there is a menu attached to a character field.

To set the active link:

  1. Select a character field.
  2. In the Menu Name property on the Properties tab, specify a menu name by clicking the ellipsis button, and then selecting a menu.
    The Active Link On Clear property is displayed in the Property column.
  3. In the Value column, click the ellipsis button for the Active Link On Clear property.
    The Active Link Selector dialog box is displayed.
  4. Select one or more active links, and then click OK.
    The active link is set.
(tick)
Active Link On Content ChangeColumn

This property is visible only when the you select the Editable value for the Display Type property for a Column field. Then, you can select the active link that gets executed at runtime when you edit the contents.

See Setting column properties.

(tick)
Active Link on Row ReorderingTable Cell Based, Table - List View

Stores the name of the active link for row reordering. This is a text field and is visible only when you select the True value for the Enable Row Reordering property.

See Table fields and List view table fields.

(tick)
Active Link on Row UnselectTable Cell Based, Table - List View

As a value for this property, you can specify the active link to be executes whenever you cancel the selection of a table row. Just click the ellipsis button in the Value column for this property, and then in the Active Link Selector dialog box, choose an active link.

See Table fields and List view table fields .

(tick)
Add LabelAttachment poolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
Add New PanelPanel holder (all)See Creating panel holders.(tick)
Alignment
  • Data (all)
  • Display (all except navigation field menu items)
  • Composite (all except table columns and panels in panel holders)

Specifies whether the field's horizontal position is anchored to the Left (default) or the Right side of a form. This property is valid in the Mid Tier . See Anchoring fields to the right side of a form or panel.

(tick)
Align ItemFlow Panel Holder

Specifies the horizontal and vertical alignment of an item. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The following can be the values for this property:

  • None (Default)
  • Top
  • Top Left
  • Top Center
  • Top Right
  • Bottom
  • Bottom Left
  • Bottom Center
  • Bottom Right
  • Center
  • Center Left
  • Center Center
  • Center Right
  • Right
  • Left
(tick)
Allow Any User to Submit
  • Attachment
  • Data (all)
See Special submit setting.(tick)
Alternative Text

All fields that have this property

See Adding images to buttons.

For Button fields, the Alternative Text field property is available under Image. For the other field types, Alternative Text field property is found under Display. 

(tick)
AnchorablePanels

Specifies if a panel is anchorable. This property is enabled only when you set the orientation of a Flow Panel Holder containing the panel to Vertical.

This property can have the following values:

  • False (Default)
  • True

See Modifying panels and panel holders.

(tick)
Anchor PlacementFlow Panel Holder

Specifies the side on which an anchor is to be placed. This property is enabled only when you set the orientation of a Flow Panel Holder to Vertical.

This property can have the following values:

  • Left (Default)
  • Right

See Modifying panels and panel holders .

(tick)
Answer FontSurvey Component

Specifies the font of the answer text. This property is displayed only when you set the value for the Display As Text property to True.

This property can have the following values:

  • Detail Text
  • Edit Field
  • Header Text (I)
  • Header Text (II)
  • Header Text (III)
  • Note Text
  • Optional Field
  • Push Button
  • Radio Button
  • Required Field
  • System Field
(tick)
Attach Name LabelAttachment poolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
Attach Orphaned ItemsNavigation (all)See Creating navigation fields.

(tick)

Progressive views support this property with vertical navigation.

Attachment FieldsAttachment PoolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
Attachment Pool ListAttachmentSee Managing attachments in Progressive Web Applications by using a remote form.(error)
Attachment ModeAttachment PoolSpecifies the attachment mode. See Managing attachments in application interfaces.(tick)
Attachment SizeAttachment PoolSpecifies an attachment size. See Managing attachments in application interfaces.(tick)
Audit Log Key
  • Attachment
  • Data (all)
See Configuring auditing.(tick)
Audit Option
  • Attachment
  • Data (all)

Select one of these options:

  • None -Changes to the field are not recorded by any audits.
  • Audit -Changes to this field trigger an audit. New values are recorded in the audit form or log form, depending on the audit style set at the form level.
  • Copy -Changes to this field are recorded during an audit, but they do not trigger an audit.
  • Audit and Copy -Changes to this field trigger an audit if the field is changed, but if it is not changed, it is still copied (that is, behaves like a copy field).

See Using buttons and menu bar items to execute active links.

(tick)
Auto CompleteCharacterSee To enable or disable auto-complete.(tick)
Auto Complete After KeystrokesCharacterSee Automatically completing menu entries.(tick)
Auto Complete Match ByCharacterSee To configure auto-complete to match by label.(tick)

Auto Fit Columns

  • Alert list
  • Table - Cell Based
  • Table - List View
  • Results list
See To add a table field to a form.

(error)


Auto Refresh StringAlert listSee Customizing table labels.(error)
Auto ResizeCharacterSee To enable dynamic resizing of dynamic fields.(error)

Auto Resize

View field and DVF

The default value of this property is True where the view field is set to adjust its height depending on the content within the view field.

If you set Auto Resize to True and do not set any maximum height limitations, Developer Studio ignores the Scroll Bar property.

If you set Auto Resize to False, then the view field height is decided by either the Height property or the Maximum Height property.

(tick) (Available only for PWA)
Background Color
  • Table - Cell Based
  • Panel (all)
  • Trim box
  • Trim text
  • Drop-Down List
  • Radio Button
  • Check Box
  • Flow Panel
  • Tab Panel

Specifies the background color:

  1. Select the appropriate field.
  2. (Panels and trim fields) On the Properties tab, for the Background Mode property, select the Opaque value.
  3. From the Background Color drop-down list, select Color.
  4. Select a color from the color palette, and click OK.

The selected color is displayed in the Background cell.

This property is also added to the Change Field active link action in Developer Studio . See Defining Change Field active link actions.

(tick)

Progressive views do not support Trim box.

Background Image
  • Table - Cell Based
  • Panel (all)

For cell-based tables, specifies the background image in all the cells in the table.

For each device type, namely desktop, mobile, and tablet, the Background Image property is available. Thus, you can set a different image for each device type and each image is independent of the other.

See Adding background images to fields and form views .

(tick)

This property is not supported for Cell-based tables in progressive views.

Background Image Horizontal
  • Table - Cell Based
  • Panel (all)

For cell-based tables, specifies the position of the image in the cells from side to side. For panels, specifies the position of the image in the panel from side to side.

This property can have the following values:

  • Left (Default)
  • Center
  • Fill
  • Right
  • Tile

See Adding background images to fields and form views.

(tick)

This property is not supported for Cell-based tables in progressive views.

Background Image Vertical
  • Table - Cell Based
  • Panel (all)

For cell-based tables, specifies the position of the image in the cells from top to bottom. For panels, specifies the position of the image in the panel from top to bottom.

This property can have the following values:

  • Top (Default)
  • Center
  • Fill
  • Bottom
  • Tile

See Adding background images to fields and form views.

(tick)

This property is not supported for Cell-based tables and panels in progressive views.

Background Mode
  • Panel (all)
  • Trim box
  • Trim text
Specifies whether the background is opaque or transparent. For text fields in a browser, the opaque background is white.

(tick)

This property is supported only for panels in progressive views.

Panel holder (all)

Specifies whether the background image for the view shows through the panel holder and all panels.

  • Opaque (default)—Fields on the form behind the panel in the stacking order are not visible.
  • Transparent—In a browser, fields on the form behind the panel holder in the stacking order are visible unless covered by a panel with a Background Color or Background Image set.

For more information about background images and colors in views, see Setting form view properties.

(tick)
Border
  • Application list
  • DVF
  • View

Specifies how borders are shown:

  • Default—The field border is displayed only when the content of the view field is a URL. This option works with a browser.
  • Hide—The field border is not displayed.
  • Show—The field border is displayed.

(tick)

Progressive views support Border property for Views.

Border Color
  • Panel (accordion, collapsible, splitter, Flow Panel, Tab Panel)
  • View

Color of lines surrounding the cells.

For the View field, the default value for the Border Color property is RGB {123, 123, 123}.

To learn about the View field, see View fields.

(tick)
Border Thickness
  • Panel (accordion, collapsible, splitter,
    Flow Panel,
    Tab Panel

Dimension of lines surrounding the cells. Specify in pixels. You can specify up to 9 pixels. Enter 0 to have no border. To create a border with the same number of pixels on all sides, enter one number. To create a border with varying sizes, enter the number of pixels for each side in the following order: Top, Right, Bottom, Left. Separate each entry with a comma. For example, to create a panel with borders that are 2 pixels on the right and left and 5 pixels on the top and bottom, enter 5,2,5,2. To create a panel with no borders on the top and bottom and borders of 3 pixels thick on the right and left, enter 0,3,0,3.(tick)
BorderlessPanel holder (accordion, collapsible, splitter)Specifies whether a border appears around the panel holder. The default is True (border does not appear).(tick)
Bottom PaddingFlow Panel Holder

An element's padding is the space between its content and its border. This property sets the bottom padding (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
(tick)
Bottom MarginFlow Panel Holder

An element's margin is the space around the element and outside of any defined borders. This property sets the bottom margin (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • -1
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
(tick)
Bulk Select LabelTable - List View

Specifies the label for a check box that is displayed at the top of a list-view table.

By default, the label is blank. You can specify any label, for example, Select All or Relate All.

This property is available in the Labels property group and is visible in progressive views only.

In a progressive view, when you select the check box, all rows in the table are selected. Also, if you select the check box (with any name, such as Relate All or Select All) the table is disabled.

When you select the Select All check box, the check boxes for the table header and table rows are disabled. You can localize the Select All label. If you select all individual records from a single page or from multiple pages, the Select All check box is not selected automatically. When you select the Select All check box, all other actions except page navigation and record sorting are disabled on that page.

You can use the ISTABLESELECTALLCHECKED function along with the Bulk Select Label property to check if the check box is selected. Learn more about this function at Functions.

(tick)

(Available only for PWA.)

Button LabelButtonSee Creating button fields.(tick)
Button TypeButton

This property specifies the type of button and can have the following values:

  • Primary
  • Secondary
  • Tertiary
  • Success
  • Info
  • Warning
  • Critical

See Button fields and Creating button fields.

(tick)
Button FieldTableUse this property to provide a button ID to display the filter in place of a button. This property is available in the Filter section.(tick)
Change HistoryAll

Contains information about field modifications. AR System automatically records the owner of a field, the user who last modified the field, and the date of the modification. To display or add to this information, use the Change History properties. For more information, see Updating the change history of fields, forms, or objects.

(tick)
Checkbox Column
  • List view table
  • Results list
See Adding a Select All or Cancel All check-box column to tables.(error)
Chunk SizeCharacter

Specifies the number of values that are displayed in a character menu field. This property is shown only when the Menu Name field is not empty. The type of this property is Integer and the default value is Empty.

To set the chunk size:

  1. Select a character field.
  2. In the Menu Name property on the Properties tab, specify a menu name by clicking the ellipsis button, and then selecting a menu.
    The Chunk Size property is displayed in the Property column.
  3. In the Chunk Size property, specify an integer value.

If you remove a menu after setting a value for this property, you must set the value of this property to Empty.

(tick)
CLOB StorageCharacter

Specifies how CLOB (character large object) data is stored:

  • Default—Use the value of the Store CLOB In-Row option on the AR System Administration: Server Information form's Database tab. See Setting database options.
  • In Row
    • If the length of the character data, including the LOB locator, is less than or equal to 4000 bytes, store the data "in row."
    • If the length of the character data, including the LOB locator, is greater than 4000 bytes, store the LOB locator "in row" and the data "out row." In-row CLOBs can degrade CPU performance.
  • Out Row—Store the data "out row." Out-row CLOBs can cause the database to grow rapidly.

This property applies only to Oracle databases.

(tick)
ColumnAll (view and vendor forms only)Specifies the name of the database table column associated with the field. This field is read-only. For more information, see Using buttons and menu bar items to execute active links.
Column ColorTable - List View

Specifies the color of a column in a List View table.

To learn how to use this property, see Setting the color for a column in a list view table.

(tick)
Column Header ColorTables (all except cell-based tables)Specifies the background color for the table column header(error)
Column Header Text ColorTables (all except cell-based tables)Specifies the text color for the table column header.(error)
Column ImagesTable - List View

Specifies the images to be displayed in the column of a table.

You can find this property in the Image property group on the Properties pane.

When you don't specify any images for this property, the value for this property is shown as No images supplied. However, when you specify images, the value is shown as Images supplied.

Learn how to use this property at To add images to a list-based table column.

(tick)

Column Width

  • Alert list
  • Table - Cell Based
  • List view table
  • Results list
  • Tree view table
See Setting column properties.(tick)
Component DefinitionSurvey Component

Holds the survey component definition. You can type in the name of a definition file as a value for this property or select a file from the drop-down list.

A survey component definition stores all mappings for a particular module, such as Change or SRM survey.

(tick)
Content ClippingDisplayFor cell-based tables, only when table chunking is enabled.(error)
Currency TypesCurrencySee Creating currency fields.(tick)
Custom CSS StyleAllSpecifies a custom CSS style for the field. For more information, see AR System installed forms.(tick)
Custom PropertiesDVFSee Data visualization fields.(tick)

Field properties D to F

PropertyField typeDescriptionIs this field supported in progressive views?

Data font

Data (all)

Specifies a font type for the data that users enter into the field. To change the data font, select any one of the following font types from the drop-down list:

  • Edit Field—Defines the font for data in fields. Default font: MS Sans Serif 8.
  • Optional Field—Defines the font for tabs in page fields and for labels of optional fields. Default font: MS Sans Serif 8.
  • Push Button—Defines the font for buttons. Default font: MS Sans Serif 8.
  • System Field—Defines the font for field labels set by AR System . Default font: MS Sans Serif Italic 8.
  • Radio Button—Defines the font for radio (option) buttons. Default font: MS Sans Serif 8.
  • Required Field—Defines the font for labels of required fields. Default font: MS Sans Serif Bold 8.
  • Header Text I—Defines the font in text trim for titles. Default font: MS Sans Serif Bold 12.
  • Header Text II—Defines the font in text trim for headers. Default font: MS Sans Serif Bold Italic 10.
  • Header Text III—Defines an alternative font in text trim for headers. Default font: MS Sans Serif Bold 10.
  • Note Text—Defines the font in text trim for labels. Default font: MS Sans Serif 8.
  • Detail Text—Defines the font in text trim for details. Default font: Arial Serif 7.

For Progressive Views, the following additional values are added in Developer Studio for this property:

  • Header Text (IV)
  • Header Text (V)
  • Header Text (VI)
  • Success
  • Info
  • Warning
  • Error

Important

Header Text (IV), Header Text (V), and Header Text (VI) are available only for character fields.

(tick)

Progressive Views support Character field

Data LengthData (all)Specifies the width of the field's data entry region in pixels. This often differs from the maximum length for data entered in the field (see "Input Length" in this section). If users enter more characters than can be displayed, the text scrolls off the end of the field, provided the internal field length can accommodate the input.(tick)
Data TypeAllSpecifies the type of information that the field is designed to contain, for example, character or trim. This property is read-only. See Creating and managing fields.
(tick)
Date Display ModeDate, Date/Time

For progressive views, this new property is added.

See Types of data fields.

(tick)
Default Thumbnail ImageCharacter

Specifies the name of the Angular icon of a thumbnail:

  1. Select a character field.
  2. On the Properties tab, for the Display Type property, select the Thumbnail value from the drop-down list.
    The Default Thumbnail Image property is displayed in the Property column.
  3. Enter the name of the Angular icon of a thumbnail as a value for the Default Thumbnail Image property.

To view the list of predefined icons that are available Out-Of-The-Box (OOTB) in Developer Studio for Progressive Views, see Icons available in Developer Studio to support PWA.

(tick)
Table - List View

Specifies the default thumbnail image that is displayed in a table column. This property is visible only when you set the Render Data As Thumbnail property to True.

Learn how to set column properties in a table at Setting column properties.

(tick)
(Available only for PWA)
Default ValueCharacter

Specifies the value that appears in the field when users initially open the form to perform a search or to submit a new request in the Mid Tier . Default values can improve application usability. For example, creating a default value as a prompt in a required field ("Enter your name here") informs users what information must be entered in the field. You can use keywords to define a default value. Keyword values that are unlikely to change, such as $USER$, expand to a value when defaults are first set. Other keywords (such as $TIME$ ) expand to a value as late as possible when defaults are loaded. For more information, see Keywords. To add a default value, select the Default Value property, click its ellipsis button, enter the default value, and click OK.

(tick)
  • Date
  • Date/Time
  • Decimal
  • Diary
  • Integer
  • Real
  • Time
Specifies the value that appears in the field whenever users load default values before performing a search or submitting a new request. (Date and time fields) This value can be a static value or one of these keywords: $TIME$, $DATE$, or $TIMESTAMP$. (Diary fields) You can use keywords. For more information, see Keywords. To add a default value, select the Default Value property, click its ellipsis button, enter the default value, and click OK.

(tick)

CurrencySee Creating currency fields.(tick)
Definition NameDVFSpecifies the definition name for the data visualization module. For more information, see Data visualization fields.(tick)
Delete Button
  • Alert list
  • Results list
See Customizing table labels.(error)
Delete LabelAttachment poolSee Managing attachments in interfaces by creating attachment pools.(tick)
Depth Effect
  • Horizontal line
  • Trim box
  • Vertical line

For a box or line, specifies the appearance of depth:

  • None
  • Raised
  • Sunken
  • Etched (default)

For examples, see Creating trim fields.

(error)

Deselect All
  • Alert list
  • Table - Cell Based
  • List view table
  • Results list
See Customizing table labels.

(error)

Deselect LabelAttachment poolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
Disable Change Flag
  • Data (all)
  • Application list
  • Attachment
  • DVF
  • View

Specifies whether the change flag ("dirty bit") is affected by the field you are creating. When this property is set to True, the field does not affect the change field status of the form. This can be helpful when you have calculations that use hidden fields. See GET-CHANGE-FLAG and SET-CHANGE-FLAG in Process commands.

Any field not in the user's current view does not affect the change flag, even if the Disable Change Flag property is set to False. You can associate a SET-CHANGE-FLAG Run Process action with a field not in the view to set the change flag as needed. See Including and excluding fields from form views and information about special run processes and $PROCESS$ in Process commands .

(tick)

Progressive views support only Data.

Disabled ImageButtonSee Adding images to buttons.(tick)
Display as Flat ImageButtonSee Adding images to buttons.(tick)
Display As Text
  • Character
  • Data (all)
  • Date/Time
  • Diary
  • Survey Component

When set to True, displays the contents of the field as plain text without a border or background. You might want to set a default value for the field (see Default Value in this section).

When set to True for a character field, the text area is Read Only, and should not be editable by changing Field Access to Read/Write from Read Only. In other words, when set to True, Field Access has no impact on the text area of the data field. Character, date/time, and diary fields are editable by using an expand box.

For the Survey Component field, this property specifies if the a form is to be displayed in the read-only mode. This property can have the following values:

  • True (Default)
  • False

(tick)


Display as SelectColumn

Specifies if a field can be displayed as a menu or a selection field.

This property is shown only when:

  • The value of the Filter property is set to True.
  • The Column field is Character with menu

This property can have the following values:

  • False (Default)
  • True
(tick)
Display LabelAttachment poolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
Display NULL value AsTree view tableSee Adding a table field to a form.(error)
Display TypeButtonSee Creating button fields.(tick)
Character

Specifies one of these display types:

  • Drop-Down List—Users can select a value from a drop-down list. Values available in the list are from a menu attached to the character field. This option is available only if the character field has a menu attached to it. This option is different from the drop-down list for a selection field although they look similar. In non-Search modes, such as New and Modify, users can select a value from the list but cannot type directly in the field. In Search mode, users can either select a value from the list or type directly in the field. Users can also enter partial list values, such as "Business" instead of "Business Services," to find all requests whose value in the field includes the word "Business."
  • Edit—Users can type values directly into the field.
  • Edit Masked—Users can type values directly into the field, but the values are displayed as asterisks. This display type offers no special security. For example, the values are not stored in the database as encrypted values. Edit masked values are exported, imported and transmitted from client to server in clear text.
  • File—Users can browse network file systems for a file path, which is added to the character field. See Adding a file system browser to character fields.
  • Rich Text—Users can make rich-text-formatting (RTF) changes in a dialog box after they click the RTF icon next to the field.
  • Rich Text In Place—Users can make RTF changes within the character field, or they can click the RTF icon and make RTF changes in a separate dialog box that contains more RTF options. For more information, see Adding rich-text-formatting capabilities to a character field.

For Progressive views, the following display types are introduced:

  • Phone Number—For a character field, after you set the Display Type as Phone Number, you can enter a phone number into the character field.
  • Email—For a character field, after you set the Display Type as Email, you can enter an email address into the character field.
(tick)

  • Date/Time
  • Date
  • Time

Specifies one of these display types:

  • Date/Time—Users can click a calendar to enter dates and times into the field. Users can also directly edit dates and times.
  • Date—Users can click a calendar to enter dates into the field. Users can also directly edit dates.
  • Time—Users can click increment and decrement arrows (q and p) to enter times into the field. Users can also directly edit times.
(tick)
DiarySpecifies this display type:* Edit—Users can type values directly into the field.(error)
Integer

Specifies one of these display types:

  • Edit—Users can type values directly into the field.
  • Numeric Spinner—(For Internet Explorer browsers only.) Users can click increment and decrement arrows (q and p) to increase or decrease the number in a field. Users can also directly edit numbers.
(tick)
Navigation
  • Horizontal Nav Bar—The field is a horizontal navigation field.
  • Vertical Nav Bar—The field is a vertical navigation field.

This property cannot be changed, so it is not possible to convert one type of navigation field to the other.

(tick)

Progressive views support only vertical navigation.

Panel holder

Specifies one of these display types:

  • Tabbed—One panel is displayed at a time. Multiple panels are indicated by tabs.
  • Collapsible (Stacked)—Multiple panels are displayed either horizontally or vertically.
  • Splitter—Multiple panels are displayed either horizontally or a vertically. A splitter control can be dragged to change the size of adjacent panels.
  • Accordion—One panel is displayed at a time; only headers of the remaining panels appear. When the header of another panel is selected, that panel is opened to display its contents.
  • Flow Panel Holder—The Flow panel holder supports the properties required to enable a progressive view. Use the Flow Panel holder for aligning fields on the form. You can also group the fields to ensure proper alignment.
(tick)
Selection

Specifies one of these display types:

  • Drop-Down List—Users can select from a list of choices.
  • Radio Button—Users can select only one choice.
  • Check Box—Users can select one or more items from a set of items.
(tick)
Table columns

See Setting column properties .

(tick)
Table fields

To support the Progress Bar widget, a new value called Progress Bar View is added.

See Configuring the Progress bar widget in Progressive Web Applications and Adding a table field to a form.

(tick)
Draggable
  • Data (all)
  • Horizontal Line
  • Vertical Line
  • Trim Text
  • Trim Box
  • Button
  • Tables (all except Results list)
  • Attachment pool
  • Panels (all)

(Web only) Specifies whether a field can be dragged to another field. This property creates only the effect of dragging. You must create workflow to copy and paste data between fields. (You can, however, configure workflow to execute on the drag event.) For more information, see Allowing users to drag and drop data.

If you enable dragging and dropping between two attachment pool fields, they should each have only one attachment field because workflow cannot determine which field is being dragged or dropped.

The default value of Draggable is false.

(tick)

Progressive views supports only Data, Panels, Attachment Pool.

Drop Shadow
  • Panels (all)
  • Panel holders
Specifies whether a panel, with rounded corners or not, or panel holder has a drop shadow. For more information, see Creating panel holders. For floating panels and panel holders, the default value of Drop Shadow is True. For non-floating panels and panel holders, the default value is False.

(tick)

Progressive view supports only Panel holder.

Droppable
  • Data (all)
  • Horizontal Line
  • Vertical Line
  • Trim Text
  • Trim Box
  • Button
  • View
  • DVF
  • Tables (all, except Results List)
  • Attachment Pool
  • Panels (all)

(Web only) Specifies whether a field is highlighted when a user drags a field. For more information, see Allowing users to drag and drop data. This property allows the field to accept drop events that occur as a result of a user dragging a field and dropping on it.

If you enable dragging and dropping between two attachment pool fields, they should each have only one attachment field because workflow cannot determine which field is being dragged or dropped.

The default value of droppable is false.

(tick)

Progressive views supports only Data, Panels, Attachment Pool.

Edit Menu/Navigation ItemsNavigationSee Creating navigation fields.

(tick)

Progressive views support only vertical navigation.

Enable Anchor NavigationFlow Panel Holder

Specifies if anchor navigation is enabled. This property is enabled only when you set the orientation of a Flow Panel Holder to Vertical.

This property can have the following values:

  • False (Default)
  • True

If you set the value of this property to True for a Flow Panel Holder, you can't set the value of this property for any other Panel Holders on that view.

See Modifying panels and panel holders.

(tick)
Enable ClearCharacter

Specifies whether a (clear) item appears on character field drop-down lists.

  • Always—A (clear) item appears in all modes. This is the default setting.
  • Search Only—A (clear) item appears in Search mode only.

This property is appears in the Properties tab only when a menu is attached to the character field and the Display Type field property of the character field is set to Drop-Down List. See Adding and removing (clear) from drop-down lists.

(error)
EnabledData (all)(Web only) Specifies whether a field is highlighted when a value is changed through a Set Fields action, and the color of the highlight. When set to True, you can specify a highlight start color and a highlight end color. The default value is false (highlight not enabled).

(tick)

Enable Menu HotkeysCharacter

Specifies if the menu hotkeys are to be enabled.

See Configuring the @mention component.

(tick)
Enable Nested Row ReorderingTable - Cell Based, Table - List View

Specifies if nested row reordering is enabled in a table. This property enables you to drag and drop table rows within a table to perform reordering.

This property can have the following values:

  • True
  • False (Default)

See Defining tables to display data.

(tick)
Enable Row ReorderingTable - Cell Based, Table - List View

Specifies if row reordering is enabled in a table. This property can have the following values:

  • True
  • False (Default)

See Defining tables to display data.

(tick)

Encrypt Data at Rest

Character fields

Allows the users to configure the field on a regular form and on a view form as confidential so that the data remains encrypted in the database. This option is applicable for any data field, provided the Entry Mode option is not set to Display only. Also, the Display only option is available for some of the data fields.

The valid values are:

  • True
  • False (default)

If the property is set to True, the AR System server encrypts the data for this field before updating the data to the database and also decrypt the data while reading it from the database.

If the property is set to True for a field with existing data, the server does not encrypt the existing data automatically. To encrypt the existing data, you must export the data before you set the property to True and then re-import the data after the property is enabled. If the property is set to False for the field with existing data, the server does not decrypt the existing data automatically. You must export the data before you set the property to False and then re-import the data after the property is disabled.

Important: If the property is set to True on a field, search on this field fails since the data in this field is encrypted. Ensure that you remove the field from all the qualification used for searching data.

Consider the following tips:

  • The property is ignored for Request ID field, Submitter field (field ID 2), Assigned To field (field ID 4), Password field (field ID 102), Encrypted string (field ID 123), locale related fields on message catalog (field ID 152 and field ID 160), GUID (field ID 179), Assignee Group (field ID 112), and Dynamic Group fields (60000-60999).
  • A character field on the join form inherits this property from its member field. You can not explicitly set this property for a character field on a join form. Any changes made to the property on the member field is inherited by all the dependent fields in the join form(s).
  • If you enable the property for character field on a vendor form, plugins are responsible to handle the encrypted data that are higher than the field length.
  • If you enable the property on a character field in base mode, you cannot disable the property in overlay mode.
  • If you have not enabled the property on a character field in base mode, you can enable the property in overlay mode.
  • If you enable the property for a field for which FTS is already enabled, the server ignores the FTS settings for that field until the property is disabled.
(error)
End ColorData (all)(Web only) When the Enabled property is set to True, enables a smooth visual transition following a system action. For best results, select a color that matches the background color of the element on which the field resides, whether it is a panel or the form. The default color is white. For display as text fields, the default color is the background color of the form.(error)

Entry Mode

  • Data (all)
  • Attachment

Specifies one of these options (available options depend on field type):

  • System—The field is populated by AR System . Certain core fields such as Request ID and Last Modified By are system fields.
  • Required—Field requires a value, default, or user-entered, when a user submits a request. Required fields have a bold label. A form has at least three required fields: Submitter, Short Description, and Status. Make a field required only if it must be filled in for every new request.  You can set the value of required fields, except the core fields to null via work flow and can save it to the database.
  • Optional—Users can enter information in the field or leave it empty. If you have optional fields that must be filled in under certain circumstances, you can create filters and active links that force the user to fill in the field when specified conditions are met.
  • Display—The field is used as a temporary field. No space is allocated for a display-only field in the database, so a display-only field value can never be recorded in the database. For this reason, display-only fields have a value of NULL when a request is retrieved. In all other ways, a display-only field can be used in the same way as any other field (for example, you can reference it in workflow).

You can select this option only when you create a field. After you save a form, the following changes occur:

  • For a required or optional field, the Display option is no longer available.
  • For a display-only field, the Entry Mode property is disabled and cannot be changed. To improve system performance, use display-only fields to store temporary values or to perform calculations. Global fields (field IDs 1000001-2000000) must be display-only.
(tick)
Expand Box
  • Character
  • Currency
  • Date
  • Date/Time
  • Diary
  • Time

Specifies whether an expand button that opens a dialog box appears next to the field. Users can enter data for the field into the dialog box. Values are

  • Default—Hides the expand button for character fields if the field length is less than 70 bytes. Displays the expand button for currency, date, date/time, diary, and time fields regardless of field length.
  • Hide—Always hides the expand button.
    Note: If you need to perform any action on the hidden expand box, you must set the Expand by Workflow property to True.
  • Show—Always displays the expand button.

The dialog box opened by the expand button depends on the type of data that can be entered into the field. The button's icon shows the type of data:

  • Character icon
  • Currency icon
  • Date and Date/Time icon
  • Diary icon
  • Time icon

For character fields,

  • This feature enables you to conserve space on the user's view of the form by making the field's display Data Length value smaller than its database Input Length value.
  • The text dialog box supports text editor commands, such as Select All and Copy, which makes it easier to work with large amounts of data in the dialog box than directly in the character field.

If you set the Display As Text property to True, you might want to hide the expand button.

When a character field has an expand button, the field displays whole words only. To see the text beyond the words displayed in the field, open the text dialog box.

Expand Box is not supported for character fields in Progressive Views. Instead, you must set Expandable to True or use a collapsible panel.

(tick) (Except for Character Field)

Expand by WorkflowCharacter

Use this property when the value for the Expand Box property is set to Hide.

Specifies how user can add an expand button that opens a dialog box appears next to the field by using workflows. Users can enter data for the field into the dialog box. Values are:

  • True
  • (Default) False
(tick)
ExpandableCharacter

Set this to True when you want the application users to be able to expand the text box.

clip showing how to expand the text box

(tick)
Field Access
  • Alert list
  • Button
  • Table - Cell Based
  • Horizontal line
  • List view table
  • Navigation (all)
  • Results list
  • Tree view table
  • Trim text
  • Trim box
  • Vertical line
Specifies how the field is initially displayed:
  • Enabled (default)—Results in an active field.
  • Disabled—Results in an inactive (dimmed out) field.

(tick)

Progressive Views support vertical navigation, buttons, cell-based table, and Trim text fields.

Data (all)

Specifies how users initially access a field in the current view:

  • Read Only—Users can read or access field information, but they cannot edit it.
  • Read/Write (default)—Users can read, access (for example, copy), and edit field information.
  • Disabled—Users can read field information, but they cannot access or edit it.
(tick)
Field IDAll (join forms only)

For fields on join forms, specifies the integer that identifies the field internally throughout AR System server . This field is read-only. See Working with fields in join forms.

(tick)
Field NameAll (joins forms only)For fields on join forms, specifies the field's database name. This field is read-only. See Working with fields in join forms.(tick)
File Name LabelAttachment poolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
File Size LabelAttachment poolSee Managing attachments in Progressive Web Applications by using a remote form.(tick)
Field Value To Define ImagesTable - List View

Specifies whether to show only an image, or only text, or both the image and text in the column of a table.

This property can have the following values:

  • Clear (Default)
  • Show Image
  • Show Text
  • Show Both Image and Text

Learn how to use this property at To add images to a list-based table column.

(tick)

(Available for PWA only.)

FilterTable, Column

Specifies if a filter is enabled at table-level or column-level.

This property can have the following values:

  • False (Default)
  • True
(tick)
Filter Additional OptionsTable ColumnUse this to add a predefined filter value in progressive views.

This property is available when the Column Filter property is set to
True and it is mapped to a Character field, Date/Time filters, and auto-complete menu filters.
This property opens a dialog where you must specify a value for Label to display in the UI and a value which is used in the qualification for this filter.
(tick) (Available only for PWA)
Filter Display OrderColumn

Specifies the display order of the filter.

This property is shown only when you set the value of the Column filter to True.

(tick)
Filter External IDTableSpecifies a field ID for a filter.(tick)
Filter QBE MatchColumn

Specifies how a match is determined when a user performs a filter query-by-example (QBE).

This property is shown only when you set the value of the Column filter to True.

This property can have the following values:

  • Anywhere
  • Equals
  • Leading (Default)

(tick)

Filter Type
  • Table Cell Based
  • Table List View

Specifies the type of filter that is to be applied to a table. This property can have the following values:

  • Advanced (Default)
  • Faceted

See Creating a faceted filter and Creating an advanced filter in Progressive Web Applications.

(tick)

(Available only for PWA.)

Filter VisibilityTable - List View

Specifies whether the filter is visible on the screen.

This property is enabled only when you set the value of the Filter property to True.

This property can have the following values:

  • True (Default)
  • False
(tick) (Available only for PWA.)
Table ColumnSet this property to True to display a filter. 

This property is available in the Filter section. You can add this property if the column Filter property value is set to True.

(tick)

(Available only for PWA.)

Fire workflow again on selected itemNavigation (all)See Creating navigation fields.

(tick)

Progressive view supports only vertical navigation.

Fit to ContentPanel (collapsible)See Avoiding scroll bars in panels.(error)
Fixed Headers
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Adding a table field to a form.(error)
Float Style
  • Panel
  • Panel holder
See Creating floating panels.

(tick)

Progressive views support only panel holder. This field is read-only.

Form NameAll (join forms only)For fields on join forms, specifies the name of the underlying form (primary or secondary) in which the field resides. This field is read-only. See Working with fields in join forms.(tick)
Full Text MFS Category Name
  • Character
  • Diary
  • Attachment
Specifies a category name for a field that is indexed for a full text search of multiple forms. (For more information, see Setting up FTS to search across multiple forms.) At index time, the server checks whether an entry has any fields with a category name (defined in the Full Text MFS Category Name field property). If so, the server also indexes the field as that category name as well.(error)

Field properties G to L

PropertyField typeDescriptionIs this field supported in progressive views?
Generate QualificationTable ColumnGenerates a filter qualification when end users select options.
To set this property, the Filter property must be set to
True and Table Type must set to Advanced.
(tick) (Available only for PWA)
GroupsTable

Creates a group of filters within one section.

Click the property to launch a dialogue where you can define a group. This property is available only when you set the Filter Type to Advanced.

Only the following filters types are allowed to be part of groups:

  • Character
    This can be with or without a menu.
  • Integer
  • Selection
    This filter type is always rendered as checkboxes.
(tick) (Available only for PWA)
Header Background ColorPanel (accordion, collapsible, splitter)Specifies the background color for the header in a panel.(error)
Header StatePanel (collapsible, splitter)Specifies whether the panel header is visible or hidden. The default is Visible.(error)
Hide Empty ColumnColumn

Specifies if the column that contains no data is to be hidden.

To enable this property, you must set the value for the Initial State property to Expandable.

This property can have the following values:

  • False (Default)
  • True

When you set the value for this property to True, a column that contains no data is hidden.

Learn how to set the column properties at Setting column properties.

(tick)
Hide Expand Column if EmptyColumn

Specifies if the expand option for the column is not to be shown when there is no data available in it.

This property can have the following values:

  • False (Default)
  • True

When you set the value for this property to True, the expand option is not displayed if all columns are empty.

Learn how to set the column properties at Setting column properties.

(tick)
Highlight HyperlinksCharacterSpecifies that text be displayed as a hyperlink. (tick)  (Available only for PWA)
HeightAllSpecifies the height of the fields in pixels. In a Progressive Web App (PWA), you can use this property to set the height of a thumbnail image.(tick)
Help TextAllSpecifies the Help text for a field. To enter Help text, select this property, click its ellipsis button, enter text in the Help Text dialog box, and click OK. For information about creating help text, see Creating help for applications.(error)
Horizontal Button AlignmentColumn

Specifies the horizontal alignment of a button in a column.

Double-click the column in a table to view the Horizontal Button Alignment property on the Properties pane in Developer Studio.

This property can have the following values:

  • Left (Default)
  • Center
  • Right

Learn how to set the column properties at Setting column properties.

(tick)
Horizontal SpaceCell-based tableSee Adding a table field to a form.(tick)
IconCharacter, Button, Vertical Navigation, Panels

Specifies a placeholder icon that you can select from a specific set of options.

To know what predefined icons are available in Developer Studio for a Progressive Web App (PWA), see Icons available in Developer Studio to support PWA.

For progressive views, a new property called Icon is added for the Vertical Navigation field. See Navigation fields.

For an anchorable panel, you can use this property to add an icon.

This property is honored only when you set the value for the Anchorable property of a panel to True.

See Modifying panels and panel holders.

(tick)
Icon PositionCharacter, ButtonSpecifies the position of an icon, such as Left or Right.(tick)

ID

All

Identifies the field internally throughout AR System . Every field in a form must have an integer field ID that is unique in that form. If you leave the ID field empty or set it to zero, AR System automatically assigns a number from the unrestricted number set. Restrictions on field ID numbers are as follows:

  • Numbers 1-99 are reserved for core fields. You cannot assign an ID in this range unless you are modifying core fields. See Core fields.
  • Numbers 100-536868911 are reserved. If you use an ID in this range, you receive a warning. Numbers 1000000-1999999 are reserved for regular global fields and 3000000-3999999 are reserved for window-scoped global fields. For information about global fields, see Creating global fields.
  • Numbers 536868912-2147483647 are administrator-defined. There are no restrictions on assigning numbers in this range. If you choose to assign field IDs instead of letting AR System do it automatically, be aware that view IDs are also drawn from the low end of this range.

Columns in table fields and panels in panel holders also have an ID. To assign order in workflow, you can assign the ID yourself or let AR System assign the number for you. The field ID remains constant even if the database name or display label changes. You cannot modify the field ID after it is saved to the database. If you define fields that serve the same purpose in more than one form, assign identical IDs to the identical fields in the different forms. You can then write workflow once for that field (with minor edits to AR System field definition) and reuse the field in multiple forms. Reusing the ID provides a consistent definition for the field across forms.

(tick)
ImageButtonSee Adding images to buttons.(tick)
Image AttachmentCharacterSee Adding rich-text-formatting capabilities to a character field.(error)
Image PositionButtonSee Adding images to buttons.(tick)
Index for FTS
  • Attachment
  • Character
  • Diary
If you are licensed for full text search, specifies whether to index a character, diary, or attachment field for FTS.(tick)
Initial Currency TypeCurrencySee Creating currency fields.(tick)
Initial PanelPanel holder (accordion)Specifies the first panel displayed in an accordion panel holder. To select the initial panel, click the property's Value cell, click the arrow button that appears in the cell, and select a panel from the drop-down list.(tick)
Initial Row Selection
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Adding a table field to a form.(tick)
Initial SizePanel (splitter, collapsible)Specifies the size of the panel when it is initially created in a collapsible or splitter panel holder.(error)
Initial Value
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Setting column properties.(error)
Inline to Left Adjacent FieldButtonEnables you to add a button right next to a field so that the button and the field appear right next to each other in the Progressive Web Application.(tick)  (Available only for PWA)
Label for Empty ValueAll Data fields

For progressive views, this new property is added. As a value for this property, you can specify a string for an empty value in a Data field, for example, "None" or "-". The default value for this field is empty.

See Data fields.

(tick)
Left PaddingFlow Panel Holder

An element's padding is the space between its content and its border. This property sets the left padding (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5

(tick)

Left MarginFlow Panel Holder

An element's margin is the space around the element and outside of any defined borders. This property sets the left margin (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • -1
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
(tick)

Input Length

Character

Specifies the maximum number of bytes or characters, depending on the value of Length Units property, that the field can contain. Leaving this property empty or setting it to 0 specifies an unlimited length. To use database storage most efficiently, set the Input Length of a character field so that it will be created as a varchar database table row. Storage for a varchar is allocated dynamically to the length of the actual field contents, not the input length. See Types of data fields for the maximum values for varchar storage for each database. If you set the Input Length to more than the maximum for varchar, the character field is created as a clob database table column and storage is allocated in blocks that average between 1K to 2K bytes (depending on the database). A full block is allocated for the first byte. When that block is filled with the field contents, another full block is allocated. To control CLOB storage in an Oracle database, see the description of "CLOB Storage" in this section. For more information about database structure in AR System , see the How the AR System database manages data. Do not use more space than you need to store the intended field contents. If you allocate more space for storage than your system needs, more space is searched during queries. If the Expand Box property is set to Default and the field length is 70 or more bytes, AR System automatically inserts an expand button to the right of the field that users can click to open a text dialog box. This can conserve space on the user's view of the form by making the field's Data Length smaller than its Input Length property. The default maximum input length for character fields is different for each of these databases:

  • Microsoft SQL Server: 2 GB
  • Oracle: 4 GB

For scalability reasons, limit the number of long character fields in a form.

To configure a different maximum input length for Oracle and Microsoft SQL Server databases, use the Db-Max-Text-Size option in the AR System configuration files. See Configuration settings C-D.

You cannot use the Indexes form property to create an index for a long or character field with an Input Length over 255 bytes. But if you are licensed for full text search, you can use the Index for FTS field property to create a search index for the field. For more information about FTS, see Enabling and disabling full text search. For some databases, you cannot search fields that are over 255 bytes.

In Progressive View, when users exceed the maximum input length, the character field displays a message and users cannot save the form until they delete the additional text.

(tick)
Label
  • Application list
  • Attachment
  • Composite (all)
  • Data (all)
  • DVF
  • Navigation (all)
  • View

Specifies a label for the field in the current form view. You can enter a label with as many as 80 characters that describes the meaning and purpose of the field. The label can include spaces and double-byte characters. Avoid using spaces at the beginning of field labels; such spaces do not appear in some browsers. If you leave this property empty, the field appears on the screen with no label. For tree view table fields, if this property has text, it becomes the root of the tree. The label need not be unique. However, if duplicate field labels exist in a form, AR System issues a warning message every time you apply changes to the form unless you disable the Developer Studio preferences for duplicate blank and nonblank field label warnings. You can use single quotation marks in field labels; however, when performing searches, users must enter two single quotation marks when specifying the quotation mark in the label. This is required because field labels that contain special characters must be enclosed in single quotation marks in searches, and a single quotation mark in the label is otherwise interpreted as the end of the field label.

(tick)

Progressive views do not support Application list and horizontal navigation.

Label AlignData (all)Aligns labels to the top, center, or bottom of the region available for the label. The default is Top for labels located to the left of the field. The default is Bottom for labels located above the field. See Arranging fields in a form view. For text fields with one row, when this property is set to Top, labels appear in the center in a browser. See the "Rows" description in this section.(error)
Label Font
  • Button
  • Data (all)
  • Panel (all)

Specifies a font type for the field label. In a default regular form, each label style identifies a different field behavior:

  • Italic—Field is maintained and automatically updated by AR System .
  • Bold—Field requires a value.
  • Plain—Field value is optional.

As the administrator, you can override the properties of the default font types, but do so cautiously to avoid confusing users. In addition, users can use preferences to change the fonts assigned to font types. All fields with the same type remain consistent. To change a label font:

  1. Select the field.
  2. In the Properties tab, select a new font type in the Label Font drop-down list.
  3. In the Data Font drop-down list, select a font type for data entered into the field if applicable.

For Progressive Views, the following additional values are added in Developer Studio for this property:

  • Header Text (IV)
  • Header Text (V)
  • Header Text (VI)
  • Success
  • Info
  • Warning
  • Error

Important

Header Text (IV), Header Text (V), and Header Text (VI) are available only for character fields.

For the description of the font types, see Data Font.

This property is also added to the Change Field active link action in Developer Studio for the Button Field. See Defining Change Field active link actions .

(tick)

Label Justify
  • Button (URL style)
  • Data (all)
  • Trim text
Specifies where label text is positioned relative to the left and right edges of the text box: Left, Center, or Right.

(tick)

Progressive views do not support Data field.

Label LocationData (all)Specifies where a data field's label appears in relation to the field: Top (above the field) or Left (default).(error)
Label/Text Color
  • Button
  • Data (all)
  • Panel (all)
  • Trim text

Specifies the color of the field's label or text. For a data field, the label appears to the left of a field or above it. For a panel field, the label appears in the panel header. Colors are set one field at a time. To change label or text color:

  1. Select the appropriate field.
  2. In the Properties tab, select Custom in the Label/Text Color drop-down list.
  3. Select a color from the color palette, and click OK.

This property is added to the Change Field active link action in Developer Studio . See Defining Change Field active link actions .

(tick)
Last Changed ByAllSpecifies the user name of the last person who modified the field. This read-only field is automatically set.(tick)
Last Changed TimeAllSpecifies the date and time that the field was last modified. This read-only field is automatically set.(tick)
Layout Style
  • Cell-based table
  • Panel (all)
  • XY—Specifies that field locations in the cell or panel are set by X and Y coordinates and sized by width and height.
  • Fill— Specifies that fields are dynamically resized within the cell or panel.
    The Fill LAyout option is not supported for cell-based table fields.

  • Flow—Specifies that RTF fields are dynamically resized within the panel.
    See Panel layout styles and Adding rich-text-formatting capabilities to a character field.

(tick)

Progressive views support Cell-based table.

This is a read-only field.

Length UnitsCharacter

In Regular forms, specifies whether the Input Length of a character field is calculated in Bytes or Characters. The default is Bytes, which is the Input Length unit for all character fields in AR System server release 7.1.00 and earlier. Because character sets use varying numbers of bytes to represent a single character, setting the Length Units property to Characters allows better control of character field sizes in the database. When creating or resizing a database column corresponding to a field with a Length Units value of Characters, AR System server applies a multiplier to calculate the column size for the field. The multiplier is determined by the server character set and the database code unit. The server uses the following multiplier values:

  • 1—WESTERN character set.
  • 2—UTF-8 with Microsoft SQL Server, GB2312, Big-5, EUC-CN, Shift-JIS, KSC-5601, and EUC-KR character sets.
  • 3—EUC-JP character set.
  • 4—UTF-8 (except Microsoft SQL Server), EUC-TW.

For example, when you create a character field with a Length Units value of Characters and an Input Length of 100 on a UTF-8 platform, the corresponding column is 200 nvarchar in a Microsoft SQL Server database (multiplier value of 2), or 400 char in other databases (multiplier value of 4).

For the core fields Request ID, Submitter, Assigned To, and Last Modified By, you can only set Length Units to Bytes. The Short Description field can use either Bytes or Characters. For Bytes, it is limited to an Input Length of 255; for Characters it is limited to Input Length 63.

Developer Studio does not display the Length Units property if the AR System server is release 7.1.00 or earlier. To configure the default value of this property, in Developer Studio , select Window > Preferences > Form, and set the Input Length Units value. In Display Only and Vendor forms, this property works with the Data Length field to restrict the length of the information to display. In Join forms and View forms, this property reflects the setting for the mapped field in the underlying form or database table.

(tick)
Line Color
  • Horizontal line
  • Panel
  • Trim box
  • Vertical line

Specifies the color of the line:

  1. Select the appropriate field.
  2. In the Properties tab, set Depth Effect to None.
  3. Select Custom in the Line Color drop-down list.
  4. Select a color from the color palette, and click OK.
(tick)

Literal FTS Index

CharacterSpecifies whether the FTS engine should use the literal method to search the contents of all requests indexed for the field. For more information about FTS, see Enabling and disabling full text search. This property is enabled when the Index For FTS property is set to True.(tick)
Localization RequiredAll

Specifies whether a field label must be translated. By default, this property is set to False. When this property is set to True, attribute 287 in the field definition is set to 1. To ascertain which fields must be translated, localizers can search .def files for the display-instance setting 287\6\1, where

  • 287 is the ID of the localization indicator attribute.
  • 6 is the data type for the attribute and can be ignored.
  • 1 is the attribute value that indicates localization is required.
(tick)
Localize Data
  • Data (all)
  • Attachment
Specifies whether configuration data can be localized for the form. The options are True and False (the default).(tick)
Localize LabelAllSpecifies whether the field label can be localized for the form. The options are True (the default) and False.(tick)

Field properties M to P

PropertyField typeDescriptionIs this field supported in progressive views?
Mapping IdentifierTable fields

To support the Progress Bar widget, this property is added in Developer Studio .

See Configuring the Progress bar widget in Progressive Web Applications.

(tick)
Maintain Aspect RatioButtonSee Adding images to buttons.(tick)
Margin Bottom
  • Cell-based table
  • Panel holder (accordion, collapsible, splitter)
For cell-based tables, specifies the space between the bottom of the cell-based table field and the last row of cells. Specify in points. For panel holders, specifies the amount of space between the bottom border of the panel holder and the bottom edge of the panels in it. If the bottom margin size is too large to allow all of the panels to be displayed, a vertical scroll bar appears.(tick)
Margin Left
  • Cell-based table
  • Panel holder (accordion, collapsible, splitter)
For cell-based tables, specifies the space between the left side of the cell-based table field and the first column of cells. Specify in points. For panel holders, specifies the amount of space between the left border of the panel holder and the left edge of the panels in it.(tick)
Margin Right
  • Cell-based table
  • Panel holder (accordion, collapsible, splitter)
For cell-based tables, specifies the space between the right side of the cell-based table field and the last column of cells. Specify in points. For panel holders, specifies the amount of space between the right border of the panel holder and the right edge of the panels in it.(tick)
Margin Top
  • Cell-based table
  • Panel (accordion, collapsible, splitter)
For cell-based tables, specifies the space between the top of the cell-based table field and the first row of cells. Specify in points. For panel holders, specifies the amount of space between the top border of the panel holder and the top edge of the panels in it. If the top margin size is too large to allow all of the panels to be displayed, a vertical scroll bar appears.(tick)
Max Rows
  • Alert list
  • List view table
  • Cell-based table
  • Results list
  • Tree view table
See Adding a table field to a form.(tick)
Max SizeAttachmentSee Managing attachments in interfaces by creating attachment pools.(error)
MaximumIntegerSpecifies the highest integer value that users can enter in the field during data submission and modification. By default, integer fields accept integer values between -2147483647 and 2147483647.(tick)
  • Currency
  • Decimal
  • Real
Specifies the highest value that the field can have during data submission and modification. This setting is required.

(tick)

Maximum HeightCharacterSee Adding rich-text-formatting capabilities to a character field.(error)


Maximum Height

View field or DVFSpecifies the maximum height of the view field or DVF in pixels.
If you enable Auto Resize along with Maximum Height, the view field increases in size to accommodate the content until the field reaches the height specified for this property.
(tick) (Available only for PWA)
Maximum SizePanel (splitter)Specifies the maximum size allowed for a panel in a splitter panel holder.(error)
Menu ContainerPanelSpecifies that the panel is a container of panels. It can contain sub-panels, list of sub-container panels, section panels, and hidden panels. (tick) (Available only for PWA)
Menu FixedPanelThis property is not supported. 
Menu HiddenPanelSpecifies that the panel hides all the fields it contains when displayed on PWA screens.(tick) (Available only for PWA)
Menu MobilePanelThis property is not supported.

Menu Name

  • Character
  • Table - List View

Attaches a character menu to a character field and inserts a menu button to the right of the field. Character menus provide users with a fill-in aid that can help standardize the text contents and thereby improve the accuracy of searches. Unless you specify a pattern match (see the description of "Pattern" in this section) or change the display type to Drop-Down List (see the description of "Display type" in this section), users can enter their own text even when a character menu is attached to the field. To attach a menu, select it in the property's drop-down list. The $NULL$ option allocates space for the menu button, but hides the button in the user's client. When you use the Change Field action to associate a menu, the menu button appears without disrupting form layout. See Using buttons and menu bar items to execute active links. For information about designing and creating a character menu, see Creating character menus.

For the Table - List View field, specifies the name of the menu when the following conditions are true:

  • For a column in a table, the value for the Filter property is set to True.
  • The column is mapped to a character field.
(tick)
Table Column

Specifies a search menu for the filter. You have to set the type Search for the menu. You can use this only when the Filter property value is set to True and is mapped to a character field.

This property takes precedence over the Menu Name property under Attributes of the character field.

(tick) (Available only for PWA)
Menu HotkeysCharacter

Use this property to define hotkey definitions.

See Configuring the @mention component.

(tick)

Menu Section

Panel

Specifies that the panel is a container that holds other fields or objects.

A panel with the Display > Type property set to Menu Section retains the relative positions of the fields that it encloses when displayed on the PWA screen. The following example illustration shows two fields within the menu section positioned one above another in Developer Studio are displayed one above another on PWA screens as well. 

Menu Section is similar to the Section Panel property, except that Section Panel does not retain the relative positions of the fields on PWA screens. For more information, see  Section Panel.

(tick) (Available only for PWA)
Menu StyleCharacter

Specifies how menu text is added to the field when users select an item from a character menu:

  • Append—Text is added to any text already in the field. If text is in the field, a blank space is inserted before the menu text value is appended.
  • Overwrite—Text replaces any text already in the field.
(tick)
Menu WidthCharacter

Applicable for the all the character fields that have a menu associated with them. The value for this property can be a number starting from 0 and the type of this property is Integer. Menu width is the width of the drop-down menu. The menu width is always relative to the width of the character field.

To set the menu width:

  1. In the Menu Name property, specify a menu name by clicking the ellipsis button, and then selecting a menu.
  2. In the Menu Width property, enter an integer value, for example, 100.
(tick)
MinimumIntegerSpecifies the lowest integer value that users can enter in the field during data submission and modification. By default, integer fields accept integer values between -2147483647 and 2147483647.(tick)

  • Currency
  • Decimal
  • Real
Specifies the lowest value that the field can have during data submission and modification. This setting is required.

(tick)

Minimum Height

View fields and DVF

Specifies a minimum height to the view field or DVF.

If the content within the view takes up less space than the value for Min Height, the view displays a blank space.

(tick) (Available only for PWA)
Minimum SizePanel (splitter)Specifies the minimum size allowed for a panel in a splitter panel holder.(error)
ModeApplication list

Specifies whether the entry points in an application list field are presented as a traditional list, or with the appearance of a vertical navigation bar:

  • Traditional—The application list appears in the traditional AR System Home Page format, with entry points displayed as links.
  • Flyout—The application list looks like a vertical navigation bar, and entry points are displayed as flyout options. See Navigation fields.
(error)
Module TypeDVFSpecifies the module type for the data visualization field: flashboard, report, or visualizer. See Data visualization fields and Using buttons and menu bar items to execute active links.(tick)
Mouseover EffectButton

Displayed only when you set the value of the Display as Flat Image property to True.

Specifies what shape does a mouse pointer take and whether the button is displayed when you hover the mouse pointer over a button.

This property can have the following values:

  • None—The mouse pointer takes the shape of an arrow. The button is not displayed.
  • Button—The mouse pointer takes the shape of a hand. The button is displayed.
  • Pointer Cursor (Default)—The mouse pointer takes the shape of a hand. The button is not displayed.

See Adding images to buttons.

(tick)

Name

All

Identifies the field in the database. Every field in a form must have an alphanumeric field name that is unique in that form. Names can have up to 80 characters, including spaces. They can include double-byte characters, but avoid using numbers at the beginning of a name. If you leave this property empty, Developer Studio generates a name based on the field type and appends a number to the name to make it unique. For example, if the form has a field named Column1, Developer Studio names the next field of the same type Column2. Do not use the keyword FUNCTION as a field name; if you do, the system generates an error, and the underlying database view is not created.

If you create a field with a dollar sign ($) or an apostrophe (') in the database name, you must double the dollar sign or the apostrophe when using the field in workflow in addition to adding the surrounding characters. For example, a field named MyMoney$ must be entered in workflow as $MyMoney$$$, and a field named John's Money must be 'John''s Money'.

The field name is easier to use than the field ID when you create workflow such as active links and filters. Unlike the field label, the field name is not specific to a view of the form. Do not confuse the field Name with the field Label, especially when creating workflow. To avoid naming conflicts with the database server, do not use a word reserved by the database server software as a field name. See your database documentation for a list of reserved words.

(tick)
Navigation Initial StateNavigation (all)See Creating navigation fields.(tick)
Navigation ModeVertical navigation

Indicates the options for displaying vertical navigation menu items.

  • Expandable—Submenu items are displayed in a vertical list expanded below the parent menu item.
  • Flyout—Submenu items are displayed in a vertical list expanded to the right of the parent menu item.
(tick)
New DescriptionAllRecords information about a field change. To create a change description, select the New Description property, click its ellipsis button, and enter a description into the New Description dialog box. When you next save the field, your entry is moved to the Change History property, where it is stored in read-only diary format.(tick)
Next Label
  • Cell-based table
  • List view table
  • Results list
See the description of  "Next Label" and "Size of Chunk" in this section.(error)
Number of Entries Returned
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Customizing table labels.(tick)
OpacityPanel (all)Specifies the degree of transparency of the panel's background color. If the panel does not have a background color, this property is unavailable. See Creating panels.(error)
Order Column IDCell-based table, List View Table

Stores the order column ID. This is a text field.

See Defining tables to display data.

(tick)
Orientation
  • Horizontal line
  • Vertical line
  • Panel holder (accordion, collapsible, splitter, and Flow Panel holder)
Specifies the orientation of a line: Vertical or Horizontal. For panel holders, specifies the orientation of the panel headers: Vertical or Horizontal.

(tick)

Progressive views supports only Panel holder

OwnerAllIdentifies the author of each entry in the Change History property.(tick)
Panel Border ColorCell-based Table

Specifies the color of the panel border of a table. The default value for this property is RGB {0,0,0}.

See Setting table colors.

(tick)
Panel Border ThicknessCell-based Table

Specifies the thickness of the panel border of a table. The default value for this property is 1.

See Setting table colors.

(tick)
Panel Bottom MarginPanelSee Adding rich-text-formatting capabilities to a character field.(tick)
Panel Left MarginPanelSee Adding rich-text-formatting capabilities to a character field.(tick)
Panel Right MarginPanelSee Adding rich-text-formatting capabilities to a character field(tick)
Panel StatePanel (collapsible)Specifies whether a panel in a collapsible panel holder is expanded or collapsed. The default is Expand.(error)
Panel Top MarginPanelSee Adding rich-text-formatting capabilities to a character field.(tick)
PanelsPanel holder (all)See Creating panel holders.(tick)
Parent Entity IDSurvey ComponentSpecifies the field ID of the form that holds the record ID.(tick)
Parent fieldPanel holder (all)Parent field property is automatically set for a field when you place a field on panel.(tick)
PatternCharacter

Restricts what users can enter into the field. You can specify two types of character patterns:

  • Specify a character pattern that the value must match. It is similar to that used in the LIKE operator and can include any of the same wildcard characters (see Operators).
  • Use a keyword to specify a style for a character field. You can specify only one of the following keywords for a pattern, and it cannot be combined with a pattern of characters and wildcards:
    • $ALNUM$—The value must be alphabetic characters and digits (and blank space).
    • $ALPHA$—The value must be alphabetic characters (and blank space).
    • $DIGIT$—The value must be digits.
    • $LOWER$—The value can be any character except uppercase letters. This includes special characters, digits, and blank spaces.
    • $MENU$—The value must match an item defined in the default menu attached to the field. Do not use $MENU$ together with a Change Field workflow action that attaches a new menu (with new values) to the field. You cannot use the $MENU$ keyword with a file menu or a data dictionary menu. You cannot use the $MENU$ keyword with a search menu if the search menu qualification includes a field value from the current screen or with an SQL menu if the WHERE clause of the query includes a field value from the current screen.
    • $PRINT$—The value must be printable characters.
    • $UPPER$—The value can be any character except lowercase letters. This includes special characters, digits, and blank spaces.
      The way that keywords are interpreted is language-dependent. For example, $LOWER$ is not valid in Japanese, and $MENU$ is not valid in a multilingual environment.

(tick)
Pause IntervalCharacter

Specifies the time interval in milliseconds. This property accepts only an integer value.

In Progressive Web Application (PWA), when a user types in a character field, the relevant helpful resources need to be shown to the user based on what is being typed. If the resources are shown for every letter that the user types, it becomes very cumbersome. To avoid this problem, you can specify a pause interval for a workflow by using this property in Developer Studio.

When you specify a pause interval for a workflow, after the user presses any key on the keyboard except the Enter key, the PWA pauses for the specified milliseconds before triggering a predefined workflow. However, when the user presses the Enter key, the PWA immediately triggers the workflow without pausing.

To learn more about this property, see Adding a pause interval in a character field for a workflow in PWA.

(tick)

(Available only for PWA)

PermissionsAllSpecifies which users have access to the field. To assign field permissions, select the Permissions property, click its ellipsis button, and use the Permissions dialog box. For more detail, see Field permissions.(tick)
PrecisionDecimal

Specifies the number of decimal places displayed in the user's view. The default setting is 2 and the maximum value of precision in AR System is 9.

(tick)
RealSpecifies the number of decimal places displayed in the user's view. The displayed number is rounded off, but the value stored in the database is not changed.(tick)
Preferences
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Customizing table labels.(tick)
Previous Label
  • Cell-based table
  • List view table
  • Results list
See the description of "Size of Chunk" in this section.(error)
Progressbar FieldTable Column

This new property is added for the Column field in a table, which holds the information about mapping with a field on the client-side.

See Configuring the Progress bar widget in Progressive Web Applications.

(tick)
Progressive Width
  • Flow Panel Holder
  • All Panels

Specifies the width of an element in the twelve-column layout when you position elements horizontally on the screen. You can find this property under the Progressive-Desktop, Progressive-Mobile, and Progressive-Tablet property groups.

The following can be the values for this property:

  • 1/12
  • 2/12
  • 3/12
  • 4/12
  • 5/12
  • 6/12
  • 7/12
  • 8/12
  • 9/12
  • 10/12
  • 11/12
  • 12/12
  • Auto—Occupies the remaining width out of 12 columns in a panel structure. However, the width percentage, once rendered, doesn't change even if you hide the adjoining panels.
  • Fill Occupies the remaining width out of 12 columns in a panel structure. Also fills the remaining space horizontally when you hide the adjoining panels.

For more information, see Developing a Progressive Web Application.

(tick)

Field properties Q to Z

PropertyField typeDescriptionIs this field supported in progressive views?
Qualification Field IDSurvey ComponentHolds the field ID from the current form. The current form contains the qualification. Based on this qualification, data is obtained from the Component Definition.(tick)
QBE MatchCharacter

Specifies how a match is determined when a user performs a query-by-example (QBE) in the Mid Tier :

  • Anywhere (default)—Finds a match if the entered value occurs anywhere in the corresponding field. For example, if a user enters Bob in the Submitter field, the search returns all requests submitted by Bobby Jones, Bob Smith, and Jill Bobbington.
  • Leading—Finds a match only if the entered value occurs at the beginning of the corresponding field. For example, if a user enters Bob in the Submitter field, the search returns all requests submitted by Bob Smith and Bobby Jones but not those submitted by Jill Bobbington.
  • Equal—Finds a match only if the entered value matches the value in the corresponding field exactly. For example, to find requests submitted by Bob Smith, the user must enter Bob Smith, with exact spelling and capitalization, in the Submitter field. However, for some databases (such as Microsoft SQL Server), case-sensitivity depends on the underlying DBMS settings, regardless of the specified QBE Match.

Equal and Leading generally provide better performance than Anywhere. Use them wherever they are appropriate. You can use the Preferences dialog box (Window > Preferences) to set a default QBE match type for all new character fields that are not core fields. 

A search on a character field with the QBE match type Anywhere performs a full table scan of the database, reading every record in a form and ignoring any indexes for the field. Searches on fields with the QBE match type Leading or Equal are typically faster than searches on fields with the match type Anywhere, especially if the field is indexed. See Defining indexes. Some relational operators and wildcards work during a QBE regardless of the QBE Match setting. This means that users can specify an exact match in a field with the QBE Match setting Anywhere by using the equal sign (=) relational operator. Users can also use the percent sign (%) wildcard at the beginning of the search string ( %abcd ) to override the QBE Match setting Leading or Equal. Using the % wildcard anywhere else in a string (abcd% ) does not override the Equal setting. Overriding the Leading or Equal settings overrides the performance benefits of using those settings.

The behaviors described above refer to searching a database. However, the fields configured for Full Text Search (FTS) exhibit full text search behavior. 

(tick)
Question FontSurvey Component

Specifies the font of the question. This property is displayed only when you set the value for the Display As Text property to True.

This property can have the following values:

  • Detail Text
  • Edit Field
  • Header Text (I)
  • Header Text (II)
  • Header Text (III)
  • Note Text
  • Optional Field
  • Push Button
  • Radio Button
  • Required Field
  • System Field
(tick)
Read ButtonAlert listSee Customizing table labels.(tick)
Refresh Button
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Customizing table labels.(tick)
Refresh on Entry Change
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Adding a table field to a form.(tick)
Refresh Row Selection
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Adding a table field to a form.(tick)
Remote/Local FieldsCell-based tableOpens a dialog box used to add columns to tables. See Adding a table field to a form.(tick)
Render Data As ThumbnailTable - List View

Specifies if the image in a column of a table is displayed as a thumbnail.

This property can have the following values:

  • False (Default)
  • True

Learn how to set column properties in a table at Setting column properties.

(tick)

(Available only for PWA.)

Report Button
  • Cell-based table
  • List view table
  • Results list
See Customizing table labels.(error)
Results Color
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table

In a list-view table, use this property to set a font color and a background color for the table.

Learn how to set font color and background color at Setting the font color and background color for a list view table.

(tick)
Right PaddingFlow Panel Holder

An element's padding is the space between its content and its border. This property sets the right padding (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
(tick)
Right MarginFlow Panel Holder

An element's margin is the space around the element and outside of any defined borders. This property sets the right margin (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • -1
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
(tick)
Rounded Corners
  • Panel (all)
  • Flow Panel
  • Tab Panel

Specifies the radius of roundness for the corners of a panel. The default is blank (no rounded corners).

Rounded corners are shown in Developer Studio .

(tick)
Row Header
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Customizing table labels.(error)
Row Selection
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Adding a table field to a form.(tick)
Rows
  • Character
  • Diary
Specifies the number of rows of text that are displayed.

(tick)

Progressive views support only the character field.

  • Check box
  • Drop-down list
  • Radio button
For radio buttons, specifies the number of rows used for selection options. A setting of 1 produces one horizontal row. A setting of 2 divides the options into two horizontal rows, and so on. For other types of selection fields, this property cannot be changed.(tick)
Table Column

For a character field in a column of a nested table, this property specifies the number of rows of text that are displayed. The default value for this property is 5. You can set any value that is greater than or equal to 5. However, if you set any value that is lesser than 5, Developer Studio sets the value that you had set earlier (either 5 or greater than 5). 

For a nested table, set the value for the Initial State property to Expanded, and then specify a value for this property.

In a progressive view, the specified number of rows are displayed along with a Show more button. When you click Show more, full text is displayed along with a Show less button.

(tick)
Save LabelAttachment poolSee Managing attachments in interfaces by creating attachment pools.(tick)
Scale Image to FitButtonSee Adding images to buttons.(tick)
Scroll Bar
  • Application list
  • DVF
  • View

Specifies how scroll bars are displayed:

  • Default—Displays scroll bars only when the field content does not fit completely within the field.
  • Show—Always displays scroll bars.
  • Hide—Always hides scroll bars.

If the content of a field (such as a AR System form) has its own scroll bars, they appear even if you hide scroll bars for the field itself. If you can hide the scroll bars of the content, you can remove all scroll bars from the field.

(tick)

Section Panel

Panel

Specifies that the panel is a container that holds other fields or objects.

A panel with the Display > Type property set to Section Panel does not retain the relative positions of the fields it encloses when displayed on PWA screens. The following illustration shows an example of two fields arranged one above another in Developer Studio . However, on a PWA screen, they are displayed side-by-side.

To see how to retain the relative positions of the fields on PWA screens, see Menu Section.

(tick)  (Available only for PWA)
Select All
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See Customizing table labels.(error)
Select Column Label
  • Alert list
  • Cell-based table
  • List view table
  • Results list

See Customizing table labels.


(tick)
Select item on clickNavigation (all)See Creating navigation fields.(tick)
Selections
  • Check box
  • Drop-down list
  • Radio button
See Creating selection fields.(tick)
ServerDVF

Specifies the AR System server that contains the data visualization module. See Using buttons and menu bar items to execute active links.

(tick)
Show Apply Button
  • Table - List View
  • Table - Cell Based

Specifies if the Apply filters button is to be shown on the filter. In addition, it also displays the Cancel and Remove all, buttons.
This property is available in the Filter section only when you set the Filter Type to Advanced.

This property can have the following values:

  • False (Default)
  • True
(tick) (Available only for PWA)
Show as URLColumn

Specifies if the text in a column of a table is shown as a URL. When you click the URL, an active link is executed.

In a nested table, this property is honored in progressive views for a column of type character.

This property can have the following values:

  • False (Default)
  • True

When you set the value for this property to True, the text is shown as a hyperlink in the character column.

Learn how to set the column properties at Setting column properties.

(tick)
Show URLCharacter

Specifies whether a URL is made active when a user types a URL address (such as http://www.bmc.com) into a character field.  The default is False, which means the URL does not become active within the field.

If the field is not empty and Show URL is set to True, users cannot directly type into the field. They must open the expand box to edit the contents of the field.

(tick)
SizeButton

Specifies the size of an icon. This property can have the following values:

  • Extra-Small
  • Small
  • Extra-Large
  • Large
  • Block - Occupies the full width of its parent panel.

See Button fields and Creating button fields.

(tick)

Slack Distribution OrderPanelSee Avoiding scroll bars in panels.(tick)
Show BorderCell-based Table, List View Table

For progressive views, this property specifies if the border in a table field is shown.

The following can be the values for this property:

  • True (Default)
  • False

See Defining tables to display data .


Show BadgeTabbed Panel Holder

Specifies if a child component is visible.

This property can have the following values:

  • False (Default)
  • True

See Panel holder display types.

(tick)
Show as tab on mobileTabbed Panel Holder

Specifies if a child component is visible. It distinguishes if a panel is for mobile devices or for other devices.

This property can have the following values:

  • False (Default)
  • True

See Panel holder display types.

(tick)
SortCell-based tableSee Setting sort order and visible levels.(tick)
Sort/Levels
  • Alert list
  • List view table
  • Results list
  • Tree view table
See Setting sort order and visible levels.(tick)
Splitter StatePanel holder (splitter)

Specifies whether the splitter bars between panels in a splitter panel holder are visible and can be dragged to resize the panels. The default is Visible.

  • Visible—The splitter bar is visible and can be dragged.
  • Disabled—The splitter bar is not visible and cannot be dragged.
  • Invisible—The splitter bar is not visible but can be dragged.
(tick)
Start ColorData (all)

(Web only) When the Enabled property is set to True, enables selection of a color for the highlight based on the theme of the form, background color, and other factors. If no highlight start color is specified, the Mid Tier uses the default color of yellow.

(error)
Sub Level Background ColorVertical Navigation barThe sub level alternate background color. This setting is applicable only to Vertical Navigation Bar in the Flyout mode.(tick)
Tab Order
  • Application list
  • Button
  • Composite (all)
  • Data (all)
  • DVF
  • Navigation (all)
  • Trim text
  • View
Specifies the order in which the field is selected when users press the TAB key. See Setting the tab order of fields in a form view.

(tick)

Progressive views do not support Application list field.

Tab TypeTabbed Panel Holder

Specifies the tab type. This property is of type Enumeration.

It can have the following values:

  • Tabs (Integer value = 1)
  • Pills (Integer value = 2)
  • Inverted (Integer value = 3)
  • Bordered (Integer value = 4)
  • Stacked (Integer value = 5)

See Panel holder display types.

(tick)
TableAll (view and vendor forms only)Specifies the name of the database table associated with the field. This field is read-only. For more information, see Types of forms and Using buttons and menu bar items to execute active links.(tick)
Table Drill Down
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Adding a table field to a form.(error)
Table Header Footer Gradient Background Color
  • Tables (all)
  • Attachments
For tables, this property specifies the color for the header and footer. For attachments, this property specifies the color for the footer. (Attachments do not support header).(error)
Table Not Loaded String
  • Cell-based table
  • List view table
See Customizing table labels.(tick)
Tabless BorderlessPanel holder (tabbed)See Creating panel holders.(tick)
TextTrim textSee Creating trim fields.(tick)
ViewSee View fields.(tick)
Text AlignTrim textSee Creating trim fields.(tick)
Text RotationTrim textSee Creating trim fields.(error)
Text StyleTrim text

For progressive views, the following new values are added to the Text Style property for the Trim Text field:

  • Success
  • Info
  • Warning
  • Error

See Trim fields and Creating trim fields.

(tick)
Tree/Table Property
  • Alert list
  • List view table
  • Results list
  • Tree view table
Opens a dialog box used to add columns to tables. See Adding a table field to a form.(tick)
Thickness
  • Horizontal line
  • Panel
  • Trim box
  • Vertical line
Specifies a line width of 1 to 9 pixels. The default is 2. Thickness cannot be changed if the Depth Effect is Etched.(tick)
Thumbnail ExtensionCharacter

For the new display type Thumbnail, this property can have a comma separated list of file extensions, such as PNG and JPEG as its value.

(error)

This property is available for use in Developer Studio version later than 20.08.

Thumbnail HeightTable - List View

Specifies the height in pixels for a thumbnail. Enter an integer as a value for this property. This property is visible only when the Render Data As Thumbnail property is set to True.

Learn how to set column properties in a table at Setting column properties.

(tick) (Available only for PWA)
Thumbnail WidthTable - List View

Specifies the width in pixels for a thumbnail. Enter an integer as a value for this property. This property is visible only when the Render Data As Thumbnail property is set to True.

Learn how to set column properties in a table at Setting column properties.

(tick) (Available only for PWA)
Tooltip Icon

Integer
Character
Select
Date
Time
Date/Time
Check Box
Real
Decimal
Radio Button

Select an icon for the tooltip.

You can add icon IDs from the list at Icons available in Developer Studio to support PWA.
For information about adding icons, see Adding icons in Developer Studio.
(tick) (Available only for PWA)
Tooltip Trigger

Select a user action that displays the tooltip:

  • Click (Default)
  • Hover
(tick) (Available only for PWA)
Tooltip Text/Template

Enter the text that is displayed in the tooltip.

To add the tooltip text through a template, enter template:templateName.
Where templateName is the value you enter in the Name field of the Resource Definition form. For information about using resource definitions, see Resources for templates.

(tick) (Available only for PWA)
Top PaddingFlow Panel Holder

An element's padding is the space between its content and its border. This property sets the top padding (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5

(tick)

Top MarginFlow Panel Holder

An element's margin is the space around the element and outside of any defined borders. This property sets the top margin (space) of an element. You can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups.

The values for this property can be:

  • None (Default)
  • -1
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
(tick)
Toolbar VisibilityCell-based Table, List View Table

For progressive views, this property specifies if the toolbar in a table field is visible.

The following can be the values for this property:

  • True (Default)
  • False

See Defining tables to display data.

(tick)
UnreadAlert listSee Customizing table labels.(error)
URL Color ButtonSee Creating button fields.(error)
Trim textSee Adding a URL to a trim text field.(tick)
Use Locale
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Setting table refresh intervals.(error)
Use Value as QualificationColumn

Specifies whether to use the qualification in the value of a Menu field as is when you apply a filter.

This property is shown only when:

  • The value of a filter is True
  • The Column field is Character with menu

This property can have the following values:

  • False
  • True
(tick)
VendorAll (vendor form only)For fields on vendor forms, specifies the vendor name. For more information, see Types of forms and Using buttons and menu bar items to execute active links .(tick)
Vertical Button AlignmentColumn

Specifies the vertical alignment of a button in a column.

Double-click the column in a table to view the Vertical Button Alignment property on the Properties pane in Developer Studio.

This property can have the following values:

  • Top
  • Center (Default)
  • Bottom

Learn how to set the column properties at Setting column properties.

(tick)
Vertical SpaceCell-based tableSee "Vertical Space" in Adding a table field to a form.(tick)
Vertical SpacingPanelSee Adding rich-text-formatting capabilities to a character field.(error)
ViewsAll except table columns

Specifies the form views in which a field appears. See Including and excluding fields from form views. New fields are automatically added to the current view. Depending on how your preferences are set, new fields might also be added to all other views of the form. (In Developer Studio , select Window > Preferences. Under " Developer Studio ," click Form.) Some field properties affect all form views while other field properties do not. All display property settings apply to only the form view in which they are set. For example, in one view a field might be visible while in another view the field might be hidden or located elsewhere in the form. See Creating and managing packing lists and Creating and managing fields.

(tick)
VisibleAll

Specifies whether the field is visible in the current view. When this property is set to False, the field cannot be seen in the view, although users with Customize permissions can make a hidden field visible. A hidden field remains in the database and can be accessed by workflow. You can create active links to dynamically hide and unhide all fields except tree view table column fields.

For progressive views, you can find this property under the Progressive-Desktop, Progressive-Mobile, Progressive-Tablet property groups. The default value of this property is True.

(tick)
Visible ColumnsCell-based tableSee "Visible Columns" in Adding a table field to a form.(tick)
WidthAllDefines the width of the fields in pixels. In a Progressive Web App (PWA), you can use this property to set the width of a thumbnail image.(tick)
Wrap Text
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Setting column properties.

(tick)

Progressive views do not support Alert list field.

XAll

If the Alignment property is set to Left (default), specifies the horizontal position of the left edge of the field relative to the left side of the form. If the Alignment property is set to Right, specifies the horizontal position of the right edge of the field relative to the right side of the form. The X and Y settings are relative to the top left or right corner of the form. For example, X=0, Y=0, and Alignment=Left is the top left corner of the form.

If a field is anchored to the right side of a panel in a panel holder, the field's X value might change if either of the following actions occur:

  • (Tabbed only) The Display Type of the panel holder is changed.
  • (Accordion, collapsible, or splitter) The Orientation of the panel holder is changed.
(tick)
 YAll Defines the vertical position of the left or right edge of the field in the form. The X and Y settings are relative to the top left or right corner of the form. For example, X=0, Y=0, and Alignment=Left is the top left corner of the form. If you have a series of data fields on the same line, these fields must have the same Y coordinate for tabbing between fields to work from left-to-right, top-to-bottom unless you define a tab order of fields in the form. See Setting the tab order of fields in a form view.(tick)
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Matthew Stromberg

    I have a question regarding the 'Expandable' field property. It states "Set this to True when you want the character field to expand to show additional text." It sounds by its description that if I set this property to "True", it will automatically-expand a Character field to display all of the text in the field when the Progressive View is displayed (But it does not.). Can you provide some clarification on how this property behaves in regards to Progressive Views?

    Oct 10, 2023 09:17
    1. Chaitanya Vikas Ghanta

      Thanks for this feedback, Matthew.

      Will check on this and get back to you!

      Oct 11, 2023 11:12
      1. Chaitanya Vikas Ghanta

        Hello Matthew, I have reworded the explanation for this property for more clarity. This property enables users of the application to resize the text field. Hope this helps?

        Oct 25, 2023 01:04