Test: Revision of the Participant Tab using the new data table

1 Initial Problem

This Feature Request was previously named: "Assign individual writing time extension BEFORE the students starts the ILIAS Test" and was initially written by Hackfort, Marvin [m.hackfort]. After the discussion in the UI Clinic, we have decided to rework the whole Participant-Tab in the ILIAS Test.

Currently, the Participant Tab in the ILIAS Test uses an old table implementation and lacks of some features. E.g. the opportunity to assign more time to before starting the test to some participants or add a range of IPs. Also, some of the shown information is not clear in their meaning. Another pain is the use of a subtab for adding more time, in cases of exams (Limit to one test attempt.)

Status Quo

2 Conceptual Summary

We use the UI Data Table to revise the participant tab. We abandon the subtabs "Manually Selected Participants" and "Extra Time" and supplement all information to the data table. 

The revised tab will always show a user search field to add participants manually, not only, if the setting "Select Participants Manually" is enabled. If a participant is manually added before the start of a test attempt, it will be possible to add Extra-time already before the test is started by the participant. This was not possible in the past. This setting is no longer tied to the number of attempts. In that way, it is also possible to add IP Ranges to single participants, before the test starts.

To add extra time to one participant, the test administrator clicks on the action menu in the data table row. There are also the actions to add an IP range and to finish the test of this participant. 

As currently, the test administrator will be asked if the running test attempt should be really finished. This question should also be shown in an interruptive modal.  As if today, it is not possible to finish the test of all or selected participants, if "Max. Number of Attempts" is set to "1" and the duration setting is used.  Likewise, the extra time settings and the IP range setting, will be shown as interruptive modals.
These settings as well are available as bulk actions for some selected participants and all participants in the table.

The extra time settings will be summed up, so if the duration is set to 90 minutes and in a first action, 10 minutes will be added as extra time to a participant A and later 5 minutes to all participants, participant A will have 90 + 10 + 5 minutes = 105 minutes and all other participants will have 95 minutes to finish the test. The summed up extra time, the total duration and the remaining duration of a participant will be shown in an additional column.

Status of Attempt, shows the status of a participants' attempt:

• Empty (if a participant is pre-entered at the participant tab)   --- (Or: Not started yet)
• Running
• Finished by participant
• Finished by administrator
• Finished by duration
• Finished by cronjob

If 'IP Range' or 'Extra-Time' are used, these columns will be shown from the system. Extra-Time only shows the sum of added extra times. It is not possible to minus already added extra time. IP Ranges are added in the same way for selected participants as described in the Feature Request Test: Add IP Ranges as Access Constraint to Test Settings for whole tests.

Adding extra-time to participants will be logged in the test logging. The "Name" column is mandatory, all other columns could be disabled with the data table settings.

Filter

The filter is off by default. If activated, the filter has the following options:

• Name --> free-text field
• Login -->  free-text field
• IP Range --> free-text field
• Solution --> Dropdown
  • -
  • Participants without solutions
  • Participants with solutions
• Extra Time --> Dropdown
  • -
  • Yes
  • No
• Status of Attempt
  • -
  • Running
  • Finished by participant
  • Finished by administrator
  • Finished by duration
  • Finished by cronjob

Solution is available in the current implementation and therefore again added. We could discuss if this is needed.

Saving of settings or changes must be indicated a success message box above the table. 

3 User Interface Modifications

3.1 List of Affected Views

ilTestParticipantsGUI

3.2 User Interface Details

Search

User Search will always be shown:

User Search with Button "Finish all Test Attempts":

Please note, that these mockups are not accurate anymore, since the JF has decided, how to go with these legacy forms & dropdowns. The implementation would be like described in the FR Removing Legacy-UI » Toolbar » ‘Label‘ + ‘Input‘ + ‘Legacy Dropdown‘ + ‘Submit‘. I'm not removing the mockups, lest you wonder, because I was only made aware of them by Seiler, Yvonne [yvseiler] last week. I had forgotten about the JF decision.

Table Participants and Filter

Data Table:

Table Bulk Action has the same entries, as the actions for single participants: Extra Time, IP Range and Finish Test.

Filter

Modals Finish Test (Attempt)

Interruptive Modals:

Modal 'Finish Test Attempt'

Modal 'Finish Test Attempts'

Modal 'Finish Test Attempts' for some participants

Modals Extra Time

Roundtrip Modals:

Extra Time for selected Participants (different time)

Extra Time for selected Participants (same time)

Extra Time for one Participant:

Extra Time for all Participants

Modals IP Range

Roundtrip Modals:

Note from the UX-Experts: Forms in modals should not be marked with the 'Required-asterisk', even if the field is necessary. If one has forgotten the input, the modal is not saved and an error message is shown within the modal.

3.3 New User Interface Concepts

No new interface elements

3.4 Accessibility Implications

We only use standard kitchen sink elements; therefore, we see no new implications.

4 Technical Information

{ The maintainer has to provide necessary technical information, e.g. dependencies on other ILIAS components, necessary modifications in general services/architecture, potential security or performance issues. }

5 Privacy

We do not see any implications with this feature. No new data is selected.

6 Security

We do not see any implications with this feature.

7 Contact

• Authors of the Request: Hackfort, Marvin [m.hackfort] (First Version), Strassner, Denis [dstrassner] with Input from the UI-Clinic and other stakeholders
• Authority to Sign off Conceptual Changes : Strassner, Denis [dstrassner]
• Authority to Sign off Code Changes: Kergomard, Stephan [skergomard], Becker, Maximilian [mbecker]
  
• Implementation of the feature is done by: {The maintainer must add the name of the implementing developer.}

8 Funding

If you are interest in funding this feature, please add your name and institution to this list.

• Katholische_Hochschule_Nordrhein-Westfalen

9 Discussion

JourFixe, ILIAS [jourfixe], 15 APR 2024: We highly appreciate this suggestion and schedule the feature for ILIAS 10. The table settings should be stored in the database to persist over the cookie lifetime. We prefer to present "Not started yet" for a user that hasn't yet started the test. The button "Finish All Test Attempts" will be removed with the new implementation.

10 Implementation

Implemented as described above but the changes due to Test: Revise Test Tabs have changed the looked contrary to the mookups above.

Test Cases

Test cases completed at 2024-10-25 by Strassner, Denis [dstrassner]

• C249 :  Teilnahmebeschränkung hinzufügen  (adapted).
• C361 :  Benutzer als Teilnehmer entfernen   (adapted).
• C359 :  Zugriff auf bestimmte Client IP beschränken  (adapted).
• C381 : Zeitverlängerung für Teilnehmer (adapted).
• C50044 : Unbeendeten Testdurchlauf eines Teilnehmers beenden (adapted).
• C171: Liste der Teilnehmerdaten anders sortieren (adapted).
• C166: Ergebnisübersicht/Antworten/Details von Teilnehmern anzeigen lassen (adapted).
• C167: Ergebnisse eines einzelnen Teilnehmers anzeigen lassen (adapted).
• C169: Testdaten eines Teilnehmers löschen (adapted).
• C170: Testdaten aller Teilnehmer löschen (adapted).
• C6575: Zeitzugabe während der Testdurchführung  (adapted).
• C63519: Alle Testdurchläufe während der Durchführung beenden (adapted).
• C63520: Einen bestimmten Testdurchlauf während der Durchführung beenden (adapted).
• C24648: Untergeordnete Teilnehmer verwalten: Durchläufe Schließen (adapted).

Approval

Approved at 2024-10-25 by Strassner, Denis [dstrassner].