The Copy branch action allows you to duplicate an item and its data, within the same parent item or across different parent items. This action copies the selected item and its children, making sure all related data is replicated.

When using the copy branch action, all data associated with the item, including data from different modules and list properties in the model, is copied. It enables many-to-many copying. This means you can select multiple branches within a list hierarchy and select multiple parent items under which to copy the branch data.

You must be a workspace administrator to set up a Copy branch action. However, any user with write access to the child and parent lists can run the action from a dashboard.

When you set up a Copy branch action, you must ensure that the list you copy with the action is a numbered list and has a parent hierarchy.

If the list has a child list, this must also be a numbered list. However, you can also use Copy branch to copy items in lists that don't have child lists.

You can configure the Copy branch action to copy the selected parent item along with either:

  • All descendent items, down to the lowest level, and their related data.
  • The immediate children of the selected item or items, and their related data.

You can configure a Copy branch action to copy items from a flat list. However, the action only copies the item or items the user selects in that list.

You can also configure:

  • A target dashboard for the action to open when users run the action.
  • A prompt to enable users to restrict data on the target dashboard.
  • List filters, so users can filter the list they want to copy based on properties of the parent list.

Parent list properties must have the list format for you to use them as filters.

The Marketing Manager for a shoe company wants to manage promotions across Marketing, Sales, and Production. They must ensure enough production to meet the demand generated by their marketing promotions, and that enough sales reps are assigned to support the promotion. They need to copy a promotion, and the products it promotes, from one organizational unit to another.

To meet this need, a workspace administrator:

  • Creates a composite hierarchy: Organization > #Promotions > #Products. Organization contains the items Product, Marketing, and Sales.
  • Creates standard lists for Promotions and Products, and formats a list property for #Promotions with the list Promotions. This property can be used as the display name for the numbered list.
  • Creates a similar property for #Products, and formats the property with the list Products, so this can be the display name for #Products.

This means that unique numbered items on the numbered lists can have the same display name. For example, items #1 and #4 in Promotions can both have the display name Super Sandals

The Workspace Administrator can assign the products the manager wants to promote as children of the Super Sandals promotion, and assign Super Sandals as the child of Marketing. Then set up a Copy branch action to copy all levels from #Promotions. They can create a Sales dashboard as the default dashboard to open, so the manager can move directly to assign sales reps to the promotion.

The Workspace Administrator can then publish the action to a dashboard as a button, along with the #Promotions list. The Marketing Manager can select any promotion in #Promotions and then the Copy branch button. The action launches the Copy branch dialog, and they can select which item or items in Organization to copy the promotion to. When they select OK, the Sales dashboard displays. The promotion and its children are copied as a branch under the parents the manager selected. They can assign sales reps to the promotion.