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:R3

Triggers
UC_PM_SR_01 do simple search,
 * This use case is included by the use cases

UC_PM_SR_03 do advanced search,

UC_PM_BD_03 browse by organizational unit and

UC_PM_BD_11 View my items

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 PubMan Display), the sorting order (see  PubMan Sorting) and the number of hits per page are given by the system (= by default: 10 hits per page)  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_04 view item version
The user views the details of a selected version of an item.

Status/Schedule

 * Status: implemented
 * Schedule:R5

Triggers

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

Actors

 * User

Pre-Conditions

 * One item version is selected.
 * See matrix for actions on versions/releases of an item under PubMan_Action_Matrix

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 PubMan Visibility). The possibility to view detailed information about each organization related to the item is offered, providing that information on this organization is stored in the system.
 * 3.	(Optionally) The user chooses to download a file.
 * 3.1.	The system provides the file for download.
 * 4. (Optionally) The user (only logged in users of the corresponding context) chooses to send an E-Mail to the moderator of the context, the item is administrated at.
 * 4.1 A Link from view item version is displayed. When the user clicks on the link, a new window opens with to prefilled with the contact address of the moderator of the responsible context and with the escidoc Id prefilled as subject. Further more the user can write a text and then send the Mail. Currently we took the pubman-support@gwdg.de mail address, as the contact address can't be defined per context yet.
 * 4.    (Optionally) The user chooses to view detailed information about an organization related to the item.
 * 4.1. The organizational unit detail view ("description") (see UC_PM_BD_03 Browse by organizational unit, step 4 ) is displayed, including the description and related affiliations (with Start_Date/End_Date) of the organizational unit. See scenario for history of affiliations linked from item view.
 * 5.    (Optionally) The user chooses to view the researcher profile of an author related to the item.
 * 5.1. The researcher profile, including a list of publications and person information stored in the CoNE service (see UC View researcher portfolio), is displayed, if the respective author has an authorized CONE person ID.
 * 6.	Extension point: view release history
 * 6.1.	If the user wants to view all released versions of the item and there is at least one released version of the item, include use case  UC_PM_BD_05 view release history.


 * 7.	Extension point: view item event log
 * 7.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.


 * 8.	Extension point: view revisions of item
 * 8.1.	If the user wants to view all related revisions of the item and if there is at least one related revision of the item, include use case UC_PM_BD_07 view revisions of item.


 * 9.	Extension point: view item statistics
 * 9.1.	If the user wants to view the statistics for an item, include UC_PM_BD_08 view item statistics.


 * 10.	Extension point: create item from template
 * 10.1.	If the user has the role “Depositor“ and wants to create a new item using the current item version as template, include UC_PM_SM_05 create item from template.


 * 11.	Extension point: create new revision of item
 * 11.1.	If the user has the role “Depositor”, and the current item version is in state “released” and the user wants to create a new revision for that released version, include use case UC_PM_SM_11 create new revision of item.
 * 12.	Extension point: modify item
 * 12.1.	If the user is allowed to start the modification workflow for the item, the last item version is selected and in state “released” and the user wants to modify that item version, include  UC_PM_QA_11 modify item.
 * 13.	Extension point: withdraw item
 * 13.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.
 * 14. Extension point: do simple export
 * 14.1 If the user wants to do a simple export of the item, include UC_PM_EX_02 Do simple export.
 * 15. Extension point: grant or revoke audience privileges for files
 * 15.1 If the user as allowed to grant or revoke audience rights for files of an item, include UC_PM_UM_11_Grant_or_revoke_audience_privileges_for_files.
 * 16.	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 (see PubMan Display). The use case ends successfully.

Post-Conditions / Results

 * The details of the item are displayed, including the information how to cite this item.

Future Developement

 * offer alternative 2b for navigating from previous/next single item view:

2b. The item was opened from a item list.
 * 1. The system gives the possibility to go to the next or previous item in the list.
 * 2. The system displays the previous/next item version


 * Link with "Cite this file as...."
 * automatically sending of private PDFs (The idea is that someone provides his email address - some mechanism shoud ensure that it is actually a person - and then the website should send the pdf.)

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:R3

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 and the release comment is displayed. The last released version of the revision is displayed. Note: In simple publication and simple modification workflow, the release comment is actually the submission comment. 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.

See also Logging

Status/Schedule

 * Status: implemented
 * Schedule:R3

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 Logging). The list is sorted descending by the date of event. The most recent event is listed first.


 * 4.	The use case ends successfully.

Post-Conditions / Results

 * The event log of the item is displayed.

Future Developments
add optional step 3:
 * 3.	(Optionally) The user chooses to view the differences between two item versions. Include UC_PM_BD_xx View differences between two item versions.

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.

Status/Schedule

 * Status: 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”.Note: this is valid for both sides of relation

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. Only immmediately related items are displayed (= first level of relation).

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 (comment) 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.

Future development
As semantic relations will be extended in future, better visualisation of related items needed. Details to be crosschecked with users:
 * increase visibility of OA revisions (e.g if revision of item exists, which is OA, highlight it)
 * increase visibility of chronological order of revisions (i.e. make understandable which is "latest"/most current revision)

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

See also Statistics

Status/Schedule

 * Status: implemented
 * 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 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 URL
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: implemented
 * Schedule:R3

Triggers

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

Actors

 * User

Pre-Conditions

 * None

Flow of Events

 * 1.	The user requests an item by providing the URL assigned by the system for persistently citing the item or the item version.
 * 2.	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

 * 2a. 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 her items.

Status/Schedule

 * Status: implemented
 * Schedule:R3

Triggers

 * The user wants to overview all her items.

Actors

 * Depositor

Pre-Conditions

 * None

Flow of Events
The defaults for the sorting order (see PubMan Sorting) and the number of hits per page are given by the system (= 10 hits per page are default).
 * 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.
 * 3.	 (Optionally) The user changes the sorting order of the item list.
 * 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 chooses to filter the item list according to one item state or to all states. Default sorting is by pending status.
 * 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.


 * 8.	The use case ends successfully.

Post-Conditions / Results

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

Future developments
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.
 * add another extension point:


 * Change default sorting for status of items from to, as soon as item retrieval from Framework is performant enough.

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
 * Schedule:to be defined

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.

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
 * Schedule:to be defined

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.

Comment DEV Team

 * Natasa: maybe we can rework this use case as at one time there can be only one task in state "processing" for an item. Again, workflow dependent, but probably view the item "position" in the workflow would be better i.e. not limit to state "processing". --Natasa 12:27, 22 January 2008 (CET)

''However we name the use case...the functionality should provide to a user to see, "where" in the workflow loop the item is currently...so it is indeed the position in the workflow. Agree to rework for future release. ''--Ulla 17:25, 1 February 2008 (CET)

Scenario
As we currently don't have a workflow engine, we decided to have a so called "moderator workspace" for now.

In the moderator workspace the moderator sees all items, which have been submitted in the collection(s) where s/he is moderator. Only the moderator can release items after s/he has checked them.

Specification
Status: implemented

Schedule: R3.5

Pre-conditions

 * Extended publication and modification workflow (e.g. depositor can only submit an item when s/he creates it)
 * the following is only true for users, which have only moderator privileges (if they also have depositor rights, they have two workspaces a depositor one and a moderator one)

Moderator Workspace

 * moderator can see all items, which s/he has privilege as moderator
 * the default sorting is descending by date of creation/last change of the item, so that the newest entry is listed first

Send back for re-work
See: Func. Spec. QA.

Prototype

 * Moderator Workspace

Future Development

 * the user name of the depositor should be visible within the QA workspace

Discussion
Talk:PubMan_Func_Spec_Browsing_and_displays

File visibility
The possibility of downloading a file depends on
 * the access level set to a file
 * the organisational unit a user is assigned to
 * the status of the item. Files attached to items in status, cannot be downloaded.

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”.

See PubMan File Properties for more information.

Display
Please see Display types on PubMan

Sorting
Please see Sorting on PubMan

Help
Please see Helptexts

Actions possible on versions/releases of items
PLease see PubMan Action Matrix

HTML Prototype

 * The publicly available HTML prototype for browsing and displays and for other functionalities can be accessed from here: eSciDoc Prototyping.