This documentation is for the old version. Go to the latest Upload Suite docs

uploadSettings.actionUrl Property

Supported browsers: Internet ExplorerFirefoxGoogle ChromeSafari

Gets or sets a URL to the page files are posted to.

Syntax

JavaScript Initialize
$au.uploader({
    uploadSettings: {
        //...other params...
        actionUrl: ".",
        //...other params...
    }
})
Get/Set Value at Runtime
$au.uploader('uploaderID').uploadSettings().actionUrl(value);
value = $au.uploader('uploaderID').uploadSettings().actionUrl();

Property Value

Type: String

The URL to the page files are posted to. When specifying this value, take into account the following cases:

Using Quotation Marks and Semicolons

URLs can contain semicolon or quotation mark characters (like this one: http://upload.server.com/uploadFile;jsessionid=123?param='value'). If so, to avoid parameter parsing errors enclose such URLs in single (' ') or double (" ") quotes. Additionally, quotation marks (both single ' and double ") inside URLs should be escaped with a backslash:

"http://upload.server.com/uploadFile;jsessionid=123?param=\'value\'"

Uploading to the Same Page

If you want to submit files to the same page where Image Uploader is hosted, specify the dot character (.) as a value of this property.

Using Absolute and Relative URLs

URLs can be both absolute (e.g. http://domain.com/upload/upload.aspx) and relative to the current page (e.g. /upload/upload.aspx).

For example, if Image Uploader is inserted to the http://domain.com/ImageUploader/default.aspx page, the relative URLs specified via this property will correspond to the following locations.

Specified URLExpected Location
"/upload/upload.aspx"http://domain.com/upload/upload.aspx
"./upload/upload.aspx"http://domain.com/ImageUploader/upload/upload.aspx
"upload/upload.aspx"http://domain.com/ImageUploader/upload/upload.aspx
"upload.aspx"http://domain.com/ImageUploader/upload.aspx

Default value is ".".

Remarks

That page should contain the server code which parses the upload request, saves files to necessary folders on server and performs any other additional actions.

Note

Usually this URL must have a specific extension (depending on the web server settings). For ASP platform it should be .asp, for ASP.NET the extension is .aspx, for PHP it is .php, for Perl it can be .pl or .cgi, etc. In other words, the file containing this script should have the extension registered in the settings of your web server as a server page. Otherwise upload will fail.

See Also

Reference

Manual