Docs: Fix AsciiDoc list formatting
[working/Evergreen.git] / docs / acquisitions / selection_lists_po.adoc
1 Selection Lists and Purchase Orders
2 -----------------------------------
3
4 Selection Lists
5 ~~~~~~~~~~~~~~~
6
7 Selection lists allow you to create, manage, and save lists of items that you may want to purchase. To view your selection list, click Acquisitions -> My Selection Lists. Use the general search to view selection lists created by other users.
8
9 Create a selection list
10 ^^^^^^^^^^^^^^^^^^^^^^^
11
12 Selection lists can be created in four areas within the module. Selection lists can be created when you <<_brief_records,Add Brief Records>>, Upload MARC Order Records, or find records through the <<_marc_federated_search,MARC Federated Search>>. In each of these interfaces, you will find the Add to Selection List field. Enter the name of the selection list that you want to create in that field.
13
14 Selection lists can also be created through the My Selection Lists interface:
15
16 . Click Acquisitions -> My Selection Lists.
17 . Click the New Selection List drop down arrow.
18 . Enter the name of the selection list in the box that appears.
19 . Click Create.
20
21 image::media/acq_selection_create.png[create selection list]
22
23 Add items to a selection list
24 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
25
26 You can add items to a selection list in one of three ways: <<_brief_records,add a brief record>>; upload MARC order records; add records through a <<_marc_federated_search,federated search>>; or use the View/Place Orders menu item in the catalog.
27
28 Clone selection lists
29 ^^^^^^^^^^^^^^^^^^^^^
30
31 Cloning selection lists enables you to copy one selection list into a new selection list. You can maintain both copies of the list, or you can delete the previous list.
32
33 . Click Acquisitions -> My Selection Lists.
34 . Check the box adjacent to the list that you want to clone.
35 . Click Clone Selected.
36 . Enter a name into the box that appears, and click Clone.
37
38 image::media/acq_selection_clone.png[clone selection list]
39
40 Merge selection lists
41 ^^^^^^^^^^^^^^^^^^^^^
42
43 You can merge two or more selection lists into one selection list.
44
45
46 . Click Acquisitions -> My Selection Lists.
47 . Check the boxes adjacent to the selection lists that you want to merge, and click Merge Selected.
48 . Choose the Lead Selection List from the drop down menu. This is the list to which the items on the other list(s) will be transferred.
49 . Click Merge.
50
51 image::media/acq_selection_merge.png[merge selection list]
52
53 Delete selection lists
54 ^^^^^^^^^^^^^^^^^^^^^^
55
56 You can delete selection lists that you do not want to save. You will not be able to retrieve these items through the General Search after you have deleted the list. You must delete all line items from a selection list before you can delete the list.
57
58
59 . Click Acquisitions -> My Selection Lists.
60 . Check the box adjacent to the selection list(s) that you want to delete.
61 . Click Delete Selected.
62
63 Mark Ready for Selector
64 ^^^^^^^^^^^^^^^^^^^^^^^
65
66 After an item has been added to a selection list or purchase order, you can mark it ready for selector. This step is optional but may be useful to individual workflows.
67
68
69 . If you want to mark part of a selection list ready for selector, then you can check the box(es) of the line item(s) that you wish to mark ready for selector. If you want to mark the entire list ready for selector, then skip to step 2.
70 . Click Actions -> Mark Ready for Selector.
71 . A pop up box will appear. Choose to mark the selected line items or all line items.
72 . Click Go.
73 . The screen will refresh. The marked line item(s) will be highlighted pink, and the status changes to selector~ready.
74
75 image::media/acq_selection_mark_ready.png[mark ready]
76
77 Convert selection list to purchase order
78 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
79
80 Use the Actions menu to convert a selection list to a purchase order.
81
82
83 . From a selection list, click Actions ~> Create Purchase Order.
84 . A pop up box will appear.
85 . Select the ordering agency from the drop down menu.
86 . Enter the provider.
87 . Check the box adjacent to prepayment required if prepayment is required.
88 . Choose if you will add All Lineitems or Selected Lineitems to your purchase order.
89 . Check the box if you want to Import Bibs and Create Copies in the catalog.
90 . Click Submit.
91
92
93 Purchase Orders
94 ~~~~~~~~~~~~~~~
95
96 Duplicate Purchase Order Name Warning Dialog
97 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
98
99 When creating a purchase order or editing an existing purchase order, the purchase order name must be unique for the ordering agency.  Evergreen will display a warning dialog to users, if they attempt to create or edit purchase order names that match the names of already existing purchase orders at the same ordering agency. The *Duplicate Purchase Order Name Warning Dialog* includes a link that will open the matching purchase order in a new tab.
100
101 Purchase Order Names are case sensitive.
102
103 *Duplicate PO Name Detection When Creating a New Purchase Order*
104
105 image::media/po_name_detection_1.JPG[PO Name Detection 1]
106
107 When a duplicate purchase order name is detected during the creation of a new purchase order, the user may:
108
109 * Click *View PO* to view the purchase order with the matching name. The purchase order will open in a new tab.
110 * Click *Cancel* to cancel the creation of the new purchase order.
111 * Within the _Name (optional)_ field, enter a different, unique name for the new purchase order.
112
113 If the purchase order name is unique for the ordering agency, the user will continue filling in the remaining fields and click *Save*.
114
115 If the purchase order name is not unique for the ordering agency, the Save button will remain grayed out to the user until the purchase order is given a unique name.
116
117 *Duplicate PO Name Detection When Editing the Name of an Existing Purchase Order*
118
119 To change the name of an existing purchase order:
120
121 . Within the purchase order, the _Name_ of the purchase order is a link (located at the top left-hand side of the purchase order). Click the PO Name.
122 . A new window will open, where users can rename the purchase order.
123 . Enter the new purchase order name.
124 . Click *OK*.
125
126 image::media/po_name_detection_2.JPG[PO Name Detection 2]
127
128 If the new purchase order name is unique for the ordering agency, the purchase order will be updated to reflect the new name.
129 If the purchase order name is not unique for the ordering agency, the purchase order will not be updated with the new name. Instead, the user will see the *Duplicate Purchase Order Name Warning Dialog* within the purchase order.
130
131 image::media/po_name_detection_3.JPG[PO Name Detection 3]
132
133 When a duplicate purchase order name is detected during the renaming of an existing purchase order, the user may:
134
135 * Click *View PO* to view the purchase order with the matching name. The purchase order will open in a new tab.
136 * Repeat the steps to change the name of an existing purchase order and make the name unique.
137
138 Purchase Order Activation Progress Bar
139 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
140
141 After you click *Activate Order*, you will be presented with the record import interface for records that are not already in the catalog. Once you complete entering in the parameters for the record import interface, the progress screen will appear. As of Evergreen 2.9, this progress screen consists of a progress bar in the foreground, and a tally of the following in the background of the bottom-left corner:
142
143 * Lineitems processed
144 * Vandelay Records processed
145 * Bib Records Merged/Imported
146 * ACQ Copies Processed
147 * Debits Encumbered
148 * Real Copies Processed
149
150 Activate Purchase Order with Zero Copies
151 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
152
153 In previous versions, by default, a purchase order could be activated with or
154 without copies attached to line items.
155
156 In versions 2.3 and above, by default, a purchase order cannot be activated if a line item
157 on the purchase order has zero copies.  A new feature enables you to activate a
158 purchase order that lacks copies.
159
160 To activate a purchase order with line items that have zero copies, check the
161 box *Allow activation with zero-copy lineitems*.  
162
163 image::media/Zero_Copies1.jpg[Zero_Copies1]
164
165 Enhancements to Canceled and Delayed Items
166 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
167
168 Cancel/Delay reasons have been modified so that you can easily differentiate between canceled and delayed items.  Each label now begins with *Canceled* or *Delayed*.  To view the list, click *Administration* -> *Server Administration* -> *Acquisitions* -> *Cancel Reasons*.
169
170 The cancel/delay reason label is displayed as the line item status in the list of line items or as the copy status in the list of copies.
171
172 image::media/2_7_Enhancements_to_Canceled2.jpg[Canceled2]
173
174
175 image::media/2_7_Enhancements_to_Canceled4.jpg[Canceled4]
176
177 A delayed line item can now be canceled.  You can mark a line item as delayed, and if later, the order cannot be filled, you can change the line item's status to canceled.  When delayed line items are canceled, the encumbrances are deleted.
178
179 Cancel/delay reasons now appear on the worksheet and the printable purchase order.
180
181 Paid PO Line Items
182 ^^^^^^^^^^^^^^^^^^
183
184 Purchase Order line items are marked as "Paid" in red text when all non-cancelled copies on the line item have been invoiced.
185
186 image::media/2_10_Lineitem_Paid.png[Paid Lineitem]
187
188
189 Brief Records
190 ~~~~~~~~~~~~~
191
192 Brief records are short bibliographic records with minimal information that are often used as placeholder records until items are received. Brief records can be added to selection lists or purchase orders and can be imported into the catalog. You can add brief records to new or existing selection lists. You can add brief records to new, pending or on~order purchase orders.
193
194 Add brief records to a selection list
195 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
196
197 . Click Acquisitions -> New Brief Record. You can also add brief records to an existing selection list by clicking the Actions menu on the selection list and choosing Add Brief Record.
198 . Choose a selection list from the drop down menu, or enter the name of a new selection list.
199 . Enter bibliographic information in the desired fields.
200 . Click Save Record.
201
202 image::media/acq_brief_record.png[]
203
204 Add brief records to purchase orders
205 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
206
207 You can add brief records to new or existing purchase orders.
208
209 . Open or create a purchase order. See the section on <<_purchase_orders,purchase orders>> for more information.
210 . Click Add Brief Record.
211 . Enter bibliographic information in the desired fields. Notice that the record is added to the purchase order that you just created.
212 . Click Save Record.
213
214 image::media/acq_brief_record-2.png[]
215
216 MARC Federated Search
217 ~~~~~~~~~~~~~~~~~~~~~
218
219 The MARC Federated Search enables you to import bibliographic records into a selection list or purchase order from a Z39.50 source.
220
221 . Click Acquisitions -> MARC Federated Search.
222 . Check the boxes of Z39.50 services that you want to search. Your local Evergreen Catalog is checked by default. Click Submit.
223 +
224 image::media/acq_marc_search.png[search form]
225 +
226 . A list of results will appear. Click the "Copies" link to add copy information to the line item. See the <<_line_items,section on Line Items>> for more information.
227 . Click the Notes link to add notes or line item alerts to the line item. See the <<_line_items,section on Line Items>> for more information.
228 . Enter a price in the "Estimated Price" field.
229 . You can save the line item(s) to a selection list by checking the box on the line item and clicking Actions -> Save Items to Selection List. You can also create a purchase order from the line item(s) by checking the box on the line item and clicking Actions ~> Create Purchase Order.
230
231 image::media/acq_marc_search-2.png[line item]
232
233 Line Items
234 ~~~~~~~~~~
235
236 Return to Line Item
237 ^^^^^^^^^^^^^^^^^^^
238
239 This feature enables you to return to a specific line item on a selection list,
240 purchase order, or invoice after you have navigated away from the page that
241 contained the line item.  This feature is especially useful when you must
242 identify a line item in a long list. After working with a line item, you can
243 return to your place in the search results or the list of line items.
244
245 To use this feature, select a line item, and then, depending on the location of
246 the line item, click *Return* or *Return to search*.  Evergreen will take you
247 back to the specific line item in your search and highlight the line item with a
248 colored box.
249
250 For example, you retrieve a selection list, find a line item to examine, and
251 click the *Copies* link.  After editing the copies, you click *Return*.
252 Evergreen takes you back to your selection list and highlights the line item
253 that you viewed. 
254
255 image::media/Return_to_line_item1.jpg[Return_to_line_item1]
256
257 This feature is available in _General Search Results_, _Purchase Orders_, and
258 _Selection Lists_, whenever any of the following links are available: 
259
260 * Selection List
261 * Purchase Order
262 * Copies
263 * Notes
264 * Worksheet
265
266 This feature is available in Invoices whenever any of the following links are
267 available:
268
269 * Title
270 * Selection List
271 * Purchase Order
272
273 Display a Count of Existing Copies on Selection List and Purchase Order Lineitems
274 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
275
276 When displaying Acquisitions lineitems within the Selection List and Purchase Order interfaces, Evergreen displays a count of existing catalog copies on the lineitem. The count of existing catalog copies refers to the number of copies owned at the ordering agency and / or the ordering agency's child organization units.
277
278 The counts display for lineitems that have a direct link to a catalog record. Generally, this includes lineitems created as "on order" based on an existing catalog record and lineitems where "Load Bibs and Items" has been applied.
279
280 The count of existing copies does not include copies that are in either a Lost or a Missing status.
281
282 The existing copy count displays in the link "bar" located below the Order Identifier within the lineitem.
283
284 If no existing copies are found, a "0" (zero) will display in plain text.
285
286 If the existing copy count is greater than zero, then the count will display in bold and red on the lineitem.
287
288 image::media/display_copy_count_1.JPG[Display Copy Count 1]
289
290 The user may also hover over the existing copy count to view the accompanying tooltip.
291
292 image::media/display_copy_count_2.JPG[Display Copy Count 2]
293
294