Versions Compared

Old Version 12

changes.mady.by.user Documenter

Saved on

compared with

New Version Current

changes.mady.by.user Documenter

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info
titleWant this feature?

Content Deploy is a Commerce Vision multisite feature. Category data can only be deployed with Online Category Maintenance mode.

Requires 4.38+.

Overview

For multisite control, deploying site CMS Administrator and Content Administrator roles can publish specific online-maintained category data to valid linked sites. NOTE - This data is not lockable. Content managers of destination sites can always rollback your changes or make further edits

This is part of the CV ecommerce multisite content management feature. Learn more: multisite content management

Overview

You can only deploy category re-structure and changes to a top level category down if its category code already pre-exists on the target site.

Image Added 

Use case: CV Franchise HQ has added new product sub-categories to a pre-existing top level category. They want their changes to be distributed to all franchisee sites. Franchisee sites will be able to alter the deployed category details should they want to localise to suit. 


Quick Guide

Source site feature setting: Deploy Content enabled. 

Target site feature setting: none 

Lockable content type: no. Deployed category details can be edited and deleted on target sites.

Deployable content type: yes. 

What can be deployed?

  • category banners
  • category tree structures (excluding products)
  • category hierarchy of products
  • category details
  • category SEO details
    • custom fields for categories       

    * all or part of a category's structure that can be edited online, including subcategories and its products (not product details), SEO URL, meta-data, banner, custom fields. ERP-integrated data cannot be deployed.

    *Also dependent on Category Maintenance Mode on source and target sites. See below.

    Deployment notes: To deploy all deployable data types, Online Category Maintenance mode must be set on both source and target sites. Top level (parent) category code must pre-exist on a target site. Products with product codes not on a target site will not be deployed.

    Other checks: a product must already exist on target site or else, will not be added as a category product in the deployment.   

                         

     



    Panel

    On this page:

    Table of Contents

    Step-by-step guide

    1. Enable Category Deploy

    In the CMS, go to Settings → Settings → Feature Management → Content → Linked Sites.
    Ensure Linked Sites is enabled, then click Configure.
    Image Removed
    In Deployment, toggle ON deploy for Category Maintenance.
    Image Removed
  • Click Save or Save & Exit. 

    • 2. Deploy category changes

    This step assumes you have category data ready to deploy. Deployable data for a category are from Category Maintenance in Online mode. 


    Category Data

    Category Maintenance Mode


    Info
    titleCheck Category Maintenance mode

    source site: online mode / target site: online mode

    • deploy category data from a single or multiple categories in one go
    • can deploy all deployable data

    source site: Integrated mode / target site: Integrated mode

    • deploy a single category's data at a time; cannot deploy multiple categories
    • cannot deploy category hierarchy (tree structure) data

    Source site: online mode / target site: Integrated mode

    • deployment will fail. The Content Deployment Log will display this error message:
      Image Added


    Warning

    A top-level category must already exist on the destination site, otherwise category content deployment will fail. New top level categories (Category Codes) cannot be deployed.

    Only online maintained category data types can be deployed. You can select to deploy one or more category data types: 

    • category image, deletion of category image
    • category banner, including image
    • category tree structure (excluding products)
    • category product hierarchy 
    • category products
    • category details
    • category SEO details
    • category custom fields       


    Deploy Category Data


    To deploy category data:

    1. Go to E-commerceEcommerce → Products & Categories → Category Maintenance.
      Image Removed
       Do you want to deploy data from multiple categories or Image Added
    2.  Deploy a single category or multiple categories?
      Image Removed
      NOTE - The multiple category option is only available when a source site is in Online Mode.
      1. Online mode: Multiple categories - click Deploy at on the top right of the page, select Deploy the button. Single category - find the category, hover over its Options, then click select Deploy.
      Follow the steps in the Deploy modal: 
      Expand
      titleClick here to view all steps...
      1. Toggle ON the
      1. Image Added
      2. Integrated mode: Single category only - find the category, then click Edit next to it. In the Maintain Category page, hover over the Options button, then select Deploy.Image Added

    3. In the Deploy popup, toggle to select the data type(s) to deploy. If the source site is in Integrated Maintenance mode, category hierarchy data cannot be selected.

      2. Toggle ON a category to deploy. If you're deploying multiple categories, toggle ON each one or Select All.

      3. Click Next.

      4. Toggle ON a linked site(s) to deploy to.

      5. Click Next.

      6. Check deploy data and details Image Added

    4. Toggle to select each category.  
      Image Added

    5. Click Next.

    6. Toggle to select one or more target sites.
      Image Added

    7. Click Next.

    8. Check the data and site selections are correct, then click Deploy. 
      Image RemovedImage Added

    9. Image Removed

      Image Removed

      In the next modal window, check whether deployment was successful or failed,

      Tip

      Think of the deployment process as completing one or more deployment instances.

      • In a deployment instance, changes in selected data type(s) and items are copied over to one destination site.
      • For a successful deployment instance, all changes must be successfully deployed to a destination site. If one change fails to deploy, the whole deployment instance will fail. No changes will be copied over to this site.
      • If you selected multiple destination sites, you are initiating multiple deployment instances. 
      Successful deployments - the progress bar reaches step 4 'Results' and has a 'Successful' message. You can also click the link (2) to see the deployment details.   
      Image Removed 
      Unsuccessful deployments - the progress bar remains at step 3 'Summary' and the failed message is displayed. Review this deployment's data and details for issues before trying again. 
      Image Removed

     

    Additional Information

    Multiexcerpt
    hiddentrue
    MultiExcerptNameFeature Title

    --

    Minimum Version Requirements
    Multiexcerpt
    MultiExcerptNameMinimum Version Requirements

    4.38

    Prerequisites
    Multiexcerpt
    MultiExcerptNamePre reqs

    Multisite Functions enabled

    Self Configurable
    Multiexcerpt
    MultiExcerptNameSelf Configurable

    No

    Business Function
    Multiexcerpt
    MultiExcerptNameBusiness Function

    Content

    BPD Only?
    Multiexcerpt
    MultiExcerptNameBPD Only

    Yes

    B2B/B2C/Both
    Multiexcerpt
    MultiExcerptNameB2B/B2C/Both

    Both

    Third Party Costs
    Multiexcerpt
    MultiExcerptNameThird Party Costs
    n/a

    Related help

    1. final step, click the link to check deployment results,

      Image Added


    2. For deployment to more than one site, scroll down to check deployment for each target site. Click More Information to view error messages logged for the specific target site deployment. 
      Image Added

    Troubleshooting Category Deployment

    Category Not Displaying a Product

    A deployment will only add a product to a deployed category if the product code exists on the target site. If the code is not found, this particular product is omitted. The deployment will still be flagged as successful.

    Solution: Before deployment, check that products and their codes are available on a target site.  

    Category Maintenance Mode Not the Same

    Category Maintenance mode on target site has been set to Integrated mode and cannot receive the data from the source site. Solution: change mode on target site to Online mode. If this cannot be done, Category Deployment cannot be used.

    Image Added 


    Enable Deploy Category (Admin) 

    1. In the CMS, go to Settings → Settings → Feature Management → Content → Deploy Content.

    2. Ensure Deploy Content is enabled, then click Configure.
      Image Added

    3. In Deployment, toggle ON deploy for Category Maintenance.
      Image Added

    4. Click Save or Save & Exit. 


    Related Resources

    Content by Label
    showLabelsfalse
    showSpacefalse
    excludeCurrenttrue
    cqllabel = "multi-site" and title ~ "'Deploy Content'"

    Content by Label
    showLabelsfalse
    showSpacefalse
    excludeCurrenttrue
    cqllabel = "multi-sitecategory" and title ~ "'CMS Category Maintenance'"