PubMan Func Spec View

UC_PM_BD_02 view item list

The user views the search result list of one or more items. The user is able to modify the display of the item list by changing the sorting order, the number of displayed items or the display type.

Status/Schedule

• Status: implemented
• Schedule:R2

Triggers

• This use case is included by the use cases UC_PM_SR_01 do simple search, UC_PM_SR_03 do advanced search and UC_PM_BD_03 browse by organizational unit.

Actors

• User

Pre-Conditions

• A search result list is available.

Flow of Events

• 1. The user chooses to view a list of items by executing one of the above mentioned use cases.
• 2. The system displays the number of items and the list of items. The defaults for the display type (see FE_PM_02 Display types), the sorting order (see FE_PM_03 Sort item list) and the number of hits per page are given by the system or are taken from the users preferences if available.
• 3. (Optionally) The user changes the sorting order.
  • 3.1. The system displays the item list in the selected sorted order.
• 4. (Optionally) The user chooses another number of hits to be displayed per page.
  • 4.1. The system displays the item list containing the selected number of hits per page.
• 5. (Optionally) The user changes the display type.
  • 5.1. The system displays the item list in the selected display type.
• 6. (Optionally) The user changes the display type for one item.
  • 6.1. The system displays the item in the selected display type.
• 7. The use case ends successfully.

Post-Conditions / Results

• The item list is displayed in the selected sorting order containing the defined number of hits per page and the items are displayed in their selected display type.

UC_PM_BD_03 browse by organizational unit

The user browses by organizational unit.

Status/Schedule

• Status: implemented
• Schedule:R2

Triggers

• The user wants to browse by organizational unit.

Actors

• User

Pre-Conditions

• None

Flow of Events

• 1. The user chooses to browse by organizational unit.
• 2. The system displays an organizational unit browse view.
• 3. (Optionally) The user chooses to view the child organizational units of an organizational unit.
  • 3.1. The system displays all child organizational units of the selected organizational unit.
• 4. (Optionally) The user chooses to view the items of an organizational unit.
  • 4.1. The system searches for items where the organization of a creator is linked to the selected organizational unit or any child organizational unit in the structure and displays the result list. Include use case UC_PM_BD_02 view item list.
  • 4.2. (Optionally) The user chooses to view detailed information of the selected organizational unit.
    • 4.2.1. The system displays an organizational unit detail view.
• 5. The use case ends successfully.

Post-Conditions / Results

• The organizational unit browse view is displayed.

UC_PM_BD_04 view item version

The user views the details of a selected version of an item.

Status/Schedule

• Status: partly implemented R2(only last version visible).
• Schedule:R3

Triggers

• The user wants to view the details of the item version.

Actors

• User

Pre-Conditions

• One item version is selected.

Flow of Events

• 1. The user chooses to view the selected item version.
• 2. The system displays the data of the item version and the files. The possibility for download is offered for all files the user has privileges to access (for details see 13.1).
• 3. (Optionally) The user chooses to download a file.
  • 3.1. The system provides the file for download.
• 4. Extension point: view release history
  • 4.1. If the user wants to view all released versions of the item, include use case UC_PM_BD_05 view release history.
• 5. Extension point: view item event log
  • 5.1. If the user is in any role defined in the workflows for the item’s collection.and wants to view the log entries for the item versions, include use case UC_PM_BD_06 view item event log.
• 6. Extension point: view revisions of item
  • 6.1. If the user wants to view all related revisions of the item, include use case UC_PM_BD_07 view revisions of item.
• 7. Extension point: view item statistics
  • 7.1. If the user wants to view the statistics for an item, include UC_PM_BD_08 view item statistics.
• 8. Extension point: create item from template
  • 8.1. If the user has the role “Depositor“ and wants to create a new item using that item as template, include UC_PM_SM_05 create item from template.
• 9. Extension point: create new revision of item
  • 9.1. If the user has the role “Depositor”, at least one item version is in state “released” and the user wants to create a new revision to that item, include use case UC_PM_SM_11 create new revision of item.
• 10. Extension point: modify item
  • 10.1. If the user is allowed to start the modification workflow for the item, the last item version is in state “released” and the user wants to modify that item, include UC_PM_QA_11 modify item.
• 11. Extension point: withdraw item
  • 11.1. If the user is the owner of that item, the last item version is in state “released” and the user wants to withdraw that item, include use case UC_PM_QA_09 withdraw item.
• 12. The use case ends successfully.

Alternatives

• 2a. The item is in state “withdrawn”.
• 1. The system displays the withdrawal comment, the withdrawal date and the item data. The use case ends successfully.

Post-Conditions / Results

• The details of the item are displayed.

UC_PM_BD_05 view release history

The user chooses to get an overview on the released versions of an item.

Status/Schedule

• Status: implemented
• Schedule:R2

Triggers

• The user chooses to see the released versions of an item. • This use case is included by the use case UC_PM_BD_04 view item version.

Actors

• User

Pre-Conditions

• One item is selected • At least one item version in status “released” exists.

Flow of Events

• 1. The user chooses to view the release history for the selected item.
• 2. The system displays a list of all released versions of the item. For each entry, the version number and the date of release is displayed. The list is sorted descending by the date of release. The item with the most recent date of release is listed first.
• 3. The use case ends successfully.

Post-Conditions / Results

• A list of the released item versions is displayed, sorted in descending order.

UC_PM_BD_06 view item event log

The user chooses to view the log entries for the item versions, i.e. detailed information on all events. Events include creation of new item versions as well as status changes and their correlating action comments. For each log entry the user who executed the event, the date of this event and the version number is provided.

Status/Schedule

• Status: not implemented
• Schedule:to be defined

Triggers

• The user wants to see the log of an item. • This use case is included by the use case UC_PM_BD_04 view item version.

Actors

• Depositor • Moderator • Metadata-Editor • Authority

Pre-Conditions

• One item is selected. • The depositor is the owner of the item.

Flow of Events

• 1. The user chooses to see the item log.
• 2. The system displays all item versions and their corresponding log entries (see FE_PM_09 Logging). The list is sorted descending by the date of event. The most recent event is listed first.
• 3. (Optionally) The user chooses to view the differences between two item versions. Include UC_PM_BD_10 View differences between two item versions.
• 4. The use case ends successfully.

Post-Conditions / Results

• The event log of the item is displayed.

UC_PM_BD_07 view revisions of item

The user chooses to display all items for which a relation of type IsRevisionOf/HasRevision to/from the selected item exists. The selected item can be source or target of the relation. [R2]Only the relation of type “IsRevisionOf” will be implemented.

Status/Schedule

• Status: partly implemented R2 (hasRevisions not implemented, revision comments not implemented)
• Schedule:R3

Triggers

• The user wants to display the related revisions of a selected item. • This use case is included by the use case UC_PM_BD_04 view item version.

Actors

• User

Pre-Conditions

• One item is selected. • At least one revision of the item exists, which is in state “released”.

Flow of Events

• 1. The user chooses to view the revisions of a selected item.
• 2. The system displays a list of all former and a list of all later revisions of the item. Former revisions are items which have a relation of type “HasRevision” pointing to the selected item or items to which the selected item has a relation of type "IsRevisionOf". Later revisions are items which have a relation of type “IsRevisionOf” pointing to the selected item or items to which the selected item has a relation of type “HasRevision”. If a relation description exists, the system displays it. The lists are sorted descending by the date of release of the last released version. The item with the most recent date of release is listed first. The use case ends successfully.

Post-Conditions / Results

• The system displays a list of existing revisions of an item.

UC_PM_BD_08 view item statistics

The user chooses to display the usage statistics for an item.

Status/Schedule

• Status: in implementation
• Schedule:R3

Triggers

• The user wants to view the usage statistics for an item. • This use case is included by the use case UC_PM_BD_04 view item version.

Actors

• User

Pre-Conditions

• One item is selected.

Flow of Events

• 1. The user chooses to view the usage statistics for the selected item.
• 2. The system displays the statistical data (see FE_PM_10 Usage Statistics). The use case ends successfully.

Post-Conditions / Results

• The system displays the statistical data for the selected item.

UC_PM_BD_09 resolve item by PID

The user wants to view a specific item or item version by providing an URL assigned by the system for persistently citing the item or the item version.

Status/Schedule

• Status: partly implemented (resolution via URL is possible, but not yet via PID. TODO:UC should be renamed or reworked)
• Schedule:R3

Triggers

• The user wants to resolve a specific item or item version.

Actors

• User

Pre-Conditions

• None

Flow of Events

• 3. The user requests an item by providing the URL assigned by the system for persistently citing the item or the item version.
• 4. The system displays the item version details. If no explicit version is requested the last released version is displayed. The use case ends successfully.

Alternatives

• 4a. No item was found.
• 1. The system displays an error message (MSG_PM_BD_01). The use case ends without success.

Post-Conditions / Results

• The details of the item or a message is displayed.

UC_PM_BD_11 view my items

The user wants to view his items.

Status/Schedule

• Status: not implemented
• Schedule:R3

Triggers

• The user wants to overview all his items.

Actors

• Depositor

Pre-Conditions

• None

Flow of Events

• 1. The user chooses to overview his items.
• 2. The system displays the list of the last versions of all items the user is owner of and the number of list entries. The defaults for the sorting order (see FE_PM_03 Sort item list) and the number of hits per page are given by the system.
• 3. (Optionally) The user changes the sorting order of the item version list.
  • 3.1. The system displays the item version list in the selected sorted order.
• 4. (Optionally) The user chooses another number of hits to be displayed per page.
  • 4.1. The system displays the item version list containing the selected number of hits per page.
• 5. (Optionally) The user chooses to filter the item version list according to one item state or to all states.
  • 5.1. The system displays the list of the last versions of all items in the selected state or all states and the number of list entries.
• 6. Extension point: view item version
  • 6.1. If the user wants to view the item version, include use case UC_PM_BD_04 view item version.
• 7. Extension point: view current tasks for item
  • 7.1. If the user wants to view the current tasks for the item, include use case UC_PM_BD_13 view current tasks for item.
• 8. The use case ends successfully.

Post-Conditions / Results

• The filtered item version list is displayed in the selected sorting order containing the defined number of hits per page.

UC_PM_BD_12 view my tasks

The user wants to view the tasks in state “processing” assigned to him. From the task list the user is able to start the corresponding workflow actions.

Status/Schedule

• Status: not implemented (TODO: needs rework)
• Schedule:R3

Triggers

• The user wants to view his tasks in state “processing”.

Actors

• Account User

Pre-Conditions

• The user has at least one privilege in a publication or a modification workflow.

Flow of Events

• 1. The user chooses to view his tasks in state “processing”.
• 2. The system displays the list of tasks and the corresponding workflow actions. The list can be sorted by start date (default descending), label or object information.
• 3. (Optionally) The user changes the sorting criterion and order of the task list.
  • 3.1. The system displays the task list in the selected sorting criterion an order.
• 4. Extension point: edit item
  • 4.1. If the task is categorized as “editable”, the associated object is an item and the user wants to edit that item version, include use case UC_PM_SM_02 edit item.
• 5. Extension point: view item version
  • 5.1. If the associated object is an item and the user wants to view the item version, include use case UC_PM_BD_04 view item version.
• 6. (Optionally) The user chooses one workflow action, include the corresponding use case.
  • 6.1. The system sets the state of task to “finished”.
• 7. The use case ends successfully.

Comment Rupert:I would agree to have a task list which does not add additional management efforts for tasks. So maybe one extension point would be enough and - unless we face the situation were hundreds of task must be handled - I would keep the sorting out for now and keep the list simple. If we should go for work flows I would suggest to start as simple as possible.

Post-Conditions / Results

• The tasks in state “processing” for this user are displayed

UC_PM_BD_13 view current tasks for item

The user wants to view the tasks for a selected item.

Status/Schedule

• Status: not implemented (TODO: needs rework)
• Schedule:R3

Triggers

• The user wants to view the tasks for a selected item.

Actors

• Depositor

Pre-Conditions

• One item is selected.
• The user is the owner of the item.

Flow of Events

• 1. The user chooses to view the tasks for the selected item.
• 2. The system displays all the tasks in state “processing” to which the selected item is associated to. The use case ends successfully.

Post-Conditions / Results

• The tasks for the selected item are displayed.

Additional information

File visibility

The possibility of downloading a file depends on the visibility of the file or the privilege of the user to edit the item version. Files with the visibility

• “Private” can be downloaded by the owner,
• “Organizational unit” can be downloaded by any user who is member of any of the organizational units the file is visible by or their subunits,
• “Public” can be downloaded by all users of the system including the “anonymous user”.

Use Case

Quality Assurance

Persistent Identifer or Identification

Uniform Resource Locator