Circulation Documentation - Needs

Don't worry about

whether documentation already exists
whether a function is built out in FOLIO
duplicating a documentation need if it overlaps in different categories

We can figure that out as we go from the list. Just put down what comes to mind where you think it might fit!

1 App-Specific Documentation
- 1.1 Users
- 1.2 Users - RA SIG will write
- 1.3 Inventory (sent list to Jesse Lambertson 3-16-2021)
- 1.4 Courses
- 1.5 Requests
- 1.6 Check-In
- 1.7 Check-Out
- 1.8 Circulation Log
2 Cross-App Workflows
3 Settings and Circulation Rules
4 Behind The Scenes Stuff To Know / Tips for Implementation
5 Workarounds for not-yet-completed workflows
6 Reporting

App-Specific Documentation

Users

Create a User
Delete a User
Change a user's barcode
Renew an item on loan to a user
Add / Delete Blocks
How to change passwords for staff
How Patron expiration dates work
How to add service points to users
How to add permissions to users
How Inactive / Active Statuses work, what they do
How do Custom Fields work - for statistical purposes
1. examples from adopting institutions - what they've added and how they're used
Waiving a fee/fine (full/partial) - RA will write
Refunding a fee/fine (full/partial)- RA will write
Accepting payment for a fee/fine (full/partial) - RA will write
Setting up a proxy relationship between two users
How to anonymize loans in users - the manual commands
In-App reports - what's available, when you might run them, what's required

Users - RA SIG will write

Workflow Name	Existing Documentation or link to FOLIO DOCS	Needs a writer	Apps	Could this be a flowchart?

Workflow Name	Existing Documentation or link to FOLIO DOCS	Needs a writer	Apps	Could this be a flowchart?
Viewing a patron's fee/fine history	https://iris.docs.folio.org/docs/users/#feesfines
Waiving a fee/fine - full waive, partial waive
Refunding a fee/fine - full waive, partial waive
Accepting payment for a fee/fine - full/partial

Inventory (sent list to Jesse Lambertson 3-16-2021)

How item statuses work
1. Outline of the three part model so people know what's coming
  1. Item State in FOLIO
How to change an item to ____ status
1. Protections on item statuses
2. Missing item statuses - adding notes
How to record item damage
How to search in inventory
1. How to do CQL queries in Inventory - esp. examples of searches.
How to find item histories
1. When you might go to Inventory vs Circ Log vs. LDP
How to edit / update item notes
How to edit / update check in and check out notes
How you can find an item in Inventory and then request it for a patron
Change an item barcode
In-App reports - what's available, when you might run them, what's required
Handling long missing items

Courses

Workflow	Existing documentation or DOCS Jira link	Apps Involved	Could this be a flowchart?

Workflow	Existing documentation or DOCS Jira link	Apps Involved
Intro to Courses How people use the app for different needs Examples of use of the app from adopters		Courses
How to create a course	https://docs.folio.org/docs/access/courses/courses/#creating-a-course	Courses
Create a course with cross-listings	https://docs.folio.org/docs/access/courses/courses/#adding-a-cross-listed-course
Find a list of items on reserve for a course	https://iris.docs.folio.org/docs/access/courses/courses/#searching-for-reserves
How do temporary locations work on courses items	https://docs.folio.org/docs/access/courses/courses/#adding-a-reserve-item-to-a-course	Courses, Inventory
How do temporary loan types work on courses items
Integrations with outside systems - LTI	LTI: Course Reserves - LTI connectivity
Integrations with outside systems - ARES
Reserve items - using processing statuses how to set up values tips for using, examples from adopters	https://docs.folio.org/docs/administration/settings/settings_courses/#settings--courses--processing-statuses
Copyright information in Courses how to set up copyright status dropdown what fields do or don't do	https://iris.docs.folio.org/docs/settings/settings_courses/settings_courses/#settings--courses--copyright-statuses
In-app reports: what's available, when you might run them, what's required to do so	There are no in-app reports for Courses and none are planned.

Requests

Workflow	Existing documentation or Docs Jira	Apps	Could this be represented in a flowchart?

Workflow	Existing documentation or Docs Jira	Apps	Could this be represented in a flowchart?
How to request an item (place/process holds, pages, recalls)	https://docs.folio.org/docs/access/requests/requests/#creating-a-request	Requests
How requests work for on-campus versus remote storage	https://folio-org.atlassian.net/browse/DOCS-154	Requests, Inventory?
How to run a page report	https://docs.folio.org/docs/access/requests/requests/#generating-a-page-requests-csv-export https://docs.folio.org/docs/access/requests/requests/#printing-pick-slips	Requests
How to change a request pickup location (including restrictions based on request status)	https://folio-org.atlassian.net/browse/DOCS-20	Requests	No
How to run a daily unfilled requests report	https://docs.folio.org/docs/access/requests/requests/#exporting-your-search-results-to-csv	Requests
How to cancel a request	https://docs.folio.org/docs/access/requests/requests/#canceling-a-request	Requests
How to reorder a request queue	https://docs.folio.org/docs/access/requests/requests/#reordering-the-request-queue-for-an-item	Requests
In-App reports - what's available, when you might run them, what's required	https://docs.folio.org/docs/access/requests/requests/#exporting-a-hold-shelf-clearance-report	Requests

Check-In

Workflow	Existing documentation or DOCS jira	Apps	Could this be a flowchart?

Workflow	Existing documentation or DOCS jira	Apps	Could this be a flowchart?
How anonymizing loans works if you do it in check in	https://folio-org.atlassian.net/browse/DOCS-23
How checking in works for items with multiple pieces	https://iris.docs.folio.org/docs/access/check-in/checkin/#pop-ups-that-can-occur-when-checking-in-an-item
How to backdate a check-in	https://docs.folio.org/docs/access/check-in/checkin/#checking-in-and-backdating-an-item
In-App reports - what's available, when you might run them, what's required	There are no in-app reports for the Check-in app and none are planned.

Check-Out

Workflow	Existing Documentation or DOCS jira	Apps	Could this be a flowchart?

Workflow	Existing Documentation or DOCS jira	Apps
How to loan to someone who is borrowing as a proxy for another patron	https://docs.folio.org/docs/access/check-out/checkout/#checking-out-to-a-proxy-borrower	Checkout, Users
How checkout works for items with multiple pieces
How to change a loan due date	https://docs.folio.org/docs/access/check-out/checkout/#changing-the-due-date-of-an-item
How to override patron blocks
How to override item blocks
In-App reports - what's available, when you might run them, what's required

Circulation Log

Workflow	Existing Documentation or DOCS Jira	Apps	Could this be a flowchart?

Workflow	Existing Documentation or DOCS Jira	Apps	Could this be a flowchart?
Why you would use the circulation log vs. other FOLIO features troubleshooting scenarios where the circ log would be used what data is in the circ log and what data isn't	https://docs.folio.org/docs/access/circulation-log/circ_log/ Could maybe add these two extra things to the top under overview
How to look up item histories (and what you might find here that isn't in Inventory)
How to interpret circ log records that have proxy relationships
How anonymized data looks in the circ log
How to look for notice information
How to look at fee/fine information

Cross-App Workflows

Workflow name	Existing Documentation or DOCS Jira?	Apps	Could this be a flowchart?

Workflow name	Existing Documentation or DOCS Jira?	Apps	Could this be a flowchart?
Handling items that have been in transit for too long		Inventory, Requests
Patron claims that they returned an item but it's still on their account (claim returned)		Users, Inventory
On-the-fly / Fast Add record creation, loaning items, considerations for use (Inventory vs. Courses vs. Check Out)		Inventory, Courses, Check Out
Handling fines - declared lost, aged to lost		Users, Export Manager, Inventory
Handling lost and paid items		Users, Inventory
Managing Patron Blocks - how to set them up on users, how to override		Users, Check Out
Remote Storage		Settings, Inventory, Check In, Check Out

Settings and Circulation Rules

Workflow name/description	Existing documentation or DOCS Jira	Needs a writer?	Apps	Could this be represented graphically / through flowchart?

Workflow name/description	Existing documentation or DOCS Jira	Needs a writer?	Apps
Tags - how they work, plans for future development, suggestions for scenarios where they would be helpful			Settings, any app that has installed tags (many)
How to create permission sets	Done - on docs.folio.org site		Settings
Calendars - how to set up dates / times, how exceptions work	Google Doc - Settings > Calendar		Settings
Configuring Settings for Remote Storage			Settings
Things to consider when deciding how to write circulation rules How the fallback policy works How prioritization works Special characters and indentations Sample circulation rule sets from adopters
What happens w/circulation rules and policies if you change item information after an item is loaned (e.g., change a loan type for an item that is checked out)	https://docs.google.com/document/d/1-X4nnInZ26WlG6O6jiTp2aM5-US0rjM9X7tHTpQrkLQ/edit?usp=sharing	Yes
What happens if/when you delete a circulation rule?	https://docs.google.com/document/d/195f5vHKtbDS2-WqPK0us5li8V7CMsGCRE_T-CZiO2lI/edit?usp=sharing	Yes
What happens if/when you delete a policy - loan, request, notice, lost items, overdue policies?	https://docs.google.com/document/d/195f5vHKtbDS2-WqPK0us5li8V7CMsGCRE_T-CZiO2lI/edit?usp=sharing	Yes
What areas in Settings should RA SMEs care about? E.g., material types and loan types in inventory, patron groups in Users, fee/fines in Users	https://docs.google.com/document/d/1g1-RcVYu2WFmxCn0AMPxFQdXRJE4H6rEM3y7W1iai-Q/edit?usp=sharing	Yes	Settings
Is there a recommended sequence in configuring circulation in FOLIO? E.g., what goes first? Examples from institutions on how they did their configurations	https://docs.google.com/document/d/1HhKi-r01KYwCNLrPgmCGwVTEbwu7a0J8oqBbACcmOVQ/edit?usp=sharing	Yes	Settings
Configuring settings for Fees and Fines - owners, manual charges, waive reasons, refund reasons, comment required, transfer accounts	Settings - Users - Fee/Fine Comment Required Settings - Users - Fee/fine Manual Charges Settings - Users - Fee/fine owners Settings - Users - Fee/fine Waive Reasons Settings - Users - Payment Methods Settings - Users - Refund reasons