Clarification of Log Data for Tests

1 Initial Problem

This FR aims at clarifying some log entries in ILIAS log data files. The goal is to make log data easier to understand for humans, i.e. examiners.

This FR only concerns data that can be exported by ILIAS admins via: Administration -> Repository and Objects -> Test and Assessment -> Log Data!
However, it would not be surprising if by changing text in this dataset will also change data in other files elsewhere. I.e. "test.log" created with the core archive export file for ILIAS tests.

Problems:

• log entries cannot be mapped to users, because no unique user account is referenced; "Jon Doe"...could be anyone...
• log entry for test finish is too technical/cryptic: "updateLearningProgressAfterPassFinishedIsWritten has been called from ilTestPlayerAbstractGUI (finPass=0 / Lp=)"
  • it also does not differ between an automatic test finish due to a reached time limit or the user manually finishing the test pass
• log entry for only viewing/reading a question are unclear, right now this action can be derived from the log entry "User did not enter values"
• the log contains UNIX timestamps that are not readable for humans: "The test was modified [complete: 1 => , tstamp: 1613562328 => 1613562898]"
• log entries contain unresolved variable names that are not comprehensible to the average ILIAS user (i.e. examiner): "The test was modified [tstamp: 1613562269 => 1613562283, question_set_type: FIXED_QUEST_SET => RANDOM_QUEST_SET]"
• log entries for manual feedback make no use of the question column and make it hard to find the actual feedback/comment by the examiner: "Fabian Sesterhenn (admin-fsesterh) added manual feedback for test person Doe1, Jon and question Question 13 - Essay: <p>test 1 2 3... dsdsdsd</p>"

2 Conceptual Summary

2.1 RFC 2119

2.2 Requirements

• The user name is extended with the account loginname in parentheses, i.e. "Fabian Sesterhenn (sesterhenn)"
• "updateLearningProgressAfterPassFinishedIsWritten has been called from ilTestPlayerAbstractGUI" is replaced with "Test finished"
• "User did not enter values" is replaced with "User viewed question"
• manual feedback for a question will reference the question in the intended column, the log entry itself can be shortened to "Manual Feedback for participant [TESTPARTICIPANT]: [FEEDBACK]."

3 User Interface Modifications

3.1 List of Affected Views

None. Only the export data for test protocols is affected.

3.2 User Interface Details

None.

3.3 New User Interface Concepts

None.

3.4 Accessibility Implications

None.

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

• user name (login)
• name and surname of user account

6 Security

No security implications.

7 Contact

• Author of the Request: Sesterhenn, Fabian [sesterhenn]
  
• Maintainer: Strassner, Denis [dstrassner]
• 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.

• TH Köln

9 Discussion

10 Implementation

{ The maintainer has to give a description of the final implementation and add screenshots if possible. }

Test Cases

Test cases completed at {date} by {user}

• {Test case number linked to Testrail} : {test case title}

Approval

Approved at {date} by {user}.