Playbook activity state-mapping rules

concept brazil Updated Sep 10, 2026 1 min read playbook-activity-state-mapping-rules.md
Raw file servicenow.com

Map playbook activity states to states from the given experience record.

[Omitted image "activity-state-mapping.gif"] Alt text: Changing how a Pending state is mapped from flow to playbook activity

Activity state-mapping rules are required for each Experience Status Table. These rules determine how to update the status for an experience record whenever a playbook user updates the state of an activity, such as when they complete an activity.

The out-of-the-box Global Playbook Experience includes default rules for the sys_flow_data and task tables. These sets of rules are enough for most playbook activities, but additional rules can be created for custom tables if needed.

Find the default mapping rules under the Status Mapping tab of a playbook experience.

[Omitted image "activity-status-mapping.png"] Alt text: Playbook Experience status mapping tab

Experience status mapping records

A Experience Status Mapping record pulls the states (Experience Status value) for the given Experience Status Table. Map from:

  • Experience Status to Activity State, or
  • Activity State to Experience Status.

The Experience Status to Activity State tab controls which activity state is shown in a card for a given experience status record value. The Activity State to Experience Status tab controls how the experience status record is updated when a playbook user updates an activity state, such as skipping an activity.

[Omitted image "activity-state-mapping-flow-exp2act.png"] Alt text: Mapping from flow states to playbook activity states

[Omitted image "activity-state-mapping-flow-act2exp.png"] Alt text: Mapping from playbook activity states to flow states

Note: There is always a default set of activity states, but the set of states for an experience record depends on the table in your activity definition.

[Omitted image "activity-state-mapping-task-exp2act.png"] Alt text: Mapping from task status values to playbook activity states

[Omitted image "activity-state-mapping-act2exp.png"] Alt text: Mapping from playbook activity states to task status values

Note: The number values shown indicate these task statuses:

[Omitted image "activity-state-mapping-task-values.png"] Alt text: Task status values

Default playbook activity states will always be set.

[Omitted image "activity-state-mapping-card.png"] Alt text: Default activity states in a drop-down for the Activity Card Value field

Parent Topic:Playbook activity state mapping

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