Create or edit an EVAM view definition

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read

    • Create or edit an Entity View Action Mapper (EVAM) view definition in the AI Search Admin console to customize how your AI Search results are displayed in the portal or workspace.

    Before you begin

    Role required: admin or ais_admin

    About this task

    An EVAM is a data source type tool that helps standardize how data is displayed in lists and cards. An EVAM enables users to combine data from multiple sources, configure views for each source, and navigate through large data sets. By creating or editing an EVAM definition, you can combine the conditions, fields, and declarative actions with an associated view template to customize the result-card interface to your needs.

    Procedure

    1. Navigate to All > AI Search Admin > AI Search Admin Home.
    2. On the Applications tab, select the application card that you want to create or edit the EVAM configurations for.
    3. On the sidebar tab, select Result-card Interface.
      The result-card Interface shows the EVAM definition if it’s already configured. You can modify the existing EVAM definition or if you’re configuring your application for the first time, you can add a new EVAM definition. For more information, see step 4.

      Result-card interface of the search application in the AI Search Admin console where you can change the EVAM definition if needed.

    4. Optional: Update an existing EVAM definition or add a new definition.
      • To update the existing EVAM definition for the result-card interface, select Change.
      • To add a new EVAM definition and configure the result-card interface for the first time, select Choose.
      1. Create or update an EVAM definition for the result-card interface.

        Choose result card interface dialog box in the AI Search Admin console, where you can either select an existing result card interface or create a new interface for the search application.

        Option Procedure
        Select from the existing result-card interfaces for your search application
        1. Select Use an existing result-card interface.
        2. From the Result card interface list, select an option.
        Add a new result-card interface for your search application
        1. Select Create new interface.
        2. In the Configuration name field, enter the name.
      2. Select Save.
    5. From the Select a bundle to edit list, select an EVAM configuration bundle.
      You can link more bundles to the selected EVAM definition by selecting Advanced configuration. For more information, see Create an EVAM definition.
      The list of view configurations that are associated with the selected bundle are displayed.
    6. Manage the EVAM view configuration.
      OptionProcedure
      Create an EVAM view configuration
      1. Select Create New.
      2. In the Create new view config dialog box, review the auto-populated values, and then select Create.
      Edit the existing EVAM view configuration
      1. From the View configs list, identify an EVAM view configuration that you want to edit.
      2. Select the More Actions icon () and then select Edit.
    7. On the form, fill in the fields.
      For a description of the field values, see Edit view config form.
    8. In the Preview Card section, review the auto-generated JSON to verify the edits that you made to the view configuration.

      The following example shows the Edit view config form that helps you review the layout of your result-card interface in the Preview Card section.

      Figure 1. Edit view config form
      Edit view config form showing the preview card.
    9. Select Save.

    Result

    Changes made to search result EVAM cards take effect immediately in AI Search applications.

    What to do next

    After creating a view configuration, you must activate it. For more information, see Activate or deactivate an EVAM view configuration.