Revert "LP#1332651 do not strip internal spaces in barcode"
[working/Evergreen.git] / docs / acquisitions / purchase_requests_management.adoc
1 Managing patron purchase requests
2 ---------------------------------
3
4 Introduction
5 ~~~~~~~~~~~~
6
7 indexterm:[purchase requests]
8
9 Patron Requests can be used to track purchase suggestions from patrons in Evergreen.  This feature allows purchase requests to be placed on selection lists to integrate with the Acquisitions module.  Patron Requests can be accessed through the Acquisitions module under *Acquisitions -> Patron Requests* and through patron accounts under *Other -> Acquisition Patron Requests*.  Requests can be placed and managed through both interfaces.
10
11 Place a Patron Request
12 ~~~~~~~~~~~~~~~~~~~~~~
13
14 . Go to *Acquisitions -> Patron Requests*.  This interface is scoped by Patron Home Library and will default to the library your workstation is registered to. 
15 .. Requests can also be placed directly through a patron account, in which case the interface will scope to the patron ID.
16 +
17 image::media/patronrequests_requestgrid.PNG[Patron Requests Grid]
18 +
19 . Click *Create Request* and a modal with the patron request form will appear.
20 . Create the request by filling out the following information:
21 .. _User Barcode_ (required): enter the barcode of the user that is placing the request
22 .. _User ID_: this field will populate automatically when the User Barcode is entered
23 .. _Request Date/Time_: this field will populate automatically
24 .. _Need Before Date/Time_: if applicable, set the date and time after which the patron is no longer interested in receiving this title
25 .. _Place Hold?_: check this box to place a hold on this title for this patron.  Holds are placed when the bib and item record are created in the catalog as part of the acquisitions process.
26 .. _Pickup Library_: pickup library for the hold.  This field will default to the patron’s home library is the pickup library is not selected in the patron account.
27 .. _Notify by Email When Hold is Ready_ and _Notify by Phone When Hold is Ready_:  preferences set in patron account will be used or can be set manually here.
28 .. _Request Type_ (required): type of material requested
29 .. _ISxN_
30 .. _UPC_
31 .. _Title_
32 .. _Volume_
33 .. _Author_
34 .. _Publisher_
35 .. _Publication Location_
36 .. _Publication Date_
37 .. _Article Title_: option available if Request Type is “Articles”
38 .. _Article Pages_: option available if Request Type is “Articles”
39 .. _Mentioned In_
40 .. _Other Info_
41 . Click *Save* at the bottom of the form.
42  
43 image::media/patronrequests_requestform.PNG[Patron Requests Form]
44
45
46 Actions for Requests
47 ~~~~~~~~~~~~~~~~~~~
48
49 After placing a Patron Request, a variety of actions can be taken by selecting the request, or right-clicking, and selecting Actions within either *Acquisitions -> Patron Requests* or through the patron account under *Other -> Acquisition Patron Requests*:
50
51 * *Edit Request* - make changes to the request via the original request form.  Edits can be made when the status of a request is New.
52 * *View Request* - view a read-only version of the request form
53 * *Retrieve Patron* - retrieve the account of the patron who placed the request
54 * *Add Request to Selection List* - add the request to a new or existing Selection List in the Acquisitions module.  The bibliographic information in the request will generate the MARC order record.  From the selection list, the request will be processed through the acquisitions module and the status of the request itself will be updated accordingly.
55 * *View Selection List* - view the Selection List a request has been added to (this option will be active only if the request is on a selection list)
56 * *Set Hold on Requests* - allows you to indicate that a hold should be placed on the requested title, without needing to go in and edit the request.  You can set a hold as long as the status of the request is New or Pending.
57 * *Set No Hold on Requests* - allows you to indicate that a hold should not be placed on the requested title, without needing to go in and edit the request individually.
58 * *Cancel Requests* - cancel the request and select a cancellation reason
59
60 Administration
61 ~~~~~~~~~~~~~~
62
63 Request Status
64 ^^^^^^^^^^^^^^
65
66 Patron Requests will use the following statuses:
67
68 * *New* - This is the initial state for a newly created acquisition request.  This is the only state from which a request is editable.
69 * *Pending* - This is the state after a request is added to a selection list.
70 * *Ordered, Hold Not Placed* - This is the state when an associated purchase order has been created and the request's Place Hold flag is false.
71 * *Ordered, Hold Placed* - This is the state when the request's Place Hold flag is true, an associated purchase order has been created, and the bibliographic record and item for the request have been created in the catalog as part of the acquisitions process..
72 * *Received* - This is the state when the line item on the linked purchase order has been marked as received.
73 * *Fulfilled* - This is the state when an associated hold request has been fulfilled.
74 * *Canceled* - This is the state when the acquisition request has been canceled.
75
76 Notifications/Action Triggers
77 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
78
79 The following email notifications are included with Evergreen, but are disabled by default.  The notices can be enabled through the *Notifications/Action Triggers* interface under *Administration -> Local Administration*.  The existing notices could also be modified to place a message in the *Patron Message Center*.  Any enabled notifications related to holds placed on requests will also be sent to patrons.
80
81 * Email Notice: Acquisition Request created
82 * Email Notice: Acquisition Request Rejected
83 * Email Notice: Patron Acquisition Request marked On-Order
84 * Email Notice: Patron Acquisition Request marked Cancelled
85 * Email Notice: Patron Acquisition Request marked Received
86
87 Permissions
88 ^^^^^^^^^^^
89
90 This feature includes one new permission and makes use of several existing permissions.  The following permissions are required to manage patron requests:
91
92 * CLEAR_PURCHASE_REQUEST
93 ** A new permission that allows users to clear completed requests
94 ** This permission has been added to the stock Acquisitions permission group
95 ** user_request.update will still be required with this sort of action
96 ** The stock permission mappings for the Acquisitions group will be changed to include this permission
97 * CREATE_PICKLIST
98 ** Will allow the staff user to create a selection list.
99 * VIEW_USER
100 ** Permission depth will apply to requests.  If a user tries to view a patron request that is beyond the scope of their permissions, a permission denied message will appear with a prompt to log in with different credentials.
101 * STAFF_LOGIN
102 * user_request.create
103 * user_request.view
104 * user_request.update
105 ** This is checked when updating a request or canceling a request
106 * user_request.delete