Upgrading SoftArtisans XFile


When a user first runs an XFile script, SAXFile.cab or SAXFileEE.cab (see XFile Editions) is downloaded to the client. To make sure that users download the cab again whenever you upgrade it on the server, update dll version numbers in each <object> tag's codebase attribute, as explained below.

To create client-side instances of XFile's main objects, SoftArtisans FileManager, or SoftArtisans Archive, use the <object> tag with the appropriate classid. The classid specifies which control to create (the various classids are listed below). For example, to create an instance of XFileSE's visual upload control, use,

<OBJECT classid="CLSID:230C3D02-DA27-11D2-8612-00A0C93EEA3C" id="AXFFile" 
codebase="[path]/saxfile.cab">

The attribute id specifies a name for the object instance you create. You can supply any name as an id. Use the id to refer to the object in your script. For example, if you named the object instance "AXFFile," use the following to add a file to an upload:

AXFFile.AddFile "x:\filename.ext"

The codebase attribute specifies the location of XFile's visual upload control. When you upgrade XFile, add the control's new version number to the codebase attribute. To find the version number for the visual control,

  1. Extract SAAXFile.dll from SAXFile.cab
  2. Right-click SAAXFile.dll
  3. Open Properties
  4. Select the Version tab

Let's say the version number is 2.0.1.0. Add "version=2.0.1.0" to the codebase attribute:

<OBJECT classid="CLSID:230C3D02-DA27-11D2-8612-00A0C93EEA3C" id="AXFFile" 
codebase="/SAXFileSamples/saxfile.cab#version=2.0.1.0">

The following tables list the objects you can create using the <object> tag, the dlls containing the objects, and their classids. Note that the objects of XFileSE and XFileEE have different classids. When setting an object's classid, be careful to set the classid for the version of XFile that you are using.

XFileEE

Object Dll Classid
XFRequest SAXFileEE.dll 8B3512EF-4FF5-4aa4-9CDE-56BB03E04B9F
AXFFile SAAXFile.dll 7B7929AB-E06A-4508-BE68-1CC7A6997808
AXFFileDownload SAAXFile.dll AD58C149-8AE2-4878-99DC-3A164E32F814
AXFFileProgress SAAXFile.dll 9C6E12BB-F8AE-44aa-9694-9912396B6033
XFResume SAAXFile.dll 53B29E97-9753-44B4-AE57-D51322B2BD49
SoftArtisans Archive SAArch.dll D3400FEE-041F-11D3-B1C5-00A0C9B4587A
SoftArtisans FileManager SAFilMgr.dll E7B62F4E-82F4-11D2-BD41-00105A0A7E89

XFileSE

Object Dll Classid
XFRequest SAXFileEE.dll C3A57B60-C117-11D2-BD9B-00105A0A7E89
AXFFile SAAXFile.dll 230C3D02-DA27-11D2-8612-00A0C93EEA3C
AXFFileDownload SAAXFile.dll B82FA17C-F3A9-11D2-B5DD-0050041B7FF6
AXFFileProgress SAAXFile.dll C3EAF164-E06A-11D2-B5C9-0050041B7FF6
SoftArtisans Archive SAArch.dll D3400FEE-041F-11D3-B1C5-00A0C9B4587A
SoftArtisans FileManager SAFilMgr.dll E7B62F4E-82F4-11D2-BD41-00105A0A7E89

Copyright © 2000-2003 SoftArtisans, Inc. All rights reserved.