Basic Steps in Troubleshooting of HTML5/Flash Uploader
This topic is a guide which aims at helping you to understand what is wrong with your application. Here we consider the most popular errors:
- HTML5/Flash Uploader Does not Render
- Message "Not all files were uploaded successfully" Appears
- Upload is Complete but Files are not Uploaded
- You Get "Package upload error: Error #2170" Error
If an error occurs, we recommend you to start with the debug console which allows you to get error, debug, and information messages from HTML5/Flash Uploader right in your browser. To turn the debug console on you should:
- Set the DebugScriptLevel (or debug.level)
to
3. - Specify how debug messages should be displayed (in pop-up window, console, or alert) with the DebugScriptMode (or debug.mode) property.
Allow pop-up windows or open browser error console. Here are the ways to open the console in the most popular browsers:
- In Internet Explorer 8 open Tools -> Developer Tools (or press F12), then select Script tab in the left pane and click Console in the right pane.
- In Mozilla Firefox we recommend to use Firebug.
- In Google Chrome click the Wrench icon and select Tools -> JavaScript Console (or press Ctrl+Shift+J).
- In Safari turn on the Develop menu in the Advanced pane of Safari Preferences, after that go to Develop -> Show Error Console (or press Cmd+Alt+C).
- Reload your application.
The following code inserted in your application will print all debug messages from HTML5/Flash Uploader to pop-up window (or to the console if pop-ups are blocked).
<aur:ImageUploaderFlash ID="Uploader1" runat="server"
DebugScriptLevel="3" DebugScriptMode="Default" /><?php
require_once "ImageUploaderFlashPHP/Uploader.class.php";
$uploader = new ImageUploaderFlash('Uploader1');
$uploader->setDebugScriptLevel(3);
$uploader->setDebugScriptMode("['popup','console']");
$uploader->render();
?>If you prefer JavaScript, remember that the following code should be inserted before rendering HTML5/Flash Uploader:
<script type="text/javascript">
$au.debug().level(3);
$au.debug().mode(['console','popup']);
</script>For more information about the debug console, please, see the Using HTML5/Flash Uploader at Runtime topic.
HTML5/Flash Uploader Does not Render
Firstly, make sure that client browser has Adobe Flash Player 10.1 plug-in installed.
Another possible reason is an error in your script which embeds HTML5/Flash Uploader. Please, use the debug console as it is described at the beginning of this topic to find the error.
Message "Not all files were uploaded successfully" Appears
Far more likely that an internal server error has occurred, which could be caused by the following reasons:
- HTML5/Flash Uploader cannot save uploaded files because of wrong permissions configuration. See the Installation and Deployment Notes topic to learn how to set required permissions.
- The request size is too big. See the Configuring HTML5/Flash Uploader ASP.NET or Configuring HTML5/Flash Uploader PHP topics, or refer to your server documentation to learn how to increase maximum request length.
- There is an error in your upload script (specified with the UploadSettings.ActionUrl property); see the Debugging Upload Scripts topic.
Also, the error message can appear if server attempts to redirect you to another page, because:
- Your upload script tries to redirect users to another page, but HTML5/Flash Uploader does not support redirection in an upload script. To implement redirection use the RedirectUrl property.
- You upload in non-Internet Explorer browser and lost session or authorization cookies, so the sever tries to redirect you to the login page. Please, see the Maintaining Sessions and Authentication topic.
Upload is Complete but Files are not Uploaded
This can indicate one of the following:
- You did not specify any Converter. If so, specify at least one.
- You do not actually save uploaded files. In this case, either implement the upload processing script or use the autosave feature. For more information, please, see the Saving Uploaded Files topic.
- You use the autosave feature, but did not specify DestinationFolder.
- You are trying to find files in a folder different from the one specified in your upload script.
- You use PHP platform and experience a server-side error (HTTP code 500); see the Debugging PHP HTML5/Flash Upload Scripts topic.
You Get "Package upload error: Error #2170" Error
This error occurs when you use two different domains: one for hosting HTML5/Flash Uploader and the other for uploading files to. You should implement the cross-domain policy for Flash applications and register two license keys (one per domain) in order to fix this error. See the Using Host and Upload Domains that Differ from One Another topic for more information.
See Also
Reference
- debug Class
- Converter Class
- ImageUploaderFlash.UploadSettings Class
- BaseUploadControl.DestinationFolder Property
Manual
- Debugging ASP.NET HTML5/Flash Upload Scripts
- Debugging PHP HTML5/Flash Upload Scripts
- Saving Uploaded Files in HTML5/Flash Uploader ASP.NET
- Saving Uploaded Files in HTML5/Flash Uploader PHP
- Saving Uploaded Files via HTML5/Flash Uploader in Other Platforms
- Configuring HTML5/Flash Uploader ASP.NET
- Configuring HTML5/Flash Uploader PHP
- Installation and Deployment Notes
- Using HTML5/Flash Uploader at Runtime
- System Requirements
- Maintaining Sessions and Authentication in HTML5/Flash Uploader ASP.NET
- Maintaining Sessions and Authentication in HTML5/Flash Uploader PHP