Links added to new features.
[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
36<listitem>\r
c0a02d7a
JP
37<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
38<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
39deleted.</para>\r
40</listitem>\r
41\r
42<listitem>\r
43<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
44Acquisitions Module if no circulation modifier is specified.</para>\r
c0a02d7a 45<para>If this setting is left blank no circulation modifier will be applied during the acquisitions process.</para>\r
e81dc611
RJ
46</listitem>\r
47\r
48<listitem>\r
49<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
50if no copy location is specified.</para>\r
c0a02d7a 51<para>If this setting is left blank the system will use the SITKA Stacks copy location.</para>\r
e81dc611
RJ
52<para>The Default Copy Location can be used to make on-order items OPAC invisible. See \r
53<link linkend="onorder-OPAC-invisible">How to Make Your On-order Records OPAC Invisible</link> for instructions.</para>\r
54</listitem>\r
55\r
56<listitem>\r
57<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
58attempts to spend from the fund will be blocked.</para>\r
59</listitem>\r
60\r
61\r
62<listitem>\r
63<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
64attempts to spend from the fund will be blocked.</para>\r
65</listitem>\r
66\r
67\r
68<listitem>\r
c0a02d7a 69<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 70using acquisitions.</para>\r
c0a02d7a
JP
71<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
72not currently using acquisitions and so acquisitions libraries are required to use their library code for the prefix.</para>\r
e81dc611
RJ
73</listitem>\r
74\r
75\r
76<listitem>\r
77<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 78<para>If this setting is left blank the system will use ACQ as the default call number.</para>\r
e81dc611
RJ
79</listitem>\r
80</itemizedlist>\r
81</section> \r
82\r
83<section xml:id="acq-permissions-overview">\r
84<title>Acquisitions Permissions Overview</title>\r
85<para>There are four Acquisitions Permission Groups: <link linkend="permissions-acqselector">Basic Selector, Advanced Selector</link>, \r
86<link linkend="permissions-acqpurchase">Purchaser</link>, <link linkend="permissions-acqadmin">Administrator</link>. These permission groups are applied \r
c0a02d7a 87in additional to a staff member's current permissions group.</para>\r
e81dc611 88\r
c0a02d7a
JP
89\r
90<note><para>At present acquisitions permissions are only available to those libraries involved in the Sitka Acquisitions Pilot.</para></note>\r
e81dc611
RJ
91\r
92\r
93\r
94<simplesect xml:id="permissions-acqselector">\r
95<title>Acquisitions Selection</title>\r
96<para>There are two permission group options for a selector.</para>\r
97\r
98<para><emphasis role="bold">Acq Basic Selector</emphasis></para>\r
99<para>This group includes permissions to:</para>\r
100<itemizedlist>\r
101<listitem>\r
102<para>perform searches using the Acquisitions General Search</para>\r
103</listitem>\r
104<listitem>\r
105<para>create, merge, clone, and delete selection lists</para>\r
106</listitem>\r
107<listitem>\r
108<para>add line items to a selection list</para>\r
109</listitem>\r
110<listitem>\r
111<para>view and use selection lists created by another user</para>\r
112</listitem>\r
113<listitem>\r
114<para>create brief MARC records</para>\r
115</listitem>\r
116<listitem>\r
117<para>perform a MARC Federated Search</para>\r
118</listitem>\r
119<listitem>\r
120<para>add copies, alerts, and notes to line items</para>\r
121</listitem>\r
122<listitem>\r
123<para>apply funds to copies and line items on a selection list</para>\r
124</listitem>\r
125<listitem>\r
126<para>link line items to bibliographic records in the catalogue</para>\r
127</listitem>\r
128<listitem>\r
129<para>mark line items <guilabel>selector-ready</guilabel> and/or <guilabel>order-ready</guilabel></para>\r
130</listitem>\r
131<listitem>\r
132<para>view, but not create, purchase orders</para>\r
133</listitem>\r
134<listitem>\r
c0a02d7a 135<para>view fund summaries for the current year for the location the workstation is registered to</para>\r
e81dc611
RJ
136</listitem>\r
137</itemizedlist>\r
138\r
139<para><emphasis role="bold">Acq Advanced Selector</emphasis></para>\r
140<para>In addition to the Acq Basic Selector permissions, this group includes permissions to:</para>\r
141<itemizedlist>\r
142<listitem>\r
143<para>view fund summaries for multiple years and location</para>\r
144</listitem>\r
145<listitem>\r
146<para>create, edit, delete funds</para>\r
147</listitem>\r
148<listitem>\r
149<para>view debits associated with a fund</para>\r
150</listitem>\r
151<listitem>\r
152<para>transfer money between funds</para>\r
153</listitem>\r
154</itemizedlist>\r
155\r
156</simplesect>\r
157\r
158<simplesect xml:id="permissions-acqpurchase">\r
159<title>Acquisitions Purchaser</title>\r
160\r
161<para>In addition to selector permissions, this groups includes permissions to:</para>\r
162\r
163<itemizedlist>\r
164<listitem>\r
165<para>apply distribution formulas to line items</para>\r
166</listitem>\r
167<listitem>\r
168<para>create, view, rename, print, and activate purchase orders</para>\r
169</listitem>\r
170<listitem>\r
171<para>add notes and charges to purchase orders</para>\r
172</listitem>\r
173<listitem>\r
174<para>receive and un-receive purchase orders, line items, and copies</para>\r
175</listitem>\r
176<listitem>\r
177<para>view purchase order history</para>\r
178</listitem>\r
179<listitem>\r
180<para>cancel purchase orders, line items, and copies</para>\r
181</listitem>\r
182<listitem>\r
183<para>change a line item's claim policy</para>\r
184</listitem>\r
185<listitem>\r
186<para>claim line items and copies</para>\r
187</listitem>\r
188<listitem>\r
189<para>print claim vouchers</para>\r
190</listitem>\r
191<listitem>\r
192<para>create, view, print, and close invoices</para>\r
193</listitem>\r
194<listitem>\r
195<para>reopen invoices</para>\r
196</listitem>\r
197<listitem>\r
198<para>add charges to invoices</para>\r
199</listitem>\r
200<listitem>\r
201<para>prorate charges across the funds on an invoice</para>\r
202</listitem>\r
203<listitem>\r
204<para>view, but not edit, providers</para>\r
205</listitem>\r
206<listitem>\r
207<para>view all invoices associated with a particular provider</para>\r
208</listitem>\r
209</itemizedlist>\r
210\r
211</simplesect>\r
212\r
213<simplesect xml:id="permissions-acqadmin">\r
214<title>Acquisitions Administrator</title>\r
215\r
216<para>In addition to the selector and purchaser permissions, this groups includes permissions to:</para>\r
217<itemizedlist>\r
218<listitem>\r
219<para>create, edit, and delete funding sources</para>\r
220</listitem>\r
221<listitem>\r
222<para>allocate credit to funding sources</para>\r
223</listitem>\r
224<listitem>\r
225<para>create, edit, and delete funds</para>\r
226</listitem>\r
227<listitem>\r
228<para>allocate credit from funding sources to funds</para>\r
229</listitem>\r
230<listitem>\r
231<para>create, edit, and delete providers</para>\r
232</listitem>\r
233<listitem>\r
234<para>update a variety of Library Editor Settings</para>\r
235</listitem>\r
236<listitem>\r
237<para>create distribution formulas</para>\r
238</listitem>\r
239<listitem>\r
240<para>create line item alerts</para>\r
241</listitem>\r
242<listitem>\r
243<para>assign acquisitions permission groups to other staff members</para>\r
244</listitem>\r
245</itemizedlist>\r
246\r
247<note><para>The Acquisition Administrator Permission Group can only be assigned to library staff by members of the Sitka Team.</para></note>\r
248\r
249</simplesect>\r
250\r
251</section>\r
252\r
253<section xml:id="acq-secondary-groups">\r
254<title>Secondary Group Permissions</title>\r
255\r
256<para>The <guibutton>Secondary Groups</guibutton> button functionality has been introduced with the acquisitions module. This button enables supplemental permission\r
257 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
258permission group. </para>\r
259\r
c0a02d7a
JP
260<para><link linkend="acq-granting-permissions">Granting Acquisitions Permissions</link></para>\r
261<para><link linkend="acq-removing-permissions">Removing Acquisitions Permissions</link></para>\r
262\r
263\r
e81dc611
RJ
264<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
265 Selector, and Acq Basic Selector permission to other users.</para></note>\r
266\r
c0a02d7a
JP
267<caution><para>Acquisitions permissions groups only function as secondary groups. If an acquisitions permission group is set as a user's \r
268<guilabel>Main (Profile) Permission Group</guilabel>, that user will be unable to login to Evergreen.</para></caution>\r
e81dc611
RJ
269\r
270<simplesect xml:id="acq-granting-permissions">\r
271<title>Granting Acquisitions Permissions</title>\r
272\r
273<para>To be able to use the acquisitions module, staff must be granted the appropriate supplemental permission group.</para>\r
274\r
275<procedure>\r
276<step>\r
277<para>Open the account of the user you wish to grant acquisitions permissions to.</para>\r
278</step>\r
279\r
280<step>\r
281<para>Click <guibutton>Edit</guibutton>.</para>\r
282</step>\r
283\r
284<step>\r
285<informalfigure>\r
286<para>Click <guibutton>Secondary Groups</guibutton>, located to the right of the <guilabel>Main (Profile) Permission Group</guilabel>.</para>\r
287<para><mediaobject>\r
288<alt>screenshot of providers</alt>\r
289\r
290<imageobject>\r
291<imagedata fileref="media/sup-permissions-1.png" scalefit="0"></imagedata>\r
292</imageobject>\r
293</mediaobject></para>\r
294</informalfigure>\r
295</step>\r
296\r
297<step>\r
298<informalfigure>\r
299<para>From the dropdown menu select one of the Acq Supplementary Perm Groups.</para>\r
300<para><mediaobject>\r
301<alt>screenshot of providers</alt>\r
302\r
303<imageobject>\r
304<imagedata fileref="media/sup-permissions-2.png" scalefit="0"></imagedata>\r
305</imageobject>\r
306</mediaobject></para>\r
307</informalfigure>\r
308</step>\r
309\r
310<step>\r
311<para>Click <guibutton>Add</guibutton>.</para>\r
312</step>\r
313\r
314<step>\r
315<informalfigure>\r
316<para>Click <guibutton>Save</guibutton>.</para>\r
317<para><mediaobject>\r
318<alt>screenshot of providers</alt>\r
319\r
320<imageobject>\r
321<imagedata fileref="media/sup-permissions-3.png" scalefit="0"></imagedata>\r
322</imageobject>\r
323</mediaobject></para>\r
324</informalfigure>\r
325</step>\r
326\r
327<step>\r
328<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
329</step>\r
330</procedure>\r
331\r
332</simplesect>\r
333\r
334<simplesect xml:id="acq-removing-permissions">\r
335<title>Removing Acquisitions Permissions</title>\r
336\r
337<procedure>\r
338<step>\r
339<para>Open the account of the user you wish to remove acquisitions permissions from.</para>\r
340</step>\r
341\r
342<step>\r
343<para>Click <guibutton>Edit</guibutton>.</para>\r
344</step>\r
345\r
346<step>\r
347<informalfigure>\r
348<para>Click <guibutton>Secondary Groups</guibutton>, located to the right of the <guilabel>Main (Profile) Permission Group</guilabel>.</para>\r
349<para><mediaobject>\r
350<alt>screenshot of providers</alt>\r
351\r
352<imageobject>\r
353<imagedata fileref="media/sup-permissions-1.png" scalefit="0"></imagedata>\r
354</imageobject>\r
355</mediaobject></para>\r
356</informalfigure>\r
357</step>\r
358\r
359<step>\r
360<informalfigure>\r
361<para>Click <guibutton>Delete</guibutton> beside the permission group you would like to remove.</para>\r
362<para><mediaobject>\r
363<alt>screenshot of providers</alt>\r
364\r
365<imageobject>\r
366<imagedata fileref="media/sup-permissions-4.png" scalefit="0"></imagedata>\r
367</imageobject>\r
368</mediaobject></para>\r
369</informalfigure>\r
370</step>\r
371\r
372<step>\r
373<informalfigure>\r
374<para>Click <guibutton>Save</guibutton>.</para>\r
375<para><mediaobject>\r
376<alt>screenshot of providers</alt>\r
377\r
378<imageobject>\r
379<imagedata fileref="media/sup-permissions-5.png" scalefit="0"></imagedata>\r
380</imageobject>\r
381</mediaobject></para>\r
382</informalfigure>\r
383</step>\r
384\r
385<step>\r
386<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
387</step>\r
388</procedure>\r
389\r
390</simplesect>\r
391\r
392\r
393</section>\r
394 \r
395</chapter>\r