Migrate customizations and enable cart layouts

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read

    • Move customization to cart layout widgets, and then enable cart layouts.

    Before you begin

    Role required: admin

    About this task

    When you customize a few UI macros, you should migrate the customizations to cart layout widgets before you enable cart layouts.

    Following are the UI macros whose customizations need migration before you enable cart layouts:

    • sc_catalog_homepage_cart
    • sc_catalog_requested_for
    • catalog_item
    • catalog_cart_default
    • sc_cart_main

    In addition, if you have customized the com.glideapp.servicecatalog_category_view UI page, or the Catalog Cart dynamic content, you must migrate these customizations before you enable cart layouts.

    Procedure

    1. Save copies of the customizations for later reference.
    2. Revert the customizations to restore the customized macros or other content to their standard state.
    3. Remove the record for the customization from the Customer Update [sys_update_xml] table.
    4. Run the following script in Background Scripts to set the property and set the correct state for all the items in the catalog: 
      var cm = new CartLayoutMigration();cm.configureLayoutProperty();cm.setLayoutFalse();cm.setEmptyLayout();
    5. Reimplement any cart layout customizations that you want to maintain in the upgraded instance by configuring widget macros.
    6. To enable cart layouts, set the service catalog system property glide.sc.use_cart_layouts to Yes.