Document Solutions for Excel, Java Edition | Document Solutions
In This Topic
    Getting Started
    In This Topic

    System Requirements

    DsExcel Java requires the following system requirements depending upon the framework you are using to create an application. 

    For OS versions supported in DsExcel Java, refer to System Requirements.

    Note: To avoid security issues and improve JDK 8 compatibility, in DsExcel v6.0 release, we have removed support for JDK 7 and earlier versions. In order to upgrade your DsExcel application to JDK 8, you must remove dependency of the dsexcel.extension package and delete *.class and *.jar files related to the extension package.
    Note: The DsExcel Java version lower than v5.1.1 will not work in JDK 17 or higher.

    Note: With v7.0, gcexcel.jar (GcExcel) package is renamed to dsexcel.jar (DsExcel). The namespaces and classes remain the same, which provide the same functionality and are backwards compatible, ensuring minimal impact on your existing projects.

    To upgrade GcExcel package to DsExcel package in your existing projects, follow one of the below options:

    • Update package using Migration tool:
      1. The migration tool is present in the package downloaded from the website. Follow the instructions displayed in the UI when using the tool for a seamless migration. The tool will replace the gcexcel dependencies with dsexcel in pom.xml and gradle build files of your Java projects. If any other change is required in the project, it should be updated manually.
    • Update package manually from NuGet package manager:
      1. Download the DsExcel java package from Maven Central repository or download it locally on your machine from MESCIUS website.
      2. Open the Eclipse IDE.
      3. Open the existing Java project.
      4. In Java settings, under Libraries tab, click gcexcel.jar and then click Remove to remove it and its dependencies from the project.
      5. Click Add External JARs and select dsexcel-7.0.0.jar to add it to your project.
      6. Click Finish. The jar file will be added under the Referenced Libraries in your project.

    Setting up an application

    DsExcel Java API reference is available through Maven Central Repository, a directory that stores all the java archives (.jar files) and adds libraries, plugins and references to your project.

    For installation of the product, refer to the following steps:

    Step 1 - Download the DsExcel Java package

    You can either download the DsExcel java package from Maven Central repository or download it locally on your machine from MESCIUS website.

    Step 2 - Install the DsExcel Java package and add dependency for DsExcel library

    Complete the following steps to install the DsExcel Java package (dsexcel-7.0.0.jar) and add dependency for DsExcel Java library in your application.

    If you are creating an application :

    1. Using Java Integrated Development Environment (IDE) :

      You can install any Java IDE - Eclipse or IntelliJ as per your choice. Shared below are the steps to create a Java application using Eclipse IDE:

      1. Open the Eclipse IDE.
      2. Create a new Java project.
      3. In Project name field, enter the name of your project and click Next.
      4. In Java settings, under Libraries tab, click Add External JARs.
        Java Settings dialog
      5. Select the dsexcel-7.0.0.jar to add it to your project.
      6. Click Finish.
      7. The jar file will be added under the Referenced Libraries in your project.

        Jar file under the Referenced Libraries

      8. The following dependencies are also required, apart from dsexcel.jar:

        • javax.json-1.0.4.jar
        • fontbox-2.0.24.jar 
        • pdfbox-2.0.24.jar
        • commons-logging-1.2.jar
        • gson-2.8.9.jar
      Note: To know more about these dependencies, refer DsExcel Dependencies.

    2. Using the Gradle project:

      Open the build.gradle and append the following script in the dependencies block:

      compile("com.mescius.documents:dsexcel:7.0.0")
              
    3. Using the Maven project:

      Open the pom.xml and add below xml element in the dependencies node.

      <dependency>
         <groupId>com.mescius.documents</groupId>
         <artifactId>dsexcel</artifactId>
         <version>7.0.0</version>
      </dependency>

      The jar file will be added as a library in the project and your project can now reference all classes of DsExcel in the jar file.