New LSE for fiscal close-out added.
[sitka/doc/acquisitions.git] / admin / admin-acq-permissions.xml
CommitLineData
e81dc611
RJ
1<?xml version='1.0' encoding='UTF-8'?>\r
2<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"\r
3 xml:lang="EN" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="admin-acq-permissions">\r
4 <info>\r
5 <title>Permissions and Settings</title>\r
6 <legalnotice>\r
7 <para><emphasis role="bold">Adapted with permission from original material by the <link\r
8 xlink:title="http://evergreen-ils.org/dokuwiki/lib/exe/fetch.php?media=administration_functions_in_the_acquistions_module_ev.pdf"\r
9 xlink:href="http://evergreen-ils.org/dokuwiki/lib/exe/fetch.php?media=administration_functions_in_the_acquistions_module_ev.pdf">Evergreen\r
10 Community</link></emphasis></para>\r
11 </legalnotice>\r
12 \r
13 \r
14\r
15 <abstract>\r
c0a02d7a
JP
16 <para>The Acquisitions Module requires specific library settings to be set and acquisitions permissions to be granted to staff \r
17before the module can be used.</para>\r
18<para>This chapter covers the library settings specific to acquisitions as well as the permission groups specific to acquisitions and how to apply them.</para>\r
19 </abstract>\r
e81dc611
RJ
20 \r
21\r
22 </info>\r
23\r
e81dc611
RJ
24\r
25\r
26 <section xml:id="acq-library-settings">\r
27 <title>Acquisitions Specific Settings in Library Settings Editor</title>\r
28 \r
29\r
30<para>Several settings in the <guilabel>Library Settings Editor</guilabel> pertain to functions in the Acquisitions Module.</para>\r
31<para>You can access these settings by clicking <menuchoice><guimenu>Admin</guimenu>\r
c0a02d7a
JP
32<guisubmenu>Local Administration</guisubmenu><guimenuitem>Library Settings Editor</guimenuitem></menuchoice>. To update these settings a user must have both \r
33LSA and Acquisitions Administration permissions.</para> \r
e81dc611
RJ
34\r
35<itemizedlist>\r
77d0873a
JP
36\r
37<listitem>\r
fdcff3a9
JP
38<para><guilabel>Allow funds to be rolled over without bringing the money along</guilabel></para>\r
39<para>This setting controls whether money and encumbrances or just encumbrances are rolled over when performing the \r
40<link linkend="yearend-closeout">Fiscal Year Close-out Operation</link>.</para>\r
41</listitem>\r
42\r
43<listitem>\r
77d0873a
JP
44<para><guilabel>Allows patrons to create automatic holds from purchase requests</guilabel></para>\r
45<para>This is a placeholder setting for functionality that will be coming post 2.2.</para>\r
46</listitem>\r
47\r
e81dc611 48<listitem>\r
c0a02d7a
JP
49<para><guilabel>CAT: Delete bib if all copies are deleted via Acquisitions lineitem cancellation</guilabel> - This settings has been set to TRUE for all of Sitka.</para> \r
50<para>This means when a line item is cancelled, if there are no longer copies at any library attached to the bibliographic record, the bibliographic record will be \r
e81dc611
RJ
51deleted.</para>\r
52</listitem>\r
53\r
54<listitem>\r
55<para><guilabel>Default circulation modifier</guilabel> - Enter the circulation modifier that you would be like to be applied to items that are created in the \r
56Acquisitions Module if no circulation modifier is specified.</para>\r
c0a02d7a 57<para>If this setting is left blank no circulation modifier will be applied during the acquisitions process.</para>\r
e81dc611
RJ
58</listitem>\r
59\r
60<listitem>\r
61<para><guilabel>Default copy location</guilabel> - Select the copy location that you would like to be applied to items that are created in the Acquisitions Module \r
62if no copy location is specified.</para>\r
c0a02d7a 63<para>If this setting is left blank the system will use the SITKA Stacks copy location.</para>\r
e81dc611
RJ
64<para>The Default Copy Location can be used to make on-order items OPAC invisible. See \r
65<link linkend="onorder-OPAC-invisible">How to Make Your On-order Records OPAC Invisible</link> for instructions.</para>\r
66</listitem>\r
67\r
68<listitem>\r
69<para><guilabel>Funding Spending Limit for Block</guilabel> - When the amount remaining in the fund, including spent money and encumbrances, goes below this percentage, \r
70attempts to spend from the fund will be blocked.</para>\r
71</listitem>\r
72\r
e81dc611
RJ
73<listitem>\r
74<para><guilabel>Fund Spending Limit for Warning</guilabel> - When the amount remaining in the fund, including spent money and encumbrances, goes below this percentage, \r
75attempts to spend from the fund will be blocked.</para>\r
76</listitem>\r
77\r
77d0873a
JP
78<listitem>\r
79<para><guilabel>Set copy creator as receiver</guilabel> - When receiving a copy in acquisitions, set the copy "creator" to be the staff that received the copy.</para>\r
80<para>The creator of a copy can be seen in <guilabel>Edit Item Attributes</guilabel>.</para>\r
81</listitem>\r
e81dc611
RJ
82\r
83<listitem>\r
c0a02d7a 84<para><guilabel>Temporary barcode prefix</guilabel> - The temporary barcode prefix must be entered as your library code preceded by the letter A. This prevents conflicts between the libraries\r
e81dc611 85using acquisitions.</para>\r
c0a02d7a
JP
86<para>If this setting is left blank the system will use ACQ as the default barcode prefix. This prefix has potential to conflict with prefixes used by libraries \r
87not currently using acquisitions and so acquisitions libraries are required to use their library code for the prefix.</para>\r
e81dc611
RJ
88</listitem>\r
89\r
90\r
91<listitem>\r
92<para><guilabel>Temporary call number prefix</guilabel> - Enter a temporary call number prefix for items that are created in the Acquisitions Module.</para>\r
c0a02d7a 93<para>If this setting is left blank the system will use ACQ as the default call number.</para>\r
e81dc611
RJ
94</listitem>\r
95</itemizedlist>\r
96</section> \r
97\r
98<section xml:id="acq-permissions-overview">\r
99<title>Acquisitions Permissions Overview</title>\r
100<para>There are four Acquisitions Permission Groups: <link linkend="permissions-acqselector">Basic Selector, Advanced Selector</link>, \r
101<link linkend="permissions-acqpurchase">Purchaser</link>, <link linkend="permissions-acqadmin">Administrator</link>. These permission groups are applied \r
c0a02d7a 102in additional to a staff member's current permissions group.</para>\r
e81dc611 103\r
c0a02d7a
JP
104\r
105<note><para>At present acquisitions permissions are only available to those libraries involved in the Sitka Acquisitions Pilot.</para></note>\r
e81dc611
RJ
106\r
107\r
108\r
109<simplesect xml:id="permissions-acqselector">\r
110<title>Acquisitions Selection</title>\r
111<para>There are two permission group options for a selector.</para>\r
112\r
113<para><emphasis role="bold">Acq Basic Selector</emphasis></para>\r
114<para>This group includes permissions to:</para>\r
115<itemizedlist>\r
116<listitem>\r
117<para>perform searches using the Acquisitions General Search</para>\r
118</listitem>\r
119<listitem>\r
120<para>create, merge, clone, and delete selection lists</para>\r
121</listitem>\r
122<listitem>\r
123<para>add line items to a selection list</para>\r
124</listitem>\r
125<listitem>\r
126<para>view and use selection lists created by another user</para>\r
127</listitem>\r
128<listitem>\r
129<para>create brief MARC records</para>\r
130</listitem>\r
131<listitem>\r
132<para>perform a MARC Federated Search</para>\r
133</listitem>\r
134<listitem>\r
135<para>add copies, alerts, and notes to line items</para>\r
136</listitem>\r
137<listitem>\r
138<para>apply funds to copies and line items on a selection list</para>\r
139</listitem>\r
140<listitem>\r
141<para>link line items to bibliographic records in the catalogue</para>\r
142</listitem>\r
143<listitem>\r
144<para>mark line items <guilabel>selector-ready</guilabel> and/or <guilabel>order-ready</guilabel></para>\r
145</listitem>\r
146<listitem>\r
147<para>view, but not create, purchase orders</para>\r
148</listitem>\r
149<listitem>\r
c0a02d7a 150<para>view fund summaries for the current year for the location the workstation is registered to</para>\r
e81dc611
RJ
151</listitem>\r
152</itemizedlist>\r
153\r
154<para><emphasis role="bold">Acq Advanced Selector</emphasis></para>\r
155<para>In addition to the Acq Basic Selector permissions, this group includes permissions to:</para>\r
156<itemizedlist>\r
157<listitem>\r
158<para>view fund summaries for multiple years and location</para>\r
159</listitem>\r
160<listitem>\r
161<para>create, edit, delete funds</para>\r
162</listitem>\r
163<listitem>\r
164<para>view debits associated with a fund</para>\r
165</listitem>\r
166<listitem>\r
167<para>transfer money between funds</para>\r
168</listitem>\r
169</itemizedlist>\r
170\r
171</simplesect>\r
172\r
173<simplesect xml:id="permissions-acqpurchase">\r
174<title>Acquisitions Purchaser</title>\r
175\r
176<para>In addition to selector permissions, this groups includes permissions to:</para>\r
177\r
178<itemizedlist>\r
179<listitem>\r
180<para>apply distribution formulas to line items</para>\r
181</listitem>\r
182<listitem>\r
183<para>create, view, rename, print, and activate purchase orders</para>\r
184</listitem>\r
185<listitem>\r
186<para>add notes and charges to purchase orders</para>\r
187</listitem>\r
188<listitem>\r
189<para>receive and un-receive purchase orders, line items, and copies</para>\r
190</listitem>\r
191<listitem>\r
192<para>view purchase order history</para>\r
193</listitem>\r
194<listitem>\r
195<para>cancel purchase orders, line items, and copies</para>\r
196</listitem>\r
197<listitem>\r
198<para>change a line item's claim policy</para>\r
199</listitem>\r
200<listitem>\r
201<para>claim line items and copies</para>\r
202</listitem>\r
203<listitem>\r
204<para>print claim vouchers</para>\r
205</listitem>\r
206<listitem>\r
207<para>create, view, print, and close invoices</para>\r
208</listitem>\r
209<listitem>\r
210<para>reopen invoices</para>\r
211</listitem>\r
212<listitem>\r
213<para>add charges to invoices</para>\r
214</listitem>\r
215<listitem>\r
216<para>prorate charges across the funds on an invoice</para>\r
217</listitem>\r
218<listitem>\r
219<para>view, but not edit, providers</para>\r
220</listitem>\r
221<listitem>\r
222<para>view all invoices associated with a particular provider</para>\r
223</listitem>\r
224</itemizedlist>\r
225\r
226</simplesect>\r
227\r
228<simplesect xml:id="permissions-acqadmin">\r
229<title>Acquisitions Administrator</title>\r
230\r
231<para>In addition to the selector and purchaser permissions, this groups includes permissions to:</para>\r
232<itemizedlist>\r
233<listitem>\r
234<para>create, edit, and delete funding sources</para>\r
235</listitem>\r
236<listitem>\r
237<para>allocate credit to funding sources</para>\r
238</listitem>\r
239<listitem>\r
240<para>create, edit, and delete funds</para>\r
241</listitem>\r
242<listitem>\r
243<para>allocate credit from funding sources to funds</para>\r
244</listitem>\r
245<listitem>\r
246<para>create, edit, and delete providers</para>\r
247</listitem>\r
248<listitem>\r
249<para>update a variety of Library Editor Settings</para>\r
250</listitem>\r
251<listitem>\r
252<para>create distribution formulas</para>\r
253</listitem>\r
254<listitem>\r
255<para>create line item alerts</para>\r
256</listitem>\r
257<listitem>\r
258<para>assign acquisitions permission groups to other staff members</para>\r
259</listitem>\r
260</itemizedlist>\r
261\r
262<note><para>The Acquisition Administrator Permission Group can only be assigned to library staff by members of the Sitka Team.</para></note>\r
263\r
264</simplesect>\r
265\r
266</section>\r
267\r
268<section xml:id="acq-secondary-groups">\r
269<title>Secondary Group Permissions</title>\r
270\r
271<para>The <guibutton>Secondary Groups</guibutton> button functionality has been introduced with the acquisitions module. This button enables supplemental permission\r
272 groups to be added to staff accounts. The <guibutton>Secondary Groups</guibutton> button is currently only visible to those users with the Acq Admin supplemental\r
273permission group. </para>\r
274\r
c0a02d7a
JP
275<para><link linkend="acq-granting-permissions">Granting Acquisitions Permissions</link></para>\r
276<para><link linkend="acq-removing-permissions">Removing Acquisitions Permissions</link></para>\r
277\r
278\r
e81dc611
RJ
279<note><para>The Acq Admin permission can only be granted to users by Sitka Staff. Only users with the Acq Admin permission can grant the Acq Purchaser, Acq Avd.\r
280 Selector, and Acq Basic Selector permission to other users.</para></note>\r
281\r
c0a02d7a
JP
282<caution><para>Acquisitions permissions groups only function as secondary groups. If an acquisitions permission group is set as a user's \r
283<guilabel>Main (Profile) Permission Group</guilabel>, that user will be unable to login to Evergreen.</para></caution>\r
e81dc611
RJ
284\r
285<simplesect xml:id="acq-granting-permissions">\r
286<title>Granting Acquisitions Permissions</title>\r
287\r
288<para>To be able to use the acquisitions module, staff must be granted the appropriate supplemental permission group.</para>\r
289\r
290<procedure>\r
291<step>\r
292<para>Open the account of the user you wish to grant acquisitions permissions to.</para>\r
293</step>\r
294\r
295<step>\r
296<para>Click <guibutton>Edit</guibutton>.</para>\r
297</step>\r
298\r
299<step>\r
300<informalfigure>\r
301<para>Click <guibutton>Secondary Groups</guibutton>, located to the right of the <guilabel>Main (Profile) Permission Group</guilabel>.</para>\r
302<para><mediaobject>\r
303<alt>screenshot of providers</alt>\r
304\r
305<imageobject>\r
306<imagedata fileref="media/sup-permissions-1.png" scalefit="0"></imagedata>\r
307</imageobject>\r
308</mediaobject></para>\r
309</informalfigure>\r
310</step>\r
311\r
312<step>\r
313<informalfigure>\r
314<para>From the dropdown menu select one of the Acq Supplementary Perm Groups.</para>\r
315<para><mediaobject>\r
316<alt>screenshot of providers</alt>\r
317\r
318<imageobject>\r
319<imagedata fileref="media/sup-permissions-2.png" scalefit="0"></imagedata>\r
320</imageobject>\r
321</mediaobject></para>\r
322</informalfigure>\r
323</step>\r
324\r
325<step>\r
326<para>Click <guibutton>Add</guibutton>.</para>\r
327</step>\r
328\r
329<step>\r
330<informalfigure>\r
331<para>Click <guibutton>Save</guibutton>.</para>\r
332<para><mediaobject>\r
333<alt>screenshot of providers</alt>\r
334\r
335<imageobject>\r
336<imagedata fileref="media/sup-permissions-3.png" scalefit="0"></imagedata>\r
337</imageobject>\r
338</mediaobject></para>\r
339</informalfigure>\r
340</step>\r
341\r
342<step>\r
343<para>Click <guibutton>Save</guibutton> in the top right hand corner of the <guilabel>Edit Screen</guilabel> to save the user's account.</para>\r
344</step>\r
345</procedure>\r
346\r
347</simplesect>\r
348\r
349<simplesect xml:id="acq-removing-permissions">\r
350<title>Removing Acquisitions Permissions</title>\r
351\r
352<procedure>\r
353<step>\r
354<para>Open the account of the user you wish to remove acquisitions permissions from.</para>\r
355</step>\r
356\r
357<step>\r
358<para>Click <guibutton>Edit</guibutton>.</para>\r
359</step>\r
360\r
361<step>\r
362<informalfigure>\r
363<para>Click <guibutton>Secondary Groups</guibutton>, located to the right of the <guilabel>Main (Profile) Permission Group</guilabel>.</para>\r
364<para><mediaobject>\r
365<alt>screenshot of providers</alt>\r
366\r
367<imageobject>\r
368<imagedata fileref="media/sup-permissions-1.png" scalefit="0"></imagedata>\r
369</imageobject>\r
370</mediaobject></para>\r
371</informalfigure>\r
372</step>\r
373\r
374<step>\r
375<informalfigure>\r
376<para>Click <guibutton>Delete</guibutton> beside the permission group you would like to remove.</para>\r
377<para><mediaobject>\r
378<alt>screenshot of providers</alt>\r
379\r
380<imageobject>\r
381<imagedata fileref="media/sup-permissions-4.png" scalefit="0"></imagedata>\r
382</imageobject>\r
383</mediaobject></para>\r
384</informalfigure>\r
385</step>\r
386\r
387<step>\r
388<informalfigure>\r
389<para>Click <guibutton>Save</guibutton>.</para>\r
390<para><mediaobject>\r
391<alt>screenshot of providers</alt>\r
392\r
393<imageobject>\r
394<imagedata fileref="media/sup-permissions-5.png" scalefit="0"></imagedata>\r
395</imageobject>\r
396</mediaobject></para>\r
397</informalfigure>\r
398</step>\r
399\r
400<step>\r
401<para>Click <guibutton>Save</guibutton> in the top right hand corner of the <guilabel>Edit Screen</guilabel> to save the user's account.</para>\r
402</step>\r
403</procedure>\r
404\r
405</simplesect>\r
406\r
407\r
408</section>\r
409 \r
410</chapter>\r