From 4b115bac26f3ba71b45fcbebc31bf535fc81f19d Mon Sep 17 00:00:00 2001 From: Owen Leonard Date: Mon, 4 Aug 2008 13:21:06 -0500 Subject: [PATCH] Correcting markup for validity. Signed-off-by: Joshua Ferraro --- .../en/modules/help/acqui/booksellers.tmpl | 61 +++++++++- .../prog/en/modules/help/acqui/parcel.tmpl | 33 +++++- .../prog/en/modules/help/admin/aqbudget.tmpl | 36 +++++- .../en/modules/help/admin/matching-rules.tmpl | 16 ++- .../modules/help/authorities/authorities.tmpl | 67 ++++++++++- .../en/modules/help/members/member-flags.tmpl | 109 +++++++++++++++++- .../prog/en/modules/help/tags/review.tmpl | 45 +++++++- .../prog/en/modules/help/tools/export.tmpl | 27 ++++- .../help/tools/manage-marc-import.tmpl | 18 ++- 9 files changed, 375 insertions(+), 37 deletions(-) diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/booksellers.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/booksellers.tmpl index 4a639a9ccc..7a16728b0e 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/booksellers.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/booksellers.tmpl @@ -1,5 +1,58 @@ -
-


Ordering

  • Click 'New order'
  • You can add a new order from a book you already have in your catalog, a suggestion from a patron or an empty form.
    • TIP: For instructions on ordering from a suggestion see 'Managing Suggestions' in this manual
  • To order from an existing record, search for the record in your system
  • To order a new book, click 'From a new (empty) record'
  • Fill in the fields for your order.
    • TIP: After entering a quantity and vendor price, the other fields will be calculated automatically.
    • Actual Cost will be used to subtract from your budgets (whereas the other fees will be used when calculating replacement costs)
  • After clicking 'Save' you will be brought to an order summary
  • If you are done adding to that order, click the 'Close this basket' link
    • TIP: This is not necessary, you will still be able to mark items received without closing a basket.  Closing a basket is good practice for keeping track of late orders which is discussed in this manual.

 

Receiving Orders

After your orders have been entered into the system and sent off to the vendors, you will need to mark them received.

TIP: To receive serials see the 'Receiving Serials' part of this manual.

  • To receive an order click 'Receive Shipment'
  • Enter the invoice number is 'Vendor invoice' and the shipment date in 'Shipment date'
  • Click 'Save'
  • You'll need to choose which items arrived in this shipment
  • Either search by title or ISBN or click 'Receive order' next to the item you'd like to mark as received
  • Be sure to update the 'Quantity received' as well as any other information you need for your records
    • TIP: To add another received item, click the '+' (plus) icon at the bottom left.  If you add too many click the '-' (minus) to the right of the '+' (plus)
  • Click 'Save'
  • You will now see the received items in the summary of 'Items in this shipment'
  • When you've added all of the items to your shipment you can browse away from the page.
    • To make edits to your shipment return to Acquisitions and search for the vendor in question.
      • Click the 'Receive Parcel' button
      • Your previous orders will be searchable and editable from here
-
- + +

Ordering

+ +

+ Receiving OrdersAfter your orders have been entered into the system and sent off to the vendors, you will need to mark them received. + +TIP: To receive serials see the 'Receiving Serials' part of this manual.

+ + + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/parcel.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/parcel.tmpl index 2d5b31a8fb..59877f9547 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/parcel.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/acqui/parcel.tmpl @@ -1,5 +1,30 @@ -
-

Receiving Orders

After your orders have been entered into the system and sent off to the vendors, you will need to mark them received.

TIP: To receive serials see the 'Receiving Serials' part of this manual.

  • To receive an order click 'Receive Shipment'
  • Enter the invoice number is 'Vendor invoice' and the shipment date in 'Shipment date'
  • Click 'Save'
  • You'll need to choose which items arrived in this shipment
  • Either search by title or ISBN or click 'Receive order' next to the item you'd like to mark as received
  • Be sure to update the 'Quantity received' as well as any other information you need for your records
    • TIP: To add another received item, click the '+' (plus) icon at the bottom left.  If you add too many click the '-' (minus) to the right of the '+' (plus)
  • Click 'Save'
  • You will now see the received items in the summary of 'Items in this shipment'
  • When you've added all of the items to your shipment you can browse away from the page.
    • To make edits to your shipment return to Acquisitions and search for the vendor in question.
      • Click the 'Receive Parcel' button
      • Your previous orders will be searchable and editable from here
-
- + +

Receiving Orders

+

After your orders have been entered into the system and sent off to the vendors, you will need to mark them received. +TIP: To receive serials see the 'Receiving Serials' part of this manual.

+ + + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/aqbudget.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/aqbudget.tmpl index a81dd49e71..5288c69c57 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/aqbudget.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/aqbudget.tmpl @@ -1,5 +1,33 @@ -
-

Funds & Budgets

TIP: Funds may be ignored if you are setting your Global System Preferences for 'Acquisitions' to "simple" acquisitions: the funds are only useful when using "normal" acquisitions.


"Funds" are accounts that you establish to track your expenditures for library materials. They may be used for any kind of material and should match the lines in your materials budget. For instance, if your library establishes a budget line for books, another for audiovisual materials, a third line for magazines, and a fourth budget line for electronic databases, then you would have four funds.

TIP: The first time you access this page, you will be asked to add your first fund -- thereafter you will have the option of editing and deleting funds.

Adding a Fund

  • Click 'New Fund'
  • Each fund has a unique fund code, limited to a maximum of five characters, which identifies it
  • Enter in a fund name to provide more information for staff members about the fund
  • Funds can be library/branch specific if needed, but this is an optional field
  • Once a fund is created a budget can then be applied to it
  • Click 'Add budget' next to the fund you want to edit
  • IMPORTANT: Your dates will not save correctly unless you have set your date format ('dateformat') in the Global System Preferences under 'I18N/L10N' -- DO THIS BEFORE setting budgets
  • Once budgets have been added you can see/search them all by clicking 'Show all budgets' under the list of funds
  • Budget information will also be accessible via the 'Acquisitions' module
  • From this module you can easily see what has been spent from each budget





-
- + +

Funds & Budgets

+ +

TIP: Funds may be ignored if you are setting your Global System Preferences for 'Acquisitions' to "simple" acquisitions: the funds are only useful when using "normal" acquisitions.

+ +

"Funds" are accounts that you establish to track your expenditures for library materials. They may be used for any kind of material and should match the lines in your materials budget. For instance, if your library establishes a budget line for books, another for audiovisual materials, a third line for magazines, and a fourth budget line for electronic databases, then you would have four funds.

+ +

+TIP: The first time you access this page, you will be asked to add your first fund -- thereafter you will have the option of editing and deleting funds.

+ +

Adding a Fund

+ + + + + + + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/matching-rules.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/matching-rules.tmpl index 1b0eb3fc45..693119ef60 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/matching-rules.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/matching-rules.tmpl @@ -1,5 +1,13 @@ -
-

Record Matching Rules

IMPORTANT: This is an advanced feature and should not be altered without knowing how it will effect data migration.

Use this tool to create rules to apply during the data migration process. It will prevent duplicates from coming into the system when importing MARC records.

An import rule or matching rule consists of one or more 'match points' and zero or more 'match checks'. Each match point specifies a 'search index' and a MARC 'tag', 'subfield', or 'length' (fixed field position) when a record is imported. For each match point, a string is constructed from the tag specified in the match point and the related index is searched.

The set of matching records are assigned a score (the value of which is determined by the match point rule). Then, the rest of the match points are considered and the scores of each set of matches is added up. The set of matching records whose total score is over a threshold value defined in the matching rule are candidate matches.

Match checks are applied for all candidate matches. Each match check specifies a tag in the incoming record and a tag in the possible matching record. The values must be the same for a match to be considered good (e.g., doing a match check on title, or publication date) -
- + +

Record Matching Rules

+

+IMPORTANT: This is an advanced feature and should not be altered without knowing how it will effect data migration.

+ +

Use this tool to create rules to apply during the data migration process. It will prevent duplicates from coming into the system when importing MARC records. An import rule or matching rule consists of one or more 'match points' and zero or more 'match checks'. Each match point specifies a 'search index' and a MARC 'tag', 'subfield', or 'length' (fixed field position) when a record is imported. For each match point, a string is constructed from the tag specified in the match point and the related index is searched.

+ +

The set of matching records are assigned a score (the value of which is determined by the match point rule). Then, the rest of the match points are considered and the scores of each set of matches is added up. The set of matching records whose total score is over a threshold value defined in the matching rule are candidate matches.

+ +

Match checks are applied for all candidate matches. Each match check specifies a tag in the incoming record and a tag in the possible matching record. The values must be the same for a match to be considered good (e.g., doing a match check on title, or publication date).

+ + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/authorities/authorities.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/authorities/authorities.tmpl index 1357112d84..4374cbf29f 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/authorities/authorities.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/authorities/authorities.tmpl @@ -1,5 +1,62 @@ - -
-Adding an Authority Record

IMPORTANT: To add authority records in bulk, contact your system administrator and tell them that they can use this script: misc/migration_tools/bulkauthimport.pl

  • Click 'New Authority'
  • Choose the type of authority record you would like to add to your system
    • Tip: To alter this list you need to make changes to your system parameters
      • Get there: Home > Administration > MARC Authorities framework
  • Continue with cataloging your authorities

Altering Authorities Records

  • Search for the Authority
  • Click on the summary for the record you want to edit
  • Click 'Edit' at the top left

Adding Authorities to a record

There are three ways to add authorities to a record:
  • query authority file when adding/editing a record (during cataloging)
  • enable Koha to auto-detect authority records when a record is saved
  • library maintains its own authority records based on the dataset

Here are details on these options:

Query authority file when adding/editing a record (during cataloging)

The Bibliographic editor allows queries to the authority file at the add/edit stage of a record, so that cataloging staff can create the links between a bibliographic and authority record when they are cataloging.


If you wish to provide access to authority records for a given subfield -- MARC 21's 700a subfield, for instance, to make sure an author's name is available in an added entry in its approved form -- you will need to create a subfield "9" for that tag (e.g. tag 700, subfield 9).  This is done by adding the subfield via the 'Authority types' administration module.

  • Get there: More > Administration > Authority types
    • TIP: Make sure this subfield is managed in the same tab as the other managed subfields for this tag, and then click the "hidden" checkbox so it will not be displayed with the rest of the record.

 

Koha uses subfield 9 to store the link between a bibliographic record and an authority record.

 

When the catalogers are adding a record, they will see three dots (...) after the textbox of the 700a subfield (or any field you have chosen to add a subfield 9 to). Clicking on these dots will open a pop-up window allowing the cataloger to search your authority records for a standardized version of the author's name. If the desired name is found in your authority records, it can be automatically copied into the 700a subfield. (If the desired name is not found, the cataloger can enter the name manually.)

 


Auto-detection of authority records when a record is saved

Alternatively, the library can opt into the auto-detection of authority records when a record is saved.  This is done by turning the 'BiblioAddsAuthorities' system preference on.
  • Get there: More > Administration > Global preferences > Authorities > BiblioAddsAuthorities

Library-maintained authority records

A third option allows libraries to maintain their own authority records based on the dataset; many libraries prefer not to enable that option because it creates 'ghost' authority records in the system. It's up to the library (or group) which options to enable, or disable.

-
- + +

Adding an Authority Record

+ +

IMPORTANT: To add authority records in bulk, contact your system administrator and tell them that they can use this script: + misc/migration_tools/bulkauthimport.pl

+ +

Altering Authorities Records

+ +

Adding Authorities to a record

+

There are three ways to add authorities to a record:

+ +

Here are details on these options:

+

Query authority file when adding/editing a record (during cataloging)

+ +

The Bibliographic editor allows queries to the authority file at the add/edit stage of a record, so that cataloging staff can create the links between a bibliographic and authority record when they are cataloging.

+

If you wish to provide access to authority records for a given subfield -- MARC 21's 700a subfield, for instance, to make sure an author's name is available in an added entry in its approved form -- you will need to create a subfield "9" for that tag (e.g. tag 700, subfield 9).  This is done by adding the subfield via the 'Authority types' administration module.

+ +

Koha uses subfield 9 to store the link between a bibliographic record and an authority record.

+ +

When the catalogers are adding a record, they will see three dots (...) after the textbox of the 700a subfield (or any field you have chosen to add a subfield 9 to). Clicking on these dots will open a pop-up window allowing the cataloger to search your authority records for a standardized version of the author's name. If the desired name is found in your authority records, it can be automatically copied into the 700a subfield. (If the desired name is not found, the cataloger can enter the name manually.)

+ +

Auto-detection of authority records when a record is saved

+ +

Alternatively, the library can opt into the auto-detection of authority records when a record is saved.  This is done by turning the 'BiblioAddsAuthorities' system preference on.

+ + +

Library-maintained authority records

+ +

A third option allows libraries to maintain their own authority records based on the dataset; many libraries prefer not to enable that option because it creates 'ghost' authority records in the system. It's up to the library (or group) which options to enable, or disable.

+ + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/members/member-flags.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/members/member-flags.tmpl index aaa5b6ff95..f0c6eff3cf 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/members/member-flags.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/members/member-flags.tmpl @@ -1,3 +1,106 @@ - -
Setting Patron Permissions

Patron permissions are used to define the rights of staff members when in the intranet/staff client.

  • To alter patron permissions, click on Patrons on the main menu at the top of the screen.
  • Search or browse for the patron you'd like to edit
  • Click on the patron's name from the results
  • Click the 'More' button on the top right of the patron profile and choose 'Set Permissions'
  • Choose the permissions you'd like this patron to have
  • You can pick as many permissions as you'd like for each staff member
    • TIP: If a staff member is set to 'superlibrarian' they have access to all functions and do not need any other permissions checked
  • To give staff members more granular permissions, you can turn on the GranularPermissions system preference
    • Get there: More > Administration > General preferences > Admin > GranularPermissions
    • If this setting is on the permissions menu will offer more granual permissions
    • This allows staff members access to specific tools
      • TIP: If this preference is turned OFF after being ON, the system reverts to the original behavior, although the specific permissions are retained.  This means if a staff member has been given granular permissions they will retain those even if this is turned OFF
 
What will each permission level do?

Depending on the permission certain menu items will be removed from the menus in Koha, preventing users from accessing them.

  • superlibrarian 
    • Access to all librarian functions
  • circulate
    • Ability for logged in user to check books out and back in
  • catalogue
    • Must be given to all staff members to allow them to log into the staff interface
    • This permission will allow staff members to search the catalog via the staff interface
  • parameters
    • Provides access to all admin links and preferences
  • borrowers
    • Add or modify patrons (with the exception of setting permissions)
  • permissions
    • Ability to set patron permissions 
  • reserveforothers
    • Place holds on books for patrons via the staff interface
  • borrow
    • Borrow books from the library with this staff account
  • editcatalogue Modify bibliogra
    • Provides cataloging permissions such as altering and adding bibliographic and holdings data)
  • updatecharges
    • Handle fines and charges for patrons (including paying, adding credits, and adding invoices)
  • acquisition
    • Access to acquisition and patron purchase suggestions management
  • management
    • Deprecated - no longer in use
  • tools
    • Use tools (export, import, barcodes)
    • With GranularPermissions on this section will be expanded to allow access only to specific tools
      • Get there: More > Administration > General preferences > Admin > GranularPermissions
  • editauthorities
    • Allow staff member to edit authorities
  • serials
    • Allow staff member to manage serials subscriptions and claims
  • reports
    • Allow staff member to access to the reports module
  • staffaccess
    • Provides the ability to modify login / permissions for staff users
 
- + +

Setting Patron Permissions

+

Patron permissions are used to define the rights of staff members when in the intranet/staff client.

+ + +

What will each permission level do?

+ +

Depending on the permission certain menu items will be removed from the menus in Koha, preventing users from accessing them.

+ \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tags/review.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/tags/review.tmpl index 368f73a251..cf52a9625f 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tags/review.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/tags/review.tmpl @@ -1,5 +1,42 @@ -
-

Tags

This tool gives librarians the option to moderate patron added tags.  This moderation page will show up regardless of the system preference settings related to tagging.

IMPORTANT: This feature is still experimental

IMPORTANT: Tagging will make use of AJAX capability in JavaScript-enabled browsers

  • Go to the 'Tools' module (usually under 'More' in your Global Nav)
  • Choose 'Tags'
  • From this menu you can approve or reject tags
    • TIP: Note that you are approving the terms used, but not the title the terms are applied to, moderation is for checking that terms are approriate for your library
  • The 'Weight' refers to the number of times the tag has been used within the system
  • To approve a tag, click 'approve' in that line or check the box and click 'approve' at the top
    • Approving a tag adds it to your whitelist
  • To reject a tag, click 'reject' in that line or check the box and click 'reject' at the top
    • Rejecting a tag adds it to your blacklist
  • The terms summary in the top left will allow you to filter your results by tag status
  • The status of tags can always be edited by clicking on one of these filters and changing the status
  • You can test terms against you whitelist or blacklist by using the test tool
  • If a term has been rejected the test will tell you that that term is prohibited.  If it has been approved it will show that that word is allowed.
    • TIP: The blacklist is already populated with some key terms depending on the dictionary you're using
  • When a patron adds a tag to an item that a librarian has already rejected, it will automatically be rejected.

Will I be notified when new tags are added?

This feature is yet to be developed, but is in the works. -
- + +

Tags

+ +

This tool gives librarians the option to moderate patron added tags.  This moderation page will show up regardless of the system preference settings related to tagging.

+ +

IMPORTANT: This feature is still experimental

+ +

IMPORTANT: Tagging will make use of AJAX capability in JavaScript-enabled browsers

+ +

Will I be notified when new tags are added?

+

This feature is yet to be developed, but is in the works.

+ + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/export.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/export.tmpl index cfda8d9dcd..bfa7b6a53f 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/export.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/export.tmpl @@ -1,5 +1,22 @@ - -
-MARC Export

This tool allows librarians to export both bibliographic records and holdings in either MARC format or MARCXML.
TIP: The only fields above that are required are the two under 'Output format'.

  • If you'd like a limited number of records, enter in a filter for biblio numbers or item call numbers.
  • If you'd like to only import items of one type or from one library, you can choose those from the pull downs
  • By default all items are exported unless the 'Don't export items' box is checked.
  • You can also choose to not export specific MARC fields
    • TIP: Separate these fields by a space.
  • Click 'Export' and follow your browser's instructions for saving the file
-
- + + +

MARC Export

+

This tool allows librarians to export both bibliographic records and holdings in either MARC format or MARCXML.

+ +

+ +TIP: The only fields above that are required are the two under 'Output format'.

+ + + \ No newline at end of file diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/manage-marc-import.tmpl b/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/manage-marc-import.tmpl index b35069d68a..f6cab947c9 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/manage-marc-import.tmpl +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/tools/manage-marc-import.tmpl @@ -1,5 +1,15 @@ -
-Manage Staged MARC Records

After records have been imported, you can review the records before finalizing the import.

  • By default the records are matched using the field you specified when importing the data
    • You can change this before completing the import by choosing a new option from the pull down.
  • After reviewing the records, click 'Complete import'
  • After your import is complete, you will be given a summary of the import and the ability to undo your actions

-
- + +

Manage Staged MARC Records

+ +

After records have been imported, you can review the records before finalizing the import.

+ + + \ No newline at end of file -- 2.39.5