Create a multi-data source list display in Entity View Action Mapper

Use EVAM to take in different datasources, configure views, and show them in a card display view.

Before you begin

Role required: admin or evam_admin

About this task

A typical scenario is showing user requests and incidents in a single display view. A user might want to see requests that can be made from a catalog, such as a computer order. They also might want to see open or closed incidents. These items come from different data sources, but need to display through a consistent standard that can be easily configured.

This tutorial runs through creating an EVAM definition with two data sources, a configuration bundle for each data source which contains two view configurations, and associated actions and view templates. Many tasks are repeated, instead of repeating each step, the following table lists the unique configurations and definitions:

Procedure

1. Create an EVAM definition for user requests.

   An EVAM definition houses data sources, configuration bundles with associated view configurations, data filters, actions, and templates. After you initially submit your EVAM definition, you will see the related lists to add data sources, configuration bundles, and data filters.

1. Define data sources for your EVAM definition.

   Create and link each data source to the User Request definition. The initial data source is for catalog requests. You can also make one for incidents submitted.

1. Create and link a view configuration bundle.

   You should create two configuration bundles, a catalog request bundle and an incidents submitted bundle.

1. Create an action definition.

   You can use the create and link related list.

1. Create view templates for requested items and associate with the view configuration.

   Here is the template info for the Requested Items Template:

   {
       "component": "now-card-evam-record",
       "staticValues": {
           "highlightedHeaderIcon": {
               "key": "clock-outline"
           },
           "highlightedHeaderBkgColor": {
               "key": "positive"
           },
           "imageType": {
               "key": "image"
           },
           "detailLabelOne": {
               "translatable": true,
               "key": "created"
           },
           "detailLabelTwo": {
               "translatable": true,
               "key": "number"
           }
       },
       "mappings": {
           "highlightedHeaderLabel": "state",
           "titleLabel": "cat_item.name",
           "imageURL": "cat_item.picture",
           "subtitle": "cat_item.short_description",
           "detailValueOne": "sys_created_on",
           "detailValueTwo": "number"
       },
       "actionMappings": {
           "clickAction": "navigation"
       }
   }
   

2. Repeat steps 3-5 to add another view configuration for closed requests.

   You created a configuration bundle with one view configuration. Add another configuration called Closed requests. This view configuration references the same data source [requested item], but uses different conditions to show ().

3. Associate view templates to view configurations, select Update.

4. View your finished product.