merge fix from trunk to all branches
[webpac] / doc / dbf_import.pod
1 =head1 Import DBF files into WebPAC
2
3 dBase file format C<.dbf> is supported using C<XBase> perl module.
4 Configuration in C<all2xml.conf> for this type looks like this:
5
6   [hda]
7         dbf_file=/data/drustvene/hda/ISO.DBF
8         type=dbf
9         import_xml_file=isis
10         import_xml_tag=isis
11         dbf_codepage=cp852
12         dbf_mapping=<<_END_OF_MAP_
13   ID_BROJ               mfn
14   ISBN_BROJ     010
15   SKUPINA1      200
16   SKUPINA2      205
17   SKUPINA4      210
18   SKUPINA5      215
19   SKUPINA6      225
20   SKUPINA7      300
21   ANOTACIJA     330
22   PREDMET1      610
23   PREDMET2      610
24   PREDMET3      510
25   UDK           675
26   REDALICA      700
27   SIGNATURA     990
28   _END_OF_MAP_
29
30 Options are following:
31
32 =over 4
33
34 =item dbf_file
35
36 Full path to C<.dbf> file that you want to import.
37
38 =item type
39
40 It should be C<dbf> for dBase files.
41
42 =item import_xml_file
43
44 If you want to re-use exising import_xml file, you can use this option
45 to specify C<import_xml/B<import_xml_file>.xml> file.
46
47 If not used, you will have to create C<import_xml/dbf.xml> file.
48
49 =item import_xml_tag
50
51 If using C<import_xml_file> you will like to specify which tag to use
52 for C<dbf> data using this option.
53
54 =item dbf_codepage
55
56 Override codepage in C<import_xml_file> for this C<.dbf> database.
57
58 =item dbf_mapping
59
60 Specify mapping from C<.dbf> fields to ISO fields. Each field is assumed to
61 have MARC/ISO subfields in form C<^a> or C<$a> and so on.
62
63 Mapping must be specified using text here notation in config file, and must
64 have two fields: original name of column from C<.dbf> file and new field name
65 which is used in C<import_xml>.
66
67 =back
68
69 =cut