Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

API reference documentation for all modules located at:  https://dev.folio.org/reference/api/

*Field "Date sent" needed, as well as linking between location table and notices-storage

*General notice counts.

*Includes notices send by day, by type, by library or department.

...

  • This report is modeled on UXPROD-2032, a cluster of Resource Access reports currently consisting of a single report (REP-238) on slips notices sent to patrons by date and location, that is run as needed. Here is an example of an excising report: slip_notices_sent.PNG

...

  • Date range, type of notices.

Data elements can be found at:

https://s3.amazonaws.com/foliodocs/api/mod-circulation-storage/p/scheduled-notice-storage.html#scheduled_notice_storage_scheduled_notices__scheduled_noticeid__get

https://s3.amazonaws.com/foliodocs/api/mod-circulation-storage/p/patron-notice-policy.html#patron_notice_policy_storage_patron_notice_policies__patronnoticepolicyid__get


Folio Attribute (Module/Path:Object)Folio Data Element DescriptionParameters/Query
Table name: /mod-notify/notify


ID (mod-notify/notify/ID)The notification ID of the noticeProvides
a join between
type of notices
recipientId (mod-
inventory-storage/item-storage/items and mod-circulation-storage/loan-storage/loans
recipientId
notify/notify/recipientId)
The holdings record ID of the itemProvides
a join between mod-inventory-storage/item-storage/items and mod-inventory-storage/holdings-storage/holdings
an ID of the user if needed
text

text of the notification

Needed to pull in location name element from mod-inventory-storage/locations; provides  join between mod-inventory-storage/item-storage/items and mod-inventory-storage/locations

Text of the notices sent

Table name:mod-
inventory
circulation-storage/
holdings
scheduled-notice-storage
/holdings
Item holdings ID


id (mod-
inventory
circulation-storage/
holdings
scheduled-notice-storage/
holdings/ID
id)The
holdings ID of the itemProvides a join between mod-inventory
UUID of scheduled task
LoanId (mod-circulation-storage/
holdings-storage/holdings and mod-inventory-storage/item-storage/items.Item Location (mod-inventory-storage/holdings-storage/holdings/permanentLocationID)

Item's permanent holdings location ID

Needed to pull in location name element from mod-inventory-storage/locations; provides  join between  mod-inventory-storage/holdings-storage/holdings and mod-inventory-storage/locationsItem Location (mod-inventory-storage/holdings-storage/holdings/temporaryLocationID)

Item's temporary holdings location ID

Needed to pull in location name element from mod-inventory-storage/locations; provides  join between  mod-inventory-storage/holdings-storage/holdings and mod-inventory-storage/locationsItem Title (mod-inventory-storage/holdings-storage/holdings/shelvingTitle)The title of the claimed returned item
Needed for item search/replacement
scheduled-notice-storage/loanId)
The UUID of related loan for loan notices



requestId
 (mod-circulation-storage/scheduled-notice-storage/requestID)
UUID of related request for request notices



feeFineActionId
 (mod-circulation-storage/scheduled-notice-storage/feeFineActionID)
The
UUID of related action for fee/fine notices

Instance ID (mod-inventory-storage/holdings-storage/holdings/InstanceID)The instance ID of the item
Provides a join between mod-inventory-storage/holdings-storage/holdings and mod-inventory-storage/instance-storage/instances.

Table name: (mod-circulation-storage/scheduled-notices)

Item checkout location (mod-circulation-storage/loan-storage/loans/itemEffectiveLocationAtCheckOut)Location from where item was checked out
Item checkout location, could be a location filter for this report.l

loan ID (mod-circulation-storage/loan-storage/loans/id
) Loan IDNeeded to count the number of unique loans, to calculate historic chargesLoan item status (mod-circulation-storage/loan-storage/loans/itemStatus) Status of the loan itemWhere item status  = 'Claimed returned'. This data element provides the main filter point for this report. claimed returned date (mod-circulation-storage/loan-storage/loans/claimedReturnedDate) Date the item was claimed returned for this loanThis data element provides a filter point for this report (where claimedReturnedDate between [start] And [end]). loan renewal count (mod-circulation-storage/loan-storage/loans/renewal count)Number of times an item loan has been renewedNeeded to add to the count of unique loan ids to calculate historic chargesloan policy ID (mod-circulation-storage/loan-storage/loans/loanPolicyID)ID of the last policy used in relation to this loanProvides a join between mod-circulation-storage/loan-storage/loans  and mod-circulation-storage/loan-policy-storage/loan-policiesItem ID (mod-circulation-storage/loan-storage/loans/itemId
)

The UUID of the itemUser ID (mod-circulation-storage/loan-storage/loans/userId) The ID of the user whose loan is claimed as returnedProvides a join between mod-circulation-storage/loan-storage/loans and mod-user/users; needed to connect to user table to bring in patron informationTable name: mod-circulation-storage/loan-policy-storage/loan-policies

Provides a join point between mod-circulation-storage/loan-storage/loans and mod-inventory-storage/item-storage/items

Loan
policy id (mod-circulation-storage/loan-policy-storage/loan-policies/id)loan policy
ID
Provides a join between mod-circulation-storage/loan-storage/loans  and mod-circulation-storage/loan-policy-storage/loan-policiesLoan policy name (mod-circulation-storage/loan-policy-storage/loan-policies/name)description of the loan policy, e.g., one hour loan, three week loan, etc.
Provides a description for the type of loan policy for the item that was claimed returned

Table name: mod-inventory-storage/
instance
location-
storage/instances
units

ID (mod-inventory-storage/
instance
location-
storage
units/
instances
institutions/id
)
The instance ID of the item
Provides a join between

ID(mod-inventory-storage/

instance

location-

storage/instances and mod-inventory-storage/holdings-storage/holdings Date of Publication (mod-inventory-storage/instance-storage/instances/publication:dateOfPublicationItem Record Date

units/campuses/id)

Date (year YYYY) of publication, distribution, etc.
Needed for item search/replacement

ID(mod-inventory-storage/
instance
location-
storage
units/
instances
libraries/
cataloguedDate
id)Date item record was created (date the item first entered the system after being acquired
)Needed for item search/replacementTable name: mod-inventory-storage/material-types(mod-inventory-storage/material-types/id)The material type ID of the itemProvides a join between mod-inventory-storage/material-types and mod-inventory-storage/item-storage/items Material Type Name (mod-inventory-storage/material-types/name) Name of the material type (e.g., book, DVD, etc.
)
Needed for item search/replacement

Table name:
mod-inventory-storage/locationsLocation name (mod-inventory-storage/locations/name)

Name of location

This provides the main location filter  for this report.Location ID (mod-inventory-storage/locations/id)ID of the locationProvides a join between mod-inventory-storage/locations and mod-inventory-storage/item-storage/itemsTable name: mod-users/usersUser id (mod-users/users/id)The ID of the user whose loan is claimed as returnedProvides a join between mod-circulation-storage/loan-storage/loans and mod-user/usersUser first name (mod-users/users/firstName)First name of the userUser's first nameUser middle name (mod-users/users/middleName)Middle name of the userUser's middle nameUser last name
(
mod-users/users/lastName)Last name of the userUser's last nameUser
patron
group ID (mod-users/users/patronGroup)Patron group id of the userUser (patron) group id, to identify patron group name from groups table (e.g., grad student, faculty, staff, etc.)Table name: mod-users/groupsUser patron group ID (mod-users/groups/id)Patron group id of the userProvides a join between mod-users/groups and mod-user/usersUser patron group name (mod-users/groups/name)Patron group name of the userType of patron (user), e.g., grad student, faculty, staff, etc.
-notice-policy)

sendoption

sendwhen

triggering even

*NOTE:Notices are available via email only for now

...