--- sourceDocument: Australia IT Service Management sourceDocumentLink: https://www.servicenow.com/docs/r/australia/it-service-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Migration of UI actions and layouts from ITSM Agent Workspace to Service Operations Workspace for ITSM # Migration of UI actions and layouts from ITSM Agent Workspace to Service Operations Workspace for ITSM {#ariaid-title1} Release version: Australia Updated January 30, 2025 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Migration of UI actions and layouts from ITSM Agent Workspace to Service Operations Workspace for ITSM This migration process enables ServiceNow customers to transition UI actions and layouts from the ITSM Agent Workspace to the Service Operations Workspace (SOW) for ITSM. It involves identifying required tables, eligible UI actions and layout records, and using a migration utility that automates the transfer while preserving groupings and configurations. This migration ensures continuity and consistency of UI elements in the new workspace environment. Show full answer Show less ## Key Features * **UI Actions and Layouts:** UI actions appear as form buttons or list menu items, grouped under layouts that act as containers. * **Tables Involved:** * **sysuiaction:** Stores UI actions and layout configurations. * **sysawformuiactionlayout:** Contains records representing UI action groups eligible for migration. * Additional mapping tables like **sysuxformaction** , **sysuxformactionlayoutitem** , and **sysuxformactionlayout** are used to identify and map UI actions during migration. * **Migration Utility Process:** * Identifies UI Action Layout records mapped to UI Action Groups. * Maps or creates corresponding UX Form Actions Layout Group records. * Handles layout migration by linking or creating necessary mapping records between UI Action Groups and UX Form Action Layout Groups. * Migrates input tables, creating or mapping UX Form Actions Layout records as needed. * Groups UI actions only if a corresponding UX Form Actions Layout record is found; otherwise, UI actions appear ungrouped. * Checks for unified UX Form Actions Layout records and processes migration accordingly. * Creates missing mapping records in the **sysuxm2mactionlayoutitem** table when necessary. ## Post-Migration Tasks After migration, verify that UI actions and layouts in the Service Operations Workspace match those in the ITSM Agent Workspace and are ready for use. Customers can update the migrated UI actions and layout settings in the Service Operations Workspace to fit their specific operational needs. ## Additional Considerations The migration process is part of a broader set of migrations that include ribbons, view rules, new record menu items, highlighted fields, list actions, list categories, form headers, search configurations, Agent Assist, related list declarative actions, and field decorators---all from ITSM Agent Workspace to Service Operations Workspace for ITSM. Migration from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying the eligible UI actions and layout records for migrations, and the migration process. ## UI actions {#ui-actions-layouts-migration-itsm-aw-sow__section_mgd_bb3_ccc} UI actions appear either as form buttons or as list items in the UI action menu. The form header shows a group of UI actions under a single menu button or a split button. To group UI actions, a layout is required, which acts as a container to the group. ## Tables used for migration {#ui-actions-layouts-migration-itsm-aw-sow__section_iz2_fb3_ccc} {#ui-actions-layouts-migration-itsm-aw-sow__table_edl_3b3_ccc__entry__2} | Table name | Description | |-|-| | UI Action \[sys_ui_action\] | Contains UI action and layouts configurations to migrate. | | UI Action Layout \[sys_aw_form_uiaction_layout\] | Contains a set of records (base system or custom) associated with the agent workspace. The migration utility considers these records as eligible for migration. All the group UI actions specified in such UI Action Layout \[sys_aw_form_uiaction_layout\] record are migrated. | [ ] {#ui-actions-layouts-migration-itsm-aw-sow__table_edl_3b3_ccc} ## How the migration utility identifies UI actions and layouts for migration {#ui-actions-layouts-migration-itsm-aw-sow__section_gmw_nb3_ccc} The Service Operations Workspace migration utility identifies the eligible set of UI actions to migrate based on the following: * UI Action \[sys_ui_action\] table records that are mapped to the UX Form Actions \[sys_ux_form_action\] table records. * UX Form Actions Layout Item \[sys_ux_form_action_layout_item\] table records that are mapped to UX Form Actions \[sys_ux_form_action\] table records. * UX Form Actions Layout \[sys_ux_form_action_layout\] table records that are mapped to the input table. {#ui-actions-layouts-migration-itsm-aw-sow__ul_tcs_hsg_2cc} ## How the migration works {#ui-actions-layouts-migration-itsm-aw-sow__section_emh_j23_ccc} The Service Operations Workspace migration utility uses the following sequence to migrate the UI actions from ITSM Agent Workspace to Service Operations Workspace for ITSM. All these actions are done by the utility. 1. Searches for UI Action Layout \[sys_aw_form_uiaction_layout\] table records that are mapped to UI Action Group \[sys_aw_form_uiaction_group\] records. 2. Searches for UX Form Actions Layout Group \[sys_ux_form_action_layout_group\] table records that are mapped to UI Action Layout \[sys_aw_form_uiaction_layout\] table records. The set of UI actions and the type of grouping must be the same for these records. 3. If a record isn't found, creates a UX Form Actions Layout Group \[sys_ux_form_action_layout_group\] table record. {#ui-actions-layouts-migration-itsm-aw-sow__ol_ksy_l23_ccc} The Service Operations Workspace migration utility uses the following sequence to migrate the layouts from ITSM Agent Workspace to Service Operations Workspace for ITSM. All these actions are done by the system. 1. Searches for UI Action Group \[sys_aw_form_uiaction_group\] table records that are mapped to UX Form Actions Layout Group \[sys_ux_form_action_layout_group\] table records. 2. If a record isn't found, creates a UX Form Actions Layout Group \[sys_ux_form_action_layout_group\] table record and maps it to the UI Action Group \[sys_aw_form_uiaction_group\] table record. {#ui-actions-layouts-migration-itsm-aw-sow__ol_bhr_yg3_ccc} The Service Operations Workspace migration utility uses the following sequence to migrate input tables from ITSM Agent Workspace to Service Operations Workspace for ITSM. All these actions are done by the system. 1. Searches for a UX Form Actions Layout \[sys_ux_form_action_layout\] table record. 2. If a UX Form Actions Layout \[sys_ux_form_action_layout\] table record isn't found, completes the migration and shows grouped UI actions in the record page as ungrouped UI actions. Note: UI actions are grouped only if a UX Form Actions Layout \[sys_ux_form_action_layout\] table record is found. 3. If a record is found, performs the migration using the following sequence: 1. Checks if the UX Form Actions Layout \[sys_ux_form_action_layout\] table record is unified.For unified records, the use_layout_items_only field is selected. 2. Completes the migration if the record isn't unified. 3. Searches for Sys Ux M2m Action Layout Item \[sys_ux_m2m_action_layout_item\] table records that are mapped to the UX Form Actions Layout \[sys_ux_form_action_layout\] table record. 4. If a mapped record isn't found, creates a Sys Ux M2m Action Layout Item \[sys_ux_m2m_action_layout_item\] table record. {#ui-actions-layouts-migration-itsm-aw-sow__ol_k15_jh3_ccc} {#ui-actions-layouts-migration-itsm-aw-sow__ol_mcv_2h3_ccc} * **[Perform post-migration tasks for UI actions and layouts](https://www.servicenow.com/docs/2IKfRhwJaDzcZfOzc9F6pw)** Verify that the UI actions and layouts in Service Operations Workspace (SOW) are consistent with UI actions and layouts in ITSM Agent Workspace (ITSM AW) and are ready for use in SOW. You can update the migrated UI actions and layouts settings in SOW based on your requirements. **Related reference** * [Ribbons migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/oDKnXNFnxP~n2KRdqKL1HQ "Migration of the ribbons from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying ribbons records for migration, and the migration process.") * [Migration of view rules from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/auh80L5XsyXmO9LIUql2hQ "Migration of view rules from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying the view rules for migrations, and the migration process.") * [New record menu items migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/O0rHJ4_5Gmkr9LoqHREfqA "Migration of the new record menu items from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying new record menu items for migrations, and the migration process.") * [Migration of highlighted fields in lists and forms from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/whYNjUgAzdzDldsh5DHitQ "Migration of the highlighted fields in lists and forms from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the required tables, identifying eligible highlighted field records for migrations, and the migration process.") * [List actions migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/vPxAgI640M2hXeV6yrTIkg "Migration of the list actions from ITSM Agent Workspace to Service Operations Workspace for ITSM includes identifying the tables and the migration process.") * [List categories and modules migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/8AyVuNGsZoGkOg_Bk5QtyQ "Migration from ITSM Agent Workspace to Service Operations Workspace (SOW) for ITSM includes identifying the required tables, highlighted field records for migrations, and the migration process.") * [Migration of form headers from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/zjk88B4f1GP~gtGJtigbhA "Migration of the form headers from ITSM Agent Workspace to Service Operations Workspace (SOW) include identifying the required tables, eligible form header records for migrations and the migration process. Form headers provide an overview of the record.") * [Migration of search configurations from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/dNvwVAHJS5nXWf0cxoDslw "Migration of the search configuration from ITSM Agent Workspace to Service Operations Workspace (SOW) include identifying the eligible form header records and the migration process.") * [Migration of Agent assist from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/rO93nSkRs_8unOaTwzCZZA "Migration of the Agent assist from ITSM Agent Workspace to Service Operations Workspace (SOW) include identifying the required tables, eligible form header records for migrations and the migrations process.") * [Migration of Related list declarative actions from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/Q4z2YCkLcfE1rPokGE3Cwg "Migration of the related list declarative actions from ITSM Agent Workspace to Service Operations Workspace that includes identifying the tables and the migration process.") * [Migration of field decorators from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://www.servicenow.com/docs/CV_AbBGYpgr~ezEp3qXjpw "Migration of the field decorators actions from ITSM Agent Workspace to Service Operations Workspace that includes identifying the tables and the migration process.")