How To Use Copy Group (DriveWorks Documentation)

How To Use Copy Group

The Copy Group task copies the selected data from the logged in Group to a new or existing Group.

This is useful for carrying out tasks such as moving your implementations from a Development environment to a Production one. It can also be used to backup and restore old versions of your implementations.

Follow the steps below to copy your Group and create a Configuration XML file to easily rerun the Copy Group Task with identical settings applied.

Within the Data Management Tool navigate to DriveWorks Tasks and select Copy Group. This will launch the Copy Group Wizard.
Click the Browse... button to select the Target Group. This is the Group that data will be copied into.
Select Create A New Group or Open An Existing Group. Follow the steps through the Group Wizard to select a Target Group.
A message stating, Group connection successful, will then be displayed.
Click Next.
Configuration File
This step is optional and isn't necessary for copying a Group.
If you have previously run the Copy Group Wizard and saved a configuration file of your settings, that file can be opened from this step.
Please see the section How To Use A Copy Group Configuration File below for more information.
Click Next.
Select the Projects you want to include in the copied Group.
Click Next.
Select the Projects you want to include in the copied Group.
Click Next.
Select the Group Tables you want to include in the copied Group.
Click Next.
Select the required Component selection type.
- Automatically select all components in the selected Projects.
  All components that have been added to the selected projects will be included in the dataset.
- Manually select components.
  Components to be included in the dataset will need to be manually selected, see Step 9.
Configuration File (see Step 14 below)
When using a configuration file to create subsequent datasets the following will apply:
- Automatically select components: Any new component sets added to any of the selected projects or models added to any existing component sets will be included in any dataset produced from the configuration file.
- Manually select components: When Top Level Components are checked any new models added to any selected component sets will be included in any dataset produced from the configuration file.
Click Next.
Manually Selected Components
Please note, this is only required if Manually select components was chosen in Step 8.
Select the Captured Components to include in the Drive Package.
Selecting the Top Level Components only checkbox, will only show the parent component set models.
Click Next.
Select any additional options that you want to include in the Drive Package.
It is important to make sure that the Target Root Folder is not the same location as your Source Root Folder.
Selecting Copy All Specifications and Copy All Generated Files and Information will dramatically increase the size of the Group so consider if it is truly necessary to back these up.
Click Next.
Review the files that will be included in the copy.
Files included from the selections made will appear with a black box in the checkbox next to them.
To remove an included item uncheck the checkbox for the item in the list.
You cannot uncheck the Project or Group selections.
Click Next.
Review the Summary. This details the creation process of the Copy Group.
If changes are needed simply click previous to return to previous pages to edit what is being included.
A configuration file of the settings applied in the previous steps.
This can also be done after the Copy Group process has completed in the next step.
To save a configuration file, click Save Configuration and follow steps 14 to 15 below.
If everything is correct click Next.
This will start the Copy Group process.
To create a configuration file of the settings applied in the previous steps follow steps 14 to 15 below.
Or click Finish to close the Wizard.
Select a location to save your configuration file and give it a name.
In this example a subfolder has been created in the DriveWorks folder within the Roaming Folder called BackupConfigurations.
If a configuration file was loaded (Step 5 above) the Location and File name will default to the folder and name of the loaded configuration file.
If no configuration file was loaded a File name must be entered and the location will default to C:\Users\[UserName]\AppData\Roaming.
Click Save to create the file.
Windows Explorer can be opened at the location the package file was saved by clicking the Open File Location button.
Click Finish to exit the Copy Group Wizard.

Copy Group Configuration File

When you use the Copy Group Data Management Task there is an option to create a Configuration file. This file is an XML file containing a copy of the settings used when selecting what content to include in the copied Group. This means you can replicate the same new Group without repeating the selection process again.

To see how to create a configuration file please see steps 13-15 above.

How To Use A Copy Group Configuration File

This guide shows how you would use a Configuration XML file to Copy a Group.

Within the Data Management Tool navigate to DriveWorks Tasks and select Copy Group. This will launch the Copy Group Wizard.
Click the Browse... button to select the Target Group. This is the Group the data will be copied into.
Select Create A New Group or Open An Existing Group. Follow the steps through the Group wizard to select a Target Group.
The message "Group connection successful" will be displayed.
Click Next.
Click the Browse... button to select a Configuration File to use for creating a copy.
Browse to the location of the Configuration file.
To use the exact same settings from the configuration file, check that Use Current Configuration is selected.
To amend the settings of the configuration file check that Modify Current Configuration is selected.
Click Next.
Review the Summary. This details the creation process of the copied Group.
Click Next.
This will start the Copy Group process.
Click Finish to exit the Copy Group Wizard.

Further Information

The Copy Group Tool is explained in more detail here.

DriveWorks Pro 22 How To Use Copy Group