Difference between revisions of "Faces Browse and Display"

From MPDLMediaWiki
Jump to navigation Jump to search
 
(173 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{ESciDoc Solutions}}
{{Faces}}


= Introduction =


== Introduction ==
A small glossary for the used terms can be found under [[Faces_Miscellaneous#Glossary|Miscellaneous]].<br/>
Please enter all comments concerning the use cases on the [[Talk:Faces_Browse_and_Display|discussion page]].


A small glossary for the used terms can be found under [[Faces_Miscellaneous#Glossary|Miscellaneous]].
As '''the current state of the spec focuses on a new release''', earlier states of the spec can be found in the history of this page:
* The [http://colab.mpdl.mpg.de/mediawiki/index.php5?title=Faces_Browse_and_Display&oldid=18602 spec for R2]
* The [http://colab.mpdl.mpg.de/mediawiki/index.php5?title=Faces_Browse_and_Display&oldid=20448 spec for R3]


= Pictures =


== UC_FAC_BD_01 View picture list ==
== UC_FAC_BD_01 View picture list ==
'''Status/Schedule'''
'''Status/Schedule'''
* Status: implemented
* Status: Implemented
* Schedule: '''R1'''
* Schedule: '''R1'''


Line 17: Line 22:
'''Triggers'''
'''Triggers'''
* This use case can be included by the use cases  
* This use case can be included by the use cases  
** [[Faces_Searching#UC_FAC_SR_01_Search_within_the_collection|UC_FAC_SR_01 Search within the collection]]
** [[Faces_Searching#UC_FAC_SR_01_Search|UC_FAC_SR_01 Search]]
** [[Faces_Searching#UC_FAC_SR_02_View_all_pictures_of_one_person|UC_FAC_SR_02 View all pictures of one person]]
** [[Faces_Searching#UC_FAC_SR_02_View_all_pictures_of_one_person|UC_FAC_SR_02 View all pictures of one person]]
** [[Faces_Browse_and_Display#UC_FAC_BD_05_View_album_details|UC_FAC_BD_05_View album details]]
** [[Faces_Searching#UC_FAC_SR_04_Do_simple_search|UC_FAC_SR_04 Do simple search]]
** [[Faces_Browse_and_Display#UC_FAC_BD_04_View_album_details|UC_FAC_BD_04 View album details]]


'''Steps''' <br/>
'''Steps''' <br/>
# The user chooses to view the whole list of available pictures or executed one of the above mentioned use cases.
# The user chooses to view the whole list of available pictures or executed one of the above mentioned use cases.
# The system displays the number of pictures and the list of pictures ('''list view'''). The defaults for the sorting order and the number of hits per page are given by the system (by default: sorted by emotion, number of hits per page:12).
# The system displays the pictures list in the default display type (Picture View) and the number of hits. The defaults for the sorting order and the number of hits per page are given by the system:
#* Sorted by Emotion (default)
#* sorted by Emotion (alphabetically: anger, disgust, fear, happiness, neutrality and sadness) - Person-ID (ascending) - Picture Set (ascending)
#: Emotion (alphabetically: anger, disgust, fear, happiness, neutrality and sadness) - Person-ID (ascending) - Picture Set (ascending)
#* number of hits per page: 12
# (Optionally) The user changes the sorting order of the first sorting criteria.
# (Optionally) The user changes the display type of the picture list.
#: 3.1 The system displays the picture list depending from the first sorting criteria in the following order (by default all sorting criteria are ascending):
#: 3.1 The system displays the picture list in the selected display type.
#::* by Age - Person ID - Emotion - Picture Set
# (Optionally) The user changes the sorting order by changing one or several sorting criteria, one or several ascending/descending arrows and confirms his choice.
#::* by Emotion - Person-ID - Picture Set
#: 4.1 The system displays the picture list depending on the selected sorting criteria.
#::* by Gender - Person-ID - Emotion  - Picture Set
# (Optionally) The user chooses another number of hits to be displayed per page (12, 24, 60, 90).
#::* by Person-ID - Emotion - Picture Set
#: 5.1 The system displays the picture list with the selected number of hits per page.
#::* by Picture Set - Person-ID - Emotion
# (Optionally) The user changes the sorting order of the second, third or forth sorting criteria.
#: 4.1 The system displays the picture list in the selected sorting order.
# (Optionally) The user changes the ascending/descending order of a sorting criteria.
#: 5.1 The system displays the picture list in the selected sorting order.
# (Optionally) The user chooses another number of hits to be displayed per page.
#: 6.1 The system displays the picture list containing the selected number of hits per page.
# (Optionally) The user goes to a special page, to the last page or to the first page.
# (Optionally) The user goes to a special page, to the last page or to the first page.
#: 7.1 The system displays the selected page.
#: 6.1 The system displays the selected page.
# Extension point: '''add pictures to album'''
#: 7.1 If the user wants to add pictures to one of his (shared) private albums, include [[Faces_Album_Management#UC_FAC_AM_02_Add_picture_to_album|UC_FAC_AM_02 Add picture to album]].
# The use case ends successfully.
# The use case ends successfully.


'''Actors Involved''' <br/>
'''Actors Involved''' <br/>
* User
* User


== UC_FAC_BD_02 View picture details ==
== UC_FAC_BD_02 View picture details ==
Line 57: Line 57:
'''Steps''' <br/>
'''Steps''' <br/>
# The user selects one picture.
# The user selects one picture.
# The system displays the picture in the web resolution ('''detailed view''') and all available attributes of the picture. The use case ends successfully.
# The system displays the picture in the web resolution ('''detailed view''') and all available attributes of the picture.
# Extension point: '''add pictures to album'''
#: 3.1 If the user wants to add pictures to one of his (shared) private albums, include [[Faces_Album_Management#UC_FAC_AM_02_Add_picture_to_album|UC_FAC_AM_02 Add picture to album]].
# The use case ends successfully.


'''Actors Involved''' <br/>
'''Actors Involved''' <br/>
* User
* User


== UC_FAC_BD_03 View picture for comparison ==
== UC_FAC_BD_03 View picture for comparison ==
Line 76: Line 78:
'''Steps''' <br/>
'''Steps''' <br/>
# The user chooses to view the picture for comparison (same image from the other picture set).
# The user chooses to view the picture for comparison (same image from the other picture set).
# The system displays the picture for comparison next to the selected one in the web resolution. The use case ends successfully.
# The system displays the picture for comparison next to the selected one in the web resolution.  
 
# Extension point: '''add pictures to album'''
'''Actors Involved''' <br/>
#: 3.1 If the user wants to add pictures to one of his (shared) private albums, include [[Faces_Album_Management#UC_FAC_AM_02_Add_picture_to_album|UC_FAC_AM_02 Add picture to album]].
* User
 
 
== UC_FAC_BD_04 Navigate within one picture ==
'''Status/Schedule'''
* Status: in specification
* Schedule: '''R3'''
 
'''Motivation''' <br/>
* The user wants to analyze one picture.
 
'''Pre-Condition''' <br/>
* One picture is selected (in the detailed view).
 
'''Steps''' <br/>
# (Optionally) The user zooms in and out within the picture.
# (Optionally) The user navigates left, right, up and down within the zoomed picture.
# (Optionally) The user switches back to see the whole picture.
# The use case ends successfully.
# The use case ends successfully.


Line 102: Line 86:
* User
* User


= Albums =


== UC_FAC_BD_05 View album details ==
== UC_FAC_BD_04 View album details ==
'''Status/Schedule'''
'''Status/Schedule'''
* Status: in design
* Status: implemented
* Schedule: '''R2'''
* Schedule: '''R3''' ''(without sharing and note pads)''


'''Motivation''' <br/>
'''Motivation'''  
* The user wants to view the details of an album.
* The user wants to view the details of an album.


'''Pre-Condition''' <br/>
'''Triggers'''
* This use case can be included by following use cases
:* [[Faces_Browse_and_Display#UC_FAC_BD_05_View_album_list|UC FAC BD 05 View album list]]
 
'''Pre-Condition'''
* One album is selected.
* One album is selected.
* Further pre-conditions are based on the state of the album:  
* Further pre-conditions are based on the state of the album:  
:{| border="1"
: '''pending:''' The user is the owner of the item or has administrator rights.
|width="100pt"| '''State'''
: '''released:''' None.
|width="500pt"|
: '''withdrawn:''' None.
|-
| submitted
| The user is the owner of the item.
|-
| released
| None.
|-
| withdrawn
| The user is the owner of the item.
|}


'''Steps''' <br/>
'''Steps'''  
# The user chooses to view the selected album.
# The user chooses to view the selected album.
# The album is in the state '''released'''. The system displays the name of the album, the owner of the album, the affiliation of the owner, the album description if available, the PID of the album and its publishing date. Include [[Faces_Browse_and_Display#UC_FAC_BD_01_View_picture_list|UC_FAC_BD_01 View picture list]].
# The system displays:
#* the metadata of the album (see [[Faces_Album_Management#Album_Metadata_Set|Album Metadata Set]])
#* the pictures of the album (include  [[Faces_Browse_and_Display#UC_FAC_BD_01_View_picture_list|UC_FAC_BD_01 View picture list]])
#* the number of pictures within the album together with an information when some of this pictures are private visible only (+ their number)
#* all available dates: created, last modified, published, withdrawn
#* the withdrawl comment (the PID of the album will be crossed out)
#* for shared albums: the user who has done the last modification of the album, all active shared users (user names) and user groups and the owner of the album
#* for shared albums the user is the owner: all shared users (user names for active users and e-mail address for inactive users) inclusive the state of the shared users and all user groups.
# Extension point: '''remove picture from album'''
#: 3.1 If the album is in the state '''pending''' or '''submitted''', the user is the '''owner''' of the album or a '''shared user''' of the album and wants to remove a picture from the album, include [[Faces_Album_Management#UC_FAC_AM_03_Remove_picture_from_album|UC_FAC_AM_03 Remove picture from album]].
# Extension point: '''edit album'''
#: 4.1 If the album is in the state '''pending''' or '''submitted''', the user is the '''owner''' of the album or a '''shared user''' of the album and wants to edit the album, include [[Faces_Album_Management#UC_FAC_AM_04_Edit_album|UC_FAC_AM_04 Edit album]].
# '''Not implemented yet:''' Extension point: '''share album'''
#: 5.1 If the album is in the state '''pending''' and the user is the '''owner''' of the album, include [[Faces_Album_Management#UC_FAC_AM_09_Share_album|UC_FAC_AM_09 Share album]].
# '''Not implemented yet:''' Extension point: '''unshare album'''
#: 6.1 If the album is in the state '''submitted''', the user is the '''owner''' of the album and at least one shared user for the album exists, include [[Faces_Album_Management#UC_FAC_AM_11_Unshare_album|UC_FAC_AM_11 Unshare album]].
# Extension point: '''delete album'''
#: 7.1 If the album is in the state '''pending''' or '''submitted''', no shared user exists and the user is the '''owner''' of the album and wants to delete the album, include [[Faces_Album_Management#UC_FAC_AM_05_Delete_album|UC_FAC_AM_05 Delete album]].
# Extension point: '''release album'''
#: 8.1 If the album is in the state '''pending''' or '''submitted''', the user is the '''owner''' of the album and wants to release the album, include [[Faces_Album_Management#UC_FAC_AM_06_Release_album|UC_FAC_AM_06 Release album]].
# Extension point: '''export album'''
# Extension point: '''export album'''
#: 3.1 If the user wants to export the pictures of the album, include [[Faces_Album_Management#UC_FAC_AM_09_Export_album|UC_FAC_AM_09 Export album]].
#: 9.1 If the album is not in the state '''withdrawn''' and the user wants to export the pictures of the album, include [[Faces_Album_Management#UC_FAC_AM_08_Export_album|UC_FAC_AM_08 Export album]].
# Extension point: '''withdraw album'''
#: 10.1 If the album is in the state '''released''', the user is the '''owner''' of the album and wants to withdraw the album, include use case [[Faces_Album_Management#UC_FAC_AM_07_Withdraw_album|UC_FAC_AM_07 Withdraw album]].
# '''Not implemented yet:''' Extension point: '''create private note pad'''
#: 11.1 If the user is the '''owner''' of the album or a '''shared user''' of the album and wants to create a private note pad for the album, include use case [[Faces_Note_Pads#UC_FAC_NP_01_Create_private_note_pad|UC_FAC_NP_01 Create private note pad]].
# '''Not implemented yet:''' Extension point: '''view note pad'''
#: 12.1 If a corresponding note pad in the state '''pending''' exists where the user is the '''owner''' or a '''shared user''' of the note pad and wants to view it, include [[Faces_Note_Pads#UC_FAC_NP_02_View_note_pad|UC_FAC_NP_02 View note pad]].
#: 12.2 If a corresponding note pad in the state '''released''' or '''withdrawn''' exists and the user wants to view it, include [[Faces_Note_Pads#UC_FAC_NP_02_View_note_pad|UC_FAC_NP_02 View note pad]].
# '''Not implemented yet:''' Extension point: '''view album event log'''
#: 13.1  If the user is the '''owner''' of the album or a '''shared user''' of the album and wants to view the event log of the album, include [[Faces_Versioning#UC_FAC_VS_01_View_album_event_log|UC_FAC_VS_01 View album event log]].
# The use case ends successfully.
# The use case ends successfully.
'''Alternatives''' <br/>
:2.a The album is in the state "'''withdrawn'''". The system displays the name of the album, the owner of the album, the affiliation of the owner, the album description if available, the crossed out PID of the album, its publishing and withdrawn date and the withdrawl comment. Include [[Faces_Browse_and_Display#UC_FAC_BD_01_View_picture_list|UC_FAC_BD_01 View picture list]].
:: 1. The use case ends successfully.
:2.b The album is in the state '''submitted'''. The system displays the name of the album, the album description if available and the created and last modified dates. Include [[Faces_Browse_and_Display#UC_FAC_BD_01_View_picture_list|UC_FAC_BD_01 View picture list]].
:: 1. Extension point: '''remove picture from album'''
::: 1.1 If the user wants to remove a picture from the album, include [[Faces_Album_Management#UC_FAC_AM_04_Remove_picture_from_album|UC_FAC_AM_04 Remove picture from album]].
:: 2. Extension point: '''rename album'''
::: 2.1 If the user wants to rename the album or change its description, include [[Faces_Album_Management#UC_FAC_AM_05_Edit_album|UC_FAC_AM_05 Edit album]].
:: 3. Extension point: '''delete album'''
::: 3.1 If the user wants to delete the album, include [[Faces_Album_Management#UC_FAC_AM_06_Delete_album|UC_FAC_AM_06 Delete album]].
:: 4. Extension point: '''release album'''
::: 4.1 If the user wants to release the album, include [[Faces_Album_Management#UC_FAC_AM_07_Release_album|UC_FAC_AM_07 Release album]].
:: 5. The use case ends successfully.
:4.a The user is the owner of the album.
:: 1. Extension point: '''withdraw album'''
::: 1.1 If the user wants to withdraw the album, include use case [[Faces_Album_Management#UC_FAC_AM_08_Withdraw_album|UC_FAC_AM_08 Withdraw album]].
:: 2. The use case ends successfully.


'''Actors Involved''' <br/>
'''Actors Involved'''  
* Account user
* Account user


== UC_FAC_BD_05 View album list ==
'''Status/Schedule'''
* Status: implemented
* Schedule: '''R3'''


== UC_FAC_BD_06 View my albums ==
'''Motivation'''
'''Status/Schedule'''
* The user wants to overview all his albums that are visible for him.
* Status: in design
 
* Schedule: '''R2'''
'''Pre-Condition'''
* One account user is selected.


'''Motivation''' <br/>
'''Triggers'''
* The user wants to overview all his albums.
* This use case can be included by following use cases
:* [[Faces_Searching#UC_FAC_SR_03_Public_Album_Search|UC_FAC_SR_03 Public Album Search]]


'''Steps''' <br/>
'''Steps'''
# The user chooses to overview his albums.
# The user chooses to overview all albums that are visible to him (all albums he is the owner of, all albums he shares and all published albums).
# The system displays the list of all albums the user is owner of and the number of list entries. In this list are displayed following information about each album: the name, the number of pictures, the description if available, the date last modified and the state. The defaults for the sorting order and the number of hits per page are given by the system (by default: sorted by name (alphabetically), number of hits per page:12).
# The system displays the list of all albums the selected user is allowed to see in the default display type (Grid View) and the number of list entries.
# (Optionally) The user changes the sorting order.
#* The defaults for the sorting order and the number of hits per page are given by the system (by default: date last modified (beginning with the newest date), number of hits per page: 10).
# (Optionally) The user changes the sorting order (each metadata can be used as sorting criteria).
#: 3.1 The system displays the album list in the selected sorting order.
#: 3.1 The system displays the album list in the selected sorting order.
# (Optionally) The user chooses another number of hits to be displayed per page.
# (Optionally) The user filters the displayed albums
#: 4.1 The system displays the album list containing the selected number of hits per page.
#: Following filter criteria are available:
#:* all my albums
#:* my private albums (incl. the ones I am sharing)
#:* my public albums
#:* all public albums
#:* my withdrawn albums
#: 4.1 The system filters the album list based on the selected filter criteria.
# (Optionally) The user chooses another number of hits per page (following numbers are available: 10, 25, 50, 75, 100).
#: 5.1 The system displays the album list with the selected number of hits per page.
# (Optionally) The user goes to a special page, to the last page or to the first page.
# (Optionally) The user goes to a special page, to the last page or to the first page.
#: 5.1 The system displays the selected page.
#: 6.1 The system displays the selected page.
# ''Extension point: '''search within album list'''''
# Extension point: '''view album details'''
#: ''6.1 If the user wants to search within the album list, include [[Faces_Searching#UC_FAC_SR_03_Search_within_album_list|UC_FAC_SR_03 Search within album list]].''
#: 7.1 If the user wants to view the details of a selected album, include [[Faces_Browse_and_Display#UC_FAC_BD_04_View_album_details|UC_FAC_BD_04 View album details]].
# '''Not implemented yet:''' Extension point: '''copy album content'''
#: 8.1 If the user wants to copy the content of one album, include [[Faces_Album_Management#UC_FAC_AM_12_Copy_album_content|UC_FAC_AM_12 Copy album content]].
# The use case ends successfully.
# The use case ends successfully.


'''Actors Involved''' <br/>
'''Actors Involved'''  
* Account user
* Account user


== UC_FAC_BD_07 Resolve album by URL ==
'''Status/Schedule'''
* Status: implemented
* Schedule: '''R2'''
'''Motivation'''
* A not logged in user follows a (published) link to a released album.
'''Steps'''
# The user requests an album by providing the URL assigned by the system for persistently citing the album.
# The system displays the metadata of the album (see [[Faces_Application_Profile_Album|Application Profile Album]]) and following further information depending on the state of the album:
#: '''released:''' The publishing date
#: '''withdrawn:''' The publishing and withdrawn dates and the withdrawl comment (the PID is crossed out)


== UC_FAC_BD_07 View released albums ==
'''Actors Involved'''
* User
 
== UC_FAC_BD_08 View file metadata ==
'''Status/Schedule'''
'''Status/Schedule'''
* Status: in design
* Status: implemented
* Schedule: '''R2'''
* Schedule: '''R3'''
 
'''Motivation'''
* The user wants to see the file metadata (see [[Faces_Application_Profile_FacesFile|Faces Application Profile FacesFile]]) of a file, which are mostly technical metadata.
 
'''Pre-Condition'''
* One picture is selected.


'''Motivation''' <br/>
'''Triggers'''  
* The user wants to overview all released albums.


'''Steps''' <br/>
'''Steps'''  
# The user chooses to overview all released albums.
# The user chooses to view file metadata about the selected picture.
# The system displays the list of all released albums and the number of list entries. In this list are displayed following information about each album: the name, the number of pictures, the description if available, the owner, the affiliation of the owner and the date published. The defaults for the sorting order and the number of hits per page are given by the system (by default: sorted by name (alphabetically), number of hits per page:12).
# The system displays the available resolutions (thumbnail, web resolution, original resolution) of the selected picture.
# (Optionally) The user changes the sorting order.
# The user chooses one resolution for which he wants to see the file metadata.
#: 3.1 The system displays the album list in the selected sorting order.
# The system displays the file metadata (in XML) of the selected resolution. The use case ends successfully.
# (Optionally) The user chooses another number of hits to be displayed per page.
#: 4.1 The system displays the album list containing the selected number of hits per page.
# (Optionally) The user goes to a special page, to the last page or to the first page.
#: 5.1 The system displays the selected page.
# ''Extension point: '''search within album list'''''
#: ''6.1 If the user wants to search within the album list, include [[Faces_Searching#UC_FAC_SR_03_Search_within_album_list|UC_FAC_SR_03 Search within album list]].''
# The use case ends successfully.


'''Actors Involved''' <br/>
'''Actors Involved'''
* User
* User


= Further =


== UC_FAC_BD_08 Resolve released album by URL ==  
== UC_FAC_BD_10 View statistics ==
'''Status/Schedule'''
* Status: implemented
* Schedule: '''R3'''
 
'''Motivation'''
* The user chooses view the usage statistics (see [[Faces_Statistics|Faces Statistics]]) for the Faces solution.
 
'''Steps'''
# The user chooses to view the usage statistics for Faces.
# The system displays the statistical data of the last 12 months (including the current month) which have been collected per month. The use case ends successfully.
 
'''Actors Involved'''
* Administrator
 
== UC_FAC_BD_11 Navigate within one picture ==
'''Status/Schedule'''
'''Status/Schedule'''
* Status: in design
* Status: in design
* Schedule: '''R2'''
* Schedule: '''???'''
 
'''Motivation'''
* The user wants to analyze one picture. Therfore, the [[Digilib]] tool will be used.


'''Motivation''' <br/>
'''Pre-Condition'''
* A not logged in user follows a (published) link to a released album.
* One picture is selected (in the detailed view).


'''Steps''' <br/>
'''Steps'''
# The user requests a released album by providing the URL assigned by the system for persistently citing the released album.  
# (Optionally) The user zooms in and out within the picture.
# The system displays the metadata of the released album (not the pictures) and a message ([[Faces_System_Messages|MSG_FAC_AM_06]]). The use case ends successfully.  
# (Optionally) The user navigates left, right, up and down within the zoomed picture.
# (Optionally) The user switches back to see the whole picture.
# The use case ends successfully.


'''Actors Involved''' <br/>
'''Actors Involved'''
* User
* User


== UC_FAC_BD_12 View note pad ==
'''Status/Schedule'''
* Status: in design
* Schedule: '''???'''
'''Motivation'''
* The user wants to view a note pad.


== Further Development ==
'''Pre-Condition'''
* One note pad is selected.
* Further pre-conditions are based on the state of the album:
*: '''pending:'''
*:* For private note pads: the user is the owner of the note pad.
*:* For shared note pads: the user shares the notepad or is the owner of the note pad.
*: '''released:''' None.
*: '''withdrawn:''' None.


'''Triggers'''
* This use case can be included by following use cases
:* [[Faces_Browse_and_Display#UC_FAC_BD_04 View album details|UC_FAC_BD_04 View album details]]


==== Identified Use Cases ====
'''Steps'''
* UC_FAC_BD_ View technical metadata -->'''R3'''
# The user chooses to view the selected note pad.
# The system displays the note pad and its metadata (see [[Faces_Note_Pads#Note_Pad_Metadata_Set|Note Pad Metadata Set]]).
#: For '''shared note pads''', additionally following properties will be displayed
#:# For the '''owner''' of the note pad:
#:#* List of shared users (e-mail address, user name) and list of invited users (e-mail address)
#:# For the '''shared users''' of the note pad:
#:#* List of shared users (user name) and number of invited users
# Extension point: '''edit note pad '''
#: 3.1 If the note pad is in state '''pending''', the user is the '''owner''' or shares the the note pad and wants to edit it, include [[Faces_Note_Pads#UC_FAC_NP_02_Edit_note_pad|UC_FAC_NP_02 Edit note pad]].
# Extension point: '''delete note pad '''
#: 4.1 If the note pad is the state '''pending''', the user is the '''owner''' of the note pad and wants to delete it, include [[Faces_Note_Pads#UC_FAC_NP_04_Delete_note_pad|UC_FAC_NP_04 Delete note pad]].
# Extension point: '''release note pad '''
#: 5.1 If the note pad is in the state '''pending''', the user is the '''owner''' of the note pad and wants to release it, include [[Faces_Note_Pads#UC_FAC_NP_05_Release_note_pad|UC_FAC_NP_05 Release note pad]].
# Extension point: '''withdraw note pad '''
#: 6.1 If the note pad is in the state '''released''', the user is the '''owner''' of the note pad and wants to withdraw it, include [[Faces_Note_Pads#UC_FAC_NP_06_Withdraw_note_pad|UC_FAC_NP_06 Withdraw note pad]].
# Extension point: '''view album details'''
#: 7.1 If the user wants to view the album the note pad corresponds to, include [[Faces_Browse_and_Display#UC_FAC_BD_04_View_album_details|UC_FAC_BD_04 View album details]].
# The use case ends successfully.
 
'''Actors Involved'''
* Account user




[[Category:Faces|Browse and Display]]
[[Category:Faces_Functional_Specification|Browse and Display]]
[[Category:Functional_specification]]

Latest revision as of 11:27, 12 January 2012

FACES

Scope · Functionalities
Disclaimer and Copyright
Support

Application Profiles
Release Agreement

Specification:
Browse and Display · Search
Albums · Users
Note Pads · Versioning

Related Projects:
Imeji

edit


Introduction[edit]

A small glossary for the used terms can be found under Miscellaneous.
Please enter all comments concerning the use cases on the discussion page.

As the current state of the spec focuses on a new release, earlier states of the spec can be found in the history of this page:

Pictures[edit]

UC_FAC_BD_01 View picture list[edit]

Status/Schedule

  • Status: Implemented
  • Schedule: R1

Motivation

  • The user wants to view several or all pictures of the collection in the list view.

Triggers

Steps

  1. The user chooses to view the whole list of available pictures or executed one of the above mentioned use cases.
  2. The system displays the pictures list in the default display type (Picture View) and the number of hits. The defaults for the sorting order and the number of hits per page are given by the system:
    • sorted by Emotion (alphabetically: anger, disgust, fear, happiness, neutrality and sadness) - Person-ID (ascending) - Picture Set (ascending)
    • number of hits per page: 12
  3. (Optionally) The user changes the display type of the picture list.
    3.1 The system displays the picture list in the selected display type.
  4. (Optionally) The user changes the sorting order by changing one or several sorting criteria, one or several ascending/descending arrows and confirms his choice.
    4.1 The system displays the picture list depending on the selected sorting criteria.
  5. (Optionally) The user chooses another number of hits to be displayed per page (12, 24, 60, 90).
    5.1 The system displays the picture list with the selected number of hits per page.
  6. (Optionally) The user goes to a special page, to the last page or to the first page.
    6.1 The system displays the selected page.
  7. Extension point: add pictures to album
    7.1 If the user wants to add pictures to one of his (shared) private albums, include UC_FAC_AM_02 Add picture to album.
  8. The use case ends successfully.

Actors Involved

  • User

UC_FAC_BD_02 View picture details[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R1

Motivation

  • The user wants to view one picture in detail (a higher resolution of the picture and its attributes).

Steps

  1. The user selects one picture.
  2. The system displays the picture in the web resolution (detailed view) and all available attributes of the picture.
  3. Extension point: add pictures to album
    3.1 If the user wants to add pictures to one of his (shared) private albums, include UC_FAC_AM_02 Add picture to album.
  4. The use case ends successfully.

Actors Involved

  • User

UC_FAC_BD_03 View picture for comparison[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R1

Motivation

  • The user wants to see both picture sets of one image to compare them with each other.

Pre-Condition

  • One picture is selected (in the detailed view).

Steps

  1. The user chooses to view the picture for comparison (same image from the other picture set).
  2. The system displays the picture for comparison next to the selected one in the web resolution.
  3. Extension point: add pictures to album
    3.1 If the user wants to add pictures to one of his (shared) private albums, include UC_FAC_AM_02 Add picture to album.
  4. The use case ends successfully.

Actors Involved

  • User

Albums[edit]

UC_FAC_BD_04 View album details[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R3 (without sharing and note pads)

Motivation

  • The user wants to view the details of an album.

Triggers

  • This use case can be included by following use cases

Pre-Condition

  • One album is selected.
  • Further pre-conditions are based on the state of the album:
pending: The user is the owner of the item or has administrator rights.
released: None.
withdrawn: None.

Steps

  1. The user chooses to view the selected album.
  2. The system displays:
    • the metadata of the album (see Album Metadata Set)
    • the pictures of the album (include UC_FAC_BD_01 View picture list)
    • the number of pictures within the album together with an information when some of this pictures are private visible only (+ their number)
    • all available dates: created, last modified, published, withdrawn
    • the withdrawl comment (the PID of the album will be crossed out)
    • for shared albums: the user who has done the last modification of the album, all active shared users (user names) and user groups and the owner of the album
    • for shared albums the user is the owner: all shared users (user names for active users and e-mail address for inactive users) inclusive the state of the shared users and all user groups.
  3. Extension point: remove picture from album
    3.1 If the album is in the state pending or submitted, the user is the owner of the album or a shared user of the album and wants to remove a picture from the album, include UC_FAC_AM_03 Remove picture from album.
  4. Extension point: edit album
    4.1 If the album is in the state pending or submitted, the user is the owner of the album or a shared user of the album and wants to edit the album, include UC_FAC_AM_04 Edit album.
  5. Not implemented yet: Extension point: share album
    5.1 If the album is in the state pending and the user is the owner of the album, include UC_FAC_AM_09 Share album.
  6. Not implemented yet: Extension point: unshare album
    6.1 If the album is in the state submitted, the user is the owner of the album and at least one shared user for the album exists, include UC_FAC_AM_11 Unshare album.
  7. Extension point: delete album
    7.1 If the album is in the state pending or submitted, no shared user exists and the user is the owner of the album and wants to delete the album, include UC_FAC_AM_05 Delete album.
  8. Extension point: release album
    8.1 If the album is in the state pending or submitted, the user is the owner of the album and wants to release the album, include UC_FAC_AM_06 Release album.
  9. Extension point: export album
    9.1 If the album is not in the state withdrawn and the user wants to export the pictures of the album, include UC_FAC_AM_08 Export album.
  10. Extension point: withdraw album
    10.1 If the album is in the state released, the user is the owner of the album and wants to withdraw the album, include use case UC_FAC_AM_07 Withdraw album.
  11. Not implemented yet: Extension point: create private note pad
    11.1 If the user is the owner of the album or a shared user of the album and wants to create a private note pad for the album, include use case UC_FAC_NP_01 Create private note pad.
  12. Not implemented yet: Extension point: view note pad
    12.1 If a corresponding note pad in the state pending exists where the user is the owner or a shared user of the note pad and wants to view it, include UC_FAC_NP_02 View note pad.
    12.2 If a corresponding note pad in the state released or withdrawn exists and the user wants to view it, include UC_FAC_NP_02 View note pad.
  13. Not implemented yet: Extension point: view album event log
    13.1 If the user is the owner of the album or a shared user of the album and wants to view the event log of the album, include UC_FAC_VS_01 View album event log.
  14. The use case ends successfully.

Actors Involved

  • Account user

UC_FAC_BD_05 View album list[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R3

Motivation

  • The user wants to overview all his albums that are visible for him.

Pre-Condition

  • One account user is selected.

Triggers

  • This use case can be included by following use cases

Steps

  1. The user chooses to overview all albums that are visible to him (all albums he is the owner of, all albums he shares and all published albums).
  2. The system displays the list of all albums the selected user is allowed to see in the default display type (Grid View) and the number of list entries.
    • The defaults for the sorting order and the number of hits per page are given by the system (by default: date last modified (beginning with the newest date), number of hits per page: 10).
  3. (Optionally) The user changes the sorting order (each metadata can be used as sorting criteria).
    3.1 The system displays the album list in the selected sorting order.
  4. (Optionally) The user filters the displayed albums
    Following filter criteria are available:
    • all my albums
    • my private albums (incl. the ones I am sharing)
    • my public albums
    • all public albums
    • my withdrawn albums
    4.1 The system filters the album list based on the selected filter criteria.
  5. (Optionally) The user chooses another number of hits per page (following numbers are available: 10, 25, 50, 75, 100).
    5.1 The system displays the album list with the selected number of hits per page.
  6. (Optionally) The user goes to a special page, to the last page or to the first page.
    6.1 The system displays the selected page.
  7. Extension point: view album details
    7.1 If the user wants to view the details of a selected album, include UC_FAC_BD_04 View album details.
  8. Not implemented yet: Extension point: copy album content
    8.1 If the user wants to copy the content of one album, include UC_FAC_AM_12 Copy album content.
  9. The use case ends successfully.

Actors Involved

  • Account user

UC_FAC_BD_07 Resolve album by URL[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R2

Motivation

  • A not logged in user follows a (published) link to a released album.

Steps

  1. The user requests an album by providing the URL assigned by the system for persistently citing the album.
  2. The system displays the metadata of the album (see Application Profile Album) and following further information depending on the state of the album:
    released: The publishing date
    withdrawn: The publishing and withdrawn dates and the withdrawl comment (the PID is crossed out)

Actors Involved

  • User

UC_FAC_BD_08 View file metadata[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R3

Motivation

Pre-Condition

  • One picture is selected.

Triggers

Steps

  1. The user chooses to view file metadata about the selected picture.
  2. The system displays the available resolutions (thumbnail, web resolution, original resolution) of the selected picture.
  3. The user chooses one resolution for which he wants to see the file metadata.
  4. The system displays the file metadata (in XML) of the selected resolution. The use case ends successfully.

Actors Involved

  • User

Further[edit]

UC_FAC_BD_10 View statistics[edit]

Status/Schedule

  • Status: implemented
  • Schedule: R3

Motivation

  • The user chooses view the usage statistics (see Faces Statistics) for the Faces solution.

Steps

  1. The user chooses to view the usage statistics for Faces.
  2. The system displays the statistical data of the last 12 months (including the current month) which have been collected per month. The use case ends successfully.

Actors Involved

  • Administrator

UC_FAC_BD_11 Navigate within one picture[edit]

Status/Schedule

  • Status: in design
  • Schedule: ???

Motivation

  • The user wants to analyze one picture. Therfore, the Digilib tool will be used.

Pre-Condition

  • One picture is selected (in the detailed view).

Steps

  1. (Optionally) The user zooms in and out within the picture.
  2. (Optionally) The user navigates left, right, up and down within the zoomed picture.
  3. (Optionally) The user switches back to see the whole picture.
  4. The use case ends successfully.

Actors Involved

  • User

UC_FAC_BD_12 View note pad[edit]

Status/Schedule

  • Status: in design
  • Schedule: ???

Motivation

  • The user wants to view a note pad.

Pre-Condition

  • One note pad is selected.
  • Further pre-conditions are based on the state of the album:
    pending:
    • For private note pads: the user is the owner of the note pad.
    • For shared note pads: the user shares the notepad or is the owner of the note pad.
    released: None.
    withdrawn: None.

Triggers

  • This use case can be included by following use cases

Steps

  1. The user chooses to view the selected note pad.
  2. The system displays the note pad and its metadata (see Note Pad Metadata Set).
    For shared note pads, additionally following properties will be displayed
    1. For the owner of the note pad:
      • List of shared users (e-mail address, user name) and list of invited users (e-mail address)
    2. For the shared users of the note pad:
      • List of shared users (user name) and number of invited users
  3. Extension point: edit note pad
    3.1 If the note pad is in state pending, the user is the owner or shares the the note pad and wants to edit it, include UC_FAC_NP_02 Edit note pad.
  4. Extension point: delete note pad
    4.1 If the note pad is the state pending, the user is the owner of the note pad and wants to delete it, include UC_FAC_NP_04 Delete note pad.
  5. Extension point: release note pad
    5.1 If the note pad is in the state pending, the user is the owner of the note pad and wants to release it, include UC_FAC_NP_05 Release note pad.
  6. Extension point: withdraw note pad
    6.1 If the note pad is in the state released, the user is the owner of the note pad and wants to withdraw it, include UC_FAC_NP_06 Withdraw note pad.
  7. Extension point: view album details
    7.1 If the user wants to view the album the note pad corresponds to, include UC_FAC_BD_04 View album details.
  8. The use case ends successfully.

Actors Involved

  • Account user