Convert XLSM to HTML & Convert XLSM to XML With/Without MS Excel

Command Line Examples: Conversion of XLSM to HTML/XML

 

The first example shows how to convert a single worksheet within a XLSM file to a HTML file using both the ‘Convert XLS’ and ‘MS Excel’ conversion methods. Also in the first example we’ll show how to specify a specific range within a sheet(s) to convert.

The second example shows how to convert multiple sheets within a single Excel file.  Creating a single and multi-file output is illustrated.

The third and final example shows how to convert one or more sheets within many XLSM files within a folder (and subfolders).

To convert to XML simply change the /C44 to /C46 in the examples below.  Although not shown in the examples below, the /H switch could have been added to include values in addition to formulas when converting the Excel file.

Each switch shown in blue is described in detail below the examples. It is highly recommended you review each switches description before implementing the example, thereby giving you the full power of ‘Convert XLS’.

Example 1 (Single Sheet Conversion) 

To convert a single XLSM file, C:\in\B.XLSM (Sheet named "LastSheet") to a HTML file, C:\out\B.HTM using the ‘Convert XLS’ conversion method, the following syntax would be used:

    ConvertXLS.EXE /S"C:\in\B.XLSM" /F52 /N"LastSheet" /T"C:\out\B.HTM" /C44 /M2 /V

Building on the last example, say you want to specify a range, say A1:B10 within a sheet to convert. No problem, simply modify the /N switch as shown below:

    ConvertXLS.EXE /S"C:\in\B.XLSM" /F52 /N"LastSheet^A1:B10" /T"C:\out\B.HTM" /C44 /M2 /V

Specifying ranges can be very powerful. For example if you want to only extract column N you can use “N:N” for the range.

To do the same using the 'MS Excel' conversion method (slower and MS Excel is required) simply change the /M2 switch to /M1 as shown below:

    ConvertXLS.EXE /S"C:\in\B.XLSM" /F52 /N"LastSheet" /T"C:\out\B.HTM" /C44 /M1 /V

 Example 2 (Multiple Sheet Conversion) 

In example 1 we saw how the /N switch is used to specify the sheet/range to.  Here we build upon that and show how to specify more than one sheet to convert.

To convert a single XLSM file, C:\in\B.XLSM (Sheets named "LastSheet","FirstSheet", and "MidSheet") to one HTM file, C:\Out\B.HTM, the following syntax would be used:

    ConvertXLS /S"C:\in\B.XLSM" /F52 /N"FirstSheet,LastSheet,MidSheet" /T"C:\Out\B.HTM" /C44 /M2 /V

 After completion of this example the following file will be created containing all the data of the 3 sheets specified:

                C:\Out\B.HTM

 To create several output files you can add the /U switch like so:

ConvertXLS /S"C:\in\B.XLSM" /F52 /N"FirstSheet,LastSheet,MidSheet" /T"C:\Out\B.HTM" /C44 /M2 /U /V

 After completion the output would be several files:

C:\Out\B-FirstSheet.HTM

C:\Out\B-MidSheet.HTM

C:\Out\B-LastSheet.HTM

If FirstSheet, MidSheet, and LastSheet were indexed 1,2 and 4 respectively, the same results can be attained by setting /N To /N"1-2,4". 

Example 3 (Multiple File/Folder Conversion) 

Say you wanted to convert the 2^nd sheet (/N"2") regardless of what the sheet name might be, of all the XLSM files within the  “C:\in” folder and subfolders (/R for recursive subfolders). To do this the syntax would be:

    ConvertXLS.EXE /S"C:\in\*.XLSM" /F52 /N"2" /T"C:\out\*.HTM" /C44 /M2 /R /V

The example above can be modified to have the resulting files placed in the same folder as the original files.  By specifying the /G switch and removing the /T switch as shown below:

    ConvertXLS.EXE /S"C:\in\*.XLSM" /F52 /N"2" /G /C44 /M2 /R /V

 In the last two examples, you can also use the /M1 switch to specify the ‘MS Excel’ conversion method.

---

• The /S and /T switches above specify Source (input) and Target (output) path respectively and are both required when converting a single file.  It is always a good idea to use double quotes around the path especially if there are space characters within the path.

•  The /C44 switch specifies that the target (output) file to be a HTML file whereas the /F52 switch specifies the original (input file) is a XLSM file.  See Excel Conversion File Type Constants (documentation) for all possible values for /C and /F.

• The /M2 switch tells it to use the ‘Convert XLS’ conversion method which is exceptionally fast. Note the /M1 switch could have been used to specify the ‘MS Excel’ conversion method which is a bit slower and requires MS Excel.

• The /R switch tells it to search the original folder and its subfolders for files to convert.

• /G switch can be used to tell ‘Convert XLS’ to simply place each output file in the same folder as each input file.

• /N"{Sheet^Range^DelimChar^FixedWidth^X}"  Is used when converting to/from an Excel, CSV or fixed width text file. It specifies which Sheets to convert, what Range to convert and what delimitation/separation character to use, and the method to import export to a fixed width text file.  The syntax for this parameter is critical, the items are separated by a carrot character "^".  If you do not include Sheet, Range or DelimChar by leaving them blank they will default to all sheets, all used ranges and the comma delimitation character.  Be certain to include the double quotation character around this parameter like: /N"Apples,Oranges^A2:B20^9"

Sheet:  Only used when an Excel file is the original file. Use "*" or "" for all sheets. You can use names of sheets, or the numeric index. If using numeric indices, you can specify ranges of sheets (i.e. "1,4,10-20" and "4-10,9" etc.). Range and DelimChar are optional.

Range: You could optionally specify a range, say if you only wanted to convert a portion of the input file.  Use the same syntax as an Excel range (e.g. A1:B10).

DelimChar: Not useful in these examples. It is for specifying the ASCII value of the delimitation character used in a CSV file. 44 for comma, 124 for Bar “|”, 9 for the tab etc.

FixedWidth: Not useful in these examples. Here you can specify how to import/export a fixed width text file.  Not used in this example.

• /H If converting from XLSM to something else and using the ‘Convert XLS’ conversion method (/M2) you can optionally specify to include values along with formula, much like "MS Excel" conversion method does.

• /U If converting an XLSM file with multiple sheets specified, the /U switch will generate multiple files instead of a single file.

• The /V (for Verbose) switch is used to give instant feedback by having the program report the status of the conversion with a message box.  You can remove this once you have perfected your command line specification.  You can also (or instead of /V) create a Log file that will contain the results of the conversion by using the /L switch.