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:
- Copy new Image Uploader files to the server: ImageUploader4.cab, ImageUploader2.jar, and iuembed.js.
- 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.
- 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).
- 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.
- Update the license key. Contact sales@aurigma.com for all license upgrade questions.
- 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 Image Uploader Embedding Scripts Library Reference.
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 list below contains obsolete and removed members of Image Uploader.
- EnableRotate was renamed to AllowRotate;
- Layout was renamed to PaneLayout;
- PreviewThumbnailActiveColor was renamed to PreviewThumbnailBorderColor;
- PreviewThumbnailInactiveColor was renamed to PreviewThumbnailBorderHoverColor;
- ShowUploadCompleteMessage was replaced by MessageUploadCompleteText;
- UploadMode was replaced by FilesPerOnePackageCount;
Also, there are several properties that are completely removed and no longer supported: MessageNoFilesToSendText, SignatureFilter, ShowStatusPane, StatusFilesInFolderText,
and 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.
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.
Edited by user Wednesday, May 6, 2009 5:25:54 PM(UTC)
| Reason: Not specified