Define event mappings for Work scheduler

task brazil Updated Sep 10, 2026 2 min read work-sched-event-mapping.md
Raw file servicenow.com

Add event mappings required for card interactions and for the card properties transformation to the page configurations in Work scheduler.

Before you begin

Important: Starting with the Brazil release, Workforce Optimization for ITSM is being prepared for future deprecation. It will be hidden and no longer installed on new instances but will continue to be supported. For details, see the Deprecation Process [KB0867184] article in the Now Support Knowledge Base.

Role required: workspace_admin or ui_builder_admin​

Procedure

  1. In the Page configuration section, select the Events tab.

  2. Attach the Transform workItem to cardProps to the Page ready event.

    1. In the Page ready menu, select +Add a new event handler.

    2. In the pop-up screen, go the Scripts section and select Transform workItem to cardProps.

    3. Select Add.

  3. Attach the Transform workItem to cardProps to the Page ready event.

    1. In the Page ready menu, select +Add a new event handler.

    2. In the pop-up screen, go the Scripts section and select Transform workItem to cardProps.

    3. Select Add.

  4. Attach the Transform workItem to cardProps to the Page property changed event.

    1. In the Page property changed menu, select +Add a new event handler.

    2. In the pop-up screen, go the Scripts section and select Transform workItem to cardProps.

    3. Select Add.

  5. Attach the CARD_CLICKED and CARD_CLICKED (Work item cards) events.

    The Create an event popup screen displays.

To Attach

Do this

The CARD_CLICKED event

  1. In the Dispatched events section, select +Add.
  2. In the Event label field, enter CARD_CLICKED.
  3. From the Target parent event handler menu, select CARD_CLICKED (Work item cards)
  4. Click Add.

The CARD_ACTION_CLICKED (Work item cards) event

  1. In the Dispatched events section, select +Add.
  2. In the Event label field, enter CARD_ACTION_CLICKED.
  3. From the Target parent event handler menu, select CARD_ACTION_CLICKED (Work item cards)
  4. Click Add.
Here's a demo on how to define event mappings for the Work scheduler.

What to do next

Configure container components for Work scheduler

Parent Topic:Create a Work scheduler card using the Next Experience UI Builder

Previous topic:Define the workItem property in the Work scheduler page configuration

Next topic:Configure container components for Work scheduler

Related topics

Events in UI Builder

Search documentation
Search document titles and file paths on the brazil branch