---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/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 search configurations from ITSM Agent Workspace to Service Operations Workspace for ITSM

# Migration of search configurations from ITSM Agent Workspace to Service Operations Workspace for ITSM {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read  
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.

## How the migration utility identifies search configuration for migration {#search-config-migration-itsm-aw-sow__section_gt5_jnj_dcc}

The migration utility in SOW identifies the eligible set of search configuration records to be migrated based on the following sequence:

1. Filters the application search sources records (sys_search_source) that are mapped to ITSM Agent Workspace master config record using the m2m_search_context_config_search_source table.
2. Checks the application search sources that are mapped to SOW context config record.
3. Searches each filtered record that are mapped to ITSM Agent Workspace master config record and checks if that record is not mapped to SOW context config record to identify the search sources which are unique to ITSM Agent Workspace only and not mapped to SOW context config record.
4. For all those unique search records that are mapped to ITSM Agent Workspace, the SOW migration utility creates similar mapping to SOW context config record at m2m_search_context_config_search_source table.
5. If common search sources mapped between ITSM Agent Workspace and SOW are found and the order of the mapping is differed in SOW from ITSM Agent Workspace, the SOW migration utility updates the order from ITSM Agent Workspace mapping to SOW mapping.
6. Migrates the values of ITSM Agent Workspace search view config record to SOW search view config record.
7. When both the search view config and the search sources are mapped to SOW from ITSM Agent Workspace, the SOW migration utility updates the globalSearchDataConfigIdSOW page property to reflect SOW context config record available in the base system.
{#search-config-migration-itsm-aw-sow__ol_xmz_nnj_dcc}

## How the migration works {#search-config-migration-itsm-aw-sow__section_s4z_14j_dcc}

The SOW migration utility uses the following sequence to migrate the search configuration records from ITSM Agent Workspace to SOW:

1. Searches the reference record for Global Search Data Config and Global Search View Config using the sys_aw_master_config table in ITSM Agent Workspace.
2. Determines the Search engine type in the Global Search Data Config record. If the search engine is zing then migration proceeds. Else, the migration process stops.
3. Using the Global Search Data Config record, a query is run on the Application Search Sources (m2m_search_context_config_search_source) table to retrieve all the search sources.
4. Using the SOW search context config available in the base system, a query is executed on the Application Search Sources (m2m_search_context_config_search_source) table to retrieve all the search sources.The SOW
   search context config exists as a record in the sys_search_context_config table and sys_id can be found at SOW page property called globalSearchDataConfigId.

5. Compares between the search sources by executing a query on the Application Search Sources (m2m_search_context_config_search_source) table using Global Search Data Config record (ITSM Agent Workspace search sources) and SOW search context config record (SOW search sources), to find unique search sources mapped to ITSM Agent Workspace but not SOW.
6. If the order value of a SOW search source is different than the order value of the ITSM Agent Workspace search source at the Application Search Sources table, the SOW migration utility updates the SOW search source with the same order value as in mapped in ITSM Agent Workspace.
7. Creates record in the Application Search Sources (m2m_search_context_config_search_source) table with SOW context config record that is available in the base system and searches the unique sources that are found by comparing the ITSM Agent Workspace search sources and SOW search sources.
8. Opens the Global Search View Config reference record that is retrieved using the sys_aw_master_config table in ITSM Agent Workspace and copy all the values to SOW view config record (SOW page property with name global_search_configurations). The SOW view config record is available in the base system.
9. Updates the SOW page property globalSearchDataConfigId to have OOB SOW context config record.
{#search-config-migration-itsm-aw-sow__ol_apq_c4j_dcc}
* **[Perform post-migration tasks for search configurations](https://servicenow-prod.fluidtopics.net/~N6kwZxBpQtngtkH2T8DYw)**   
  Verify that the search configurations in Service Operations Workspace (SOW) are consistent with the search configurations in ITSM Agent Workspace (ITSM AW) and are ready for use in SOW. You can update the migrated search configurations settings in SOW based on your requirements.

**Related reference**   

* [Migration of UI actions and layouts from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/TG0dTdcaNVmz09a1BHGDVw "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.")
* [Ribbons migration from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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 Agent assist from ITSM Agent Workspace to Service Operations Workspace for ITSM](https://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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://servicenow-prod.fluidtopics.net/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.")

