Download - CSV to XML Converter
CSV to XML Converter
Converts Comma-Separated-Value
files to Xcelsius – SAP BO
Dashboards 4.x compliant XML-
files
Copyright – Gino Scheppers
csv
XML
csvcsv
XMLXML
CSVtoXML
CSVtoXML (CSVtoXML.jar) is a „command-line driven‟ Java-program, it converts one or more CSV-files to one or more Xcelsius & SAP BO Dashboards 4.x compliant XML-files.
The program is platform independent. Runs in Windows, Sun Solaris, Unix, Linux,…
CSVtoXML is freeware.
Requisites:
Java JRE 1.5 or higher
CSVtoXML
Running the program with the –Help option, will result in an overview of all the available parameters.
Cmd: java –jar <installdir>\CSVtoXML.jar -Help
CSVtoXML
The program is a command-line driven java program, that can run from within a batch-file or script-file (like *.cmd, *. bat, …).
Usage:
java -jar <install dir>CSVtoXML.jar [Options]
Example:
java -jar “C:\Program Files\csvtoxml\CSVtoXML.jar” -Help
Important !
All command-line-options are case-sensitive !
usage:
CSVtoXML
Option: -Help
Shows all parameter options
Usage:
java -jar <install dir>CSVtoXML.jar -Help
Example:
java -jar “C:\Program Files\csvtoxml\CSVtoXML.jar” -Help
Option overview:
CSVtoXML
Option: -cleanDirectory
This option will clean the source-folder after the conversion process.
Important: this option will clean the complete folder! In this case, the output-folder should be different from the source-folder, otherwise you will end-up with no files!
Usage:
java -jar <install dir>CSVtoXML.jar -cleanDirectory -sourceFolderc:/temp/csv -destinationFolder c:/temp/xml
The above example will convert all files with extension *.txt and *.csv (=default behavior) in the source-folder to the destination-folder, after the conversion, all files in the source-folder will be deleted.
Option overview:
CSVtoXML
Option: -csvFilename <arg>
Use this option to indicate the file to convert
Important: Use slash instead of backslash in the path definition
<arg> = <drive:/path/filename>
<arg> = <//server/share/path/filename>
Usage:
java -jar <install dir>CSVtoXML.jar -csvFilenamec:/temp/csv/kpi.csv The above example will convert the file kpi.csv to kpi.xml in the folder
c:\temp\xml.
java -jar <install dir>CSVtoXML.jar -csvFilename kpi.csv -sourceFolder c:/temp/csv/ -destionationFolder c:/temp/xml In the above example, the converted file will be placed in the folder c:\temp\xml
Option overview:
CSVtoXML
Option -sourceFolder <arg>
Use this option to indicate the source path
Important:
Use slash instead of backslash in the path definition <arg> = <drive:/path/>
<arg> = <//server/share/path/>
Using this option without the -csvFilename option will convert allfiles in the source-folder
Usage – example:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ The above example will convert all files (with extension *.csv and *.txt) in the
folder c:\temp\csv. The result will be placed in the same folder
Option overview:
CSVtoXML
Option: -destinationFolder <arg>
Use this option to indicate the destination path
Important:
Use slash instead of backslash in the path definition <arg> = <drive:/path/>
<arg> = <//server/share/path/>
If you don‟t use this option, all converted files will be placed into the source-folder
Tip: if the target-folder doesn‟t exist, it will be created by the program.
Usage: java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -
destinationFolder c:/temp/xml The above example will convert all files (with extension *.csv and *.txt) in the
folder c:\temp\csv. The result will be placed in c:\temp\xml
Option overview:
CSVtoXML
Option: -xmlFilename <arg>
Default: the source-file name will be used as destination-file name, use this option if you want to rename the destination filename into another filename.
Important: you can use the merge-option (see next slide) if you want to merge all files into
one file.
Usage:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -destionationFolder c:/temp/xml -csvFilename kpi.csv -xmlFilenamemyXML.xml
The above example will convert the file kpi.csv in the folder c:\temp\csv into the xml-file myXML.xml in the directory c:\temp\xml
Option overview:
CSVtoXML
Option: -merge
Use this option to merge all the converted files into one xml-file
Important: Use this option in combination with the –xmlFilename option
Usage – example:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -destionationFolder c:/temp/xml -merge -xmlFilename myXML.xml
The above example will convert all files (with extension *.csv and *.txt) in the folder c:\temp\csv into one xml-file (myXML.xml) into the directory c:\temp\xml
The source-filename without extension will be used as variable tag-name.
Option overview:
CSVtoXML
Option: -variableNameRange <arg>
Default, the name of the source-file (without extension) will be used as variable name tag, use this option if you want to change the <variable name>-tag into another name.
Important: Don‟t use this option in combination with the –merge option
Usage – example:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -destionationFolder c:/temp/xml -csvFilename kpi.csv -variableNameRange kpi -xmlFilename myXML.xml
The above example will convert the file kpi.csv in the folder c:\temp\csv into one xml-file (myXML.xml) into the directory c:\temp\xml using kpi as variable-name tag.
Option oveview:
CSVtoXML
Option: -zipFilename <arg>
Use this option to indicate the name of the backup-file
Important:
Use slash instead of backslash in the path definition <arg> = <drive:/path/filename>
<arg> = <//server/share/path/filename>
If the target folder doesn‟t exist, it will be created.
Using #date# or #datetime# in the name to replace it with the current date (format: yyyyMMdd ) or with the current timestamp (format: yyyyMMdd_HHmmss)
Usage – example:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -zipFilename c:/temp/zip/myZip#date#.zip The above example will convert all files (with extension *.csv and *.txt) in the
folder c:\temp\zip, and zip into the file myZip20121101.zip
Option overview:
CSVtoXML
Option: -extensionFilter <arg>
Default all files with extension *.csv and *.txt will be converted, use this option if you want to specify files with an other extension.
Important: Use ; as delimiter if you want to specify more then one extension.
Usage – example:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -extensionFilter csv;txt;prn The above example will convert all files with extension *.csv, *.txt and *.prn in the
folder c:\temp\csv, into the same folder
Option overview:
convert
CSVtoXML
Option: -delimiter <arg>
Default ; is used as delimiter in the csv-file, use this option if you want to use an other delimiter.
Usage – example:
java -jar <install dir>CSVtoXML.jar -sourceFolder c:/temp/csv/ -delimiter # The above example will convert all files with extension *.csv, *.txt in the folder
c:\temp\csv, into the same folder, using a crossroad (#) as delimiter.
Option overview:
csv
xml
Example: converting two csv-files to one xml-file
Suppose you want to monitor the number of BO accounts in a three pillar environment (dev,
accept & production) on two different BO installations (Infra. One & Infra. Two)
On a daily basis you receive two csv-files (InfraOne.csv and InfraTwo.csv) in the C:\tmp\csv
folder.
Create a cmd-file with the following command to convert the two csv‟s to one xml-file.
java -jar CSVtoXML.jar -sourceFolder "C:/tmp/csv/" -destinationFolder "C:/tmp/xml/" -
merge -xmlFilename MergedXML.xml
Create a dashboard using the XML-data connector
read the next slides for more info
Example: converting two csv-files to one xml-file
Convert with CSVtoXML.jar
DWH
Query & Export to csv
Example: converting two csv-files to one xml-file
Example: converting two csv-files to one xml-file
Tip: define two Excel Named Ranges
with the same name of your variable
name – tag
Important: The Import Named Ranges-
button imports the Excel ranges, not the
variable name-section in the xml-file!
Example: converting two csv-files to one xml-file
Refreshing your dashboard with new xml-data will result in a ‘Cannot Access External
Data’ error message. You will need to make a trusted version of your swf-file!
Steps1. Right-click on the swf in the browser and click on Global Settings…
2. Click on the Advanced-tab and click on the Trusted Location Settings-
button
3. Add the name of the swf-file as trusted file
4. Restart your dashboard in the browser
Logging Services
Default „Log4j 1.2.16‟ from apache.org is used to
log the program activity.
Read http://logging.apache.org/log4j/1.2/ for more
info.
Tip: replace the original log4j.properties file in
CSVtoXML.jar (use winzip to open the jar) with your own
configuration file to customize the logging output.
More info: http://www.tutorialspoint.com/log4j/log4j_configuration.htm
http://logging.apache.org/log4j/1.2//apidocs/org/apache/log4j/EnhancedPatternLayout.html