Copying Designs
When designing a study in EDC Studio, you can use templates or existing Study definition objects. You can copy Items, Codelists, and Units from within your current Study. You can also copy some types of definition objects to your current study from another study in the same vault, or from another study in a different vault that you have access to. To copy from another vault, the vault containing the study you are copying from must be in the same domain as the vault containing your current study, or you must be a cross-domain user with access to the domain that the other vault is in. The following definition objects can be copied from other studies:
- Event Groups
- Events
- Forms
- Rules
- Codelists
- Units
Copying from the Current Study
You can easily create copies of definitions for Items, Codelists, and Units for use in the same Study. For example, you may want to collect the same data, with the same restrictions applied, for an Item on multiple Forms, but you would like to change the Label and Help Content for one of the Forms. You can create a copy of that Item through the Actions menu by next to the item.
To create a copy of an Item, Codelist, or Unit:
- In Studio, navigate to the object record you want to copy.
- Enter a new Name for your object definition, or append additional text to the existing name. For Vault to copy the object definition, this value must be unique.
- Click Save. Vault creates the new object definition record.
Once you have copied the Item, Codelist, or Unit, you can edit and use it in your study.
Copying from Another Study
When you copy definition objects, Vault also copies their child components, for example, the Item Groups and Items associated with the copied Form. Vault also copies the coding configuration of any copied Forms.
Copying Event Groups
You can copy an Event Group (Event Group Definition) from one Study to another Study in the same vault or another vault that you have access to. When you copy an event group, Vault also copies that event group’s properties and, optionally, its rules.
For example, Tracey, a clinical programmer at Verteo Pharma, designed the Veeofen study last month. This month, she is designing the Wonderdrug study. The Treatment Visits event group from Veeofen is identical to what she needs for the Wonderdrug study. Tracey can copy that Treatment Visits event group from Veeofen into Wonderdrug, instead of manually creating it a second time.
To copy an event group:
- Navigate to Studio > Event Groups.
- Click Copy From Study.
- Select Create a copy or Use existing to handle duplicates. See details below.
- Optional: Select the Rules checkbox to also copy any Rule Definitions associated with the event.
- Select a Vault.
- For Copy From Study, choose where you want to copy from (From Another Study or From Library.)
- Select a Study Environment to copy from.
- Search or scroll to locate the Event Definition you want to copy.
- Select the Event Group you want to copy.
- Optional: Select the Select all checkbox to select all Events for copying.
- Click Copy Event Groups. Vault begins copying the Event Definition into your Study.
- Optional: In the Copy from Study dialog:
- Click View Summary to see a list of the copied forms and the status of the copy.
- Click View Log to see detailed status information for each object record copied.
- When finished, click Close. Once you click Close, you can no longer access the summary or log file.
Copying Events
You can copy an Event (Event Definition) from one Study to another Study in the same vault or another vault that you have access to. When you copy a form, Vault also copies that event’s properties and, optionally, its rules.
For example, Tracey, a clinical programmer at Verteo Pharma, designed the Veeofen study last month. This month, she is designing the Wonderdrug study. The Ongoing Treatment Visit from Veeofen is identical to what she needs for the Wonderdrug study. Tracey can copy that Ongoing Treatment Visit event from Veeofen into Wonderdrug, instead of manually creating it a second time.
To copy an event:
- Navigate to Studio > Events.
- Click Copy From Study.
- Select Create a copy or Use existing to handle duplicates. See details below.
- Optional: Select the Rules checkbox to also copy any Rule Definitions associated with the event.
- Select a Vault.
- For Copy From Study, choose where you want to copy from (From Another Study or From Library.)
- Select a Study Environment to copy from.
- Search or scroll to locate the Event Definition you want to copy.
- Select the Event you want to copy.
- Optional: Select the Select all checkbox to select all Events for copying.
- Click Copy Events. Vault begins copying the Event Definition into your Study.
- Optional: In the Copy from Study dialog:
- Click View Summary to see a list of the copied forms and the status of the copy.
- Click View Log to see detailed status information for each object record copied.
- When finished, click Close. Once you click Close, you can no longer access the summary or log file.
Copying Forms
You can copy a Form (Form Definition) from one Study to another Study in the same vault or another vault that you have access to. When you copy a form, Vault also copies that form’s properties, its Item Groups, its Items, its Codelists and Units, and, optionally, its rules.
Rule Copy: Vault will not copy any cross-form Rules associated with a copied Form.
For example, Lateef, a clinical programmer at Bryce Pharma, designed the Deetoza study last month. This month, he is designing the Veeofen study. The Physical Exam form from Deetoza is identical to what he needs for the Veeofen study. He can copy that Physical Exam form, and all of its related records, from Deetoza into Veeofen, instead of manually creating those object records a second time.
To copy a form:
- Navigate to Studio > Forms in Browse view.
- Click Copy From Study.
- Select Create a copy or Use existing to handle duplicates. See details below.
- Optional: Select the Rules checkbox to also copy any Rule Definitions associated with the form.
- Optional: Select the Safety Configuration checkbox to also copy any configuration for the Safety Configuration associated with the form. Vault indicates which forms have safety configurations in the dialog’s Has Safety Configuration column. Note that this requires a Study Role with the Manage Safety Configuration permission.
- Select a Vault.
- For Copy From Study, choose where you want to copy from (From Another Study or From Library.)
- Select a Study Environment to copy from.
- Search or scroll to locate the Form Definition you want to copy.
- Select the Form you want to copy.
- Click Copy Forms. Vault begins copying the Form Definition into your Study.
- Optional: In the Copy from Study dialog: * Click View Summary to see a list of the copied forms and the status of the copy. * Click View Log to see detailed status information for each object record copied.
- When finished, click Close. Once you click Close, you can no longer access the summary or log file.
Labs: Note that you can’t copy a Lab form with an existing Lab panel between studies.
Copying Rules
You can copy a Rule (Rule Definition and Rule Action) from one Study to another Study in the same vault or another vault that you have access to.
For example, Lateef, a clinical programmer for Bryce Pharma, designed the Deetoza study last month. He wrote several complicated date comparison rules. This month, he’s building rules for the Veeofen study. He can use the same rule expressions that he wrote for Deetoza’s date comparisons if he updates the identifiers to match Events in the Veeofen study. He can copy those date comparison rules from Deetoza into Veeofen, update the identifiers in the rule expressions, and then reactivate those rules to use them in the Veeofen study.
When you select rules to copy, Vault checks whether or not the rules are valid (if identifiers in the rule expressions match up to design definition records in the target study). On any invalid rules, Vault shows an Invalid indicator.
You can still copy these invalid rules into your Study, but Vault moves them into the Inactive status. You’ll have to update the rule expression and rule action to point to identifiers or objects that exist in your study before you can use these rules.
To copy rules:
- Navigate to Studio > Rules.
- Select Create a copy or Use existing to handle duplicates. See details below.
- Select a Vault.
- For Copy From Study, choose where you want to copy from (From Another Study or From Library.)
- Select a Study Environment to copy from.
- Search for or scroll to locate the Rule Definition you want to copy.
- Select the rules you want to copy.
- Optional: Select the Select all checkbox to copy all rules.
- Click Copy Rules. Vault begins copying the Rule Definitions and related records into your Study.
- Optional: In the Copy from Study dialog:
- Click View Summary to see a list of the copied rules and the status of the copy.
- Click View Log to see detailed status information for each copied rule.
- When finished, click Close.
Once you click Close, you can no longer access the summary or log file.
Copying Codelists
You can copy a Codelist (a Codelist Definition and its Codelist Definition Items) from one Study to another Study in the same vault or another vault that you have access to. To copy a codelist:
- Navigate to Studio > Codelists.
- Click Copy From Study.
- Select Create a copy or Use existing to handle duplicates. See details below.
- Select a Vault.
- For Copy From Study, choose where you want to copy from (From Another Study or From Library.)
- Select a Study Environment to copy from.
- Search or scroll to locate the Codelist you want to copy.
- Select the Codelist you want to copy.
- Optional: Select the Select all checkbox to copy all codelists.
- Click Copy Codelists. Vault begins copying the Codelist into your Study.
- Optional: In the Copy from Study dialog:
- Click View Summary to see a list of the copied codelist and the status of the copy.
- Click View Log to see detailed status information for each object record copied.
- When finished, click Close.
Once you click Close, you can no longer access the summary or log file.
Copying Units
You can copy a Unit (a Unit Definition and its Unit Definition Items) from one Study to another Study in the same vault or another vault that you have access to. To copy a unit:
- Navigate to Studio > Units.
- Click Copy From Study.
- Select Create a copy or Use existing to handle duplicates. See details below.
- Select a Vault.
- For Copy From Study, choose where you want to copy from (From Another Study or From Library.)
- Select a Study Environment to copy from.
- Search or scroll to locate the Unit you want to copy.
- Select the Unit you want to copy.
- Optional: Select the Select all checkbox to copy all units.
- Click Copy Units. Vault begins copying the Units into your Study.
- Optional: In the Copy from Study dialog:
- Click View Summary to see a list of the copied units and the status of the copy.
- Click View Log to see detailed status information for each object record copied.
- When finished, click Close.
Once you click Close, you can no longer access the summary or log file.
Duplicate Handling
If you attempt to copy a Form or Event from another Study that already exists in your Study, you can choose how Vault handles the conflict. Vault identifies duplicates by the CDM Key value. For both of these options, Vault creates a new object record if there are no duplicates.
Create a Copy
If you choose Create a copy, Vault copies the existing definition record into a new Form, Event, or Event Group and adds the new record to your study.
Use Existing & Update with Changes
If you choose Use existing, Vault uses the existing definition record and logs the reuse.
If you select Update with Changes, Vault uses the existing definition record, but it also applies any changes from the matching record in the other study. These changes are included in the log.
Copy Log
You can choose to download a CSV log for your copy job from within the Copy from Study dialog. Note that once you close that dialog, you can no longer access the log file.
The log file lists each object that was copied, whether or not the copy was successful, and details about any errors that occurred during the copy.
Versioning for Copied Definitions
When you copy a Form, Vault sets the Form and its related object records to the same version as the Study you’re copying it into.