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.
The following tables list the field properties in alphabetical order.
Field properties A to C
Property | Field type | Description |
---|---|---|
Active Link(s) | Button | See To create a button field. |
Navigation field menu item | See To create a navigation field. | |
Add Label | Attachment pool | See To create an attachment pool. |
Add New Panel | Panel holder (all) | See To create a panel holder. |
Alignment |
| 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 |
| See Special submit setting. |
Alternative Text | Button | See To add an image to a button. |
Attach Name Label | Attachment pool | See To create an attachment pool. |
Attach Orphaned Items | Navigation (all) | See To create a navigation field. |
Attachment Fields | Attachment pool | See To create an attachment pool. |
Attachment Pool List | Attachment | See To move an attachment field from one attachment pool to another. |
Audit Log Key |
| See Specifying fields to be audited. |
Audit Option |
| Select one of these options:
See Using buttons and menu bar items to execute active links. |
Auto Complete | Character | See To enable or disable auto-complete. |
Auto Complete Match By | Character | See To configure auto-complete to match by label. |
Auto Fit Columns |
| See To add a table field to a form. |
Auto Refresh String | Alert list | See To customize table labels. |
Auto Resize | Character | See Enabling dynamic resizing of RTF fields. |
Background Color |
| Specifies the background color:
The selected color is displayed in the Background cell. |
Background Image |
| 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 |
| 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 |
| 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 |
| 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.
For more information about background images and colors in views, see Setting form view properties. | |
Border |
| Specifies how borders are shown:
|
Border Color | Panel (accordion, collapsible, splitter) | Color of lines surrounding the cells. |
Border Thickness | Panel (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. |
Borderless | Panel holder (accordion, collapsible, splitter) | Specifies whether a border appears around the panel holder. The default is True (border does not appear). |
Button Label | Button | See To create a button field. |
Change History | All | Contains 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 |
| See Adding a select all or cancel all check-box column to tables. |
CLOB Storage | Character | Specifies how CLOB (character large object) data is stored:
Note: This property applies only to Oracle databases. |
Column | All (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 Color | Tables ( all except Cell-based tables) | Specifies the background color for the table column header |
Column Header Text Color | Tables (all except Cell-based tables) | Specifies the text color for the table column header. |
Column Width |
| See To set column properties. |
Content Clipping | Display | For cell-based tables, only when table chunking is enabled. |
Currency Types | Currency | See To add a currency field to a form. |
Custom CSS Style | All | Specifies a custom CSS style for the field. For more information, see BMC Remedy AR System installed forms. |
Custom Properties | Data visualization | See Data visualization fields. |
Field properties D to F
Property | Field type | Description |
---|---|---|
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:
|
Data Length | Data (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 Type | All | Specifies 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 | Character | 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. |
| 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. | |
Currency | See To add a currency field to a form. | |
Definition Name | Data visualization | Specifies the definition name for the data visualization module. For more information, see Data visualization fields. |
Delete Button |
| See To customize table labels. |
Delete Label | Attachment pool | See To create an attachment pool. |
Depth Effect |
| For a box or line, specifies the appearance of depth:
For examples, see Trim lines, boxes, and text. |
Deselect All |
| See To customize table labels. |
Deselect Label | Attachment pool | See To create an attachment pool. |
Disable Change Flag |
| 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 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 |
Display as Flat Image | Button | See To add an image to a button. |
Display as Text |
| 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 Label | Attachment pool | See To create an attachment pool. |
Display NULL value As | Tree view table | See To add a table field to a form. |
Display Type | Button | See To create a button field. |
Character | Specifies one of these display types:
| |
| Specifies one of these display types:
| |
Diary | Specifies this display type:* Edit — Users can type values directly into the field. | |
Integer | Specifies one of these display types:
| |
Navigation |
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:
| |
Selection | Specifies one of these display types:
| |
Table columns | See To set column properties. | |
Table fields | See To add a table field to a form. | |
Draggable |
| (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 |
| 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 |
| (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 Items | Navigation | See To create a navigation field. |
Enable Clear | Character | Specifies whether a (clear) item appears on character field drop-down lists.
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. |
Enabled | Data (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:
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:
|
End Color | Data (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 |
| Specifies one of these options (available options depend on field type):
You can select this option only when you create a field. After you save a form, the following changes occur:
|
Expand Box |
| 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
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:
For character fields,
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 |
| Specifies how the field is initially displayed:
|
Data (all) | Specifies how users initially access a field in the current view:
| |
Field ID | All (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 Name | All (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 Label | Attachment pool | See To create an attachment pool. |
File Size Label | Attachment pool | See To create an attachment pool. |
Fire workflow again on selected item | Navigation (all) | See To create a navigation field. |
Fit to Content | Panel (collapsible) | See Using Fit to Content to dynamically resize panels. |
Fixed Headers |
| See To add a table field to a form. |
Float Style |
| See Creating floating panels. |
Form Name | All (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 |
| 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
Property | Field type | Description |
---|---|---|
Header Background Color | Panel (accordion, collapsible, splitter) | Specifies the background color for the header in a panel. |
Header State | Panel (collapsible, splitter) | Specifies whether the panel header is visible or hidden. The default is Visible. |
Height | All | Specifies the height of the fields in pixels. |
Help Text | All | Specifies 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 Space | Cell-based table | See Horizontal Space. |
ID | All | 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:
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. |
Image | Button | See To add an image to a button. |
Image Attachment | Character | See Allowing users to add an image to a character field. |
Image Position | Button | See To add an image to a button. |
Index for FTS |
| If you are licensed for full text search, specifies whether to index a character, diary, or attachment field for FTS. |
Initial Currency Type | Currency | See To add a currency field to a form. |
Initial Panel | Panel 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 |
| See To add a table field to a form. |
Initial Size | Panel (splitter, collapsible) | Specifies the size of the panel when it is initially created in a collapsible or splitter panel holder. |
Initial Value |
| See To set column properties. |
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 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:
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 in BMC Remedy ITSM Deployment online documentation. |
Label |
| 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 Align | Data (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 |
| Specifies a font type for the field label. In a default regular form, each label style identifies a different field behavior:
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:
|
Label Justify |
| Specifies where label text is positioned relative to the left and right edges of the text box: Left, Center, or Right. |
Label Location | Data (all) | Specifies where a data field's label appears in relation to the field: Top (above the field) or Left (default). |
Label/Text Color |
| 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:
|
Last Changed By | All | Specifies the user name of the last person who modified the field. This read-only field is automatically set. |
Last Changed Time | All | Specifies the date and time that the field was last modified. This read-only field is automatically set. |
Layout Style |
|
|
Length Units | Character | 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:
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 |
| Specifies the color of the line:
|
Literal FTS Index | Character | Specifies 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 Required | All | 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
|
Localize Data |
| Specifies whether configuration data can be localized for the form. The options are True and False (the default). |
Localize Label | All | Specifies whether the field label can be localized for the form. The options are True (the default) and False. |
Field properties M to P
Property | Field type | Description |
---|---|---|
Maintain Aspect Ratio | Button | See To add an image to a button. |
Margin Bottom |
| 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 |
| 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 |
| 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 |
| 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 |
| See To add a table field to a form. |
Max Size | Attachment | See To create an attachment pool. |
Maximum | Integer | Specifies 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. |
| Specifies the highest value that the field can have during data submission and modification. This setting is required. | |
Maximum Height | Character | See Enabling dynamic resizing of RTF fields. |
Maximum Size | Panel (splitter) | Specifies the maximum size allowed for a panel in a splitter panel holder. |
Menu Name | Character | 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. |
Menu Style | Character | Specifies how menu text is added to the field when users select an item from a character menu:
|
Minimum | Integer | Specifies 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. |
| Specifies the lowest value that the field can have during data submission and modification. This setting is required. | |
Minimum Size | Panel (splitter) | Specifies the minimum size allowed for a panel in a splitter panel holder. |
Mode | Application 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:
|
Module Type | Data visualization | Specifies 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. |
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, 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 State | Navigation (all) | See To create a navigation field. |
Navigation Mode | Vertical navigation | Indicates the options for displaying vertical navigation menu items.
|
New Description | All | Records 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 |
| See the description of "Next Label" and "Size of Chunk" in this section. |
Number of Entries Returned |
| See To customize table labels. |
Opacity | Panel (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 |
| Specifies the orientation of a line: Vertical or Horizontal. For panel holders, specifies the orientation of the panel headers: Vertical or Horizontal. |
Owner | All | Identifies the author of each entry in the Change History property. |
Panel Bottom Margin | Panel | See Enabling dynamic resizing of RTF fields. |
Panel Left Margin | Panel | See Enabling dynamic resizing of RTF fields. |
Panel Right Margin | Panel | See Enabling dynamic resizing of RTF fields. |
Panel State | Panel (collapsible) | Specifies whether a panel in a collapsible panel holder is expanded or collapsed. The default is Expand. |
Panel Top Margin | Panel | See Enabling dynamic resizing of RTF fields. |
Panels | Panel holder (all) | See To create a panel holder. |
Parent field | Panel holder (all) | Parent field property is automatically set for a field when you place a field on panel. |
Pattern | Character | Restricts what users can enter into the field. You can specify two types of character patterns:
|
Permissions | All | Specifies 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. |
Precision | Decimal | Specifies 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. |
Real | Specifies 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 |
| See To customize table labels. |
Previous Label |
| See the description of "Size of Chunk" in this section. |
Field properties Q to Z
Property | Field type | Description |
---|---|---|
QBE Match | Character | Specifies how a match is determined when a user performs a query-by-example (QBE) in the mid tier:
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 Button | Alert list | See To customize table labels. |
Refresh Button |
| See To customize table labels. |
Refresh on Entry Change |
| See To add a table field to a form. |
Refresh Row Selection |
| See To add a table field to a form. |
Remote/Local Fields | Cell-based table | Opens a dialog box used to add columns to tables. See To add a table field to a form. |
Report Button |
| See To customize table labels. |
Results Color |
| See To set row text and background colors. |
Rounded Colors | Panel (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 |
| See To customize table labels. |
Row Selection |
| See To add a table field to a form. |
Rows |
| Specifies the number of rows of text that are displayed. |
| 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 Label | Attachment pool | See To create an attachment pool. |
Scale Image to Fit | Button | See To add an image to a button. |
Scroll Bar |
| Specifies how scroll bars are displayed:
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 |
| See To customize table labels. |
Select Column Label |
| |
Select item on click | Navigation (all) | See To create a navigation field. |
Selections |
| See To add selection items. |
Server | Data visualization | Specifies the BMC Remedy AR System server that contains the data visualization module. See Using buttons and menu bar items to execute active links. |
Shared Fields | Panel holder (all) | See Shared fields in panel holders. |
Show URL | Character | 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 Order | Panel | See Distributing slack to avoid scroll bars. |
Sort | Cell-based table | See To set sort order and visible levels. |
Sort/Levels |
| See To set sort order and visible levels. |
Splitter State | Panel 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.
|
Start Color | Data (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 Color | Vertical Navigation bar | The sub level alternate background color. This setting is applicable only to Vertical Navigation Bar in the Flyout mode. |
Tab Order |
| 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. |
Table | All (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 |
| See To add a table field to a form. |
Table Header Footer Gradient Background Color |
| 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 |
| See To customize table labels. |
Tabless Borderless | Panel holder (tabbed) | See To create a panel holder. |
Text | Trim text | See To create trim fields. |
View | See To create a view field. | |
Text Align | Trim text | See To create trim fields. |
Text Rotation | Trim text | See To create trim fields. |
Text Style | Trim text | See To create trim fields. |
Trr/Table Property |
| Opens a dialog box used to add columns to tables. See To add a table field to a form. |
Thickness |
| Specifies a line width of 1 to 9 pixels. The default is 2. Thickness cannot be changed if the Depth Effect is Etched. |
Unread | Alert list | See To customize table labels. |
URL Color | Button | See To create a button field. |
Trim text | See To add a URL to a trim text field. | |
Use Locale |
| See Locale-specific refresh. |
Vendor | All (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 Space | Cell-based table | See Vertical Space. |
Vertical Spacing | Panel | See Enabling dynamic resizing of RTF fields. |
Views | All except table columns | Specifies 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. |
Visible | All | 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. |
Visible Columns | Cell-based table | See Visible Columns. |
Width | Alla | Defines the width of the fields in pixels. |
Wrap Text |
| See To set column properties. |
X | All | 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:
|
Y | All | 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. |
Comments
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?
Hello Albert,
We are working on your query. We will respond shortly.
Regards,
Anagha
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
Log in or register to comment.