Aurigma Image Uploader 4.8 Dual
Upgrading from Image Uploader 2.x for ActiveX
See Also

Aurigma Image Uploader 4.0 Dual has a number of changes since Aurigma Image Uploader 2.5 for ActiveX. It has much more features and API improvements, including backward incompatible ones. Also, one of important changes is that Aurigma Image Uploader 4.0 Dual now is offered as ActiveX + Java bundle only. Even if you do not want Java version, the only supported way to embed Image Uploader on the page is to use iuembed.js helper script rather than the OBJECT element-based syntax.

This topic discusses how to upgrade from Aurigma Image Uploader 2.5 for ActiveX to Aurigma Image Uploader 4.0 Dual.

# Steps to Update Image Uploader

In short, you should follow these steps to upgrade from Aurigma Image Uploader 2.5 for ActiveX to Aurigma Image Uploader 4.0 Dual:

1. Copy new Image Uploader files to the server:
   - ImageUploader4.cab
   - ImageUploader2.jar
   - iuembed.js
2. If you are using OBJECT element to insert Image Uploader to the page, re-write your code using the iuembed.js . You will find explanations regarding this matter later in this topic.
3. Make sure that codebase settings of ActiveX and Java versions are configured properly (i.e. they are pointing to the CAB file and the folder with JAR file).
4. Review Image Uploader members you are using and make sure that they do not belong to the obsolete members list. If so, change your code to reflect changes in API. Breaking changes of API are described later in this topic.
5. Update the license key. Contact sales@aurigma.com for all license upgrade questions.
6. If you want to use some new features of Aurigma Image Uploader 4.0 Dual check out this documentation. In particular, it is recommended to examine the What's New? topic to see what new features are added and where to read about it more detailed.

# Using iuembed.js Instead of OBJECT Element

Although you still can use OBJECT element to insert Image Uploader to the page, it is not recommended to do. There are a number of advantages of iuembed.js against the OBJECT:

- With iuembed.js you can insert both ActiveX and Java and work with it in unified way. Moreover, this code is the same for all modern browsers. Even if you do not use Java version, if you decide to work with it later, it will not require to make modifications of the client side code. Just modify one parameter.
- This script implements an number of handy features, such as ability to check whether ActiveX control is already installed, ability to display a text if the installation failed, etc.
- All demo applications distributed with Image Uploader are written using the iuembed.js . This way it is much easier to reuse this code during development. In the same time old-style syntax is not used anymore.

To find information about how to insert Image Uploader using the iuembed.js script, refer the Inserting Image Uploader into Web Page topic. For more information about features of the iuembed.js , see the Helper Script Reference (iuembed.js).

Note
If you still want to use the OBJECT tag, you need to update the clsid and codebase attributes. You can find necessary values in the iuembed.js file, in activeXClassID and activeXControlCodeBase of the ImageUploaderWriter class respectively.

# List of Breaking API Changes

The table below contains a list of obsolete and removed members of Image Uploader. These members still work (for backward compatibility reasons), however it is highly recommended to get rid of them.

Old Member Name | New Member Name | Comments
--- | --- | ---
EnableRotate | AllowRotate | Renamed.
Layout | PaneLayout | Renamed.
PreviewThumbnailActiveColor | PreviewThumbnailBorderColor | Renamed.
PreviewThumbnailInactiveColor | PreviewThumbnailBorderHoverColor | Renamed.
ShowUploadCompleteMessage | N/A | Eliminated. Set the MessageUploadCompleteText property to an empty string to hide the upload complete message.
UploadMode | N/A | Eliminated. Use the FilesPerOnePackageCount property instead.

Also, there are several properties that are completely removed and no longer supported. Here is a list of them:

- MessageNoFilesToSendText
- SignatureFilter
- ShowStatusPane
- StatusFilesInFolderText
- StatusSelectedFilesText

And at last, there were changes in default behavior. Now unlike previous versions of Image Uploader no thumbnails are uploaded by default. Only original file is uploaded unless you override it by modifying appropriate properties (such as UploadThumbnail1FitMode, etc). See the Resizing and Rotating Images topic for more information about this.

# Behavior Changes

First of all, Progress event now fires relating to the current request. It means that if you send files in several requests (analogue for Separate upload mode in Aurigma Image Uploader 2.5 for ActiveX), the progress arguments Value and ValueMax will be calculated inside a single request rather than for all files. Of course, if you upload all files in the same request, there will not be any difference.

Another change affects the use of additional folder navigators, e.g. code sample described in Open File Dialog Sample topic. Now instead of the name attribute of the OBJECT element, you can use any string to link Image Uploader with Explorer Combo. All objects that have the same value as the AdditionalFolderNavigator property are considered linked. See the Open File Dialog Sample demo for more details.

One more significant change is that Image Uploader now does not send full file path when sending a file name. It sends only the name of the file, but does not send folder structure. This behavior modification was caused by changes made in new browser (Internet Explorer 7, Mozilla Firefox, etc). Due security reasons they do not send the folder structure to the server. So does Image Uploader. The FileName_I cannot be used to retrieve full path anymore as well.

If an ability to extract full path is critical to you, you should order a private label version. Feel free to email to sales@aurigma.com if you are interested.

# See Also

##### Manual

Upgrading from Image Uploader 3.x for ActiveX
Upgrading from Image Uploader 1.x for Java
Inserting Image Uploader into Web Page

##### Reference

Helper Script Reference (iuembed.js)

##### Related Links

What's New?