Bulk Voucher Changes
Bulk Voucher Change Process
Often it is necessary to update hundreds, or thousands, of vouchers in bulk
- e.g. to activate a set of vouchers, or lock stolen vouchers.
The OCS GUI provides the bulk voucher changes wizard to perform such bulk
activities. The wizard can be accessed from the voucher search screen,
Bulk Change button:
Clicking the button shows the Bulk Voucher Change wizard. The first screen is:
Based on the voucher serial number, a set of vouchers may have a state transition triggered. First, enter the start and end serial number (inclusive). Both these values must be provided.
- The serial number range does not need to be within a single batch.
- The serial number range does not need to have vouchers for every serial number within the range (the range may go beyond the last serial number in the database, or cover serial numbers which do no exist).
Further note that not all vouchers within the range need to be in the same state. The system will gracefully handle bulk voucher updates with different initial voucher states.
The next screen in the wizard will request the state transition for each voucher type of vouchers identified within the serial number range:
Select the transition to trigger for each voucher type. Note that each voucher will be independently triggered, and the transition will trigger if it is possible from the voucher’s initial state.
lock transition may be requested for vouchers in both the
created and active state, and the system will apply the transition
for both initial voucher states. If a voucher within the range
is already redeemed, the transition will not be possible (and so
the voucher will be skipped).
Once the transition to trigger has been selected, either
Apply the transition
immediately, or use the
Next button to move to the next wizard
screen and enter additional information.
The default voucher lifecycle
requires no additional information unless redeeming a voucher (in which
case the account ID will be required in the additional information).
Once requested, the bulk voucher update will provide an update result for each voucher in the voucher serial number range:
These results can be inspected on-screen.