Merge branch 'bug_8117' into 3.12-master
[koha.git] / koha-tmpl / intranet-tmpl / prog / en / modules / help / tools / csv-profiles.tt
1 [% INCLUDE 'help-top.inc' %]
2
3 <h1>CSV Profiles</h1>
4
5 <p>CSV Profiles are created to define how you would like your cart or list to export.</p>
6
7 <h3>Add CSV Profiles</h3>
8
9 <p>To add a CSV Profile</p>
10
11 <ul>
12         <li>Click 'CSV Profiles' from the Tools menu
13 <ul>
14         <li>The 'Profile name' will appear on the export pull down list when choosing 'Download' from your cart or list</li>
15     <li>The 'Profile description' is for your own benefit, but will also appear in the OPAC when patrons download content, so make sure it's clear to your patrons as well</li>
16         <li>The 'CSV separator' is the character used to separate values and value groups</li>
17     <li><strong>Tip:</strong> The most common option here is comma because most spreadsheet applications know how to open files split by commas.</li>
18         <li>The 'Field separator' is the character used to separate duplicate fields
19 <ul>
20     <li>Example: You may have multiple 650 fields and this is the character that will appear in between each one in the column</li>
21 </ul>
22 </li>
23         <li>The 'Subfield separator' is the character used to separate duplicate subfields
24 <ul>
25         <li>Example: You may have multiple $a subfields in a field</li>
26 </ul>
27 </li>
28         <li>The 'Encoding' field lets you define the encoding used when saving the file</li>
29     <li>Finally format your CSV file using the 'Profile MARC fields' fields
30 <ul>
31     <li>Define which fields or subfields you want to export, separated by pipes. Example :200|210$a|301</li>
32     <li><strong>Tip:</strong> You can also use your own headers (instead of the ones from Koha) by prefixing the field number with an header, followed by the equal sign. Example : Personal name=100|title=245$a|300</li>
33 </ul>
34 </li>
35 </ul>
36 </li>
37 </ul>
38
39 <p>When you have entered in all of the information for you profile, simply click 'Submit' and you will be presented with a confirmation that your profile has been saved.</p>
40
41 <h3>Modify CSV Profiles</h3>
42
43 <p>Once you have created at least one CSV Profile an 'Edit profile' tab will appear next to the 'New profile' button.</p>
44
45 <ul>
46     <li>Choose the profile you would like to edit and alter the necessary fields.</li>
47     <li>After submitting your changes you will be presented with a confirmation message at the top of the screen</li>
48     <li>To delete a profile, check the 'Delete selected profile' option before clicking 'Submit Query'</li>
49 </ul>
50
51 <h3>Using CSV Profiles</h3>
52
53 <p>Your CSV Profiles will appear on the export list or cart menu under the 'Download' button in both the staff client and the OPAC</p>
54
55 <p><strong>See the full documentation for CSV Profiles in the <a href="http://manual.koha-community.org/3.10/en/csvprofiles.html">manual</a> (online).</strong></p>
56
57 [% INCLUDE 'help-bottom.inc' %]