Change & Migration
FocusedHow Should Several Planned Veeva Vault Configuration Changes Deployed Together Be Evidenced Against Unintended Interaction?
Teams batch changes for defensible operational reasons: a limited number of change windows, a wish to reduce the number of separate outage or disruption events, or simply because several small, independently requested changes were ready around the same time. LIB-059 addresses emergency, unplanned change control, and LIB-007 addresses assessing impact from Veeva's own scheduled platform releases; neither covers this case, where the organisation itself deliberately chooses to deploy several of its own planned, non-emergency configuration changes together.
Batching is a legitimate choice, but it is also a distinct risk decision
EU GMP Annex 11 requires that changes to a computerised system, including its configuration, be made only in a controlled manner under a defined procedure; it does not require, or forbid, batching multiple changes into one deployment. What batching does is change the shape of the risk: instead of assessing one change's impact in isolation, the organisation must also assess whether the changes in the batch could affect each other. ICH Q9(R1) supports formality proportionate to complexity, and a batch of unrelated changes to different, non-interacting parts of the configuration is a materially lower-complexity decision than a batch where two changes touch the same object type, lifecycle or workflow. State that assessment explicitly in the change record rather than treating "we batched it" as a single, undifferentiated risk category.
Keep per-change evidence traceable inside the batch
The first discipline a batch needs is one that has nothing to do with batching itself: every individual change in the batch should still trace to its own requirement, its own impact assessment, and its own test evidence, exactly as it would if deployed alone. A reviewer, or an inspector, should be able to pick any single change out of the batch and follow it end to end without having to disentangle it from the others. Losing this traceability is the most common failure mode of batched change records, where a combined test summary describes the batch as a whole and no longer shows which specific test evidence belongs to which specific change.
Define what an interaction check actually tests
Per-change evidence answers whether each change works on its own. It does not answer whether the changes work together, and that is a different, additional test that has to be deliberately scoped, not assumed to be covered by the sum of the individual tests. Identify, from the batch's own content, which changes plausibly interact: two changes touching lifecycle rules on the same object type, a workflow change alongside a security-model change that could alter who can execute the new workflow step, or a picklist or reference-data change alongside a change that consumes that same value. Where a Configuration Migration Package deploys the batch as one Outbound Package and one Inbound Package on the target, Vault Compare may inform package preparation or impact assessment, but the packaging mechanism only groups changes for deployment; it does not test them together. The interaction check therefore has to be designed and executed separately from the deployment mechanics.
Where no plausible interaction exists between any of the batched changes, say so explicitly and explain how that was determined, rather than silently omitting an interaction check and leaving the reader to assume none was needed.
Decide, in advance, what a failure in the batch means
Before deployment, the change record should state what happens if one change in the batch fails testing: whether the entire batch is held back until that change is fixed and retested, or whether the failing change can be withdrawn from the package and the remaining changes deployed on schedule with the failed one rescheduled separately. Deciding this in advance, rather than improvising under deployment-window time pressure, avoids the two worst outcomes: deploying a known-failing change because pulling it out at the last minute seemed too disruptive, or holding back several good changes because of one unrelated failure when the package could have been re-cut without it.
Sources
- European Commission, EudraLex Volume 4, Annex 11: Computerised Systems.
- International Council for Harmonisation, ICH Q9(R1): Quality Risk Management.
- Pharmaceutical Inspection Co-operation Scheme, Good Practices for Computerised Systems in Regulated GXP Environments.
- Veeva Systems, Using Configuration Migration Packages.