Define event mappings for Work scheduler
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
-
In the Page configuration section, select the Events tab.
-
Attach the Transform workItem to cardProps to the Page ready event.
-
In the Page ready menu, select +Add a new event handler.
-
In the pop-up screen, go the Scripts section and select Transform workItem to cardProps.
-
Select Add.
-
-
Attach the Transform workItem to cardProps to the Page ready event.
-
In the Page ready menu, select +Add a new event handler.
-
In the pop-up screen, go the Scripts section and select Transform workItem to cardProps.
-
Select Add.
-
-
Attach the Transform workItem to cardProps to the Page property changed event.
-
In the Page property changed menu, select +Add a new event handler.
-
In the pop-up screen, go the Scripts section and select Transform workItem to cardProps.
-
Select Add.
-
-
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 |
|
|
The CARD_ACTION_CLICKED (Work item cards) event |
|
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
---
title: Define event mappings for Work scheduler
description: Add event mappings required for card interactions and for the card properties transformation to the page configurations in Work scheduler.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-service-management/workforce-optimization-for-it-service-management/work-sched-event-mapping.html
release: brazil
product: Workforce Optimization for IT Service Management
classification: workforce-optimization-for-it-service-management
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Create a Work scheduler card using the Next Experience UI Builder, Setting up, Work scheduler, Workforce Optimization for ITSM, IT Service Management]
---
# Define event mappings for Work scheduler
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\]](https://support.servicenow.com/kb_view.do?sysparm_article=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.
<table id="choicetable_c2r_hgm_ntb"><thead><tr><th align="left" id="d244656e232">
To Attach
</th><th align="left" id="d244656e235">
Do this
</th></tr></thead><tbody><tr><td id="d244656e241">
**The __CARD\_CLICKED__ event**
</td><td>
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**.
</td></tr><tr><td id="d244656e288">
**The __CARD\_ACTION\_CLICKED \(Work item cards\)__ event**
</td><td>
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**.
</td></tr></tbody>
</table> Here's a demo on how to define event mappings for the Work scheduler.
## What to do next
[Configure container components for Work scheduler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/work-sched-card-based-container.md)
**Parent Topic:**[Create a Work scheduler card using the Next Experience UI Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/create-workscheduler-card-wfo-itsm.md)
**Previous topic:**[Define the workItem property in the Work scheduler page configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/work-sched-create-page-properties.md)
**Next topic:**[Configure container components for Work scheduler](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/workforce-optimization-for-it-service-management/work-sched-card-based-container.md)
**Related topics**
[Events in UI Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/work-events.md)
| title | Define event mappings for Work scheduler |
| description | Add event mappings required for card interactions and for the card properties transformation to the page configurations in Work scheduler. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/it-service-management/workforce-optimization-for-it-service-management/work-sched-event-mapping.html |
| release | brazil |
| product | Workforce Optimization for IT Service Management |
| classification | workforce-optimization-for-it-service-management |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Create a Work scheduler card using the Next Experience UI BuilderSetting upWork schedulerWorkforce Optimization for ITSMIT Service Management |