Faces Searching

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

UC_FAC_SR_01 Search
Status/Schedule
 * Status: implemented
 * Schedule: R2

Motivation
 * The user wants to search within the Faces collection.

Expected Outcome
 * The search result is displayed.

Steps
 * 1) The user chooses to execute a search.
 * 2) The system displays the search mask. The following information should be searchable: age (young, middle, old), age range, gender (female, male), person-id, emotion (neutrality, sadness, disgust, fear, anger, happiness), picture set (a, b).
 * 3) (Optionally) The user chooses not to search within the whole collection but selects a released album where he wants to search within.
 * 4) The user chooses one or more search/filter criteria and starts the search.
 * When searching for age, gender, emotion and/or picture set the user selects one or more checkboxes.
 * When searching for age range and/or person-id the user provides a search string.
 * For the person-id maximum triple-digit numbers are valid search string. Smaller numbers will be handled with one (for double-digit numbers) or two (single-digit numbers) zeros are in front of them (e.g. 12 will be handled as 012). To search for several ids, its valid to separate the numbers via a semicolon.
 * For the age range only double-digit numbers are valid values.
 * The search criteria will be combined within one attribute through the boolean operator OR (e.g. anger or happiness) and within the different attributes through the boolean operator AND (e.g. young and happiness).
 * 1) The system searches for the defined search criteria and creates a search result containing all pictures visible to the user according to his privileges (logged in or not).
 * 2) The system displays the search query and the list of pictures of the search result. Include UC_FAC_BD_01 View picture list.
 * 3) (Optionally) The user chooses to revise the search.
 * 6.1 The system displays the search mask again with the filled out search criteria the user has entered before.
 * 6.2 Continue with step 3.
 * 1) The user is satisfied with the search result. The use case ends successfully.

Alternatives
 * 6a. No picture matched the search request or no picture from the result set is visible to the user.
 * The system displays a message (MSG_FAC_SR_01). Continue with step 7.

Actors Involved
 * User

UC_FAC_SR_02 View all pictures of one person
Status/Schedule Motivation Pre-Condition Steps Actors Involved
 * Status: implemented
 * Schedule: R1
 * The user wants to see all pictures from a selected person.
 * One picture is selected (in the detailed view).
 * 1) The user chooses to see all pictures of the person depicted on the selected picture.
 * 2) The system performed an ID search for the ID of the depicted person.
 * 3) The system displays all pictures of the person. Include UC_FAC_BD_01 View picture list.
 * 4) The use case ends successfully.
 * User

UC_FAC_SR_03 Public Album Search
Status/Schedule
 * Status: implemented
 * Schedule: R3

Motivation
 * The user wants to search within the metadata of all released albums.

Pre-Condition
 * The public album search field is displayed.

Steps
 * 1) The user provides a search string into the public album search field and starts the search.
 * The search string consists of one or more search tokens. A token can be a single word (= term) or a phrase (= any string in double quotes). A term may contain wildcards in the middle or at the end (* for matching zero to many characters, ? for matching zero or one character). Wildcards are not allowed as the first character. Within a phrase token, no wildcards are allowed. Phrases are automatically right truncated, thus in its context, the phrase may be followed by any character. Tokens may be combined through boolean operators (AND, OR, NOT) and grouped by parenthesis. If no boolean operator is given between the tokens AND is used as default operator.
 * 1) The system searches for the search string in the selected album metadata (only in Album.Name, Album.Description, Album.Author, Album.Author.Affiliation, Album.FurtherAuthor, Album.FurtherAuthor.Affiliation)
 * 2) The system displays the search results. Include UC_FAC_BD_05 View album list
 * 3) The use case ends successfully.

Alternatives
 * 3.a No list entry matched the search request. The system displays a Message (MSG_FAC_SR_01). Continue with Step 7.

Actors Involved
 * User

UC_FAC_SR_04 Do simple search
Status/Schedule
 * Status: in specification
 * Schedule: imeji

Motivation
 * The user wants to search for pictures (not albums) by providing a simple search string.

Expected Outcome
 * The search result is displayed.

Pre-Condition
 * The simple search field is displayed.

Steps
 * 1) The user provides a search string into the simple search field and starts the search.
 * The search string consists of one or more search tokens. A token can be a single word (= term) or a phrase (= any string in double quotes). A term may contain wildcards in the middle or at the end (* for matching zero to many characters, ? for matching zero or one character). Wildcards are not allowed as the first character. Within a phrase token, no wildcards are allowed. Phrases are automatically right truncated, thus in its context, the phrase may be followed by any character. Tokens may be combined through boolean operators (AND, OR, NOT) and grouped by parenthesis. If no boolean operator is given between the tokens AND is used as default operator.
 * 1) The system searches for the defined search string in all metadata about the pictures and creates a search result containing all pictures visible to the user according to his privileges (logged in or not).
 * 2) The system displays the search query and the list of pictures of the search result. Include UC_FAC_BD_01 View picture list.
 * 3) The use case ends successfully.

Alternatives
 * 3a. No picture matched the search request or no picture from the result set is visible to the user.
 * The system displays a message (MSG_FAC_SR_01). Continue with step 4.

Actors Involved
 * User

Constraints
 * The simple search only searches for metadata of the pictures, not for metadata about albums, notepads, etc.

Further requirements

 * UC Search for album, in comparison to "Search for pictures" (required by Natasa)