A former repository picker proposal has been moved to: https://github.com/ILIAS-eLearning/ILIAS/pull/360.
This PullRequest was closed. A new PullRequest will open - Informations above.

• PHP Class:
• PHP Example:
• External Library:
• Status of Entry: To be revised
• Status of Implementation: to be implemented
• Description*:
  • Purpose: A form requires a specific repository object to be indicated: to limit it' application, to point to it, to become a starting point or the like.  The form might need none or exactly one repository object or may be able to use one or more objects. 
  • Composition: 
  • Effect: Picking a repository object from within a form is a workflow to be included in the form and take effect. 

Mock-Ups: Picking Exactly One Object

Mock-Ups: Picking One or More Objects

• Background:
• Feature Wiki Reference:
• Context*: Forms 
• Rules:
  • Usage: Repository Pickers MAY be used in Forms. 
  • Composition: The Indicator leads up to a "Select"-Link. The link calls uppon a Round Trip Modal, containing a tree representation with either clickable titles orcheckboxed entries. The Modal workflow is completed by either clicking the title of an object or clicking the "save"-Button. After selecting an object, the object's title is provided as a read-only entry in the form. If more than one object can be selected, "+-" Glyphs are presented to remove the object or add another one. 

• Interaction:

Picking exactly One Object 

1. User clicks the "Select"-Link in  the form. 
2. ILIAS calls a Roundtrip Modal presenting the repository tree.
3. User selects the object by clicking on an object title (to pick one object). 
4. ILIAS closes the modal and inserts the selected object into the form. 

Picking One or More Objects

1. User clicks the "Select"-Link in  the form. 
2. ILIAS calls a Roundtrip Modal presenting the repository tree.
3. User checks all checkboxes to pick more than one object. 
4. User clicks "Save".
5. ILIAS closes the modal and inserts the selected object into the form and adds "+-"-Glyphs.

• Relations:
  • Is A:
  • Must Use:
  • May Use:

3 Discussion on former Article

Kiegel, Colin [kiegel] 2016-11-17: I support this request. However I suggest to remove the additional "label" suggested in the mockups, which is placed in front of the "Select" link. IMO this label is confusing because it looks like something was selected already.

Kiegel, Colin [kiegel] 2016-11-23: How does the repository picker relate to the dialogs for copying/moving/linking objects in the repository? Obviously these dialogs don't use overlays oposed to the repository picker from this request. Will it be a completely independent implementation or will the repository picker also allow non-overlay modes or share some code in another way with these dialogs?