Test: Move General Settings to UI Forms and use IPE

1 Initial Problem

Currently, the test uses legacy UI-Forms for the general (and other) settings.

2 Conceptual Summary

We want to move these forms to new UI-Forms. As there is no form element formatable by TinyMCE in the UI-Framework, fields that were editable with this editor need to be moved. In the form to edit general settings this concernes the "Introductory Message" and the "Concluding Remarks". We propose to move these fields to the ILIAS Page Editor.

Rationale: With ILIAS 9 there will be two options to format text content, the IPE and the Markdown-Field. As these fields can be used to design longer messages, especially in the case of the "Concluding Remarks" a whole page, the IPE is the correct implementation. Additionally, since ILIAS 8 we are using the IPE for a very similar purpose in the Learning Sequence Learning Sequence: Replace TinyMCE with Page Editor. We would implement a similar solution for the test.

As the infrastructure is there and the introduction is trivial, we propose, to also introduce the option to add a Custom Icon to the test. This would bring it inline, with the current aims for Icon-Handling.

3 User Interface Modifications

3.1 List of Affected Views

• Settings -> General Settings
• Settings -> Edit Introductory Message
• Settings -> Closing Remarks
• ObjectListGUI of Test
• Icon on all views of Test

3.2 User Interface Details

• The two settings "Introductory Message" and "Concluding Remarks" will not have a subform anymore and the byline will be adapted, to make clear, that a the text can be changed in two new sub-tabs. Proposal to be run by our language experts:
  • Introductory Message: "Shows an introductory message on the tab ‘Info’ of the test. The message can be edited in the sub-tab "Introductory Message" of these settings and is accessible already before the test can be started."
  • Concluding Remarks: "Show concluding remarks after the test has been submitted (there is no option to return to the test from this page). The message can be edited in the sub-tab "Concluding Remarks" of these settings."
• The two sub-tabs are always accessible and their contents can be edited, even if the option is not enabled. If the message is not enabled, an Info message above the toolbar notifies the user to enable the respective page.
• The current messages will be used in ILIAS 9 as long as they are not overridden by new IPE-Content. They are also accessible through buttons in a new Toolbar over the settings form (same pattern as in the Learning Sequence). This behavour will be removed with ILIAS 10.

3.3 New User Interface Concepts

None

3.4 Accessibility Implications

The form elements for the UI-Framework will improve compliance with A11y standards. On the other hand, the IPE is not accessible, as far as we know.

4 Technical Information

• The Test & Assessment is already available in the administration of the IPE, so we don't need any changes there
• If time allows, the corresponding settings will also be moved to a repository pattern. Otherwise this is a separate concern accomplished for ILIAS 10.

5 Privacy

Nothing changes due this move.

6 Security

We will see improvements due to the standardized input handling.

7 Contact

• Author of the Request: Kergomard, Stephan [skergomard], Strassner, Denis [dstrassner]
• Maintainer: Strassner, Denis [dstrassner]
• Implementation of the feature is done by: Kergomard, Stephan [skergomard]

8 Funding

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

• …

9 Discussion

JourFixe, ILIAS [jourfixe], 12 JUN 2023: We highly appreciate this suggestion and schedule the feature for ILIAS 9.

Strassner, Denis [dstrassner], 05 AUG 2023: Dev Issue: Setting "Force Waiting Time between Passes": We want to remove the Form Field "Months" as this overloads the view in the implementation with the new UI Forms and is not frequently used.

Screenshot of the Setting

JourFixe, ILIAS [jourfixe], 07 AUG 2023 : Removing the input for month is fine for us.

10 Implementation

There are small visual changes due to the new forms for all else the Mock-Ups from above apply. Not much to add here.

Test Cases

Test cases completed at 31. JUL 2023 by Strassner, Denis [dstrassner]

Changed:

• C204- (!) Überblätterte Fragen nach hinten stellen *edit*
• C208- Direkte Rückmeldungen *edit*
• C220 - Einleitung hinzufügen *edit*
• C229 -  Abschließende Bemerkung *edit*

Privacy

no change required

Approval

Approved on 01 AUG 2023 by Strassner, Denis [dstrassner].