1. Modeling
  2. Model actions
  3. Copy branch action
  4. Set up a copy branch action

As a workspace administrator, you can set up a copy branch action. With this action, users can copy an item and its children to the same parent item or a different parent item within the same model. The action copies all associated data across all modules and list properties in the model.

You can also configure the action to open another dashboard at the same time. For example, a dashboard that enables users to enter additional information against the copied items.

Requirements

Only workspace administrators can set up copy branch actions.

Before you set up the action, ensure the list you want to copy:

If the list has a child list, ensure this is also a numbered list.

The parent list and the list with which you format the list-format property can be hierarchical lists or numbered lists. However, they cannot be the Users list.

Filter properties

You can enable users to filter items in the parent list when they run the action. This is useful if the parent list is very long. To do this, you must create list properties with the list format against the parent list before you create the action.

Filter by ancestor always displays as an option, but you must assign a parent (ancestor) list to the Parent Hierarchy to enable users to filter by parent.

Prepare a dashboard or dashboards

You can only run Copy branch from a dashboard. This is because the user must select the branch to copy before they run the action.

Publish a list that displays the uppermost items in the branches you want to copy to a dashboard. This can be an existing dashboard or a new one. After you create the action, you can publish it as a button to the same dashboard.

If you want the Copy branch action to open a new dashboard when it copies the items, you must first create the dashboard that you want the action to open.

If you want to enable Prompt to show all/recently created only for the action, ensure the module view you publish to the dashboard has the list that includes the new items on rows or columns. The prompt does not display if you pivot the list to be on pages.

Set up a copy branch action

To set up a copy branch action:

  1. In the Actions tab of the Actions pane, select New Action from the toolbar at the top. 
  2. Select Copy Branch from the menu.
  3. Enter the button name in the Button text field.
    Follow best practice naming conventions to ensure the action is easy to identify.
  4. In the Copy from dropdown, select the list from which you want to select a branch to copy.
    Only numbered lists are available to select.
  5. In the Level to copy dropdown, select:
    • All levels to copy the item the user selects, all its descendants, and all associated data.
    • Immediate children only to copy only the item the user selects and its immediate children.
  6. Select the dashboard you want the action to open from the Default Dashboard to open dropdown.
  7. Optionally, select the checkbox for Prompt to show all/ recently created only.
  8. Optionally, select list item properties you want to act as filters from the Filter using drop-down list.
  9. Select OK.

You can then publish the action to a dashboard

Disclaimer

We may update our documentation occasionally, but will only do so in a way that does not negatively affect the features and functionality of the Anaplan service.