Step 5: Run the Amendment in Production

EDC Tools


Once you’ve published your new version to your production environment, you can run either a retrospective or, if enabled, prospective amendment to migrate Sites and existing Casebooks to the new version.

We recommend running amendments during “off hours”, when none or very few data entry users will be using Vault. Running amendments while data entry is in progress can lead to migration errors and errors during future casebook creation.

Choose an Amendment Type

Depending on your design change, you can choose to run a retrospective amendment or, if enabled, a prospective amendment. Retrospective amendments apply changes to all data, including submitted Forms. Prospective amendments apply changes “this point forward”, only changing existing Casebooks after a certain Event.

Contact Veeva Support to enable Prospective Amendments in your vault.
Retrospective Amendments Prospective Amendments
With retrospective casebook amendments, Vault updates all existing casebook data to reference the new version, modifying any previously collected data to comply with the new version. For example, if a new version removed the Secondary Baseline Visit form from the study, a retrospective casebook amendment would remove the Secondary Baseline Visit form from any existing Casebooks, even if the site already collected data for that form. A prospective casebook amendment is a study design revision that begins “this point forward”. Data managers can use prospective casebook amendments to apply a change to all existing _Casebooks_without removing or updating any previously collected data.

Update the Site’s Active Version

After running the amendment, update each site’s Active Version to reference the new version. Vault uses the Active Version for each site when creating new Casebooks.

To assign a casebook version to a Site:

  1. Navigate to Tools > EDC Tools > Sites.
  2. Click to open a Site.
  3. In the Active Version drop-down, select your new version.
  4. Click Save.

Vault now references your new version when creating new Casebooks.

Run the Amendment

Once a clinical programmer has published a new version of your study, you can deploy it to sites using a casebook amendment. Note that vault does not apply amendments to frozen and locked Casebooks or data.

To run an amendment:

  1. Navigate to your Study in EDC Tools.
  2. Click Casebook Versions.
  3. Click Active Versions by Site.
  4. Select the Sites you want to move to the new version. You can choose one, some, or all of your Sites.
  5. Click the button or select from the Actions menu, New Retrospective Amendment or New Prospective Amendment.
  6. Select the Target Version. This is the new version that you are moving sites onto.
  7. Fill the required fields.
  8. Set the scope of your amendment:
    • Select Update all subjects to update all subjects at the chosen sites.
    • Select Update specific subjects to select individual subjects to update. If you choose this option, Vault displays a list of subjects. Select each Subject that you want to receive the amendment.
  9. Click Run Now. Vault begins a job to apply your amendment to your sites. As part of this process, Vault also re-runs all of your study’s Rules. Vault sends you an email notification when the job is complete. You can view the job’s status and log from EDC Tools > Jobs.

Resume Data Collection

Your existing Casebooks and your Sites are now on the new design version. You can resume data collection. Repeat Stage 4: Amendments each time you need to make a mid-stream change to your Study.

EDC Tools