Skip to content

Brandeis-Library/Inventory_App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

{Inventory App}

{An application to help automate the physical inventory for libraries using ExLibris Alma.}, {04/15/2020}

By {Chris Underwood}

Description

_{ The current version of the application grabs a barcode via a barcode scanning and automatically send the barcode to an ALMA API and returns an object that contains the bib, holdings, and item records. Selected fields are shown on the screen. Then the system does a check to see if the current date is in the Inventory Date field. If yes, nothing is done. If not, a request is automatically sent to the backend to update the Inventory Date and return a updated item object. The date updated date is then presented on screen.

There are also 2 special checks: 1) to see if the item is "commited to retain" in the holdings record, 2) to see if the item is being held in a temporary location. Both of these are hidden unless true and are shown in bold in the Barcode Being Retrieved section. None, one, or two of these special fields can be true.

There is a text field on the screen that maps to item_note_3 where notes can be saved. When the Update Inventory button is pressed, the object is returned with item_note_3 in inventory_date for today's date.

The application has a React frontend and a node backend each with their own servers. }_

Setup/Installation Requirements

  • Make sure you have Node.js installed globally
  • Clone or fork the files to a location of your choice
  • Go to the folder/location of the download or where you have moved the files
  • On your terminal go to backend.
  • Run npm i
  • At the root of backend create an .env file
  • Fill in the data for the 4 environmental variables: EXLIBRIS_API_ROOT, EXLIBRIS_API_PATH, EXLIBRIS_API_BIB_GET_KEY, EXLIBRIS_API_BIB_UPDATE_KEY
  • At the terminal type npm run start to start the backend server.
  • In your web browser, navigate to localhost:9000 to see if the server is running.
  • On a new terminal instance, navigate to frontend
  • Run npm i
  • On the terminal run npm run start to start the front end server.
  • Navigate to localhost:3000 to see if the frontend is live

Known Bugs

{ At this time, the application is behaving as designed. We have plans to add more features such as adding more options for updating data and reviewing security options. }

Support and contact details

{ https://knowledge.exlibrisgroup.com/Alma, libsys-group at brandeis dot edu }

Technologies Used

{ Node.js. React.js, vanilla JavaScript, Express.js, nodemon, axios, body-parser }

License

*{MIT License

Copyright (c) [2020] [Brandeis University Library]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.}*

Copyright (c) 2020 {Chris Underwood, Library Applicaiton Developer, Brandeis University}

About

App for taking physical inventory of library collections with Ex Libris Alma.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published