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 , and then specify the properties:

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


    DescriptionEnter a name to display a unique label for the component.
    ValueClick Click to build an expression to define a condition to display a specific value from the list as the default value.
    DisabledTurn on the toggle key to disable the Composite field component.
    HiddenTurn 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 TextEnter the text that you want to add to the beginning of the field value.

    Append TextEnter 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 ListSelect the named list that you want to associate with this field.
    Named List qualificationClick 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:

Was this page helpful? Yes No Submitting... Thank you

Comments