
<sect1 id="xls2xml-program-using">
<title>Usage</title>
<para>
	This program reads a file generated by Microsoft Excel and generate a representation of its contents using XML.
</para>
<para>
	Usage:
</para>
<screen>
xls2xml xlsFILE [xmlFILE] [--refmode=(A1|R1C1|default)] [--level=(all|normal)]
</screen>
<simplelist>
	<member>
		<userinput>xlsFILE</userinput>. It's the only required parameter. It's the file name of the file generated by Microsoft Excel.
	</member>
	<member>
		<userinput>xmlFILE</userinput>. It's the file name where the XML result is stored. If it is ommited, the result is written in the standard output.
	</member>
	<member>
		<userinput>--refmode=(A1|R1C1|default)</userinput>. Which cell reference mode will be used: <userinput>A1</userinput> is the most common, <userinput>R1C1</userinput> is also available, and <userinput>default</userinput> is the reference mode used in the file generated by Microsoft Excel.
	</member>
	<member>
		<userinput>--level=(all|normal)</userinput>. How much content will be extracted.
	</member>
</simplelist>
</sect1>


<sect1 id="xls2xml-program-sample-output">
<title>Sample output</title>
<para>
	Next is an typical output. You can note that the cell contents are under "fil_spreadsheet/sheets/sheet/cells" tags. Note that the cell content are UTF8 encoded. Note that if <filename>xls2xml</filename> can't understand some formula, it outputs a error message in the cell.
</para>
    <screen>
&lt;?xml version="1.0"?&gt;
&lt;fil_spreadsheet&gt;
  &lt;defaults&gt;
    &lt;tabsstate&gt;
      &lt;order&gt;0,1,2&lt;/order&gt;
      &lt;top&gt;0&lt;/top&gt;
      &lt;first&gt;0&lt;/first&gt;
      &lt;howmanyselected&gt;1&lt;/howmanyselected&gt;
      &lt;widthratiovshorizscrollbar&gt;600&lt;/widthratiovshorizscrollbar&gt;
    &lt;/tabsstate&gt;
    &lt;building&gt;
      &lt;appid&gt;3612&lt;/appid&gt;
      &lt;appyear&gt;1996&lt;/appyear&gt;
      &lt;lasteditedWin/&gt;
      &lt;evereditedWin/&gt;
    &lt;/building&gt;
    &lt;ui/&gt;
    &lt;codepage&gt;1200&lt;/codepage&gt;
    &lt;username&gt;John Dow&lt;/username&gt;
    &lt;windowstate&gt;
      &lt;metrics&gt;
        &lt;xpos&gt;2685&lt;/xpos&gt;
        &lt;ypos&gt;65386&lt;/ypos&gt;
        &lt;width&gt;9180&lt;/width&gt;
        &lt;height&gt;5010&lt;/height&gt;
      &lt;/metrics&gt;
      &lt;display&gt;
        &lt;hidden&gt;no&lt;/hidden&gt;
        &lt;iconic&gt;no&lt;/iconic&gt;
        &lt;horizscrollbar&gt;yes&lt;/horizscrollbar&gt;
        &lt;vertscrollbar&gt;yes&lt;/vertscrollbar&gt;
        &lt;tabs&gt;yes&lt;/tabs&gt;
      &lt;/display&gt;
    &lt;/windowstate&gt;
    &lt;backup&gt;no&lt;/backup&gt;
    &lt;showobjects&gt;yes&lt;/showobjects&gt;
    &lt;precisionasdisplayed&gt;no&lt;/precisionasdisplayed&gt;
    &lt;fonts&gt;
      &lt;font refnum="0"&gt;
        &lt;height&gt;200&lt;/height&gt;
        &lt;italic&gt;no&lt;/italic&gt;
        &lt;strikeout&gt;no&lt;/strikeout&gt;
        &lt;outline&gt;no&lt;/outline&gt;
        &lt;shadow&gt;no&lt;/shadow&gt;
        &lt;bold type="yesno"&gt;no&lt;/bold&gt;
        &lt;pos&gt;normal&lt;/pos&gt;
        &lt;underline&gt;no&lt;/underline&gt;
        &lt;family type="numeric"&gt;0&lt;/family&gt;
        &lt;name&gt;Arial&lt;/name&gt;
      &lt;/font&gt;
      &lt;font refnum="1"&gt;
        &lt;height&gt;200&lt;/height&gt;
        &lt;italic&gt;no&lt;/italic&gt;
        &lt;strikeout&gt;no&lt;/strikeout&gt;
        &lt;outline&gt;no&lt;/outline&gt;
        &lt;shadow&gt;no&lt;/shadow&gt;
        &lt;bold type="yesno"&gt;no&lt;/bold&gt;
        &lt;pos&gt;normal&lt;/pos&gt;
        &lt;underline&gt;no&lt;/underline&gt;
        &lt;family type="numeric"&gt;0&lt;/family&gt;
        &lt;name&gt;Arial&lt;/name&gt;
      &lt;/font&gt;
      &lt;font refnum="2"&gt;
        &lt;height&gt;200&lt;/height&gt;
        &lt;italic&gt;no&lt;/italic&gt;
        &lt;strikeout&gt;no&lt;/strikeout&gt;
        &lt;outline&gt;no&lt;/outline&gt;
        &lt;shadow&gt;no&lt;/shadow&gt;
        &lt;bold type="yesno"&gt;no&lt;/bold&gt;
        &lt;pos&gt;normal&lt;/pos&gt;
        &lt;underline&gt;no&lt;/underline&gt;
        &lt;family type="numeric"&gt;0&lt;/family&gt;
        &lt;name&gt;Arial&lt;/name&gt;
      &lt;/font&gt;
      &lt;font refnum="3"&gt;
        &lt;height&gt;200&lt;/height&gt;
        &lt;italic&gt;no&lt;/italic&gt;
        &lt;strikeout&gt;no&lt;/strikeout&gt;
        &lt;outline&gt;no&lt;/outline&gt;
        &lt;shadow&gt;no&lt;/shadow&gt;
        &lt;bold type="yesno"&gt;no&lt;/bold&gt;
        &lt;pos&gt;normal&lt;/pos&gt;
        &lt;underline&gt;no&lt;/underline&gt;
        &lt;family type="numeric"&gt;0&lt;/family&gt;
        &lt;name&gt;Arial&lt;/name&gt;
      &lt;/font&gt;
    &lt;/fonts&gt;
  &lt;/defaults&gt;
  &lt;sheets&gt;
    &lt;sheet refnum="0"&gt;
      &lt;cells&gt;
        &lt;cell volatile="no" coord="A1"&gt;=7&lt;/cell&gt;
        &lt;cell coord="B1"&gt;&amp;quot;7 seven special-characters-&amp;#195;&amp;#161;&amp;#195;&amp;#169;&amp;#195;&amp;#173;&amp;#195;&amp;#179;&amp;#195;&amp;#186;&amp;#195;&amp;#129;&amp;#195;&amp;#137;&amp;#195;&amp;#141;&amp;#195;&amp;#147;&amp;#195;&amp;#154;&amp;#195;&amp;#177;&amp;#195;&amp;#145; 7+8 SIN(7) SIN(7)+8 CHOOSE(1,SIN(1),SIN(2),SIN(3)) CHOOSE(2,SIN(1),SIN(2),SIN(3)) CHOOSE(3,SIN(1),SIN(2),SIN(3)) 7.1 12345678912345.1 7.1+7.2 12345678912345.1+12345678912345.1 5+6+1.1 1+2-3*4/5 SIN(1.1) COS(1.1) TAN(1.1) A13+$A14+A$5+$A$6 1+1.1*-A1 -1.1-1.2+(-1.3)&amp;quot;&lt;/cell&gt;
        &lt;cell volatile="no" coord="A2"&gt;=&amp;quot;seven&amp;quot;&lt;/cell&gt;
        &lt;cell volatile="no" coord="A3"&gt;=&amp;quot;special-characters-&amp;#195;&amp;#161;&amp;#195;&amp;#169;&amp;#195;&amp;#173;&amp;#195;&amp;#179;&amp;#195;&amp;#186;&amp;#195;&amp;#129;&amp;#195;&amp;#137;&amp;#195;&amp;#141;&amp;#195;&amp;#147;&amp;#195;&amp;#154;&amp;#195;&amp;#177;&amp;#195;&amp;#145;&amp;quot;&lt;/cell&gt;
        &lt;cell volatile="no" coord="A4"&gt;=7+8&lt;/cell&gt;
        &lt;cell volatile="no" coord="A5"&gt;=SIN(7)&lt;/cell&gt;
        &lt;cell volatile="no" coord="A6"&gt;=SIN(7)+8&lt;/cell&gt;
        &lt;cell volatile="no" coord="A7"&gt;Formula error: unknown formula&lt;/cell&gt;
        &lt;cell volatile="no" coord="A8"&gt;Formula error: unknown formula&lt;/cell&gt;
        &lt;cell volatile="no" coord="A9"&gt;Formula error: unknown formula&lt;/cell&gt;
        &lt;cell volatile="no" coord="A10"&gt;=7.100000&lt;/cell&gt;
        &lt;cell volatile="no" coord="A11"&gt;=12345678912345.099609&lt;/cell&gt;
        &lt;cell volatile="no" coord="A12"&gt;=7.100000+7.200000&lt;/cell&gt;
        &lt;cell volatile="no" coord="A13"&gt;=12345678912345.099609+12345678912345.099609&lt;/cell&gt;
        &lt;cell volatile="no" coord="A14"&gt;=5+6+1.100000&lt;/cell&gt;
        &lt;cell volatile="no" coord="A15"&gt;=1+2-3*4/5&lt;/cell&gt;
        &lt;cell volatile="no" coord="A16"&gt;=SIN(1.100000)&lt;/cell&gt;
        &lt;cell volatile="no" coord="A17"&gt;=COS(1.100000)&lt;/cell&gt;
        &lt;cell volatile="no" coord="A18"&gt;=TAN(1.100000)&lt;/cell&gt;
        &lt;cell volatile="no" coord="A19"&gt;=A13+$A14+A$5+$A$6&lt;/cell&gt;
        &lt;cell volatile="no" coord="A20"&gt;=1+1.100000*-(A1)&lt;/cell&gt;
        &lt;cell volatile="no" coord="A21"&gt;=-1.100000-1.200000+(-1.300000)&lt;/cell&gt;
      &lt;/cells&gt;
      &lt;name&gt;Hoja1&lt;/name&gt;
      &lt;hidden&gt;no&lt;/hidden&gt;
      &lt;calculationmode&gt;auto&lt;/calculationmode&gt;
      &lt;maxiterations&gt;100&lt;/maxiterations&gt;
      &lt;referencemode&gt;a1&lt;/referencemode&gt;
      &lt;takeiterationoptions&gt;no&lt;/takeiterationoptions&gt;
      &lt;iterationdelta&gt;0.001000&lt;/iterationdelta&gt;
    &lt;/sheet&gt;
    &lt;sheet refnum="1"&gt;
      &lt;cells/&gt;
      &lt;name&gt;Hoja2&lt;/name&gt;
      &lt;hidden&gt;no&lt;/hidden&gt;
      &lt;calculationmode&gt;auto&lt;/calculationmode&gt;
      &lt;maxiterations&gt;100&lt;/maxiterations&gt;
      &lt;referencemode&gt;a1&lt;/referencemode&gt;
      &lt;takeiterationoptions&gt;no&lt;/takeiterationoptions&gt;
      &lt;iterationdelta&gt;0.001000&lt;/iterationdelta&gt;
    &lt;/sheet&gt;
    &lt;sheet refnum="2"&gt;
      &lt;cells/&gt;
      &lt;name&gt;Hoja3&lt;/name&gt;
      &lt;hidden&gt;no&lt;/hidden&gt;
      &lt;calculationmode&gt;auto&lt;/calculationmode&gt;
      &lt;maxiterations&gt;100&lt;/maxiterations&gt;
      &lt;referencemode&gt;a1&lt;/referencemode&gt;
      &lt;takeiterationoptions&gt;no&lt;/takeiterationoptions&gt;
      &lt;iterationdelta&gt;0.001000&lt;/iterationdelta&gt;
    &lt;/sheet&gt;
  &lt;/sheets&gt;
&lt;/fil_spreadsheet&gt;</screen>
</sect1>

