Loading...
When a Stage has closed and the Draft Schedule(s) button (labelled Redraft Schedule(s) in the case of Stages that have been drafted previously) is clicked, a background job will be scheduled for the very near future, to generate the variations using the Lottery module's processing algorithm.
Once that job and the algorithm has completed its processing, you will have one or more Schedule Variations, each of which represents the outcome of one attempt or iteration of the algorithm. Each Schedule Variation may be slightly different, and this is because the algorithm uses randomization to shuffle the list of Learners, ensuring impartiality.
On the Stage Card, begin by clicking on the button labelled "1 Variation", which will open up a dropdown allowing you to choose between 1 to 5 variants to be generated. Once you have decided on the number of Schedule Variations you would like, click the Draft Schedule(s) button.
Under the "Reviewing Schedules" heading in the Variations Overview, you'll see a dropdown selector labelled Select Schedule Variation allowing you to select one of the generated variations for review. The dropdown will contain up to five numbered variations, depending on the number specified when clicking the Draft Schedule(s) button beforehand. If any errors occurred while drafting a specific schedule variation, that variation will be marked with a red "Failed" badge, both in the dropdown and when that variation is selected.
When a schedule variation is selected, a modified version of a rotation scheduler will appear below the dropdown selector. This scheduler interface contains a stacked list of Learner rows, with some meta information in the left-hand column, such as their profile picture, full name, and student number.
Once everything in a specific Schedule Variation has been reviewed, if it is deemed to be ready and chosen as the most viable variation out of all that were drafted, it should be merged into the Lottery's working schedule.
This process is initiated with the button under the scheduler, labelled Merge Schedule. When clicked, it will open a confirmation dialogue to ensure that it is not merged before the administrator is ready. Upon clicking the Confirm button in the confirmation modal, the currently selected Schedule Variation will be merged into the Lottery's working schedule.
If an error happens to occur when attempting to merge the variation into the Lottery's working schedule, an alert message will be displayed to inform the administrator that the operation was not successful. The HTTP response code from the API request will be included in this alert, which can be helpful for diagnosing any potential issues.
When the process of merging the variation has completed, you will be returned to the Stages Overview, where the Stage Card's status will be updated to "Merged". Once you have completed any desired merge actions, you are ready to begin the final step of the Lottery process, which is to publish the Lottery's working schedule.