Bug 16426: follow-up of bug 15840 - correctly manage userid while inserting patrons
[koha.git] / koha-tmpl / intranet-tmpl / prog / en / modules / tools / import_borrowers.tt
1 [% USE Koha %]
2 [% INCLUDE 'doc-head-open.inc' %]
3 <title>Koha &rsaquo; Tools &rsaquo; Import patrons [% IF ( uploadborrowers ) %]&rsaquo; Results[% END %]</title>
4 [% INCLUDE 'doc-head-close.inc' %]
5 <style type="text/css">
6     .yui-u fieldset.rows .widelabel { width: 12em; }
7     label.description { width: 20em; }
8     .line_error { width: 100%; }
9     code { background-color: yellow; }
10 </style>
11 <script type="text/javascript">
12 //<![CDATA[
13     $(document).ready(function() {
14         [%# Make date fields have the datepicker %]
15         $("#dateenrolled").addClass('datepicker');
16         $("#dateexpiry").addClass('datepicker');
17         $("#dateofbirth").addClass('datepicker');
18     });
19 </script>
20 </head>
21 <body id="tools_import_borrowers" class="tools">
22 [% INCLUDE 'header.inc' %]
23 [% INCLUDE 'patron-search.inc' %]
24 [% INCLUDE 'calendar.inc' %]
25
26 <div id="breadcrumbs"><a href="/cgi-bin/koha/mainpage.pl">Home</a> &rsaquo; <a href="/cgi-bin/koha/tools/tools-home.pl">Tools</a> &rsaquo; <a href="/cgi-bin/koha/tools/import_borrowers.pl">Import patrons</a>[% IF ( uploadborrowers ) %] &rsaquo; Results[% END %]</div>
27
28 <div id="doc3" class="yui-t2">
29  <div id="bd">
30   <div id="yui-main">
31    <div class="yui-b">
32     <div class="yui-g">
33      <div class="yui-u first">
34 <h1>Import patrons</h1>
35 [% IF ( uploadborrowers ) %]
36 <h5>Import results :</h5>
37 <ul>
38         <li>[% imported %] imported records [% IF ( lastimported ) %](last was [% lastimported %])[% END %]</li>
39         <li>[% overwritten %] overwritten [% IF ( lastoverwritten ) %](last was [% lastoverwritten %])[% END %]</li>
40         <li>[% alreadyindb %] not imported because already in borrowers table and overwrite disabled [% IF ( lastalreadyindb ) %](last was [% lastalreadyindb %])[% END %]</li>
41         <li>[% invalid %] not imported because they are not in the expected format [% IF ( lastinvalid ) %](last was [% lastinvalid %])[% END %]</li>
42         <li>[% total %] records parsed</li>
43         <li><a href="/cgi-bin/koha/tools/tools-home.pl">Back to Tools</a></li>
44 </ul>
45   [% IF ( FEEDBACK ) %]
46   <br /><br />
47     <div>
48     <h5>Feedback:</h5>
49     <ul class="feedback">
50     [% FOREACH FEEDBAC IN FEEDBACK %]
51     <li>
52         [% IF ( FEEDBAC.filename ) %]Parsing upload file <span class="filename">[% FEEDBAC.filename %]</span>
53         [% ELSIF ( FEEDBAC.backend ) %]Upload parsed using [% FEEDBAC.backend %]
54         [% ELSIF ( FEEDBAC.headerrow ) %]These fields found: [% FEEDBAC.value %]
55         [% ELSE %][% FEEDBAC.name %] : [% FEEDBAC.value %]
56         [% END %]
57     </li>
58     [% END %]
59     </ul>
60     </div>
61   [% END %]
62   [% IF ( ERRORS ) %]
63   <br /><br />
64     <div>
65     <h5>Error analysis:</h5>
66     <ul>
67     [% FOREACH ERROR IN ERRORS %]
68         [% IF ( ERROR.badheader ) %]<li>Header row could not be parsed</li>[% END %]
69         [% FOREACH missing_critical IN ERROR.missing_criticals %]
70         <li class="line_error">
71             Line <span class="linenumber">[% missing_critical.line %]</span>
72             [% IF ( missing_critical.badparse ) %]
73                 could not be parsed!
74             [% ELSIF ( missing_critical.bad_date ) %]
75                 has &quot;[% missing_critical.key %]&quot; in unrecognized format: &quot;[% missing_critical.value %]&quot;
76             [% ELSE %]
77                 Critical field &quot;[% missing_critical.key %]&quot;
78                 [% IF ( missing_critical.branch_map ) %]has unrecognized value &quot;[% missing_critical.value %]&quot;
79                 [% ELSIF ( missing_critical.category_map ) %]has unrecognized value &quot;[% missing_critical.value %]&quot;
80                 [% ELSE %]missing
81                 [% END %]
82                 (borrowernumber: [% missing_critical.borrowernumber %]; surname: [% missing_critical.surname %]).
83             [% END %]
84             <br /><code>[% missing_critical.lineraw %]</code>
85         </li>
86         [% END %]
87         [% IF ERROR.invalid_cardnumber %]
88             <li class="line_error">
89                 Cardnumber [% ERROR.cardnumber %] is not a valid cardnumber
90                 [% IF ERROR.borrowernumber %] (for patron with borrowernumber [% ERROR.borrowernumber %])[% END %]
91             </li>
92         [% END %]
93         [% IF ERROR.duplicate_userid %]
94             <li class="line_error">
95                 Userid [% ERROR.userid %] is already used by another patron.
96             </li>
97         [% END %]
98     [% END %]
99     </ul>
100     </div>
101   [% END %]
102 [% ELSE %]
103 <ul>
104     <li>Select a file to import into the borrowers table.</li>
105     <li>If a cardnumber exists in the table, you can choose whether to ignore the new one or overwrite the old one.</li>
106 </ul>
107 <form method="post" action="[% SCRIPT_NAME %]" enctype="multipart/form-data">
108 <fieldset class="rows">
109 <legend>Import into the borrowers table</legend>
110 <ol>
111         <li>
112                 <label for="uploadborrowers">Select the file to import: </label>
113                 <input type="file" id="uploadborrowers" name="uploadborrowers" />
114         </li>
115 </ol></fieldset>
116     <fieldset class="rows">
117         <legend>Field to use for record matching</legend>
118         <ol>
119             <li class="radio">
120                 <select name="matchpoint" id="matchpoint">
121                     <option value="cardnumber">Cardnumber</option>
122                     <option value="userid">Username</option>
123                     [% FOREACH matchpoint IN matchpoints %]
124                         <option value="[% matchpoint.code %]">[% matchpoint.description %]</option>
125                     [% END %]
126                 </select>
127             </li>
128         </ol>
129     </fieldset>
130 <fieldset class="rows">
131 <legend>Default values</legend>
132 <ol>
133 [% FOREACH borrower_field IN borrower_fields %]
134   [% SWITCH borrower_field.field %]
135   [% CASE 'branchcode' %]
136     <li>
137         <label class="description" for="branchcode">[% borrower_field.description %]: </label>
138         <select id="branchcode" name="branchcode">
139             <option value="" selected="selected"></option>
140         [% FOREACH branch IN branches %]
141             <option value="[% branch.branchcode %]">
142                 [% branch.branchname %]</option>
143         [% END %]
144         </select><span class="field_hint">[% borrower_field.field %]</span>
145     </li>
146   [% CASE 'categorycode' %]
147     <li>
148         <label class="description" for="categorycode">[% borrower_field.description %]: </label>
149         <select id="categorycode" name="categorycode">
150             <option value="" selected="selected"></option>
151         [% FOREACH category IN categories %]
152             <option value="[% category.categorycode %]">
153                 [% category.description %]</option>
154         [% END %]
155         </select><span class="field_hint">[% borrower_field.field %]</span>
156     </li>
157   [% CASE %]
158     <li>
159         <label class="description" for="[% borrower_field.field %]">[% borrower_field.description %]: </label>
160         <input id="[% borrower_field.field %]" name="[% borrower_field.field %]" /><span class="field_hint">[% borrower_field.field %]</span>
161     </li>
162   [% END %]
163 [% END %]
164 [% IF ( Koha.Preference('ExtendedPatronAttributes') == 1 ) %]
165     <li>
166         <label class="description" for="patron_attributes">Patron attributes: </label>
167         <input id="patron_attributes" name="patron_attributes" />
168         <span class="field_hint">patron_attributes</span>
169     </li>
170 [% END %]
171 </ol></fieldset>
172         <fieldset class="rows">
173         <legend>If matching record is already in the borrowers table:</legend>
174     <ol><li class="radio">
175         <input type="radio" id="overwrite_cardnumberno" name="overwrite_cardnumber" value="0" checked="checked" /><label for="overwrite_cardnumberno">Ignore this one, keep the existing one</label>
176         </li>
177         <li class="radio">
178                 <input type="radio" id="overwrite_cardnumberyes" name="overwrite_cardnumber" value="1" /><label for="overwrite_cardnumberyes">Overwrite the existing one with this</label>
179         </li>
180     </ol>
181     </fieldset>
182     [% IF ( Koha.Preference('ExtendedPatronAttributes') == 1 ) %]
183         <fieldset class="rows">
184     <legend>Patron attributes</legend>
185     <ol><li class="radio">
186         <input type="radio" id="ext_preserve_0" name="ext_preserve" value="0" checked="checked" /><label for="ext_preserve_0">Replace all patron attributes</label>
187         </li>
188         <li class="radio">
189         <input type="radio" id="ext_preserve_1" name="ext_preserve" value="1" /><label for="ext_preserve_1">Replace only included patron attributes</label>
190         </li>
191     </ol>
192     </fieldset>
193     [% END %]
194         <fieldset class="action"><input type="submit" value="Import" /></fieldset>
195 </form>
196 [% END %]
197 </div>
198 <div class="yui-u">
199 <h2>Notes:</h2>
200 <ul>
201 <li><b>Header: </b>The first line in the file must be a header row defining which columns you are supplying in the import file.</li>
202 <li><b>Separator: </b>Values are comma-separated.</li>
203 <li><b>Starter CSV: </b> Koha provides a starter CSV with all the columns.
204     <ul><li><a href="?sample=1">Download starter CSV</a></li></ul>
205 </li>
206 <li><b>Field list: </b>Alternatively, you can create your own CSV and choose which fields you want to supply from the following list:
207     <ul><li>
208        [% FOREACH columnkey IN borrower_fields %]'[% columnkey.field %]', [% END %]
209     </li></ul>
210 </li>
211 [% IF ( Koha.Preference('ExtendedPatronAttributes') == 1 ) %]
212 <li><b>Extended patron attributes: </b>If loading patron attributes, the 'patron_attributes' field should contain a comma-separated list of attribute types and values. The attribute type code and a colon should precede each value.
213     <ul><li>Example 1: INSTID:12345,LANG:fr</li><li>Example 2: STARTDATE:January 1 2010,TRACK:Day</li></ul>
214 If an input record has more than one attribute, the fields should either be entered as an unquoted string (previous examples), or with each field wrapped in separate double quotes and delimited by a comma:
215     <ul><li>Example 3: &quot;STARTDATE:January 1, 2010&quot;,&quot;TRACK:Day&quot;</li></ul>
216 The second syntax would be required if the data might have a comma in it, like a date string.</li>
217 [% END %]
218 <li><b>Required fields: </b>The fields 'branchcode' and 'categorycode' are required and must match valid entries in your database.</li>
219 <li><b>Password: </b>Values for the field 'password' should be stored in plaintext, and will be converted to a Bcrypt hash (if your passwords are already encrypted, talk to your system administrator about options).</li>
220 <li><b>Date formats: </b> Date values should match your system preference, and must be zero-padded.
221     <ul><li>Example: '01/02/2008'</li></ul>
222 Alternatively, you can supply dates in ISO format.
223     <ul><li>Example: '2010-10-28'</li></ul>
224 </li>
225 </ul>
226
227      </div>
228     </div>
229    </div>
230   </div>
231   <div class="yui-b noprint">
232 [% INCLUDE 'tools-menu.inc' %]
233   </div>
234  </div>
235 [% INCLUDE 'intranet-bottom.inc' %]