Equipment Lending Library
On this page
The Equipment Lending Library lends assets. A library item is the lending record of one asset: it names the asset and, optionally, a service, and it holds the item's current loan: the borrower, the check-out date, and the due date. A reservation is a separate record that names a library item, the person who requested it, and a date range.
Reserving equipment in the Self Service Portal is covered in Reserve Equipment.
In the Web App
In the sidebar, the Asset Management group holds Equipment Lending Library, the list of library items, and Equipment Reservations, the list of reservations. Library items and reservations are also offered in the search class picker and the related-object class picker. Library items are also configuration items, so the All CIs list of the Configuration Management group lists them too, and opening one there in the current tab opens the library item's own form; see All CIs.
What you can see
The list of library items shows each item's service and its asset's name, asset tag, barcode, price, current value, and other financial figures. The asset columns stay empty for an asset you may not see.
Library items and reservations each have three permissions in a security role: View, Modify, and Delete, each a single grant with no owner-based variants. The Equipment Lending Library and Equipment Reservations lists show only the records your roles let you view. When the role that grants the permission is restricted to workspaces, they show only the records in those workspaces. See Security Roles and Permissions Reference.
A library item's service does not limit which items you see in the Web App.
Library items
The library item form's tabs are General, Activity, Reservations, Custom Data, Related Objects, Notes, History, and Attachments.
A library item has no category, organization, or location of its own. There is no separate loan record: the item itself holds its current loan. When the item is checked in, that loan is copied into the item's circulation history and cleared from the item.
The library item form holds the circulation history as a read-only list of past loans. Its default view shows the out date, due date, return date, and borrower of each loan, sorted by out date. Its rows do not open. Deleting a library item also deletes its circulation history.
A library item at its class's inactive status opens read-only: every field is locked, Save is disabled, and its attachments cannot be edited. A library item also opens read-only in this way when your roles do not let you modify library items.
Reservations
The reservation form's tabs are General, Activity, Custom Data, Related Objects, Notes, History, and Attachments.
A reservation has no name, owner, category, organization, or location of its own. Alloy Navigator itself does not test a reservation against the item's other reservations, so two reservations of the same library item can overlap unless your workflow checks for conflicts.
The Equipment Reservations list
In a new database created with the Default Workflow, the Equipment Reservations list offers eleven shared views: Active, All Reservations, by Requester, by Status, by Type, Canceled, Closed, List, Pending, Reservation Ends Today, and Reservation Starts Today. When you first open the list, it shows the List view. After the check box, the row's action button, and the flag, its columns are ID, Library Item, Type, Status, Requester, Reservation Date From, and Reservation Date To, and its rows are sorted by Library Item and then by Reservation Date From. For switching and saving views, see Lists and Views.
The list toolbar's New Equipment Reservation button opens a menu of the actions that create a reservation. In the supplied configuration it has one entry, Reservation, granted to the Library Manager, Administrator (Full), and Administrator (Workflow) roles.
In the supplied configuration, a reservation can also be created from a service request whose related CI is a library item, with the action Create Reservation; see Service Request Workflow.
Add a reservation from the list
- In the Equipment Reservations list, click New Equipment Reservation and choose Reservation.
- In the "Reserve a Library Item" form, select the Library Item, the Type, and the Requester, and enter the Reservation Date From and the Reservation Date To. All five are required, and Type starts at Short Term.
- Click Submit, or Submit and open.
Lend and return library items
A new database created with the Default Workflow contains workflow actions that lend and return library items, the actions that retire computers, hardware items, and assets, and the statuses these actions use. An upgraded database need not contain them, and an administrator may have changed them; see Default Workflow Configuration. Where an action appears, who may run it, and in which statuses it is offered are set in the workflow; see Workflow Overview.
The library item actions Check Out and Check In and the reservation action Check Out Item appear in the General group of the record's Action Bar, not on the record's toolbar. They are also offered in a list's action menu, opened from the list toolbar's action button or from a row's own action button. From the list toolbar's action button, they can run on several selected records at once. Each is offered only to the security roles it is granted to.
Check out a library item
- Open a library item at Available, or select one or more such items in the Equipment Lending Library list.
- Click Check Out in the General group of the Action Bar, or choose it from the list's action menu.
- In the "Check out this Library Item" form, select the person you lend the item to in Checked Out to, and enter the Check Out Date and Due Date. All three are required; Check Out Date starts at the current date and time. Optionally, enter Time Spent.
- Submit the form.
The item goes to Checked Out and records the activity "Marked as 'Checked Out'". When its asset is not already at Loaned or Retired, the asset goes to Loaned, and so does the computer or hardware item associated with that asset. When the borrower is someone other than you, the e-mail notification "E-mail Checked Out to Confirmation" is sent.
Check Out stops with a message instead when:
- The check-out date or the due date falls within the date range of one of the item's reservations at Pending or Active. Only these two dates are tested, so a loan whose dates enclose a whole reservation is not refused. The test does not look at who requested the reservation, so it also stops a check-out to the requester. To lend the item to the requester of a reservation at Pending, use Check Out Item on that reservation.
- The due date is before the check-out date: "The Due Date value cannot be before the Check Out Date value."
Lend a reserved item to its requester
- Open a reservation at Pending, or select it in the Equipment Reservations list.
- Click Check Out Item in the General group of the Action Bar, or choose it from the list's action menu.
- The "Check Out Item" form offers Comment, Time Spent, and Publish to Self-Service Portal. Fill them in as needed and submit the form.
The reservation goes to Fulfilled and records the activity "Reservation Fulfilled" with the comment from the form. The library item is lent to the reservation's requester, with the reservation's end date as the due date: it goes to Checked Out and records the activity "<Full Name> Checked Out". The check-out date becomes either the current date and time or the reservation's start date. When the item's asset is not already at Loaned or Retired, the asset goes to Loaned, and so does the computer or hardware item associated with that asset. No e-mail notification is sent.
Check Out Item stops with a message instead when:
- The library item is not at Available: "The Library Item is currently unavailable."
- The reservation conflicts with another reservation of the item: "Fulfilling this reservation is not currently possible due to a pre-existing reservation."
Check in a library item
- Open a library item at Checked Out or Overdue, or select such items in the Equipment Lending Library list.
- Click Check In in the General group of the Action Bar, or choose it from the list's action menu.
The current loan moves to the item's circulation history, and the item goes to Available. The item's reservations that match the loan's dates go to Fulfilled. The asset, and the computer or hardware item associated with it, go to Loanable.
Retired library items
The inactive status of library items is named Retired in the supplied configuration. When Retire Asset retires an asset, or Retire Computer or Retire Hardware also retires the asset associated with the computer or hardware item, each library item of that asset that is not yet Retired becomes Retired, and its reservations that are not Closed become Closed. The library item records no activity for this change.
When the asset associated with a computer or hardware item has a library item, the Retire Computer and Retire Hardware forms show "This Computer is associated with an existing Library item. Proceeding will retire the Library item as well." or "This Hardware is associated with an existing Library item. Proceeding will retire the Library item as well." The Retire Asset form, "Provide a Reason", with Comment, Time Spent, and Attachments, shows no such message.
The reservations calendar
Review an item's reservations
- In Asset Management > Equipment Lending Library, open the item.
- Open Reservations.
- Use the month picker or the Today, back, and forward buttons to find the dates you want. In the Status pane, choose the reservation statuses to show.
If no reservation statuses are saved in your filter, the calendar shows only the current loan bar. Past loans are in the item's circulation history, not on this calendar.
Read the calendar
A library item's Reservations tab is a calendar with two kinds of bar:
- One bar for each reservation of the item, captioned with the requester's name and running from the reservation's start date to its end date.
- While the item is out, one bar for its current loan, captioned "Checked out to" and the borrower's name and running from the check-out date to the due date. A loan with no due date gets a bar with no end. A loan that has been checked in leaves no bar.
The calendar's sidebar has a month picker, which moves the calendar to the date you pick, and a Status pane for reservation statuses. Which reservations the calendar shows depends on the reservation statuses saved in your own status filter: with statuses saved, it shows the item's reservations at those statuses; with no statuses saved, it shows only the loan bar.
The calendar's toolbar has Today, back and forward buttons, and the Day, Week, and Month views; no other date range can be chosen. In the Day and Week views, the shaded hours are the non-working hours of the default work calendar. When that work calendar holds an all-day entry for a specific date, the Day and Week views shade no hours.
To work with reservations on the calendar:
- To add a reservation, click or right-click an empty slot. The list that opens has one entry for each action that creates a reservation, under the action's own caption. In a new database created with the Default Workflow, that is one entry, Reservation, granted to the Library Manager, Administrator (Full), and Administrator (Workflow) roles. Picking an entry opens a new reservation of this library item, with its start and end dates taken from the slots you selected. The entries are unavailable unless your security roles grant the Person permission Modify Own Work Time or Modify Work Time for All.
- To open a reservation, double-click its bar; it opens when your rights allow. Right-clicking the bar offers entries to open the reservation and to show its details, beside the entries that create a reservation, but no delete entry.
- Hovering over a reservation bar shows a card with the reservation's details and, as buttons, the open and details entries of the bar's menu and a delete button. The card's delete button deletes the reservation after you confirm, and it is available only when you may delete the reservation.
- Reservation bars cannot be dragged or resized. To change a reservation's dates, change them on the reservation's form.
The calendar is read-only whenever the library item's record is read-only.