This documentation supports the 18.08 version of Remedy Action Request System.

To view the latest 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 how the field looks and acts during operations performed in a browser. The properties listed in the Properties tab vary depending on the type of field you are creating or modifying.

See also Properties tab for fields in Best Practice Customization Mode.

Field properties A to C

PropertyField typeDescription
Active Link(s)ButtonSee To create a button field.
Navigation field menu itemSee To create a navigation field.
Add LabelAttachment poolSee To create an attachment pool.
Add New PanelPanel holder (all)See To create a panel holder.
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.
Allow Any User to Submit
  • Attachment
  • Data (all)
See Special submit setting.
Alternative TextButtonSee To add an image to a button.
Attach Name LabelAttachment poolSee To create an attachment pool.
Attach Orphaned ItemsNavigation (all)See To create a navigation field.
Attachment FieldsAttachment poolSee To create an attachment pool.
Attachment Pool ListAttachmentSee To move an attachment field from one attachment pool to another.
Audit Log Key
  • Attachment
  • Data (all)
See Specifying fields to be audited.
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.

Auto CompleteCharacterSee To enable or disable auto-complete.
Auto Complete Match ByCharacterSee To configure auto-complete to match by label.
Auto Fit Columns
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To add a table field to a form.
Auto Refresh StringAlert listSee To customize table labels.
Auto ResizeCharacterSee Enabling dynamic resizing of RTF fields.
Background Color
  • Cell-based table
  • Panel (all)
  • Trim box
  • Trim text

Specifies the background color:

  1. Select the appropriate field.
  2. (Panels and trim fields) In the Properties tab, set Background Mode to Opaque.
  3. Select custom from the Background Color drop-down list.
  4. Select a color from the color palette, and click OK.

The selected color is displayed in the Background cell.

Background Image
  • Cell-based table
  • Panel (all)
For cell-based tables, specifies the background image in all cells in the table. For panels, specifies the image that appears in the background of the panel, and whether the image is embedded in the panel or inserted by reference.
Background Image Horizontal
  • Cell-based table
  • 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.
Background Image Vertical
  • Cell-based table
  • 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.
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.
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.

Border
  • Application list
  • Data visualization
  • 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.
Border ColorPanel (accordion, collapsible, splitter)Color of lines surrounding the cells.
Border ThicknessPanel (accordion, collapsible, splitter)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.
BorderlessPanel holder (accordion, collapsible, splitter)Specifies whether a border appears around the panel holder. The default is True (border does not appear).
Button LabelButtonSee To create a button field.
Change HistoryAllContains information about field modifications. BMC Remedy 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 change history.
Checkbox Column
  • List view table
  • Results list
See Adding a select all or cancel all check-box column to tables.
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.

Note: This property applies only to Oracle databases.

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 Header ColorTables ( all except Cell-based tables)Specifies the background color for the table column header
Column Header Text ColorTables (all except Cell-based tables)Specifies the text color for the table column header.
Column Width
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To set column properties.
Content ClippingDisplayFor cell-based tables, only when table chunking is enabled.
Currency TypesCurrencySee To add a currency field to a form.
Custom CSS StyleAllSpecifies a custom CSS style for the field. For more information, see BMC Remedy AR System installed forms.
Custom PropertiesData visualizationSee Data visualization fields.

Field properties D to F

PropertyField typeDescription
Data fontData (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 BMC Remedy 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.
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.
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.
Default Value

CharacterSpecifies 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.
  • 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.
CurrencySee To add a currency field to a form.
Definition NameData visualizationSpecifies the definition name for the data visualization module. For more information, see Data visualization fields.
Delete Button
  • Alert list
  • Results list
See To customize table labels.
Delete LabelAttachment poolSee To create an attachment pool.
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 Trim lines, boxes, and text.

Deselect All
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
Deselect LabelAttachment poolSee To create an attachment pool.
Disable Change Flag
  • Data (all)
  • Application list
  • Attachment
  • Data visualization
  • 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.

Note: 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.

Display as Flat ImageButtonSee To add an image to a button.
Display as Text
  • Character
  • Data (all)
  • Date/Time
  • Diary

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 using an expand box.

Display LabelAttachment poolSee To create an attachment pool.
Display NULL value AsTree view tableSee To add a table field to a form.
Display TypeButtonSee To create a button field.
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.
  • 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.
DiarySpecifies this display type:* Edit — Users can type values directly into the field.
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.
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.

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.
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.
Table columnsSee To set column properties.
Table fieldsSee To add a table field to a form.
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 data to be dragged and dropped.

Note: 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.

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 Drop shadows in panels and 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.
Droppable
  • Data (all)
  • Horizontal Line
  • Vertical Line
  • Trim Text
  • Trim Box
  • Button
  • View
  • Data Visualization
  • 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 data to be dragged and dropped. This property allows the field to accept drop events that occur as a result of a user dragging a field and dropping on it.

Note: 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.

Edit Menu/Navigation ItemsNavigationSee To create a navigation field.
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.

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

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.

Notes:

  • 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.
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.
Entry Mode
  • Data (all)
  • Attachment

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

  • System — The field is populated by BMC Remedy 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.
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.
  • 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.

Note: 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.

Field Access
  • Alert list
  • Button
  • Cell-based table
  • 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.
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.
Field IDAll (join forms only)For fields on join forms, specifies the integer that identifies the field internally throughout BMC Remedy AR System server. This field is read-only. See Working with fields in join forms.
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.
File Name LabelAttachment poolSee To create an attachment pool.
File Size LabelAttachment poolSee To create an attachment pool.
Fire workflow again on selected itemNavigation (all)See To create a navigation field.
Fit to ContentPanel (collapsible)See Using Fit to Content to dynamically resize panels.
Fixed Headers
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To add a table field to a form.
Float Style
  • Panel
  • Panel holder
See Creating floating panels.
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.
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.

Field properties G to L

PropertyField typeDescription
Header Background ColorPanel (accordion, collapsible, splitter)Specifies the background color for the header in a panel.
Header StatePanel (collapsible, splitter)Specifies whether the panel header is visible or hidden. The default is Visible.
HeightAllSpecifies the height of the fields in pixels.
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 Providing help text.
Horizontal SpaceCell-based tableSee Horizontal Space.
IDAll

Identifies the field internally throughout BMC Remedy 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, BMC Remedy 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 BMC Remedy 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 BMC Remedy 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 BMC Remedy AR System field definition) and reuse the field in multiple forms. Reusing the ID provides a consistent definition for the field across forms.

ImageButtonSee To add an image to a button.
Image AttachmentCharacterSee Allowing users to add an image to a character field.
Image PositionButtonSee To add an image to a button.
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.
Initial Currency TypeCurrencySee To add a currency field to a form.
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.
Initial Row Selection
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To add a table field to a form.
Initial SizePanel (splitter, collapsible)Specifies the size of the panel when it is initially created in a collapsible or splitter panel holder.
Initial Value
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To set column properties.
Input LengthCharacter

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 Character 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 BMC Remedy AR System, see the Understanding the AR System database. 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, BMC Remedy 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.

Note: To configure a different maximum input length for Oracle and Microsoft SQL Server databases, use the Db-Max-Text-Size option in the BMC Remedy AR System server 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. See Understanding the AR System database and information in Installing Open link in BMC Remedy ITSM Deployment online documentation.

Label
  • Application list
  • Attachment
  • Composite (all)
  • Data (all)
  • Data visualization
  • 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, BMC Remedy AR System issues a warning message every time you apply changes to the form unless you disable the BMC Remedy 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.
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.
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 BMC Remedy 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.
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.
Label LocationData (all)Specifies where a data field's label appears in relation to the field: Top (above the field) or Left (default).
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.
Last Changed ByAllSpecifies the user name of the last person who modified the field. This read-only field is automatically set.
Last Changed TimeAllSpecifies the date and time that the field was last modified. This read-only field is automatically set.
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.
    Note: 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 Enabling dynamic resizing of RTF fields.

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 BMC Remedy 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, BMC Remedy 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).

Note: 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.

BMC Remedy Developer Studio does not display the Length Units property if the BMC Remedy AR System server is release 7.1.00 or earlier. To configure the default value of this property, in BMC Remedy 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.

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.
Literal FTS IndexCharacterSpecifies 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.
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.
Localize Data
  • Data (all)
  • Attachment
Specifies whether configuration data can be localized for the form. The options are True and False (the default).
Localize LabelAllSpecifies whether the field label can be localized for the form. The options are True (the default) and False.

Field properties M to P

PropertyField typeDescription
Maintain Aspect RatioButtonSee To add an image to a button.
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.
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.
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.
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.
Max Rows
  • Alert list
  • List view table
  • Cell-based table
  • Results list
  • Tree view table
See To add a table field to a form.
Max SizeAttachmentSee To create an attachment pool.
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.
  • Currency
  • Decimal
  • Real
Specifies the highest value that the field can have during data submission and modification. This setting is required.
Maximum HeightCharacterSee Enabling dynamic resizing of RTF fields.
Maximum SizePanel (splitter)Specifies the maximum size allowed for a panel in a splitter panel holder.
Menu NameCharacterAttaches 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.
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.
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.
 
  • Currency
  • Decimal
  • Real
Specifies the lowest value that the field can have during data submission and modification. This setting is required.
Minimum SizePanel (splitter)Specifies the minimum size allowed for a panel in a splitter panel holder.
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.
Module TypeData visualizationSpecifies the module type for the data visualization field: flashboard, report, or visualizer. See Data visualization fields Using buttons and menu bar items to execute active links.
NameAll

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, BMC Remedy 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, BMC Remedy 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.

Note: 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.

Navigation Initial StateNavigation (all)See To create a navigation field.
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.
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.
Next Label
  • Cell-based table
  • List view table
  • Results list
See the description of  "Next Label" and "Size of Chunk" in this section.
Number of Entries Returned
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
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 To set color opacity for a panel.
Orientation
  • Horizontal line
  • Vertical line
  • Panel holder (accordion, collapsible, splitter)
Specifies the orientation of a line: Vertical or Horizontal. For panel holders, specifies the orientation of the panel headers: Vertical or Horizontal.
OwnerAllIdentifies the author of each entry in the Change History property.
Panel Bottom MarginPanelSee Enabling dynamic resizing of RTF fields.
Panel Left MarginPanelSee Enabling dynamic resizing of RTF fields.
Panel Right MarginPanelSee Enabling dynamic resizing of RTF fields.
Panel StatePanel (collapsible)Specifies whether a panel in a collapsible panel holder is expanded or collapsed. The default is Expand.
Panel Top MarginPanelSee Enabling dynamic resizing of RTF fields.
PanelsPanel holder (all)See To create a panel holder.
Parent fieldPanel holder (all)Parent field property is automatically set for a field when you place a field on panel.
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 Operator types).
  • 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.
      Note: 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.

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.
PrecisionDecimalSpecifies the number of decimal places displayed in the user's view. The default setting is 2 and the maximum value of precision in BMC Remedy AR System is 9.
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.
Preferences
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
Previous Label
  • Cell-based table
  • List view table
  • Results list
See the description of "Size of Chunk" in this section.

Field properties Q to Z

PropertyField typeDescription
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.

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

Read ButtonAlert listSee To customize table labels.
Refresh Button
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
Refresh on Entry Change
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To add a table field to a form.
Refresh Row Selection
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To add a table field to a form.
Remote/Local FieldsCell-based tableOpens a dialog box used to add columns to tables. See To add a table field to a form.
Report Button
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
Results Color
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To set row text and background colors.
Rounded ColorsPanel (all)

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

Note: Rounded corners are shown in BMC Remedy Developer Studio

Row Header
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
Row Selection
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To add a table field to a form.
Rows
  • Character
  • Diary
Specifies the number of rows of text that are displayed.
  • 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.
Save LabelAttachment poolSee To create an attachment pool.
Scale Image to FitButtonSee To add an image to a button.
Scroll Bar
  • Application list
  • Data visualization
  • 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.

Note: If the content of a field (such as a BMC Remedy 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.

Select All
  • Alert list
  • Cell-based table
  • List view table
  • Results list
See To customize table labels.
Select Column Label
  • Alert list
  • Cell-based table
  • List view table
  • Results list

See To customize table labels.

Select item on clickNavigation (all)See To create a navigation field.
Selections
  • Check box
  • Drop-down list
  • Radio button
See To add selection items.
ServerData visualizationSpecifies the BMC Remedy AR System server that contains the data visualization module. See Using buttons and menu bar items to execute active links.
Shared FieldsPanel holder (all)See Shared fields in panel holders.
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.

Slack Distribution OrderPanelSee Distributing slack to avoid scroll bars.
SortCell-based tableSee To set sort order and visible levels.
Sort/Levels
  • Alert list
  • List view table
  • Results list
  • Tree view table
See To set sort order and visible levels.
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.
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.
Sub Level Background ColorVertical Navigation barThe sub level alternate background color. This setting is applicable only to Vertical Navigation Bar in the Flyout mode.
Tab Order
  • Application list
  • Button
  • Composite (all)
  • Data (all)
  • Data visualization
  • 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.
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 View and Vendor forms Using buttons and menu bar items to execute active links.
Table Drill Down
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To add a table field to a form.
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).
Table Not Loaded String
  • Cell-based table
  • List view table
See To customize table labels.
Tabless BorderlessPanel holder (tabbed)See To create a panel holder.
TextTrim textSee To create trim fields.
ViewSee To create a view field.
Text AlignTrim textSee To create trim fields.
Text RotationTrim textSee To create trim fields.
Text StyleTrim textSee To create trim fields.
Trr/Table Property
  • Alert list
  • List view table
  • Results list
  • Tree view table
Opens a dialog box used to add columns to tables. See To add a table field to a form.
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.
UnreadAlert listSee To customize table labels.
URL Color ButtonSee To create a button field.
Trim textSee To add a URL to a trim text field.
Use Locale
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See Locale-specific refresh.
VendorAll (vendor form only)For fields on vendor forms, specifies the vendor name. For more information, see View and Vendor forms Using buttons and menu bar items to execute active links.
Vertical SpaceCell-based tableSee Vertical Space.
Vertical SpacingPanelSee Enabling dynamic resizing of RTF fields.
ViewsAll except table columnsSpecifies the form views in which a field appears. See To add or remove a field 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 BMC Remedy Developer Studio, select Window > Preferences. Under "BMC Remedy 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 packing lists and Creating and managing fields.
VisibleAllSpecifies 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.
Visible ColumnsCell-based tableSee Visible Columns.
WidthAllaDefines the width of the fields in pixels.
Wrap Text
  • Alert list
  • Cell-based table
  • List view table
  • Results list
  • Tree view table
See To set column properties.
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.

Note: 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.
 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.
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Albert Bihler

    Regarding option "Encrypt Data At Rest": Could you please provide some more details how encrytion/decryption exactly works? Is there a public/private key pair? If yes, where is it stored? If we set up a new ARS server using a database dump from another server including encrypted fields, will the new server be able to decrypt the data correctly?

    Nov 16, 2018 03:30
    1. Anagha Deshpande

      Hello Albert,

      We are working on your query. We will respond shortly.

      Regards,

      Anagha

      Nov 18, 2018 08:57
      1. Anagha Deshpande

        Hello Albert,

        Apologies for the late response.

        There is no public/private key.

        We use standard encryption algorithms defined in the server configuration. If you are not using any encryption installer from BMC, the default AES encryption algorithm is used for encryption and decryption.

        The key is generated dynamically and stored in one of the metadata tables (arkeystore). The algorithm is also stored as part of the data itself so that even if the algorithm is changed later, old data can still be decrypted.

        If you are using premium or performance security installers and have more secure encryption algorithms such as SHA, those algorithms are used. The key generation and storage mechanism remains the same.

        You can restore the DB dump, as that dump itself contains the keys.

        Hope this helps.

        Regards,

        Anagha

        Dec 25, 2018 10:43