Forums     Knowledge Base     OfficeWriter Online     
 
 
This documentation is for
OfficeWriter v3.8.1
.NET Platform
View Docs for Another
Version or Platform

Installation > Installing ExcelWriter

Installing ExcelWriter

Upgrading to a New Version of ExcelWriter

To replace an installed version of ExcelWriter with version 6, remove the old version and then run the automatic installer. If you want to run version 6 side-by-side with a previous version of ExcelWriter, run the installer on another computer, and copy SAXW6NET.dll and LicenseManager.exe to the target machine. Then, run LicenseManager.exe and enter your new license key.

Automatic Installation

To run the automatic installation, double-click OfficeWriter-3.x.x-Win.exe and follow the instructions. By default, the automatic installation will save ExcelWriter's assemblies in the directory C:\Program Files\SoftArtisans\OfficeWriter\ExcelWriter. You can select a different directory during the installation process.

By default, the installer will install files for both the .NET and COM versions of ExcelWriter. If you do not want the COM version, deselect COM during the installation process.

During the automatic installation process you will be asked to enter the ExcelWriter license key that you received with your order confirmation. To see all OfficeWriter license keys installed in the registry, or to add or remove a key (for example, when upgrading) run License Key Manager (Start > Programs > SoftArtisans > OfficeWriter 3.0 Windows > License Key Manager).

When you install ExcelWriter, you will also be given the option to install WordWriter. If your license key is only for ExcelWriter, and you choose to install WordWriter as well, a free limited version of WordWriter will be installed. If you ordered an evaluation or full version of the whole OfficeWriter suite, you will receive one OfficeWriter key which will unlock both products.

When you update a license key, IIS must be reset before the new license will take effect.

ExcelWriter Installation Files

File Description
SAXW6NET.dll SAXW6NET.dll contains:
  • The pure .NET ExcelTemplate object.

  • The pure .NET ExcelApplication object. *

  • .NET wrappers for the COM versions of ExcelTemplate and ExcelApplication.

SAXW6NET.dll is installed in OfficeWriter\ExcelWriter.

To run an ExcelWriter application in ASP.NET, copy SAXW6NET.dll to the application's \bin directory, or to the Global Assemble Cache (GAC).
SAXW6COM.dll SAXW6COM.dll contains:
  • The COM version of ExcelTemplate.

  • The COM version of ExcelApplication. *

SAXW6COM.dll is installed in OfficeWriter\ExcelWriter.
LicenseManager.exe The License Manager allows you to check what OfficeWriter license keys are installed in your system registry, and to add or remove license keys (when upgrading, for example).
OWAssist.cab * OWAssist.cab contains OfficeWriter Assistant, a file transfer tool included with ExcelWriter Enterprise Edition.

* This feature is not available in ExcelWriterSE.

Installing ExcelWriter at the Application Level

To make ExcelWriter available to an application, include a directory called bin at the application's top level, and save a copy of SAXW6NET.dll in this directory:

  1. At the top level of your application, create a directory called bin.

  2. Copy SAXW6NET.dll from OfficeWriter\ExcelWriter\ to your application's bin directory.

If you are using Visual Studio .NET, add the assembly to your project:

  1. Right-click the project name in Solution Explorer and choose Add Reference.

  2. Click Browse and navigate to C:\Program Files\SoftArtisans\OfficeWriter\bin.

  3. Choose SAXW6NET.dll and click Open. Click OK.

Installing ExcelWriter in the Global Assembly Cache (GAC)

To make ExcelWriter available to all ASP.NET applications on your machine, install ExcelWriter in the Global Assembly Cache (GAC):

  1. Open a command prompt window and move to the directory OfficeWriter\ExcelWriter\.

  2. Enter gacutil /i SAXW6NET.dll.

  3. Open the file machine.config (in [Windows directory]\Microsoft.NET\Framework\[.NET version directory]\CONFIG).

  4. Add the following line to the assemblies node of machine.config:

    <add assembly="SAXW6NET, Version=x.x.x.x, Culture=neutral, 
	PublicKeyToken=f593502af6ee46ae"/>

    OR

    Create a text file containing the following lines, and save it as web.config. Save web.config at the top level of your application. 

    <?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.web>
<compilation>
<compilers>
</compilers>
<assemblies>
<add assembly="SAXW6NET, Version=x.x.x.x, Culture=neutral, 
	PublicKeyToken=f593502af6ee46ae"/>
<add assembly="*" />
</assemblies>
</compilation>          
</system.web>
</configuration>
The version attribute of the add assembly node must correspond exactly to the version of SAXW6NET.dll added to the GAC. If you add a new version of SAXW6NET.dll to the GAC using the gacutil command, update the dll version attributes in machine.config. To get the exact version of SAXW6NET.dll, right-click the file and select the Properties tab.

Using ExcelWriter with Windows 2003

To use ExcelWriter on Windows 2003, you must enable the following Web Service extensions in IIS:

  • Active Server Pages
  • ASP.NET

To enable these extensions:

  1. Open the Internet Information Services (IIS) Manager.
  2. Open local computer.
  3. Select Web Service Extensions.
  4. From the list of Web Service Extensions, select Active Server Pages.
  5. Click the Allow button.
  6. From the list of Web Service Extensions, select ASP.NET.
  7. Click the Allow button.



Copyright 2007 © SoftArtisans, Inc. All Rights Reserved.