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