Card template element attributes

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Card Template Element Attributes

    This guide provides essential information on the attributes required for card template elements in ServiceNow. Understanding these attributes is crucial for creating and configuring card templates effectively, particularly when utilizing the Mobile Card Builder, which automates attribute creation.

    Show full answer Show less

    Key Features

    • Text Type Attributes:
      • TextValue: Displays static text, configured using the Translatable value field.
      • FieldLabel: Shows the label of a table field, configured with the field name.
      • FieldValue: Displays the value of a field in a record.
      • FieldFunction: Displays a count of records or groups based on a value.
    • Image Type Attributes:
      • ImageURL: Displays a static image from the attachment table using the SysID.
      • FieldValue: Displays an image from a field in a record.
    • Button and MenuButton Type Attributes:
      • Button: Selects the function to run when tapped, using the SysID.
      • TextValue: Displays static text.
      • FieldValue: Displays the value of a field.
      • Icon: Displays an icon using the SysID from the icon table.
    • Menu Type Attributes:
      • TextValue: Displays static text.
      • Icon: Displays an icon using the SysID from the icon table.
    • HtmlText Type Attributes:
      • Various attributes for customizing HTML content and rendering options.
    • Property Attributes:
      • BackgroundColor, BorderColor, TextColor: Define the respective colors using hex code or color theme names.

    Key Outcomes

    By utilizing these attributes effectively, ServiceNow customers can create visually appealing and functional card templates that enhance user interaction within mobile applications. Understanding the configuration of each attribute type ensures proper implementation and customization to meet organizational needs.

    Use this reference to determine which attributes to use for your card template elements.

    Each card template element has one or more required attributes that you must create. The sections below show the required attributes for each card template element type.

    Note:
    When using the Mobile Card Builder, the listed attributes do not need to be manually created, as the tool automatically creates the attributes in the background.

    Attributes for the Text type

    Table 1. Attributes for the Text type
    Name Description Configuration
    TextValue Used to display static text. Use the Translatable value field to enter the text to display.
    FieldLabel Used to display the label of a table field. Use the Value field to enter the name of a field. For example, short_description.
    FieldValue Used to display the value of a field in a record. Use the Value field to enter the name of a field. For example, short_description.
    FieldFunction Used to display either a count of records, or the value by which records are grouped.

    Attributes for the Image type

    Table 2. Attributes for the Image type
    Name Description Configuration
    ImageURL Used to display a static image from the attachment[sys_attachment] table on your instance. Use the Value field to enter a SysID for a record in the attachment[sys_attachment] table.
    FieldValue Used to display an image from a field in a record. Use the Value field to enter the name of a field. For example, avatar.

    Attributes for the Button and MenuButton types

    Table 3. Attributes for the Button and MenuButton types
    Name Description Configuration
    Button Used to select the function that runs when users tap a button. Use the Value field to enter the SysID of a function from the Functions[sys_sg_button] table. For details on creating functions, see Mobile functions.
    TextValue Used to display static text. Use the Value field to enter the name of a field. For example, short_description.
    FieldValue Used to display the value of a field in a record. Use the Value field to enter the name of a field. For example, avatar.
    Icon Used to display an icon. Use the Value field to enter the SysID of an icon record from the Icon[sys_sg_icon] table.

    Attributes for the Menu type

    Table 4. Attributes for the Menu type
    Name Description Configuration
    TextValue Used to display static text. Use the Value field to enter the name of a field. For example, short_description.
    Icon Used to display an icon. Use the Value field to enter the SysID of an icon record from the Icon[sys_sg_icon] table.

    Attributes for the HtmlText type

    Table 5. Attributes for the HtmlText type
    Name Description Configuration
    SearchExternalSource
    HtmlReplaceMap
    HtmlSanitizationAllowList
    HtmlRemoveList
    StringReplaceMap
    RenderType

    Property Attributes

    Use property attributes to define additional properties for your card template slot. These properties are not associated with a specific attribute type.

    Table 6. Attributes for the Menu type
    Name Description Configuration
    BackgroundColor Color of the background for the card template element. Use the Value field to define the color. Colors must be in color hex code format, or the name of a color theme. For example Primary or #8a8a8a.
    BorderColor Color of the border for the card template element. Use the Value field to define the color. Colors must be in color hex code format, or the name of a color theme. For example Primary or #8a8a8a.
    TextColor Color of the text or the card template element. Use the Value field to define the color. Colors must be in color hex code format, or the name of a color theme. For example Primary or #8a8a8a.