List categories and modules migration from ITSM Agent Workspace to Service Operations Workspace for ITSM

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 9분

    • 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.

    Associated system property

    If ITSM Agent Workspace contains list modules that use group-based list applicabilities, then only enable the glide.ux.user_criteria_enabled property mentioned in the System Property [sys_properties] table.

    How the migration utility identifies list categories and modules for migration

    The Migration utility for SOW identifies the list categories and modules to migrate based on the type of migration.

    Mapping list categories and modules

    The migration utility maintains a mapping between base system ITSM Agent Workspace list categories and list modules and their corresponding records in the Service Operations Workspace. It identifies the mapping by checking the tables, conditions, and intuitiveness in names for similarity.

    Migration criteria
    The migration utility uses different fields and values depending on the type of migration (list categories, list modules, list layout, list applicabilities, and list attributes).
    • List categories using the Workspace List Category [sys_aw_list_category] and UX List Category [sys_ux_list_category] table records.
    • List items and modules within each category using the Workspace List [sys_aw_list] and UX List [sys_ux_list] table records.
    • Columnar layout of list modules
    • List applicabilities
    • List attributes

    How the migration works

    The migration utility uses different fields, values, and migration steps depending on the type of migration. All these actions are done by the utility.

    Mapping and verification
    1. Creates and verifies a comprehensive mapping between ITSM Agent Workspace list categories or modules and Service Operations Workspace list categories or modules.
    2. Verifies the mapping based on table, conditions, and intuitiveness in the name of the base system list categories and modules in ITSM Agent Workspace and Service Operations Workspace.
    Migrating list categories
    1. Iterates over the Workspace List Category [sys_aw_list_category] table with filter condition of workspace = Agent Workspace.
    2. Check for the mapping between ITSM Agent Workspace and Service Operations Workspace for each list item.
    3. If a mapping is found, update the list categories by copying the following fields from the current ITSM Agent Workspace Workspace List Category [sys_aw_list_category] table record to the mapped Service Operations Workspace UX List Category [sys_ux_list_category] table record:
      • active
      • description
      • order
      • active
    4. If a mapping isn’t found, createss a record in the UX List Category [sys_ux_list_category] table.

      If the mapping isn’t found, it means that the specified category exists in ITSM Agent Workspace but the category is missing in Service Operations Workspace (new category created by the user).

    Migrating list items or modules for each category
    1. Iterates over the Workspace List [sys_aw_list] table with the filter condition of the current list item or module and workspace = Agent Workspace.
    2. Checks for the mapping between ITSM Agent Workspace and Service Operations Workspace for each list item.
    3. If a mapping is found, updates the list items by copying the following fields from the current ITSM Agent Workspace Workspace List [sys_aw_list] record to the mapped Service Operations Workspace UX List [sys_ux_list] record:
      • title
      • order
      • active
      • condition
    4. If a mapping isn’t found, creates a record in the UX List [sys_ux_list] table.

      If the mapping isn’t found, it means that the list item exists in ITSM Agent Workspace, but the list item is missing in Service Operations Workspace. For such cases, the migration utility creates a record in the UX List [sys_ux_list] table by setting the following fields from the current ITSM Agent Workspace list record and (category = current iterating category, configuration = Default – SOW, and view = sow):

      • title
      • order
      • active
      • condition
    5. Performs the following migration after the list item is migrated (if the mapping is found) or created (if the mapping isn’t found):
      1. Migrates list applicability for the migrated or created list item:
        1. Creates a list applicability using the List Applicability [sys_ux_applicability_m2m_list] table and user criteria (if groups are specified in the list item) with the corresponding ITSM Agent Workspace list module, roles, and groups.
        2. Attaches this newly created list applicability with the migrated or created Service Operations Workspace list item.

        The migration utility doesn’t delete any existing list applicability associated with the migrated list.

      2. Migrates columnar layout for migrated or created list item:
        1. Unifies the columnar layout in Service Operations Workspace based on the layout of the list module with a lower-order list item in the specified ITSM Agent Workspace table.
        2. Search for records with the following conditions in the List [sys_ui_list] table for setting columnar layout in Service Operations Workspace:
          • conditions = table (with which this list item is associated)
          • parent list =null

          For this record, the migration utility updates the List Element [sys_ui_list_element] table to insert or update the correct order and columns.

      3. Migrates list attributes for migrated or created list items:

        ITSM Agent Workspace uses Omit Count and Disable Highlighted Values list attributes. These attributes are associated with the Workspace List Attribute [sys_aw_list_attribute] table. For the current list item record, the migration utility:

        1. Iterates over the Workspace List Attribute [sys_aw_list_attribute_list] table to identify list attributes that are associated with the specified record.
        2. Sets the corresponding attributes in the UX List [sys_ux_list] table.