EasyXLS

How to read XLS file in ColdFusion

EasyXLS Excel library can be used to import Excel files in ColdFusion. The library works without MS Excel installed.

Step 1: Download EasyXLS Excel Library for Java

To download the trial version of EasyXLS Excel Library, press the below button:

Download EasyXLS™ Excel Library for Coldfusion

If you already own a license key, you may login and download EasyXLS from your account.

Install the downloaded EasyXLS installer for v8.6 or earlier.

Step 2: License file setup

Step required for EasyXLS v9.0 or later.

If you are using a trial, generate a trial license file from EasyXLS trials page. The trial license is valid for 30-days.

If you own a license key, you may login to the account that purchased the license and generate the license file from:
https://www.easyxls.com/my-orders

Setup the license file into your project using these guidelines.

Step 3: Add EasyXLS library to CLASSPATH in ColdFusion Administator

EasyXLS.jar must be included to class path for Java runtime environment.

EasyXLS.jar can be found:
- Inside the downloaded archive at Step 1 for EasyXLS v9.0 or later
- Under installation path for EasyXLS v8.6 or earlier, in "Lib" folder.

Add EasyXLS library to CLASSPATH

Another solution is to add EasyXLS.jar to "lib" folder from ColdFusion installation path.

Step 4: Run ColdFusion code that reads XLS file

Execute the following ColdFusion code that imports an XLS file.

<!--
===========================================================================
Tutorial 37

This tutorial shows how to read an Excel XLS file in ColdFusion (the
XLS file generated by Tutorial 28 as base template), modify
some data and save it to another XLS file (Tutorial37 - read XLS file.xls).
===========================================================================
-->

Tutorial 37<br>
----------<br>

<!-- Create an instance of the class that reads Excel files -->
<cfobject type="java" class="EasyXLS.ExcelDocument" name="workbook" action="CREATE">

<!-- Read XLS file -->
Reading file C:\Samples\Tutorial28.xls<br><br>

<cfif (workbook.easy_LoadXLSFile("C:\Samples\Tutorial28.xls") is True)>

    <!-- Get the table of data for the second worksheet -->
    <cfset xlsSecondTable = workbook.easy_getSheet("Second tab").easy_getExcelTable()>

    <!-- Write some data to the second sheet -->
    <cfset xlsSecondTable.easy_getCell("A1").setValue("Data added by Tutorial37")>
    <cfloop from="0" to="4" index="column">
        <cfset xlsSecondTable.easy_getCell(1, evaluate(column)).setValue("Data " & evaluate(column + 1))>
    </cfloop>

    <!-- Export the new XLS file -->
    Writing file C:\Samples\Tutorial37 - read XLS file.xls<br>
    <cfset ret = workbook.easy_WriteXLSFile("C:\Samples\Tutorial37 - read XLS file.xls")>

    <!-- Confirm export of Excel file -->
    <cfset sError = workbook.easy_getError()>
    <cfif (sError is "")>
        <cfoutput>
            File successfully created.
        </cfoutput>
    <cfelse>
        <cfoutput>
            Error encountered: #sError#
        </cfoutput>
    </cfif>
<cfelse>
    <cfoutput>
        Error encountered: #workbook.easy_getError()#
    </cfoutput>
</cfif>

<!-- Dispose memory -->
<cfset workbook.Dispose()>

EasyXLS Excel libraries:

Java
Excel Library for ColdFusion
full Java version to import, export or convert Excel files
Excel Reader for ColdFusion
Java version to read and import Excel files
Download EasyXLS™ Excel Library for ColdFusion

File formats:

Office 365
MS Excel 2021 - 2024
MS Excel 2007 - 2019
MS Excel 97 - 2003
XLSXXLSMXLSBXLS
XMLHTMLCSVTXT