This documentation supports the 22.1 version of BMC Helix Innovation Studio.To view an earlier version, select the version from the Product version menu.

Adding a composite field to a view


The Composite field component is available in the Common Components section of the View designer and is visible only if the Common Components bundle is deployed.

As a developer or an application business analyst, use the Composite field component in a view to display the field value in multiple options. For example, display the value from the field as a badge, or in a specific color or font, or add a prefix or suffix to the value.


Important

Application business analysts can customize the objects developed in their own applications and that are marked customizable by the administrator, but cannot customize the objects developed in com.bmc.arsys in Best Practice Customization mode. For example, objects in core BMC applications like Foundation, Approval, and Assignment cannot be customized in Best Practice Customization mode.  For more information, see Customization-layer.

Before you begin

Make sure you create a view definition with Record editor to which you want to add a Composite field component. For more information, see Creating-a-view-for-a-record-instance-by-using-record-editor.

To add a composite field component to a view definition

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
  2. Select the application for which you want to add the Composite field component.
  3. On the Views tab, click the name of the view definition to which you want to add the Composite field component.
  4. From Palette, drag the Composite field component to the Record editor component.
  5. In the Properties pane, click Settings Settings icon.png, and then specify the properties:

    Property

    Description

    Example

    Field name

    Select the field that you want to use as a composite field.

    The list of fields is displayed from the record definition that you selected for the Record editor component.


    Composite field general configuration.png

    Description

    Enter a name to display a unique label for the component.

    Value

    Click Click to build an expression to define a condition to display a specific value from the list as the default value.

    Disabled

    Turn on the toggle key to disable the Composite field component.

    Hidden

    Turn on the toggle key to hide the Composite field component at runtime.

    Available on devices

    From the following device options, select the devices on which the component should be visible:

    • Desktop
    • Mobile
    • Tablet

    By default, all three options are selected. 

    Custom settings

    Prepend Text

    Enter the text that you want to add to the beginning of the field value.

    Composite field custom configuration.png

    Append Text

    Enter the text that you want to add to the end of the field value.

    Default Icon

    Enter the name of the CSS icon class to add an icon to the component.

    For example: d-icon-user_circle.

    Default Icon Color

    Enter the appropriate CSS selector to define the color property for the icon.  

    For example: #00ff00

    Default Font Color

    Enter the appropriate CSS selector to define the color property for the font.

    For example: #00ff00

    Icon And Color Mapping json

    Map the value from the named list with the label.

    For example, {"1000" : {"iconClass": "d-icon-close", "iconColor": "#f3f3f3", "fontColor": "#00ddf3", "backgroundColor": "#fff"}}

    Text Transformation

    Select from the following options for capitalizing the text added to the component:

    • None—No capitalization. The text is displayed as it is
    • Capitalize—Transforms first character of each word to uppercase
    • Lowercase—Transforms all characters to lowercase
    • Uppercase—Transforms all characters to uppercase

    Show Badge

    Turn on the toggle key to display the field value as a badge.

    Named List

    Select the named list that you want to associate with this field.

    Named List qualification

    Click Click to build an expression to define the condition on which items appear on the named list in the application.

  6. Click Save.

Result

The following image displays a Ticket view that uses a Composite field component:

Composite field example.png

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*