Library CRUD UI v1

Description

Purpose: Implementation of basic library CRUD. Will circle back on this later to add the locations column, once we have location CRUD working.

User story:
As a FOLIO administrator
I want a UI for creating, reading, updating and deleting library records
So I can use them when creating locations

Scenarios:

  1. Scenario: :check_mark:

    • Given Settings > Organization

    • When displayed

    • Then an option for "Location setup: libraries" should display :check_mark:

      • Should be in alpha order relative to the other options that don't begin with "Location setup:", but of the options that do begin with "Location setup:", it should come directly below "Location setup: campuses" as shown in the below linked wireframes :check_mark:

  2. Scenario:CB: Newly added scenario, as this is how Zak implemented it. Seems like it's probably fine as implemented.

    • Given Settings > Organization > Location setup: libraries

    • When selected

    • Then an Institution menu should display: :check_mark:

      • Containing all institutions that have been created in "Location setup: institutions" :check_mark:

      • Default: Select an institution :check_mark:

  3. Scenario: :check_mark:

    • Given Settings > Organization > Location setup: libraries

    • When selected

    • Then a Campus menu should display: :check_mark:

      • Containing all campuses that have been created in "Location setup: campuses" :check_mark:

      • Default: Select a campus :check_mark:

  4. Scenario: CB: This was not well worded. I had intended this to convey that, unless a campus has been selected, you shouldn't be able to CRUD libraries. Anyway, I have created a new story for this behavior UIORG-83

    • Given the Institution menu on Settings > Organization > Location setup: libraries

    • When Campus A is selected

    • Then I can CRUD libraries for Campus A

  5. Scenario: :check_mark:

    • Given Library CRUD on Settings > Organization > Location setup: libraries

    • When displayed

    • Then I should be able to CRUD libraries using the standard ControlledVocab component (per STCOM-228) configured with the following columns:

      • Name - Required

      • Code - Optional

      • Last updated

        • "<dateEdited> by <editorLastName>, <editorFirstName>"

        • Name should be link to user record

      • OUT OF SCOPE: # of locations - Count of location records using this library

  6. Scenario :check_mark:

    • Given a user does not have a First name specified

    • When displayed in the Last updated column

    • Then the comma between last and first name should not display

  7. Scenario:check_mark:

    • Given the controlled vocab CRUD pages

    • When User A is displayed in the Last updated column

    • Then the name should be a link to User A record CB: Let's do this even though it's not shown as such in the mockup

  8. Scenario :check_mark:

    • Given the dates displaying in the Last updated column

    • When locale is changed in Settings > Organization > Language and localization

    • Then the date format should update accordingly

  9. Scenario :check_mark:

    • Given a value row in the controlled vocab table

    • When displayed

    • Then a delete button/icon should be displayed

  10. Scenario :check_mark:

    • Given an libraries is NOT in use by one or more location record

    • When delete button/icon is clicked

    • Then a window will pop up asking user to confirm the deletion or cancel the deletion as shown here: https://drive.google.com/file/d/0By8ccf5VV4EWZkRSVXc2cE1IbmM/view?usp=sharing

      • Header: Delete library? CB: Please use sentence case, despite the title case used in the mock-ups

      • Body: <valueName> will be removed from <controlledVocabType>.

      • Buttons: Cancel, Delete

  11. Scenario :check_mark:

  12. Scenario :check_mark:

    • Given the Cancel button on the delete confirmation window

    • When clicked

    • Then the value will not be deleted and the modal popup will close

  13. Scenario :check_mark:

    • Given a library with no name specified

    • When save is attempted

    • Then:

      • Save is not allowed

      • Validation message should display reading, "Please fill this in to continue"

  14. Scenario :check_mark:

    • Given Settings > Orgaization> Location setup: libraries has unsaved changes

    • When I navigate away from the page by clicking another navigational element in FOLIO OR using the back button in the browser

    • Then I am presented with an unsaved changes notification

      • Text: Save changes?

      • Buttons:

        • Discard changes - Discards changes and allows user to navigate as indicated

        • Cancel - Closes notification popup and leaves user on create/edit user page. Unsaved changes remain and are unsaved.

Mockups:

Out of scope:

  • Location column (will circle back on this once we have location CRUD complete) UIORG-66

  • Disable delete if used by locations UIORG-67

Environment

None

Potential Workaround

None

Checklist

hide

TestRail: Results

Activity

Show:

Cate Boerema May 15, 2018 at 3:06 PM

Oh, I actually think scenario 4 was where I was trying to say that you couldn't CRUD libraries without first selecting a campus. It wasn't clear though

So that's now covered by https://folio-org.atlassian.net/browse/UIORG-83#icft=UIORG-83. I'll note that in the story description.

Adam Shire May 15, 2018 at 12:12 PM

I'm not sure how scenario 4 and 5 are different other than 5 has more detail about the fields.

Adam Shire May 15, 2018 at 12:06 PM

My mistake. I read the user story wrong and thought that the items were supposed to be in alpha-order.

Cate Boerema May 15, 2018 at 7:39 AM

I can confirm that the hierarchy is Institutions > Campuses > Libraries > Locations. Adam, do you have reason to think this will be problematic for some institutions? There was discussion early on of letting the names of these levels be configurable, but we moved away from that thinking that fixed levels and labels would aid cross-tenant reporting (when we get to that).

Zak Burke May 15, 2018 at 12:37 AM

, I'm pretty sure the hierarchy is institution > campus > library > location. From the schema point of view, at least, this is how things are configured, and this is the order of elements in the third mockup (https://drive.google.com/file/d/10a77bS-ibPW-ylfeOAuJ4fHvCvoARhyN/view).

Is there somebody we can double check this with?

Done

Details

Assignee

Reporter

Priority

Fix versions

TestRail: Cases

Open TestRail: Cases

TestRail: Runs

Open TestRail: Runs
Created March 24, 2018 at 10:41 AM
Updated June 7, 2018 at 12:41 PM
Resolved May 15, 2018 at 7:23 PM
TestRail: Cases
TestRail: Runs

Flag notifications