Skip to main content
OCLC Support

Circulation transaction history

Learn how the Folio display of circulation transactions history can be changed using OLIB Web.

A list of the user's circulation transactions is displayed in the user's Account details page when they click the History tab.

By default this includes the most recent 50 Issue and Collect transactions from the past 1000 days:

User transaction history display.

Limiting to these transaction types significantly reduces the time it takes to display the account details screen, particularly for users with a large number or circulation transactions on their account.

In OLIB Web you can configure:

  • A setting to limit the loan history displayed
  • The display of a Previous Loans list and/or Loan History list

Limit the loan history

Limit by transaction type

By default, Folio displays the Issue (ISS) and Collect (COL) transactions.

To change this you need to create or edit the history_trantps setting in g_user_details:

  1. Go to OPAC> Configuration Settings.
  2. Search for e.g. history.
  3. Open history_trantps in modify or if it does not yet exist then create it:
Field Value Description
Config Block g_user_details  
Setting history_trantps  
Description A semi-colon separated list of circulation transaction types to limit the Loan History list by transaction type.  
Value "ISS;COL" Enter the desired Transaction Types as a semi-colon separated list encased in double quotes e.g. "ISS;COL;RET;REN". This will exclude other Transaction Types such as Reservations and Holds.
Allowable Values A semi-colon separated list of circulation transaction types.  
Sequence 1 65  
Sequence 2 0  
Include? Yes Set to Yes

When you re-load Folio, the user Account details page: History tab displays any transaction types you configured.

Limit by age of transaction

By default, Folio displays transactions from the previous 1000 days.

To change this you need to edit the history_limit_days setting in g_user_details.

  1. Go to OPAC> Configuration Settings.
  2. Search for e.g. history.
  3. Open history_limit_days in modify mode:
Field Value Description
Config Block g_user_details  
Setting history_limit_days  
Description How many days worth of circulation transactions to list in the Loan History tab.  
Value "365" Enter the number of days you want to display transactions, encased in double quotes.
Allowable Values A number encased in double quotes.  
Sequence 1 67  
Sequence 2 0  
Include? Yes Set to Yes

Limit by number of transactions

By default Folio displays the most recent 50 transactions.

To change this you need to edit the history_limit setting in g_user_details.

  1. Go to OPAC> Configuration Settings.
  2. Search for e.g. history.
  3. Open history_limit in modify mode:
Field Value Description
Config Block g_user_details  
Setting history_limit  
Description The maximum number of circulation transactions to list in the Loan History tab.  
Value "90" Enter the preferred number of transactions encased in double quotes.
Allowable Values A number encased in double quotes.  
Sequence 1 66  
Sequence 2 0  
Include? Yes Set to Yes

 Note: the above settings can be used in combination. For example, setting history_trantps to “ISS;COL”, history_limit_days to “365” and history_limit to “200” will limit the Loan History list to the most recent 200 issue and collect transactions recorded in the past year.

Display previous loans list and/or loan listory list

Previous loans

The show_prev_loans setting in g_user_details determines whether the Previous Loans list is displayed on the Account details History tab:

Previously borrowed items list.

If it is set to true, the Previous Loans list is displayed. If it is set to false or if it is not defined or included, the Previous Loans list is not displayed:

Config Setting ID Interface Config Block Setting Value Sequence 1 Sequence 2 Include?
605657 1 g_user_details show_prev_loans  true 69 0 Y
  1. Go to OPAC> Configuration Settings.
  2. Search for e.g. show.
  3. Open the show_prev_loans setting in modify set the Value field to true.
  4. Set Include?= Yes.

Display text: in g_user_details, the l_prevloans setting is the text that is displayed at the top of the Previous Loans list and should have Include?=Yes:

Config Setting ID Interface Config Block Setting Value Sequence 1 Sequence 2 Include?
605658 1 g_user_details  l_prevloans "Items you have borrowed in the past:-" 70 0 Y

Display text: the text in l_noprevloans is displayed instead, if the user has never borrowed anything in the past and should have Include?=Yes:

Config Setting ID Interface Config Block Setting Value Sequence 1 Sequence 2 Include?
605659 1 g_user_details  l_noprevloans "You have not borrowed any items in the past."  71 0 Y

 

History tab

The show_circtrans setting in g_user_details also determines whether the Loan History list is displayed on the loans History tab:

  1. Go to OPAC> Configuration Settings.
  2. Search for e.g. show.
  3. Open show_circtrans:
Config Setting ID Interface Config Block Setting Value Sequence 1 Sequence 2 Include?
605656 1 g_user_details show_circtrans true 68 0 Y
  • If Value is set to false, the Loan History list is NOT displayed
  • If Value is set to true or if show_circtrans is not defined or Include=No, the Loan History list is displayed

If neither the Previous Loans, nor the History setting is included (Include=Yes), only the Loan History list is displayed by default.

Loan history display text

Setting Config Block Display text
l_cBarcode g_user_details The text that is displayed at the top of the Barcode column in Loan History list in Folio. The default value is “Barcode”.
l_Title g_user_details The text that is displayed at the top of the Title column in Loan History list in Folio. The default value is “Title”.
l_location g_user_details The text that is displayed at the top of the Location column in Loan History list in Folio. The default value is “Location”.
userhist_transaction g_user_details The text that is displayed at the top of the Transaction column in Loan History list in Folio. The default value is “Transaction”.
l_trandate g_user_details The text that is displayed at the top of the Transaction Date column in Loan History list in Folio. The default value is “Transaction Date”.
userhist_header user_hist The text that is displayed at the top of the Loan History list in WebView. The default value is “History of your transactions:<br><i>Note: the most recent ones are shown first</i>”.
userhist_date user_hist The text that is displayed at the top of the Date column in Loan History list in WebView. The default value is “Date”.
userhist_transaction user_hist The text that is displayed at the top of the Transaction column in Loan History list. The default value is “Transaction”.
userhist_barcode user_hist The text that is displayed at the top of the Barcode column in Loan History list. The default value is “Barcode”.
userhist_title user_hist The text that is displayed at the top of the Title column in Loan History list. The default value is “Title”.
userhist_shelfmark user_hist The text that is displayed at the top of the Shelfmark column in Loan History list. The default value is “Shelfmark”.
l_prevloans user_details The text that is displayed at the top of the Previous Loans list on the Loans/Reservations tab in WebView. The default value is “Items you have borrowed in the past:-</i>”.
l_noprevloans user_details The text that is displayed at the top of the Previous Loans list on the Loans/Reservations tab if the user has not borrowed anything in the past. The default value is “You have not borrowed any items in the past.”

 Note: deleted Copies: copy transactions associated with deleted copies and/or deleted titles are also included in the loans history list. These are marked as "Deleted Copy (nnn)", where nnn is the deleted copy record's copyno.