RCLS Home page | Library Catalog
Skip to Main Content

RCLS: ILS Services: ONGOING Post GoLive FAQs

Frequently Asked Migration and Koha Questions

ONGOING: Frequently Asked Questions since GO LIVE, 8/5 - present

This list is regularly being updated. Please use CTRL+F to search the page before reaching out to RCLS for help.

Also, please check the ILS Handbook where many of these topics are covered, as well.

Updated 1pm, Aug. 23, 2004.

Acquisitions

Will libraries using the Acquisitions module in Koha be able to import MARC records?

Implementing the Koha Acquisitions module is a post-migration project. Part of the set up will be to implement EDIFACT ordering, which will enable us to import MARC records provided by vendors. Until then, our CAPS records process will continue as the way to create brief MARC records for new acquisitions, which will be overlayed with full MARC records by RCLS catalogers.

When will libraries have access to the Acquisitions module?
RCLS is starting to make a schedule for those libraries that are interested in utilizing the KOHA Acquistions module available in October. Please contact Patty Velez at RCLS if you are interested so we can start building a calendar to assist you with getting started.

Aspen

Why can't I log into my Aspen Admin account?

Aspen Admin accounts are turned off while the BWS team does a lot of background work in Aspen. While we wait, we can streamline our logins by assigning Aspen permissions to our Koha logins. This would mean one less credential to remember. Email Alex at alex@rcls.org directly with the subject line "Aspen Admin" and include the Aspen Administrator account you used to use along with your current Koha username and I'll set these up. You'll then be able to log into both Aspen and Koha using the same info once access is turned on.

Where are the "New" Banners that normally appear in Apsen Discovery on New books?

These are temporarily turned off. This is because the banners are based on when the items were first detected by the Aspen Indexer. Because we just migrated, that would be everything, so they are not useful right now.

Cataloging

Is there a way to move an item record from one bibliographic record to another?

Yes! First, make a note of the barcode of the item that you'd like to move. Next, perform a catalog search and find the target bibliographic record. Click the record to go to the record details screen. Click the "edit" button above the title. Click "Attach item." Enter the barcode of the item and click submit. The item will now be associated with the new bibliographic record. 

How is an item added to an existing record?

From the record you want to add the item to, click New and select New item. This will take you to a screen where you can enter the details for the item you want to add. This process is described in more detail in the Koha Community Manual.

What is going on with Item Groups?

Many of the Item Groups (volume analytics) did not migrate properly. This is an ongoing issue that will be corrected in due course, but will take some time. Clean-up of Item Groups is a manual process.

Batch editing didn't select the proper number of items?

Use caution when editing items in batch from Item Search. Selections for editing targets are saved through multiple searches. Make sure that the number of items selected matches what you expect before clicking the batch operation button:

Always clear your current selections before performing a new batch item edit.

Can I UNSHARE my Koha Item Templates?

Yes. Follow these steps:

1. Find any record and select +New > New item
2. At the bottom of the Add item screen, select Save as template
3. Select the template from the dropdown menu
4. Deselect the “Share template” option and Save

Note:

Shared templates are accessible by every Koha user. Unshared templates are only available to the user who created them.
As shared templates are not limited by library, please make sure that shared templates begin with your library's 3-letter code.
 

Circulation

Is there an override option in Koha? Will we be able to override for things like the number of renewals or checking out a non-circulating item?

Yes, staff will continue to have permissions to override. No override codes will be needed. Instead, a notification will appear requiring a confirmation that staff wish to override whatever restriction is in place.

How can we modify a due date?

Modifying due dates is not possible in Koha (a big change from Symphony!). One way to adjust due dates is to use the renewal option. 

The process to renew items from the patron's summary screen is outlined in the Koha Community Manual. If changing the due date to a specific date, you may set this in the renewal due date field before processing the renewal. If the item does not have any renewals left, be sure to check the box to override renewal restrictions.

Alternately, you can check in the item and then check it out again with the desired due date. If checking the item in triggers a hold or a transfer, you can use the Ignore button.

How do we bill a patron for a damaged item?

If an item is determined to be damaged beyond repair and is thus "lost" to the library's collection, changing the item's lost status to Damaged - Bill to Patron will result in a charge to the patron's account for the replacement price of the item.

Note: This is a Lost status and not a Damaged status. Use one of the damaged statuses (Bindery, Damaged - Needs Review, or Repair) to indicate that an item is damaged but may be returning to the collection after review or repair. Once the item is determined to be a complete loss, the Damaged - Bill to Patron lost status should be applied.

If an item does not have an accurate replacement price at the time it is marked Damaged - Bill to Patron, you may issue a manual invoice or manual credit to apply an adjustment to the amount owed (remember to add an explanatory note!). Once the patron pays for the item, it will no longer appear under their current checkouts.

If you need to add a PARTLOST (Missing Disc or Piece Fee) to your Koha Debit Types for Point of Sale, please email Martha at msullivan@rcls.org. 

What information is available for an item's checkout history and how does this relate to the checkouts for a bibliographic record?

The Checkout history tab available when viewing a bibliographic record in the catalog will show a log of checkouts of the item since migration to Koha and checkouts to patrons in Symphony who opted for their checkout history to be saved. 

Checkout history is also viewable from the Items tab. Total checkouts is available under the "History" heading. The number displayed here includes the total charges counter migrated from Symphony and any checkouts after the migration to Koha. Note: When clicking the link to "View item's checkout history," you will be taken to a statistical page that will only show the counter of checkouts since the Koha migration.

Is "date last seen" the same as "last inventoried" in Symphony?

Yes and more. Date last seen is a combination of Symphony's "Last Activity" and "Last Inventoried" fields. This information is collected in a single field in Koha. This date is updated when an item is checked out, checked in, or inventoried.

Our library is fine free on most of our items. Is there another way to check in items fine free, or do we have to remember to check the "forgive overdue charges" box every time we open the check in window?

Fines are determined by the circulation and fine rules map that we have set up in Koha. If your library is fine free and your rules are configured correctly, your overdue items should not be accruing fines or charging patrons.

How do we charge someone for a library service if they do not have a library account or library card?

This is possible with Point of Sale, available from the Koha menu. You can enter charges and record monies received here for transactions such as copier fees, printing, and donations. More information is available in the Koha Community Manual.

Is Auto-renewal working?

Yes. If you have items that "should" have been automatically renewed, but did not: check the item status. If the item has been marked as damaged, withdrawn, or some other status that would not normally circulate, it will not autorenew.

The patron paid a bill but the item is still showing as checked out to them.

We've found  that Migrated LONGOVERDUE items must be manually removed from a patron's account, even after the LOST fine is paid.

 

Displays

In Symphony there is a "home location" and a "current location." The current location can show when an item is temporarily on display. How do we temporarily mark an item as being on display in Koha?

From the Koha home screen, you will see a button for Displays. This is where you can create and manage lists of circulating items to be used for various displays.

Fun fact: This is actually being run by Koha's Course Reserves module, a tool that academic libraries use to manage lists of circulating items used by courses. We've added some special scripts to change a few of the labels to make it more display-friendly, but you may find lingering terms related to course reserves. A separate Displays module is in development and will become available in a future version of Koha.

You'll first want to create the display, giving it a name and filling in details such as the library and location of the display. Once the display is created, you may add items to the display individually or as a batch. After scanning the barcode of the item(s), you will be presented with some choices about what item information will change when the display is enabled. Only select location to change and choose the location where the item will be on display. 

To enable displays, go to the display details and check the box next to Enabled?. This automatically updates the location for all the items in the display list. Once the display is closed and items are ready to be returned to the shelf, go back into the display details and uncheck the box next to Enabled? to deactivate the display and reset the item locations back to normal.

Holds

For the "Holds Queue," is there a way to save column selection and deselection settings so that they remain for the next sign in?

It is possible for individual users to choose which columns to display when viewing the Holds Queue, however these settings cannot be saved on an individual basis. The default column visibility settings are set at the administrative level and affect all users of the system. If you feel that the default settings should be changed, please present this suggestion to the appropriate user group (RUG or CTUG). Recommendations from the user groups are then sent to the ILS Committee for consideration and then to the Directors Association for a vote. Once approved by the Directors Association, the system-wide change will be implemented in Koha.

Is there a way to modify the holds slip? We have a self-service holds shelf and we do not want a patron's personal information showing up on the slip.

Yes, the slips are customizable. This is something that we can do for you at RCLS HQ. We will be producing a questionnaire prior to go-live to get feedback about how you would like your notices and slips to appear, or you can reach out to us and let us know how you would like this to be customized for your library.

How will we order and hold multiple copies of a book for book discussion groups?

Staff accounts are able to place multiple item-level holds on the same bibliographic record. This will need to be done with each individual item, similar to the process in Symphony.

Note: Do not place a hold for the next available item. This is a record-level hold and cannot be duplicated for the same user. You must scroll down to the list of items attached to the record, select one to put on hold, and click the hold button at the bottom of the page.

How do you extend a hold for a patron?

From the patron's record, navigate to their active holds (tab next to their checkouts). This table will show you the status of all the patron's checkouts. To adjust the expiration date for one of these holds, click the hyperlinked title of the hold to go to the record's hold information. On this table, identify the hold for the patron you wish to extend (you will need to match to the patron's barcode). Click the date to select a new date from the date picker. To save your changes, click Update holds at the top of the holds table. Confirm that the date was updated by returning to the patron's record and viewing their holds.

Note: A bug has been fixed that prevents the date from being modified if it is on or after the expiration date. This fix will be available after go-live.

How do I run an "Expired Holds" report to see what materials need to be returned to the shelf or routed back to the owning library?

Expired holds are available in the Holds awaiting pickup tool. From the Circulation menu, click Holds awaiting pickup. Note the tabs at the top. Click Holds waiting past their expiration date to view a list of all expired holds.

Holds that have expired must be cancelled.

When you check in an expired item, you will be given the option to cancel the hold. If you select a reason, such as "Item was not picked up in the designated timeframe," the patron will receive an email alerting them that the hold was cancelled. If you do not select a reason, no communication will be sent.
 
After clicking cancel, a second pop up will appear to generate a transit or hold slip for the item, if applicable. 
The "Onshelf List" in Symphony is automatically generated at set times during the day. How will this be set up in Koha?

This is called the Holds Queue in Koha. It is available from the Circulation menu and it shows hold requests in real-time. To fill gaps in the system, the Holds Queue will be completely rebuilt twice daily, once overnight and once at noon. We recommend the following workflow:

  • Run the holds queue for your library once during the morning.
  • Pull and confirm as many holds as possible before noon.
  • Ignore any holds your library does not want to fill.
  • Run the holds queue for your library again after 1:00 p.m.
  • Holds previously ignored should no longer appear in your library's holds queue.

At this time, the Holds Queue building process will only be run overnight, and once mid-day, due to the amount of system resources required to run the process. However, if you check the Holds Queue at other times, you may be able to pull and fill local holds more frequently.

Can I see a patron's Holds History?

View this on a patron account by selecting Holds history in the left-hand menu. This information is kept for 45 days.

Can I view a patron's Hold History?

Yes. View this on a patron account by selecting Holds history in the left-hand menu. This information is kept for 45 days.

Navigation

What is the Koha web address?

https://staff-rclsny.bywatersolutions.com/

Can users define the default function of the green search box at the top?

In short, no. However, there are a few things we recommend that make getting to the Search catalog function easier:

  • A keyboard shortcut, Alt+Q (Windows) or Opt+Q (Mac), switches the search function to the catalog
  • Use the Advanced Search module for catalog searching by clicking the button from the Koha home page
  • Click Search in the black menu bar at the very top of the page, which also takes you to the Advanced Search page
  • Use your browser's bookmarks to save the Advanced Search page for easy access
Can you pin the tabs you are using the most to the toolbar?

Since Koha is browser-based, the best way to do this is to utilize your browser's bookmarks or favorites functionality. You could create a special folder of Koha pages. Most browsers have a bookmarks or favorites bar that displays under the URL address bar which provides quick access to a collection of bookmarks. 

Many browsers now support user profiles and link bookmarks and preferences to the user profile. A user profile could be set up for individuals or for departments. When the user profile is linked to more than one browser, the saved bookmarks and settings are copied from one computer to another.

If your browser supports startup pages, this is another option for quickly loading your preferred Koha pages every time you start the browser. 

It is also possible to create application shortcuts on your computer desktop that navigate to a specific URL. You can set up shortcuts on a computer desktop for the Koha home screen, Advanced search page, or wherever you'd like to go in Koha!

The black menu bar at the top of the Koha screen is customizable, however changes made here would apply to everyone using the system. If there's something you'd like to see permanently added to this menu bar, please bring this suggestion to a user group (RUG or CTUG). If accepted as a recommendation, it would then go to the ILS Committee and then on to the Directors Association for a vote before being implemented.

How do I turn of autofill in my browser?

In Firefox:

Clearing form history
If you want Firefox to forget all of your previous form entries:
  1. Click the menu button Fx89menuButton to open the menu panel.
  2. Click History, and then click Clear Recent History….
  3. In the Time range to clear: drop-down, choose Everything.
  4. Make sure that Form & search history has a check mark next to it.
  5. Click Clear Now to clear your form history and close the dialog box.
Turn off Auto form fill and prevent Firefox from storing more form entries
If you don't want Firefox to remember what you've entered into form fields, you can turn off the auto form fill feature:
  1. Click the menu button Fx89menuButton and select Settings.
  2. Select the Privacy & Security panel.
  3. In the drop-down menu next to Firefox will, choose Use custom settings for history.
  4. Remove the check mark next to Remember search and form history.
  5. Close the Settings page. Any changes you've made will automatically be saved.

Notifications

Can I Tell What Notifications a patron is getting?

in Koha, staff are empowered to view messaging history. When viewing a patron record, click the Notices option from the left-hand menu:

You will see a list of successful and attempted notices. This includes the time stamp, the message type (phone, email, sms), status, and the sending email address. These are all helpful when helping patrons find emails they might have missed.
You can view the content of any message by clicking on it.
 
Can I resend a notification to a patron?

Yes. You'll notice that you have a "resend" option. This will tell Koha to queue the message for sending again. Messages are sent every 15 minutes.

What does the "Main Contact Method" mean?

The "Main Contact Method" dropdown box interacts with the automatic messages sent from Koha, MessageBee, or Twilio (our robocall service). The Main Contact Method field appears in the Contact Information group in a patron record:

Main contact method has no bearing on automatic notices. This field is simply an FYI for staff in case they need to contact the patron for other reasons. All automatic messaging is controlled through the Patron Messaging Preferences table, at the bottom of a patron record:

 

 

Does MessageBee send email notifications?

No.  Checkout emails are not sent via MessageBee. As a result, errors and bounce-back notices for these emails are not delivered in the MessageBee dashboard. If your library is configured to receive these emails in a shared inbox, you will see something like the following:

 
Subject: Overdue Notices
An error occurred while trying to deliver the mail to the following recipients:
xxxxxxxxxxx@yahoo.com
Treat these errors as you would a similar error in MessageBee: Update the patron account to give them a manual restriction with the reason: "Invalid or No Email On File."​

Patron Records

In a patron's record, overdue items are referred to as "Previous Checkouts." Can that be changed to "Current Checkouts"?

The headings in the checkouts table are time specific to the checkout session. When new items are checked out to a patron, they appear under a heading called “Today’s checkouts.” Everything else is under a heading called “Previous checkouts.” Everything on the table is considered a current checkout because items disappear off this table when they are returned and checked in (or deemed lost and paid for, etc.). It is a way of visually separating what was checked out during a current session from everything else the patron has checked out, independent of an item's due date.

How many steps does it take to see what makes up the charges on a patron's account?

To get to a patron's charges, click the Accounting tab on the left side of the patron screen. If the patron currently has a balance due, you will be taken to the Make a payment tab by default, which will show all outstanding charges on the patron's account. For a complete history of past charges and payments, click the Transactions tab. 

Is there a way to have a patron blocked?

In Koha this is called a manual restriction. The process for adding a manual restriction can be found in the Koha Community Manual. The manual restriction options available to RCLS libraries are:

  • Invalid or No Email on File
  • Invalid or No Phone Number on File
  • Invalid or No Street Address on File
  • Card Pending
  • Manual

A note should be added with further explanation along with the staff member's initials and the three-letter library branch code.

How to unblock a patron with a migrated block?

Patrons who were blocked or barred in Symphony migrated with that status applied as a manual status. That looks like this in the patron account:

After clearing outstanding fines on these account (or bringing them below $10), the manual restriction must be removed. Click "view restrictions" to show the restrictions tab then click "Remove." This step is only necessary for patrons who migrated with a blocked status. 
 
Can you see when a library card was created?

Koha will display the date when a patron's account was opened. This can be found under the patron's Details tab, in the Library Use box on the right next to the label Registration date. This information will migrate over from Symphony. When a patron's account is renewed, the expiration date will change but the registration date will remain the same. Koha cannot track the date a library card was created, and a library card may have been created or reissued on a date different from the registration date.

What if your library does not expire patron cards? It looks like an exact date is needed to complete patron registration.

Yes, an expiration date is required by Koha. By default, we have set the expiration date for patron accounts to 120 months. Libraries can set their own policies for expiration dates. If your expiration dates are longer or shorter, you may modify this on the patron edit details screen at the time of registration or as a correction afterwards.

Is a patron's password and PIN the same thing? How do we see this or change it for a patron?

There is a terminology change. Koha will use passwords instead of PINs. Existing PINs will migrate as-is, but we will be using a stronger password requirement to create passwords for new patrons. Our recommendation is the following formula:

First two letters of last name (capital and lowercase) + Last four digits of primary phone number + exclamation point

Example: Patron with the last name Smith and phone number (845) 555-7719

Sm7719!

A big privacy change with Koha is that staff will no longer be able to see a patron's current password. Staff may assist patrons with resetting their password using one of the following methods:

  • Manually resetting it using the Change password button at the top of the patron record screen
  • Sending a password reset email to the patron by going to More > Send password reset from the patron record screen
  • Instruct the patron how to request a password reset from the Aspen Discovery login screen

The second two options assume that the patron has a valid email address on file.

Are a patron's Overdrive checkouts visible in Koha?

No. However, you may be able to access this information by using masquerade mode in Aspen Discovery.

Can I delete a patron record?

Staff can now delete patrons. This was turned off during testing, but is now available.

Can patrons save their Reading History?
Patrons can view their reading history in Aspen Discovery. Here's a primer on how reading history works:
 
  • Users who did not opt into recording their reading history in Aspen pre-migration, and had no circ history in Symphony pre-migration, will have no history in Aspen and would need to start recording in Aspen if they wanted to keep their history from that point on.
  • Users who opted into recording their history in Aspen pre-migration should have that history migrated over from the old server to the new. This would not depend on any data existing in Symphony/Koha, since the data is in Aspen regardless. Once a user starts recording their reading history in Aspen, it no longer looks to the ILS for the circ history and relies just on checkouts coming through in Aspen.
  • In the case of users who did not opt into recording their reading history in Aspen pre-migration, but *did* have circ history in Symphony pre-migration, they will be automatically opted in when they log into Aspen. When a user logs in and Aspen detects this flag, Aspen thinks, "oh, they wanted to keep their reading history, so I'll go ahead and display that for them!" In this case, users will need to opt out if they don't want to continue recording their history. Opting out at this point would remove the history from both Aspen and Koha irreversibly.

Remember that a patron's reading history is not visible to staff, however, you may be able to access this information by using masquerade mode in Aspen Discovery.

Can I view a patron's Hold History?

Yes. View this on a patron account by selecting Holds history in the left-hand menu. This information is kept for 45 days.

Periodicals

Why aren't all of my periodical issues showing? I'm missing some from 2023-24, but ones from 2021 are showing.

Bibliographic records with more than 300 items attached needed a separate export, that has not yet worked for some items. In some cases, these records are completely lacking any holdings from 2023 or 2024. In other cases, since-deleted items appear in the export without explanation. Stay tuned.

Printing

Why can't I print?

In Firefox:

Click the menu button. It's in the top right under the "X" button. It looks like 3 lines.
Then click Settings. In the search bar where it say "Find in settings" type pop.
Next to where it says "Block pop-up windows" click "Exceptions."
In the next screen, copy and paste this address: https://staff-rclsny.bywatersolutions.com and click Allow. Then Click "Save Changes."
After that, test again to see if you get the print dialog.
 
In Chrome:
Where do I find the Print Notices?

Click Tools -> Access Files. You can use the search box at the top to search for your library. Clicking the link will download an HTML File. The file will open in a browser. From here, you can print the notice or copy the text and adjust it in your word processor for choice.

Can the Quick Print button be changed to print the Quick Slip instead of a Summary?

YES!!! Done and done.

Public Access

What does OPAC mean?

Online Public Access Catalog. Koha has its own OPAC, but RCLS will not be using it. Aspen Discovery, our discovery layer, functions as our OPAC and will continue to do so after our migration to Koha.

Will we be using the Koha OPAC in concert with Aspen? If not, can we get the OPAC view links on the test server to direct us to Aspen?

Aspen will remain our Discovery layer and OPAC for the public. A test instance of Aspen is now linked to the Koha test server and all OPAC view links in catalog records now redirect to the Aspen test instance. Please note that the Browse Categories function is not currently operational in the Aspen test instance.

Searching the Catalog

Is there an option to limit the number of locations shown in search results to make a more compact view?

By default, the Location column in search results will only show copies available at the logged-in library. To see all copies available across RCLS, click the yellow Show items in all libraries button above the Location column.

This is an enhancement that was added especially for RCLS and is not documented in the Koha Community Manual.

I'm trying to use the search function to generate a list of items in a specific shelving location in our library, but the search tool is returning a list of items that we have which are marked as being in that location in ANY library in the system.

There are two types of search tools in Koha - one that searches bibliographic records and one that searches item records. 

The Advanced Search tool offers the option to limit by library and shelving location. However, it searches the entire bibliographic record and returns results that match on those values regardless of their relationship to each other. Therefore, the search tool thinks it has a match when it sees the library branch code in one field and the shelving location code in another field even though the library branch code and shelving location code are not in the same field pertaining to the same item. This is a known bug in Koha and has been reported by the community. You can see what others are saying and join the conversation on Bugzilla.

The Item Search tool is a much better tool to use if you are looking specifically for a list of items. It has similar limit options for library and shelving location. Because it is only searching item records, it will return a list of items that match on all the criteria selected.

Can users turn off their catalog search history? Or can it be manually deleted?

Search history for staff members is currently turned on and is being kept. Staff members may access it by clicking their username in the upper right corner and selecting Search history. Searches can be deleted individually or in batch. More details are available from the Koha Community Manual.

Library patron search history will not be kept in Koha. These privacy settings are controlled by Aspen Discovery.

Staff Access

Will there be a generic login for all Circ staff or will each staff member have their own login?

We will not be using generic logins for Koha. It used to be that we could reasonably assume that a person who has left the library would no longer have access to the ILS because their physical access to staff machines had been removed. Koha is available from anywhere with an internet connection. If we kept generic logins, we would need to constantly change passwords and notify remaining staff whenever a roster change happens.

Every staff member will have a unique login. It is fast and easy to log out and log back into Koha when staff members rotate on and off the Circulation Desk.

Will different staff members have different permissions?

Yes, elevated logins will be able to edit items in batch--as they do now. Right now, all firstliners have this permission so that you can learn the tool and teach it to others who may need to use it. These logins will also be able to manage and create new item groups. Before go-live, Martha Sullivan will reach out to directors for a list of who needs elevated permissions.

We will also be able to assign permissions for report creation to those who complete SQL training. After go-live, RCLS will provide SQL report writing education for use in Koha. Users who attend that training will get the ability to write their own custom reports for their library's use and to share with the rest of the system.

Will users be automatically logged out?

Yes, users will now be automatically logged out after 60 minutes of inactivity. This is a crucial cybersecurity measure to ensure the safety of our system.