Data Collection : Revision of the Placeholder Usage

1 Initial Problem

To create a single views of a data collection record in a table of a data collection, the data of fields of this record can be used.

To do this, the placeholder "[Value]" must be inserted manually with "[Value]" in the text paragraph of the page editor.

This is incredibly awkward and not user-friendly.

2 Conceptual Summary

Like other functions, placeholders can also be inserted via the editing slate for texts. This follows the operating concept of links, text, footnotes and anchors.
(Why 'Text' is explained below.)

We can use the syntax from certificates or the wiki with double square brackets if this is considered useful. → [ [value] ]

The order of the placeholders follows the order of the fields in the corresponding table – if possible.

If a field title that is defining for the placeholder is changed, it should also be changed in its application in the view. In future, this will prevent this entry from being orphaned in the view when a field title is changed.

Additional details:

• The "Delete this detailed view" function is removed. If you want to delete all content, you can delete all content using the editor's own functions.
• The "Activate this view" | "Deactivate this view" function is removed. If you want to deactivate the entire view, i.e. all content, you can deactivate all content using the editor's own functions. If a view is deactivated in the database, a migration is performed as part of the update so that all COPage elements are deactivated.
• If there is no content or only deactivated content in the view, no view is displayed on the individual data collection record.
• The info message box containing "The following rbac roles have read access on the data collection, but no read access on any standard view of a table: [Role Title], [Role Title]" is removed. At this point, it offers no added value. Furthermore, the problem cannot be solved here. 
• A new info message box containing a hint to use placeholders:  "To use data from the data collection in this view, please use the corresponding placeholders. These are available in the page element 'Text' and 'Data Table'."

This is not a MockUp !!
It shows the transformation of the current situation into the intended solution.

The MockUp.
 

3 User Interface Modifications

3.1 List of Affected Views

• SIngle View of a Data Collection Record in a view of a table.

3.2 User Interface Details

Placeholders can be inserted into a text element of the editor with a selection of a placeholder. They are inserted at the position of the cursor.

3.3 New User Interface Concepts

None.

3.4 Accessibility Implications

The insertion takes place at the location. The selection is explicitly from the space of all possibilities. The selection can be identified as such. The old solution was a continuous text far from the action.

4 Technical Information

The main aim of the revision is to achieve standardization where possible.

This applies to the code as well as the operating concepts and the UI.

Special functions will be reduced. 

5 Privacy

Nothing specific.

6 Security

Nothing specific.

7 Contact

• Author of the Request: Samoila, Oliver [oliver.samoila]
• Authority to Sign off on Conceptual Changes: Seeland, Per Pascal [PerPascalSeeland], Samoila, Oliver [oliver.samoila]
• Authority to Sign off on Code Changes: Seeland, Per Pascal [PerPascalSeeland], Szmais, Ingmar [iszmais]
• 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.

• …

9 Discussion

Kunkel, Matthias [mkunkel], 02 JUL 2024: Thanks for this request. It will make it much easier to use placeholders on the detailed view. Just one question: how you distinguish the two existing placeholder for 'Infos über Eigenarten' in the new concept?

JourFixe, ILIAS [jourfixe], 08 JUL 2024: We highly appreciate this suggestion and schedule the feature for ILIAS 10.

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}

Privacy

Information in privacy.md of component: updated on {date} by {user} | no change required

Approval

Approved at {date} by {user}.