Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Add an Entity View Action Mapper data resource to a page

Add an Entity View Action Mapper (EVAM) data resource to your page in UI Builder so that you can standardize how the data sources in your components are displayed in your cards and lists.

Before you begin

Role required: ui_builder_admin

Procedure

  1. Navigate to All > Now experience framework > UI Builder.

  2. Open an experience to work in or create an experience by selecting Create > Experience.

    See Configure how users interact with your applications in UI Builder for more information on creating experiences.

  3. Open or create a page.

    For more information, see Manage UI Builder pages and page variants.

  4. If you do not have any components on your page, add a Data set component to your page.

    For more information, see Add and configure components.

  5. In the Data and scripts panel, select the + icon and then select Data resource.

Image omitted: data-resource-open.png
Arrow pointing to Data resource option.
  1. Enter evam in the search field.

  2. Select the EVAM data resource that you want to add and repeat this step for all the EVAM data resources for your page.

Image omitted: evam-data-sources.png
EVAM data resources.
  1. Configure each EVAM data resource.
EVAM data sourceDescription
EVAM Data Resource

Add an EVAM definition and other information about the data source. - Type: Composite. - When to evaluate: In the When to evaluate this data resource list, select Immediately to have the EVAM data resource instance evaluated on page load or select Only when invoked to use an event handler to evaluate the EVAM data resource. - EVAM definition: In the EVAM Definition field, add the EVAM definition record that is associated with the data resource. - Page cursor: In the Page Cursor field, add a page cursor for the EVAM definition. - Page size: In the Page Size field, add a size for the EVAM pagination. - Page number: In the Page Number field, add the page number for the EVAM pagination. - EVAM Filter Preference: In the EVAM Filter Preference field, add the sys_ids for the EVAM data filter. To add an event handler for when that data fetch is initiated, succeeded, or failed, select Events.

In the Now Code Editor section, which is next to the Configuration pane, preview the EVAM definition script.

Image omitted: EVAM-Data-Resource-Sample.png
EVAM Data Resource Configuration.</p></td></tr><tr><td>
Fetch EVAM Data

To add an EVAM definition and other information about the data source, select Configuration. - Type: GRAPHQL. - When to evaluate: To have the EVAM data resource instance evaluated on a page load, select Immediately. To use an event handler to evaluate the EVAM data resource, select Only when invoked. - EVAM definition: In the EVAM Definition field, add the EVAM definition record that is associated with the data resource. - Page cursor: In the Page Cursor field, add a page cursor for the EVAM definition. - Page size: In the Page Size field, add a size for the EVAM pagination. - Page number: In the Page Number field, add the page number for the EVAM pagination. - EVAM Filter Preference: In the EVAM Filter Preference field, add the sys_ids for the EVAM data filter. To add an event handler for when that data fetch is initiated, succeeded, or failed, select Events.

Preview the EVAM definition script in the Now Code Editor to the right of the Configuration pane.

Image omitted: evam-fetch-data.png
Fetch EVAM Data source configuration.</p></td></tr><tr><td>
Fetch EVAM Metadata

To select when to evaluate the EVAM data resource and add an EVAM definition, select Configuration. - Type: GRAPHQL. - When to evaluate: To have the EVAM data resource instance evaluated on a page load, select Immediately. To use an event handler to evaluate the EVAM data resource, select Only when invoked. - EVAM definition: In the EVAM Definition field, add the EVAM definition record that is associated with the data resource. To add an event handler for when that data fetch is initiated, succeeded, or failed, select Events.

Preview the EVAM definition script in the Now Code Editor to the right of the Configuration pane.

Image omitted: evam-fetch-metadata.png
Fetch EVAM Metadata configuration.</p></td></tr><tr><td>
Search EVAM Data Resource

To add an EVAM definition and other information about the data source, select Configuration. - Type: Composite. - When to evaluate: To have the EVAM data resource instance evaluated on a page load, select Immediately. To use an event handler to evaluate the EVAM data resource, select Only when invoked. - EVAM Config ID: In the EVAM Config ID field, add the EVAM Config ID that is associated with the data record. - Search Context Config ID: In the Search Context Config ID field, add the Search Context Config ID that you are searching for. - Search Term: In the Search Term field, add the search terms that you are searching for - Facet Filters: In the Facet filters field, add any facet filters to help define your search. - Search Filters: In the Search Filters field, add any search filters to help define your search. - Disable Spell Checking: In the Disable Spell Checking field, select if you desire spell checking to be on or off during your search. - Pagination Token: In the Pagination Token field, add a pagination token if needed. To add an event handler for when that data fetch is initiated, succeeded, or failed, select Events.

Preview the EVAM definition script in the Now Code Editor to the right of the Configuration pane.

Image omitted: evam-search-data-resource.png
Search EVAM Data resource configuration.</p></td></tr></tbody>
  1. Configure your data set component:

    • Bind an EVAM data resource to your component.
    • Set the Show grid/list toggle to on to let users choose between the grid or list view of the EVAM information on the page.
    • Set the other configuration settings for the cards on the page.
    • Select Save.
  2. View and test your page by selecting the Preview button.

Image omitted: EVAM-SampleFinishedState.png
Finished state of EVAM.

Parent Topic:Work with the Entity View Action Mapper for UI Builder

sndocs is an independent community mirror and is not affiliated with or endorsed by ServiceNow.

ServiceNow, the ServiceNow logo, Now, and other ServiceNow marks are trademarks and/or registered trademarks of ServiceNow, Inc., in the United States and/or other countries. Other company and product names may be trademarks of the respective companies with which they are associated.

© 2026 ServiceNow, Inc. All rights reserved.

Documentation content is redistributed under the Apache License 2.0 from the ServiceNowDocs repository.