From 3ba41e17c0e97a89c4d1b5977bc885ed5ab30dd9 Mon Sep 17 00:00:00 2001
From: Dan Scott <dscott@laurentian.ca>
Date: Sun, 9 Dec 2012 00:30:29 -0500
Subject: [PATCH] Add acquisitions setup chapter

Another product of the Evergreen in Action documentation sprint!

Signed-off-by: Dan Scott <dscott@laurentian.ca>
---
 docs/admin_initial_setup/ordering_materials.txt | 238 ++++++++++++++++++++++++
 docs/media/order_record_loading.png             | Bin 0 -> 8810 bytes
 2 files changed, 238 insertions(+)
 create mode 100644 docs/admin_initial_setup/ordering_materials.txt
 create mode 100644 docs/media/order_record_loading.png

diff --git a/docs/admin_initial_setup/ordering_materials.txt b/docs/admin_initial_setup/ordering_materials.txt
new file mode 100644
index 0000000000..e13d57d26f
--- /dev/null
+++ b/docs/admin_initial_setup/ordering_materials.txt
@@ -0,0 +1,238 @@
+Ordering materials
+==================
+
+Acquisitions allows you to order materials, track the expenditure of your
+collections funds, track invoices and set up policies for manual claiming. In
+this chapter, we're going to be describing how to use the most essential
+functions of acquisitions in the Evergreen system.
+
+When should libraries use acquisitions?
+---------------------------------------
+* When you want to track spending of your collections budget.
+* When you want to use Evergreen to place orders electronically with your
+  vendors.
+* When you want to import large batches of records to quickly get your on-order
+  titles into the system.
+
+If your library simply wants to add on-order copies to the catalog so that
+patrons can view and place holds on titles that have not yet arrived,
+acquisitions may be more than you need. Adding those on-order records via
+cataloging is a simpler option that works well for this use case.
+
+Below are the basic administrative settings to be configured to get started
+with acquisitions. At a minimum, a library must configure *Funding Sources*,
+*Funds*, and *Providers* to use acquisitions.
+
+Managing Funds
+--------------
+
+Funding Sources (Required)
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+Funding sources allow you to specify the sources that contribute monies to your
+fund(s). You can create as few or as many funding sources as you need. These
+can be used to track exact amounts for accounts in your general ledger.
+
+Example funding sources might be:
+
+* A municipal allocation for your materials budget;
+* A trust fund used for collections;
+* A revolving account that is used to replace lost materials;
+* Grant funds to be used for collections.
+
+Funding sources are not tied to fiscal or calendar years, so you can continue
+to add money to the same funding source over multiple years, e.g. County
+Funding. Alternatively, you can name funding sources by year, e.g. County
+Funding 2010 and County Funding 2011, and apply credits each year to the
+matching source.
+
+. To create a funding source, select *Admin > Server Administration >
+  Acquisitions > Funding Source*. Click the *New Funding Source* button. Give
+  the funding source a name, an owning library, and code. You should also
+  identify the type of currency that is used for the fund.
+. You must add money to the funding source before you can use it. Click the
+  hyperlinked name of the funding source and then click the *Apply Credit*
+  button. Add the amount of funds you need to add. The *Note* field is optional.
+
+Funds (Required)
+~~~~~~~~~~~~~~~~
+Funds allow you to allocate credits toward specific purchases. They typically
+are used to track spending and purchases for specific collections. Some
+libraries may choose to define very broad funds for their collections (e.g.
+children's materials, adult materials) while others may choose to define more
+specific funds (e.g. adult non-fiction DVD's for BR1).
+
+If your library does not wish to track fund accounting, you can create one
+large generic fund and use that fund for all of your purchases.
+
+. To create a fund, select *Admin > Server Administration > Acquisitions >
+  Funds*. Click the *New Fund* button. Give the fund a name and code.
+. The *Year* can either be the fiscal or calendar year for the fund.
+. If you are a multi-branch library that will be ordering titles for multiple
+  branches, you should select the system as the owning *Org Unit*, even if this
+  fund will only be used for collections at a specific branch. If you are a
+  one-branch library or if your branches do their own ordering, you can select
+  the branch as the owning *Org Unit*.
+. Select the *Currency Type* that will be used for this fund.
+. You must select the *Active* checkbox to use the fund.
+. Enter a *Balance Stop Percent*. The balance stop percent prevents you from
+  making purchases when only a specified amount of the fund remains. For example,
+  if you want to spend 95 percent of your funds, leaving a five percent balance
+  in the fund, then you would enter 95 in the field. When the fund reaches its
+  balance stop percent, it will appear in red when you apply funds to copies.
+. Enter a *Balance Warning Percent*. The balance warning percent gives you a
+  warning that the fund is low. You can specify any percent. For example, if you
+  want to spend 90 percent of your funds and be warned when the fund has only 10
+  percent of its balance remaining, then enter 90 in the field. When the fund
+  reaches its balance warning percent, it will appear in yellow when you apply
+  funds to copies.
+. Check the *Propagate* box to propagate funds. When you propagate a fund, the
+  system will create a new fund for the following fiscal year with the same
+  parameters as your current fund. All of the settings transfer except for the
+  year and the amount of money in the fund. Propagation occurs during the fiscal
+  year close-out operation.
+. Check the *Rollover* box if you want to roll over remaining encumbrances and
+  funds into the same fund next year. If you need the ability to roll over
+  encumbrances without rolling over funds, go to the *Library Settings Editor*
+  (*Admin > Local Administration > Library Settings Editor*) and set *Allow
+  funds to be rolled over without bringing the money along* to *True*.
+. You must add money to the fund before you can begin using it. Click the
+  hyperlinked name of the fund. Click the *Create Allocation button*. Select a
+  *Funding Source* from which the allocation will be drawn and then enter an
+  amount for the allocation. The *Note* field is optional.
+
+Fund Tags (Optional)
+~~~~~~~~~~~~~~~~~~~~
+You can apply tags to funds so that you can group funds for easy reporting. For
+example, you have three funds for children’s materials: Children's Board Books,
+Children's DVDs, and Children's CDs. Assign a fund tag of children's to each
+fund. When you need to report on the amount that has been spent on all
+children's materials, you can run a report on the fund tag to find total
+expenditures on children's materials rather than reporting on each individual
+fund.
+
+. To create a fund tag, select *Admin > Server Administration > Acquisitions >
+  Fund Tags*. Click the the *New Fund Tag* button. Select a owning library and
+  add the name for the fund tag.
+. To apply a fund tag to a fund, select *Admin > Server Administration >
+  Acquisitions > Funds*. Click on the hyperlinked name for the fund. Click the
+  *Tags* tab and then click the *Add Tag* button. Select the tag from the
+  dropdown menu.
+
+Ordering
+--------
+
+Providers (Required)
+~~~~~~~~~~~~~~~~~~~~
+Providers are the vendors from whom you order titles.
+
+. To add a provider record,  select *Admin > Server Administration >
+  Acquisitions > Providers*.
+. Enter information about the provider. At a minimum, you need to add a
+  *Provider Name*, *Code*, *Owner*, and *Currency*. You also need to select the
+  *Active* checkbox to use the provider.
+
+Distribution Formulas (Optional)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+If you are ordering for a multi-branch library system, distribution formulas
+are a useful way to specify the number of copies that should be distributed to
+specific branches and copy locations.
+
+. To create a distribution formula, select *Admin > Server Administration >
+  Acquisitions > Distribution Formulas*. Click the *New Formula* button. Enter
+  the formula name and select the owning library. Ignore the *Skip Count* field.
+. Click *New Entry*. Select an Owning Library from the drop down menu. This
+  indicates the branch that will receive the items.
+. Select a Shelving Location from the drop down menu.
+. In the Item Count field, enter the number of items that should be distributed
+  to that branch and copy location. You can enter the number or use the arrows on
+  the right side of the field.
+. Keep adding entries until the distribution formula is complete.
+
+Helpful acquisitions Library Settings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+There are several acquisitions Library Settings available that will help with
+acquisitions workflow. These settings can be found at *Admin > Local
+Administration > Library Settings Editor*.
+
+* Default circulation modifier - Automatically applies a default circulation
+  modifier to all of your acquisitions copies. Useful if you use a specific
+  circulation modifier for on-order copies.
+* Default copy location - Automatically applies a default copy location (e.g.
+  On Order) to acquisitions copies.
+* Temporary barcode prefix - Applies a unique prefix to the barcode that is
+  automatically generated during the acquisitions process.
+* Temporary call number prefix - Applies a unique prefix to the start of the
+  call number that is automatically generated during the acquisitions process.
+
+Preparing for order record loading
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+If your library is planning to upload order records in a batch, you need to add
+some information to your provider records so that Evergreen knows how to map
+the copy data contained in the order record.
+
+. Retrieve the record for the provider that has supplied the order records by
+  selecting *Admin > Server Administration > Acquisitions > Providers*. Click on
+  the hyperlinked Provider name.
+. In the top frame, add the MARC tag that contains your holdings data in the
+  *Holdings Tag* field (this tag can also be entered at the time you create the
+  provider record.)
+. To map the tag's subfields to the appropriate copy data, click the *Holding
+  Subfield* tab.  Click the *New Holding Subfield* button and select the copy
+  data that you are mapping. Add the subfield that contains that data and click
+  *Save*.
++
+image::media/order_record_loading.png[]
++
+. If your vendor is sending other data in a MARC tag that needs to be mapped to
+a field in acquisitions, you can do so by clicking the Attribute Definitions
+tab. As an example, if you need to import the PO Name, you could set up an
+attribute definition by adding an XPath similar to:
++
+------------------------------------------------------------------------------
+code => purchase_order
+xpath => //*[@tag="962"]/*[@code="p"]
+Is Identifier => false
+------------------------------------------------------------------------------
++
+where 962 is the holdings tag and p is the subfield that contains the PO Name.
+
+Preparing to send electronic orders from Evergreen
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+If your library wants to transmit electronic order information to a vendor, you
+will need to configure your server to use EDI. You need to install the EDI
+translator and EDI scripts on your server by following the instructions in the
+Evergreen 2.3 documentation.
+(http://docs.evergreen-ils.org/2.3/_installation.html)
+
+Configure your provider's EDI information by selecting *Admin > Server
+Administration > Acquisitions > EDI Accounts*. Give the account a name in the
+*Label* box.
+
+. *Host* is the vendor-assigned FTP/SFTP/SSH hostname.
+. *Username* is the vendor-assigned FTP/SFTP/SSH username.
+. *Password* is the vendor-assigned FTP/SFTP/SSH password.
+. *Account* is the vendor-assigned account number associated with your
+  organization.
+. *Owner* is the organizational unit who owns the EDI account
+. *Last Activity* is the date of last activity for the account
+. *Provider* is a link to the codes for the Provider record.
+. *Path* is the path on the vendor’s server where Evergreen will send its
+  outgoing .epo files.
+. *Incoming Directory* is the path on the vendor’s server where incoming .epo
+  files are stored.
+. *Vendor Account Number* is the Vendor assigned account number.
+. *Vendor Assigned Code* is usually a sub-account designation. It can be used
+  with or without the Vendor Account Number.
+
+You now need to add this *EDI Account* and the *SAN* code to the provider's record.
+
+. Select *Admin > Server Administration > Acquisitions > Providers*.
+. Click the hyperlinked Provider name.
+. Select the account you just created in the *EDI Default* field.
+. Add the vendor-provided SAN code to the *SAN* field.
+
+The last step is to add your library's SAN code to Evergreen.
+
+. Select *Admin > Server Administration > Organizational Units*.
+. Select your library from the organizational hierarchy in the left pane.
+. Click the *Addresses* tab and add your library's SAN code to the *SAN* field.
diff --git a/docs/media/order_record_loading.png b/docs/media/order_record_loading.png
new file mode 100644
index 0000000000000000000000000000000000000000..160af6a5fd700ed90a69dc55bc34d19c2db0e15c
GIT binary patch
literal 8810
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
HIQYK+=yH66

literal 0
HcmV?d00001

-- 
2.11.0