[open-ils-commits] [GIT] Evergreen ILS branch master updated. 838ff8b5a5d9fc8e482fef6c3d3d55130a3f452d
Evergreen Git
git at git.evergreen-ils.org
Thu Mar 8 13:10:01 EST 2012
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Evergreen ILS".
The branch, master has been updated
via 838ff8b5a5d9fc8e482fef6c3d3d55130a3f452d (commit)
from c694929e4ba58ecf13e5903624ec6c784c37f439 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 838ff8b5a5d9fc8e482fef6c3d3d55130a3f452d
Author: Dan Scott <dscott at laurentian.ca>
Date: Thu Mar 8 11:33:20 2012 -0500
Remove Z39.50 server definitions from opensrf.xml.example
Point to the Release Notes for a description of how to map old entries
to the database tables. Maybe later someone enterprising will write up a
script that parses the XML and generates reasonable default entries in
the database tables.
Signed-off-by: Dan Scott <dscott at laurentian.ca>
Signed-off-by: Ben Shum <bshum at biblio.org>
diff --git a/Open-ILS/examples/opensrf.xml.example b/Open-ILS/examples/opensrf.xml.example
index eabd6fc..325b4c2 100644
--- a/Open-ILS/examples/opensrf.xml.example
+++ b/Open-ILS/examples/opensrf.xml.example
@@ -195,89 +195,11 @@ vim:et:ts=4:sw=4:
</allowed_services>
</xml-rpc>
-
- <z3950>
- <default>biblios</default>
- <services>
- <biblios>
- <!-- biblios does not require username/password -->
- <name>‡biblios.net</name>
- <host>z3950.biblios.net</host>
- <port>210</port>
- <db>bibliographic</db>
- <!-- fetch the full record with no holdings. FI is the most common choice -->
- <record_format>FI</record_format>
-
- <!-- Record transmission format from the server. Supported -->
- <!-- formats include usmarc and xml (for marcxml). -->
- <transmission_format>usmarc</transmission_format>
-
- <attrs>
- <tcn><code>12</code><format>1</format></tcn>
- <isbn><code>7</code><format>6</format></isbn>
- <lccn><code>9</code><format>1</format></lccn>
- <author><code>1003</code><format>6</format></author>
- <title><code>4</code><format>6</format></title>
- <issn><code>8</code><format>1</format></issn>
- <publisher><code>1018</code><format>6</format></publisher>
- <pubdate><code>31</code><format>1</format></pubdate>
- <item_type><code>1001</code><format>1</format></item_type>
- </attrs>
- </biblios>
-
- <loc>
- <!-- LoC does not require username/password -->
- <name>loc</name>
- <host>z3950.loc.gov</host>
- <port>7090</port>
- <db>Voyager</db>
- <!-- fetch the full record with no holdings. FI is the most common choice -->
- <record_format>FI</record_format>
-
- <!-- Record transmission format from the server. Supported -->
- <!-- formats include usmarc and xml (for marcxml). -->
- <transmission_format>usmarc</transmission_format>
-
- <attrs>
- <tcn><code>12</code><format>1</format></tcn>
- <isbn><code>7</code><format>6</format></isbn>
- <lccn><code>9</code><format>1</format></lccn>
- <author><code>1003</code><format>6</format></author>
- <title><code>4</code><format>6</format></title>
- <issn><code>8</code><format>1</format></issn>
- <publisher><code>1018</code><format>6</format></publisher>
- <pubdate><code>31</code><format>1</format></pubdate>
- <item_type><code>1001</code><format>1</format></item_type>
- </attrs>
- </loc>
-
- <oclc>
- <!-- Z3950 settings for OCLC. Note that OCLC requires username/password -->
- <host>zcat.oclc.org</host>
- <port>210</port>
- <db>OLUCWorldCat</db>
- <attrs>
- <!--
- These are directly from the Bib-1 Attribute Set
- http://www.loc.gov/z3950/agency/defns/bib1.html
- <code> is the "use attribute", <format> is the "structure attribute"
- This just puts some friendly names on the data.
- -->
- <tcn><code>12</code><format>1</format></tcn>
- <isbn><code>7</code><format>6</format></isbn>
- <lccn><code>9</code><format>1</format></lccn>
- <author><code>1003</code><format>6</format></author>
- <title><code>4</code><format>6</format></title>
- <issn><code>8</code><format>1</format></issn>
- <publisher><code>1018</code><format>6</format></publisher>
- <pubdate><code>31</code><format>1</format></pubdate>
- <item_type><code>1001</code><format>1</format></item_type>
- </attrs>
- </oclc>
-
- </services>
- </z3950>
-
+ <!--
+ Once upon a time, Z39.50 servers were defined here. As of Evergreen 2.2,
+ they are now defined in the database. See the Release Notes for
+ instructions on mapping the old XML entries to database tables.
+ -->
<added_content>
<!-- load the OpenLibrary added content module -->
diff --git a/docs/RELEASE_NOTES_2_2.txt b/docs/RELEASE_NOTES_2_2.txt
index 3ad4ace..036eef9 100644
--- a/docs/RELEASE_NOTES_2_2.txt
+++ b/docs/RELEASE_NOTES_2_2.txt
@@ -35,6 +35,41 @@ UPDATE biblio.record_entry
;
------------------------------------------------------------------------------
+Z39.50 server definitions
+~~~~~~~~~~~~~~~~~~~~~~~~~
+Z39.50 server target definitions have been removed from the sample
+`opensrf.xml.example` file. To migrate existing settings from your
+`opensrf.xml` configuration file to the database, peform the
+following steps:
+
+ 1. First, set up your custom Z39.50 sources in the database. For
+ each entry in `z3950/services`, map the following XML paths to the
+ corresponding `config.z3950_source` table column as follows:
++
+ ** `z3950/services/<entry>` = name
+ ** `//<entry>/name` = label
+ ** `//<entry>/host` = host
+ ** `//<entry>/port` = port
+ ** `//<entry>/db` = db
+ ** `//<entry>/record_format` = record_format
+ ** `//<entry>/transmission_format` = transmission_format
++
+ 2. Then, for each attribute defined in the `<attrs>` element for
+ a given service, map the following XML paths to the corresponding
+ `config.z3950_attr` table column as follows:
++
+ ** `z3950/services/<entry>` = source
+ ** `//<entry>/attrs/<attr>` = name
+ ** `//<entry>/attrs/<attr>/code` = code
+ ** `//<entry>/attrs/<attr>/format` = format
++
+ 3. After adding the new Z39.50 sources and corresponding attributes,
+ you will need to log out of the staff client and log back into the
+ staff client to retrieve the new entry values. If a given Z39.50
+ server does not work for a given attribute, pay attention to the
+ `truncation` column for the attribute.
+
+
New features
------------
-----------------------------------------------------------------------
Summary of changes:
Open-ILS/examples/opensrf.xml.example | 88 ++-------------------------------
docs/RELEASE_NOTES_2_2.txt | 35 +++++++++++++
2 files changed, 40 insertions(+), 83 deletions(-)
hooks/post-receive
--
Evergreen ILS
More information about the open-ils-commits
mailing list