Stock Rotation: Add raison d'être
[kohadocs.git] / source / tools.rst
index 05c1735..fd95b07 100644 (file)
@@ -19,7 +19,7 @@ Patrons and Circulation
 Patron lists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
--  *Get there:* More > Tools > Patrons and Circulation > Patron lists
+-  *Get there:* More > Tools > Patrons and circulation > Patron lists
 
 Patron lists are a way to store a group of patrons for easy modification
 via the :ref:`batch patron modification tool <batch-patron-modification-label>` or
@@ -47,6 +47,9 @@ menu.
 Enter the patron's name or cardnumber in the search box and click on the
 right result to add the patron.
 
+Alternatively, you can click on the 'Enter multiple card numbers' link and 
+scan (or type in) barcodes in the box.
+
 |image249|
 
 Once you have all of the patrons you would like to add you can click the
@@ -59,67 +62,116 @@ Once you have all of the patrons you would like to add you can click the
 Patron clubs
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
--  *Get there:* More > Tools > Patrons and Circulation > Patron clubs
+-  *Get there:* More > Tools > Patrons and circulation > Patron clubs
 
-Patron clubs create clubs which patrons may be enrolled in. It is
+Patron clubs create clubs in which patrons may be enrolled. It is
 useful for tracking summer reading programs, book clubs and other such clubs.
 
     **Important**
-    Staff will need permission to edit clubs, templates and enroll patrons. Go
-    to your staff members account tab and click on the More drop down menu.
-    Select Set Permissions and make sure patron clubs have checkmarks next to
-    each of the functions you want your staff to have. Remember if your staff
-    is a superlibrarian, they will have the permission.
+
+    Staff will need the :ref:`clubs permissions<granular-clubs-permissions-label>` 
+    to edit clubs, templates and enroll patrons. To learn how to set patron 
+    permissions, go to the :ref:`patron permissions section<setting-patron-permissions-label>` 
+    of this manual.
 
 Creating a new club template
-Here you can add fields that can be filled out at the time a new club is
-created based on the template, or a new enrollment is created for a given club
-based on the template. Click on the New Club template button
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Click on the 'New Club template' button. Here you can add fields that can be 
+filled out at the time a new club is created based on the template, or a new 
+enrollment is created for a given club based on the template. 
 
-Name is required. This could be something like Adult Book Club, Children’s
-Book Club or Summer Reading Program. Remember these templates will be starting
+|image1364|
+
+The name is required. This could be something like 'Adult Book Club', 'Children’s
+Book Club' or 'Summer Reading Program'. Remember these templates will be starting
 point for each club you create.
 
-Description can be any additional information
+The description can be any additional information.
 
 Allow Public Enrollment: if this box is checked it will allow patrons to enroll
-in a club based on this template from the OPAC
+in a club based on this template from the OPAC.
 
-Require valid email address: if this box is checked only patrons with a patrons
+Require valid email address: if this box is checked only patrons 
 with a valid email address can enroll. So they will need a email address
 to enroll.
 
-The library drop down gives you the flexibility to enroll patrons from specific
-branches. If you let it set to blank, all branches will be able to enroll.
+The library drop down gives you the flexibility to let staff from specific
+branches create clubs with this template. If you let it set to blank, staff 
+from any branch will be able to create a new club using this template.
+
+Club fields: these fields will be used when creating a club based on this
+template. For example, this can be the name of the club, the name of the animator, the theme, etc.
+
+|image1365|
+
+  'Name' is the label of the field
+
+  'Description' is additional information about this field. 
+
+  You can connect authorized values here. 
+
+Enrollment fields: you can add any additional fields you want to have filled
+out by your patrons when they enroll in a club base on this template. 
 
-Club Fields: these fields will be used when creating a club based on this
-template you can connect authorized values here
-Enrollment Fields: you can add any additional fields you want to have filled
-out by your patrons like you can connect authorized values here.
+|image1366|
+
+  'Name' is the label of the field
+
+  'Description' is additional information about this field. 
+
+  You can connect authorized values here.
 
 Creating a new club based on a template
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Click on the 'New club' dropdown menu and select the template you want to use.
 Here you can add information about a new club using a template you created.
-Click on the New Club dropdown menu and select the template you want to use.
 
-Name is required, this will be the name of the specific club using the
-template you created. For example, if I used my Kids Club template, I can
-create Kids Club 2017
+|image1367|
+
+The name is required, this will be the name of the specific club using the
+template you created. For example, 'Summer 2018 reading club'.
 
-Description – any additional information
+The description can be any additional information.
 
-Start  and End date will depict when this club runs, the entire duration
-of the club. Once the club expires, it will be removed from the OPAC for users
-to enroll if that option is selected.
+Start and End date will depict when this club runs, the entire duration
+of the club. Once the club expires, enrollment will not be possible.
 
 The library drop down gives you the flexibility to enroll patrons from specific
-branches. If you let it set to blank, all branches will be able to enroll.
+branches. If you let it set to blank, patrons from any branch will be able to enroll.
+
+Enrolling a patron in a club from the staff client
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To enroll a patron in a club from the staff client, go to the patron's account.
+
+On the 'Details' page or the 'Check out' page, click on the 'Clubs' tab. All 
+ongoing clubs will be displayed in this tab.
+
+|image1368|
 
-Enrolling a patron in a club
-    pull up a patron account
-    click on the checkout tab on the left hand side
-    click on the tab for club
-    add the patron to the selected club by selecting the enroll button
-    you can also cancel enrollment by clicking on the cancel enrollment
+Click on the 'Enroll' button and fill in the fields. 
+
+You can also cancel enrollment by clicking on the cancel enrollment.
+
+Enrolling a patron in a club from the OPAC
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you allow public enrollment, the club will be visible on the OPAC.
+
+Patrons have to sign into their account. In the 'Your summary' section, they 
+will be able to click on the 'Clubs' tab and enroll.
+
+|image1369|
+
+Viewing enrollments
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can monitor the enrollments in each club by going to the 'Patron clubs' tool page 
+and choosing 'Enrollment' from the 'Actions' button.
+
+|image1370|
 
 .. _comments-label:
 
@@ -157,10 +209,10 @@ by choosing the 'Approved comments' tab
 
 .. _patron-import-label:
 
-Patron Import
+Patron import
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
--  *Get there:* More > Tools > Patrons and Circulation > Import Patrons
+-  *Get there:* More > Tools > Patrons and circulation > Import patrons
 
 The patron import tool can be used at any time to add patrons in bulk.
 It is commonly used in universities and schools when a new batch of
@@ -168,27 +220,21 @@ students registers.
 
 .. _creating-patron-file-label:
 
-Creating Patron File
+Creating a patron import file
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Your Koha installation comes with a blank CSV file that you can use as a
-template for your patron records. If you would like to create the file
-yourself, make sure that your file has the following fields in this
-order as the header row:
-
-cardnumber, surname, firstname, title, othernames, initials,
-streetnumber, streettype, address, address2, city, state, zipcode,
-country, email, phone, mobile, fax, emailpro, phonepro, B\_streetnumber,
-B\_streettype, B\_address, B\_address2, B\_city, B\_state, B\_zipcode,
-B\_country, B\_email, B\_phone, dateofbirth, branchcode, categorycode,
-dateenrolled, dateexpiry, gonenoaddress, lost, debarred,
-debarredcomment, contactname, contactfirstname, contacttitle,
-guarantorid, borrowernotes, relationship, ethnicity, ethnotes, sex,
-password, flags, userid, opacnote, contactnote, sort1, sort2,
-altcontactfirstname, altcontactsurname, altcontactaddress1,
-altcontactaddress2, altcontactaddress3, altcontactstate,
-altcontactzipcode, altcontactcountry, altcontactphone, smsalertnumber,
-privacy, patron\_attributes
+You can download a blank CSV file with a header from the start page
+of the patron import tool that you can use as a template for your
+patron import. The header contains all fields that can be used with
+the patron import tool. You can delete fields and columns you don't need
+with the exception of a few mandatory ones.
+
+    **Important**
+
+    cardnumber, surname, and all fields you have
+    defined in the :ref:`BorrowerMandatoryField`
+    preference are required and must match valid entries in your
+    database.
 
     **Important**
 
@@ -201,14 +247,8 @@ privacy, patron\_attributes
     **Important**
 
     Date formats should match your :ref:`system preference <dateformat-label>`,
-    and must be zero-padded, e.g. '01/02/2008'.
-
-    **Important**
-
-    The fields 'branchcode', 'categorycode' and all fields you have
-    defined in the :ref:`BorrowerMandatoryField`
-    preference are required and must match valid entries in your
-    database.
+    and must be zero-padded, e.g. '01/02/2008'. Alternatively you can supply
+    dates in ISO format (e.g. '2008-12-01').
 
     **Note**
 
@@ -228,24 +268,29 @@ privacy, patron\_attributes
 
           -  "INSTID:12345,BASEBALL:Cubs,""BASEBALL:White Sox"""
 
-       -  When replacing a patron record, any attributes specified in
-          the input file replace all of the attribute values of any type
-          that were previously assigned to the patron record.
+    **Note**
+
+    It's possible to set restrictions using the patron import
+    tool. If the expiration date and comment match an existing restriction,
+    the one in the import file will be skipped. So a patron import can be
+    repeated multiple times without creating duplicate restrictions.
+    But if one of the criteria is different, a new restriction will be added.
 
 .. _importing-patrons-label:
 
 Importing Patrons
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Once you have created your file, you can use the Patron Import Tool to
+Once you have created your file, you can use the patron import tool to
 bring the data into Koha.
 
 -  Choose your CSV file
 
    |image255|
 
--  Choose to match on 'Cardnumber' or 'Username' to prevent adding of
-   duplicate card numbers to the system
+-  Choose to match on 'cardnumber' or 'username' to prevent adding of
+   duplicate card numbers to the system. Additional matchpoints can be
+   set up using patron attributes marked as unique.
 
    |image256|
 
@@ -253,20 +298,24 @@ bring the data into Koha.
    importing
 
    -  ex. If you're importing patrons specific to one branch you can use
-      the field on the Import form to apply the branch code to all those
+      the field on the import form to apply the branch code to all those
       you are importing.
 
 -  Finally you need to decide on what data you want to replace if there
    are duplicates.
 
-   |image257|
-
    -  A matching record is found using the field you chose for matching
       criteria to prevent duplication
 
-   -  If you included patron attributes in your file you can decide
-      whether to add your values to existing values or erase existing
-      values and enter only your new values.
+     |image257|
+
+   -  When using patron attributes in your installation, you can choose how 
+      they are handled on import. You can either decide to always overlay all
+      patron attributes or you choose to only replace patron attributes
+      included in your import file. This will leave other attributes
+      untouched.
+   
+     |image1355|
 
 .. _notices-&-slips-label:
 
@@ -318,12 +367,6 @@ To add a new notice or slip
 
 -  The Code is limited to 20 characters
 
-   -  **Important**
-
-          When working with the overdue notices you want each notice at
-          each branch to have a unique code. Think about using the
-          branch code in front of the notice code for each branch.
-
 -  Use the name field to expand on your Code
 
    -  **Note**
@@ -411,6 +454,30 @@ To add a new notice or slip
              slips or notice you can enter data in the Other name or
              Initials field for each patron and use that value instead.
 
+   -  The system preference :ref:`TranslateNotices` will add tabs for each
+      installed language to the notices editor. The notice defined in the
+      'Default' tab will be used if there is no preferred language set
+      for a patron.
+
+      |image1335|
+      
+.. _preview-notice-templates-label:
+
+Preview notice templates
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For some notices it is possible to preview the notice template showing how
+it would look to a specified patron for a particular item or record.
+
+If a notice template is previewable the notice template header will contain a
+field to enter preview data
+
+|image1342|
+
+Fill in the necessary information for the template then click the Preview button
+below the message body. The preview dialog will indicate if there are any problems
+generating the notice template preview.
+
 .. _overdue-notice-markup-label:
 
 Overdue Notice Markup
@@ -461,6 +528,24 @@ also want to review the `Customising Notices and Slips
 wiki page for information on formatting item
 information in these notices. Here are some of what those notices do:
 
+-  ACCEPTED
+
+   -  This notice is sent when a patron's suggestion is accepted.
+
+   -  *Note:* If you don't want to send this notice, just delete it.
+      
+-  ACCOUNT\_PAYMENT
+
+   -  This notice is sent for each payment transaction in a patron's 
+      account if the :ref:`UseEmailReceipts` system preference is set 
+      to 'Send'.
+
+-  ACCOUNT\_WRITEOFF
+
+   -  This notice is sent for each writeoff transaction in a patron's 
+      account if the :ref:`UseEmailReceipts` system preference is set 
+      to 'Send'.
+
 -  ACCTDETAILS
 
    -  Sent to patrons when their account is set up if the
@@ -473,11 +558,69 @@ information in these notices. Here are some of what those notices do:
       The notice can't be resend or triggered again after the patron account
       has been created.
 
--  ACQCLAIM (Acquisition Claim)
+-  ACQCLAIM (Acquisition claim)
+
+   -  Used for claiming orders in the aquisitions module
+
+   -  ACQCLAIM is the code of the sample notice, but it's possible to define
+      several notices choosing any code. Only the module 'Claim
+      aquisition' will be taken into account. All notices with this module
+      will appear in the pull down on the late orders page.
+
+   -  *Get there:* More > Acquisitions > Late orders
+
+   -  This notice is sent if several criteria are met:
+
+      #. The staff patron triggering the email has a valid email address.
+
+      #. The vendor contact marked as 'Contact about late orders?' has 
+         a valid email address.
+
+-  ACQORDER (Acquisition order)
+
+   -  Used in the acquisitions module to send order information to the vendor
+
+   -  The notice is triggered manually from the basket summary page using
+      the 'Email order' button in the toolbar.
+
+   -  This notice is sent if several criteria are met:
+
+      #. The staff patron triggering the email has a valid email address.
+
+      #. The vendor contact marked as 'Primary acquisitions contact' and
+         'Contact when ordering' has a valid email address.
+
+-  ACQ_NOTIF_ON_REVEIV
+
+   -  Used in the acquisition module to inform patrons on receiving orders
+      they have been added to. 
+
+-  AR\_CANCELLED
+
+   -  This notice is sent to the patron when an article request is cancelled
+      by staff.
+
+-  AR\_COMPLETED
+
+   -  This notice is sent to the patron when an article request is marked
+      as completed by staff.
+
+-  AR\_PENDING
+
+   -  This notice is sent to the patron when an article request has been
+      made in order to confirm the request.
 
-   -  Used in the claim acquisition module
+-  AR\_PROCESSING
 
-   -  *Get there:* More > Acquisitions > Late issues
+   -  This notice is sent to the patron when an article request is marked
+      as being processed by staff.
+
+-  AVAILABLE
+
+   -  This notice is sent to the patron who made a suggestion, when the
+      order created from the suggestion is received.
+
+   -  *Note:* If you don't want to send this notice, just delete it.
 
 -  CHECKIN
 
@@ -515,6 +658,17 @@ information in these notices. Here are some of what those notices do:
          -  *Get there:*\ Staff Client > Patron Record >
             :ref:`Notices`
 
+-  DISCHARGE
+
+  -  This notice is used to generate a PDF to document a successful
+     discharge request
+
+  -  The PDF can either be downloaded by the patron from their patron
+     account or from the staff interface when discharging a patron
+
+  -  The discharge feature is controlled by the :ref:`useDischarge`
+     system preference.
+
 -  DUE
 
    -  This notice is sent as the 'Item due' for an item is due
@@ -586,15 +740,32 @@ information in these notices. Here are some of what those notices do:
       :ref:`MembershipExpiryDaysNotice` set
       and the :ref:`related cron job <notify-patrons-of-expiration-label>` set.
 
--  ODUE (Overdue Notice)
+-  ODUE (Overdue notice)
 
-   -  This notice is used to send Overdue Notices to Patrons
+   -  This notice is used to send Overdue Notices to patrons
 
-   -  See a `Sample Overdue Notice <#samplenotice>`__
+   -  ODUE is the code of the sample notice, but it's possible to use
+      any code and define multiple different messages for different
+      patron categories and notice levels
 
    -  Requires that you set :ref:`Overdue Notice/Status
       Triggers <overdue-notice/status-triggers-label>`
 
+-  ORDERED
+
+   -  This notice is sent to the patron who made a suggestion, when the
+      'from a suggestion' option is used to create an order from it.
+
+   -  Note: If you don't want to send this notice, just delete it.
+
+-  PASSWORD_RESET
+
+   -  This notice is sent when a patron requests a new password from the
+      OPAC in order to validate the email address.
+
+   -  The password reset feature is controlled by the :ref:`OpacResetPassword`
+      system preference.
+
 -  PREDUE
 
    -  This notice is sent as the 'Advanced notice' for an item is due
@@ -630,6 +801,12 @@ information in these notices. Here are some of what those notices do:
          -  *Get there:*\ Staff Client > Patron Record >
             :ref:`Notices`
 
+-  REJECTED
+
+   -  This notice is sent when a patron's suggestion is rejected.
+
+   -  Note: If you don't want to send this notice, just delete it.
+
 -  RENEWAL
 
    -  This notice is sent as the 'Check out' notice for all items that
@@ -651,17 +828,24 @@ information in these notices. Here are some of what those notices do:
          -  *Get there:*\ Staff Client > Patron Record >
             :ref:`Notices`
 
--  RLIST (Routing List)
+-  SERIAL_ALERT (New serial issue)
 
-   -  Used in the serials module to notify patrons/staff of new issues
-      of a serial
+   -  Notice used in the serials module to notify patrons/staff
+      of new issues of a serial. SERIAL_ALERT (RLIST in older verisons)
+      is provided as a sample notice, but the notice code can be chosen
+      freely as only the module is taken into account. Multiple notices
+      can also be managed.
 
       -  *Get there:* More > Serials > :ref:`New
          Subscription <add-a-subscription-label>`
 
-   -  You have the option to select the 'Routing List' notice when
-      creating a new subscription (Choose from the 'Patron notification'
-      drop down).
+   -  You have the option to select the notice used to inform the patron
+      about a received serial issue for a subscription. Choose from the
+      'Patron notification' drop down.
+
+   -  If a notice has been selected for a subscription, patrons can
+      subscribe to the email notification from the subscription tab
+      in the detail view in the OPAC.
 
    -  **Note**
 
@@ -701,6 +885,15 @@ the Notices & Slips tool and their style using the
 :ref:`SlipCSS` preference to define a stylesheet. Here is what
 those slips are used for:
 
+-  AR\_SLIP
+
+   -  Used to print a slip for an article request
+
+   -  The slip or receipt can be printed manually when managing article
+      requests from the staff interface.
+
+   -  *Get there:* Circulation > Article requests > Actions > Print slip
+
 -  ISSUEQSLIP
 
    -  Used to print the quick slip in circulation
@@ -721,6 +914,13 @@ those slips are used for:
    -  The holds slip is generated when a hold is confirmed and set to 
       waiting.
 
+-  OVERDUE\_SLIP
+
+   -  Used to print an overdues slip
+
+   -  The overdues slip can be generated manually using the 'print' menu
+      in the patron account in staff. It will show all items overdue.
+
 -  TRANSFERSLIP
 
    -  Used to print a transfer slip
@@ -785,13 +985,6 @@ items
    Tech service <talkingtechitivaphonenotification-label>`), Print and SMS
    (if you have set your :ref:`SMSSendDriver <smssenddriver,-smssendusername,-and-smssendpassword-label>`).
 
-   -  **Note**
-
-          The Feed option is not yet a feature in Koha, it is there for
-          future development.
-
--  See a `Sample Overdue Notice <#samplenotice>`__
-
 .. _patron-card-creator-label:
 
 Patron Card Creator
@@ -1197,7 +1390,7 @@ side of the page.
 To delete one or multiple of these images, click the checkbox to the
 right of each image you want to delete and click the 'Delete' button.
 
-.. _patrons-(anonymize,-bulk-delete)-label:
+.. _patrons-anonymize-bulk-delete-label:
 
 Patrons (anonymize, bulk-delete)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1484,6 +1677,125 @@ collection, also letting them know where the item needs to be sent.
 
 |image292|
 
+.. _patrons-stock_rotation
+
+Stock Rotation
+~~~~~~~~~~~~~~
+
+Stock Rotation helps to spread resources more fairly amongst library branches
+and allows patrons to see a wider range of titles.
+
+Items are popular whilst they are new at a particular branch. However, their
+use often tails off over time. This tool empowers librarians to automate the
+movement of items on to another branch before usage declines and thereby
+extends the items useful life.
+
+Library staff create rotation plans and then assign them to items. A cronjob
+is then used to cycle these items round the specified libraries on the
+rotation plan, moving them to the next stage after the prescribed period
+of time has passed at the current stage.
+
+Email notices may be used to provide the library branches with a list of
+items to be put in-transit to the next branch and if an item is found to be
+on loan at the time that it should be transfered then an alert will be
+displayed when it is next returned.
+
+From the stock rotation tool page you can add new rotation plans and see a 
+summary of your currently configured rotation plans. You can then edit plan 
+details, activate and deactivate plans and manage stages and items on a given 
+rotation plan.
+
+|image1381|
+
+This tool utilises a cron job that must be configured to run on a daily basis.
+
+Editing rota details
+^^^^^^^^^^^^^^^^^^^^
+
+|image1382|
+
+Name: A clear name or code to identify the rota
+
+Cyclical: Denotes whether items remain (No) at the last library on the rotation
+plan upon reaching the end of the rota or whether they continue (Yes) to rotate,
+returning back to the first library on the rotation plan once they have
+completed their alloted time at the last library, indefinitely until manually
+removed from the rota.
+
+Active: Denotes whether a rota is active and as such whether items on it are
+rotating. It also governs whether items may be added to and removed from the
+rota.  A rota may be switched between active and inactive at any time allowing
+for rota maintanence.
+
+Description: One may optionally add an expanded description of the rota for
+display in summary views.
+
+
+Managing rota stages
+^^^^^^^^^^^^^^^^^^^^
+
+|image1383|
+
+Stages may be edited, added, removed and re-ordered at any time from this page.
+
+Library: The library the item will be at during this stage
+
+Duration: The amount of time the item should stage at this stage
+
+
+Managing rota items - Tool view
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+|image1384|
+
+Items can be added to a rota individually (by barcode) or in bulk (via the
+upload of a line delimited barcode file) on this page.
+
+You will also be presented with a summary of all items on the rota with their
+current location and you have the options to immediately progress items, mark
+items as 'in demand' and remove an item from rotation.
+
+In demand: If an item is marked as 'in demand' then the duration the item will
+stay at it's current stage will be doubled compared to what is set in the
+rota. This is often used for items that are found to be unexpectedly popular at
+a particular library.
+
+Managing rota items - Catalog view
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+|image1385|
+
+Rotating items may also be managed from the catalog view: When stock rotation is
+enabled a new menu tab 'Rota' will appear on a catalog records detail view.
+
+All attached items will appear in the summary view with their current status in
+relation to rotas and the option to mark items as 'in demand' or immediately
+progress them.  You can also remove items from rotation and add items to rotas
+here too.
+
+Managing rotation notices
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Stock rotation can send email notices to branch libraries to aid in selecting
+the items due for rotation. Branch 'Reply-to' addresses will be used in
+preference to 'Email' addresses for the notice recipients.
+
+The contents of the notices can be customised in the normal manor through the
+notices tool and the relevant notice has the code SR_SLIP.
+
+Permissions
+^^^^^^^^^^^
+
+The stock rotation tool uses two distinct permissions:
+
+manage_rotas:
+  this governs a users ability to create, update and delete a rota.
+
+manate_rota_items:
+  this governs a users ability to add, remove and progress
+items on a rota.
+
+
 .. _catalog-label:
 
 Catalog
@@ -1831,16 +2143,18 @@ authority records' tab.
 
 -  Click 'Export authority records'
 
-.. _inventory-label:
+.. _inventory-tool-label:
 
 Inventory
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 -  *Get there:* More > Tools > Catalog > Inventory
 
-Koha's Inventory Tool can be used in one of three ways:
+Koha's Inventory tool can be used in one of three ways:
 1. By printing out a shelf list that you can then mark items off on;
+
 2. By uploading a text file of barcodes gathered by a portable scanner;
+
 3. By comparing a text file of barcodes gathered by a portable scanner to a
    generated shelf list.
 
@@ -1855,8 +2169,10 @@ All parameters are optional, but if none are selected, the resulting list
 might be quite large.
 
 - Library: choose the branch you want to check, as well as if that branch
-  is the home library or the current of the items.
+  is the home library or the current holding library of the items.
+
 - Shelving location (items.location) is: you can filter by location.
+
 - Item callnumber between ... and ...: you can also limit the list to a specific
   range of callnumbers.
 
@@ -1867,6 +2183,7 @@ only the 'for loan' status as the other items probably won't be on the shelves.
 
 - Last inventory date: enter a date here to skip items that have been marked
   as seen recently.
+
 - Skip items on loan: check this box to filter out loaned items from the list.
 
 - Export to CSV file: check this box to generate a CSV file for altering in an
@@ -1885,15 +2202,17 @@ the three buttons to continue:
 
 - Mark seen and quit: updates the 'last seen' date of the checked items to
   today and returns to the previous screen.
+
 - Mark seen and continue: updates the 'last seen' date of the checked items to
   today and shows the next page of the list.
+
 - Continue without marking: doesn't update any of the items on this page
   and shows the next page of the list.
 
 If you have a portable scanner (or a laptop and USB scanner) you can
 walk through the library with the scanner in hand and scan barcodes as
-you come across them (on a laptop, scan the barcodes into a text file). Once finished you can then upload the text
-file generated by the scanner to Koha.
+you come across them (on a laptop, scan the barcodes into a text file). Once 
+finished you can then upload the text file generated by the scanner to Koha.
 
 |image317|
 
@@ -1906,27 +2225,33 @@ items scanned during inventory' before clicking 'Submit'.
 
 Alternatively, you can combine the two methods to automatically compare a list
 of scanned barcodes with a generated list. First, upload you barcode file and
-choose the date you want to appear in the items' 'last seen' field. Then, check
-the 'Compare barcodes list to results'. Choose the filters (library, shelving
-location, callnumbers or statuses) to generate a list with which to compare
-your barcodes. Click on 'Submit'.
+choose the date you want to appear in the items' 'last seen' field. The 'Compare 
+barcodes list to results' checkbox should automatically be checked. If you do 
+not want the scanned items to be automatically checked-in if they are checked-out, 
+make sure you check the 'Do not check in items scanned during inventory' checkbox. 
+Choose the filters (library, shelving location, callnumbers or statuses) to generate a 
+list with which to compare your barcodes. Click on 'Submit'.
 
-  **Note**
+    **Note**
 
-  Depending on the number of barcodes you are comparing, this may take a few
-  minutes. It is not recommended to compare lists of more than 1000 barcodes as
-  this may cause a session timeout.
+    Depending on the number of barcodes you are comparing, this may take a few
+    minutes. It is not recommended to compare lists of more than 1000 barcodes as
+    this may cause a session timeout.
 
 Once Koha has finished comparing the barcodes file to the generated list, it
 will return the number of items updated and a list of problematic items.
 
 - Missing (not scanned): the item is in the generated list but not in the
   barcodes file.
+
 - Found in wrong place: the item is in the barcodes list, but not in the
   generated list.
+
 - Still checked out: the item is checked out, but is in the generated list. It
   was not automatically checked in.
+
 - Barcode not found: the barcode doesn't exist.
+
 - Item withdrawn: the item has 'withdrawn' status, but it is in the barcodes
   file.
 
@@ -3249,13 +3574,25 @@ uploaded you will be presented with a confirmation.
 
 .. _search-files-label:
 
-Search Files
+Search files
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 All uploaded files are searchable from below the upload form. Using the
 form you can search any part of the filename and/or the Hashvalue.Search
 uploaded files
 
-You will be presened with the results of your search.
+You will be presented with the results of your search.
 
 |image1245|
+
+Access files
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+-  *Get there:* More > Tools > Additional Tools > Access files
+
+This option allows access to files stored on the server from the staff interface.
+The directories where the files are stored need to be defined in the koha-conf.xml
+file. In order to be able to access the tool, a staff patron requires the superlibrarian
+or access_files patron permission
+
+|image1340|