Bug 6681: (qa followup) document the existence of the sample files

As requestedby people testing the patch, I add references to the new
xslt files on the Z39.50/SRU servers help.

Example usages are also provided.

Test:
- Apply the patch
- Go to the help page on the 'Z39.50/SRU Servers' page
=> SUCCESS: Notice there's a section documenting XSLT file(s) usage
            and provides some examples that cover the introduced files.
- Sign off

Thanks
Tomas

Sponsored-by: Universidad Nacional de Cordoba
Signed-off-by: Frederic Demians <f.demians@tamil.fr>
  Help page does shed some light to the XSLT usage. Enough to my taste.

Signed-off-by: Katrin Fischer <katrin.fischer.83@web.de>
Signed-off-by: Tomas Cohen Arazi <tomascohen@gmail.com>

diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/z3950servers.tt b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/z3950servers.tt
index fd27234..7464b8b 100644 (file)
--- a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/z3950servers.tt
+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/z3950servers.tt
@@ -190,7 +190,7 @@
         <li>
         <label for="add_xslt">XSLT File(s) for transforming results: </label>
         <input type="text" name="add_xslt" id="add_xslt" size="100" value="[% server.add_xslt %]"/>
-        <span>( Separate files by commas.)</span>
+        <span>(comma-separated filenames)</span>
         </li>
 
         </ol>

diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt
index 43ffe27..f84abec 100644 (file)
--- a/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt
+++ b/koha-tmpl/intranet-tmpl/prog/en/modules/help/admin/z3950servers.tt
@@ -25,9 +25,33 @@
        <li>'Record type' lets you define if this is a bibliographic or an authority target.</li>
     <li>'Additional SRU options': You can enter additional options of the external server here, like sru_version=1.1 or schema=marc21, etc. Note that these options are server dependent.</li>
     <li>'SRU Search field mapping': Click on Modify to add or update the mapping from the available fields on the Koha search form to the specific server dependent index names. For instance, a SRU server could use 'cql.anywhere' for the Any field on the Koha form. If you do not enter an index name for a specific search field, the whole record will be searched.</li>
-    <li>'XSLT file(s)': You can enter here one or more XSLT file names that you want to apply on the search results.</li>
+    <li>'XSLT file(s)': You can enter here one or more (comma-separated) XSLT file names that you want to apply on the search results.</li>
 </ul>
 
+<h2>Using XSLT file(s) to transform the imported records</h2>
+<p>When retrieving records from external targets you may wish to automate some
+   changes to those records. XSLT's allow you to do this. Koha ships with some
+   sample XSLT files ready for use.</p>
+<ul>
+    <li>Del952.xsl: Remove items (MARC21/NORMARC)</li>
+    <li>Del995.xsl: Remove items (UNIMARC)</li>
+    <li>Del9LinksExcept952.xsl: Remove $9 links. Skip item fields (MARC21/NORMARC).</li>
+    <li>Del9LinksExcept995.xsl: Remove $9 links. Skip item fields (UNIMARC).</li>
+</ul>
+
+<h3>Example</h3>
+<p>If you want to remove both holdings data and $9 links when importing, you can use:</p>
+<table>
+    <thead><tr>
+        <th>Syntax</th>
+        <th>XSLT configuration</th>
+    </tr></thead>
+    <tbody>
+        <tr><td>MARC21/NORMARC</td><td>Del9LinksExcept952.xsl, Del952.xsl</td></tr>
+        <tr><td>UNIMARC</td><td>Del9LinksExcept995.xsl, Del995.xsl</td></tr>
+    </tbody>
+</table>
+
 <h2>SRU example</h2>
 <p>If you want to enter the Library of Congress SRU server, you should at least use the following information. The full URL http://lx2.loc.gov:210/LCDB must be entered as follows:</p>
 <table>