other/inca-xml2csv/trunk/README

Code
Comments
Other
Rev Date Author Line
3881 27 Apr 16 nicklas 1 == Requirements ==
3881 27 Apr 16 nicklas 2
3881 27 Apr 16 nicklas 3  1. JRE 8 
3881 27 Apr 16 nicklas 4  
3881 27 Apr 16 nicklas 5 == Introduction ==
3881 27 Apr 16 nicklas 6
3881 27 Apr 16 nicklas 7 This is a program that converts an XML file exported from INCA
3881 27 Apr 16 nicklas 8 into a tab-separated file.
3881 27 Apr 16 nicklas 9
3881 27 Apr 16 nicklas 10 == Installation and updating ==
3881 27 Apr 16 nicklas 11
3898 28 Apr 16 nicklas 12  1. Download the IncaXml2Csv-*.tar.gz file.
3881 27 Apr 16 nicklas 13  2. Unpack the downloaded file to a directory of your choice.
3881 27 Apr 16 nicklas 14  3. Done. 
3881 27 Apr 16 nicklas 15
3881 27 Apr 16 nicklas 16 == Using ==
3881 27 Apr 16 nicklas 17  
3896 28 Apr 16 nicklas 18 Run the program by double clicking the IncaXml2Csv.jar file or by
3881 27 Apr 16 nicklas 19 typing the following in a command window:
3881 27 Apr 16 nicklas 20
3897 28 Apr 16 nicklas 21 {{{
3896 28 Apr 16 nicklas 22    java -jar IncaXml2Csv.jar
3897 28 Apr 16 nicklas 23 }}}
3881 27 Apr 16 nicklas 24
3898 28 Apr 16 nicklas 25 The program will ask for 2 input files and 1 output file:
3896 28 Apr 16 nicklas 26
3896 28 Apr 16 nicklas 27  1. The TSV file exported from SCANB containing personal numbers.
3896 28 Apr 16 nicklas 28     The first line must be a header line and must contain a column
3897 28 Apr 16 nicklas 29     called `PersonalNo`.
3896 28 Apr 16 nicklas 30
3896 28 Apr 16 nicklas 31  2. The XML file exported from INCA.
3896 28 Apr 16 nicklas 32
3896 28 Apr 16 nicklas 33  3. The CSV file that should be created. By default this file
3896 28 Apr 16 nicklas 34     is placed in the same directory as the SCANB TSV file with 
3896 28 Apr 16 nicklas 35     the same name as as the INCA XML file but .xml has been 
3896 28 Apr 16 nicklas 36     replaced with .csv.
3896 28 Apr 16 nicklas 37
3896 28 Apr 16 nicklas 38
3881 27 Apr 16 nicklas 39 == Compiling ==
3881 27 Apr 16 nicklas 40
3881 27 Apr 16 nicklas 41 To compile this package you also need:
3881 27 Apr 16 nicklas 42  
3881 27 Apr 16 nicklas 43  1. Ant 1.9
3881 27 Apr 16 nicklas 44  2. Java 1.8 (JDK)
3881 27 Apr 16 nicklas 45
3881 27 Apr 16 nicklas 46 Follow these instructions:
3881 27 Apr 16 nicklas 47
3881 27 Apr 16 nicklas 48  1. Download the source code from the subversion repository. See
3881 27 Apr 16 nicklas 49     http://baseplugins.thep.lu.se/wiki/net.sf.basedb.inca for instructions.
3881 27 Apr 16 nicklas 50  
3898 28 Apr 16 nicklas 51  2. Type `ant` to compile the code and generate the `IncaXml2Csv.jar` file
3881 27 Apr 16 nicklas 52     in the project directory.
3881 27 Apr 16 nicklas 53
3881 27 Apr 16 nicklas 54  3. Use 'ant package' to create a downloadable tar.gz package.
3881 27 Apr 16 nicklas 55  
3881 27 Apr 16 nicklas 56 Tip: If you need different values for any of the properties defined in
3898 28 Apr 16 nicklas 57 the `build.xml` file, create a file named `build.properties` and set
3881 27 Apr 16 nicklas 58 the values there.
3881 27 Apr 16 nicklas 59