Ribbons migration from ITSM Agent Workspace to Service Operations Workspace for ITSM

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

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

    Tables used for migration

    Table name Description
    Ribbon Setting [sys_aw_ribbon_setting] Contains all ribbon settings.
    UX Ribbon Configuration [sys_ux_ribbon_config] Contains the ribbon configuration that is mapped to a configurable workspace. The migration utility uses the Service Operations Workspace ribbon configuration.
    Ribbon Configuration Setting [sys_ux_ribbon_config_setting] Contains mapping information between the Ribbon Setting [sys_aw_ribbon_setting] and the UX Ribbon Configuration [sys_ux_ribbon_config] table records. This information helps define and identify ribbon settings that are applicable for the specified workspace.

    Limitation

    • The combined width of the ribbon widgets must be equal to or lower than 12 for the specified table and ribbon configuration.
    • A record can’t be created when:
      • The ribbon widgets are already configured for the specified table and ribbon configuration.
      • The width of the ribbon setting that is being mapped with the ribbon configuration plus the widths of the existing ribbon settings that are mapped to the same ribbon configuration is greater than 12.

    How the migration utility identifies ribbons for migration

    The migration utility searches all ribbon settings for which workspace is set to ITSM Agent Workspace in the Ribbon Setting [sys_aw_ribbon_setting] table. These ribbon settings are candidates for migration.

    How the migration works

    The Service Operations Workspace migration utility uses the following sequence to migrate ribbons from ITSM Agent Workspace to Service Operations Workspace for ITSM. All these actions are done by the utility.
    1. Calculates the total width of existing ribbons that are mapped to Service Operations Workspace Ribbon Config plus ITSM Agent Workspace ribbons that must be migrated.
    2. If the sum of widths is greater than 12, disables all existing ribbons that are mapped to the Service Operations Workspace ribbon configuration.
      Note:
      All ITSM Agent Workspace ribbons are migrated. The aim of the ITSM Agent Workspace migration utility is to prioritize migrating items from ITSM Agent Workspace to Service Operations Workspace for ITSM and so this trade-off is acceptable.
    3. Creates a mapping between filtered ribbon settings and Service Operations Workspace ribbon configuration in the Ribbon Configuration Setting [sys_ux_ribbon_config_setting] table.