Settings for Upload Actions

The following settings can be customized for each Upload Action by administrative users on the Upload Actions page in your UploadZen Studio, accessible via Site Settings / UploadZen Studio / Upload Actions:

"General" tab:

Name for this Upload Action

(Text box)

This name will typically not be visible on content pages to end users, but helps you stay organized.

This Upload Action is...

(Descriptor for a set of SharePoint Web Sites)

Optionally select in which web sites this Upload Action will be available. By default, it will be available in all web sites and this usually does not need to be changed during your first explorations within this software. Only perform changes if you are familiar with the terminology presented in the above property editor. Should your changes not result in the expected outcome, you can always easily set this back to "all web sites, no exceptions" and then resume experimenting incrementally with your exceptions.

To define the set of Web Sites, first select either Available in all Web Sites or Available in no Web Sites, then click the except... link to describe which web sites to exclude from that selection. You can exclude:

• the root Web Site (of the respectively-current Site Collection)
• Web Sites based on the selected site definitions
• or Web Sites with the specified titles, URL path fragments or IDs.

Show UploadZen menu item in the following Document Libraries

(Descriptor for a set of SharePoint Document Libraries and Views)

Select in which Document Libraries this upload action will be offered as a menu item to end users (in the SharePoint 2007 "Upload" toolbar menu and in the SharePoint 2010 "Library Tools / Documents / New" ribbon group).

To define the set of Lists, first select either Show in all Lists or Show in no Lists, then click the except... link to describe which Lists to exclude from that selection. You can exclude:

• Lists of the selected base types
• Lists of the selected template types
• Lists of the selected base templates
• or Lists with the specified names or IDs.

To define the set of Views, first select either Show in all Views or Show in no Views, then click the except... link to describe which Views to exclude from that selection. You can exclude:

• the default View
• hidden Views
• personal Views
• or Views with the specified names or IDs.

UploadZen menu item caption

(Text box)

Sets the menu item / ribbon button caption for this UploadZen "Upload Multiple Files" menu item.

Default value for new Upload Actions:

$Resources:Tool_UploadActions_DefTitle

UploadZen menu item description

(Text box)

Sets the menu item description / ribbon button tool-tip for this UploadZen "Upload Multiple Files" menu item.

"User Interface" tab:

Client-side uploader

(Drop-down menu to pick from a set of choices)

Select the preferred uploading client technology presented to your end users when this Upload Action is invoked.

Web mode is recommended for maximum compatibility — if Silverlight plugin is installed, this mode may offer a file drop area and perform client-side zipping of uploaded files; if Silverlight or Flash plugin is installed, multiple files can be selected in a file browsing dialog at once.

Windows mode launches a native Windows application (ClickOnce / .NET Framework 2.0+) directly from Internet Explorer (or Firefox with Microsoft .NET / ClickOnce plug-in) — this choice in some cases does not deploy properly to Vista-and-newer-Windows IE clients, and never to non-Windows / non-IE clients.

• Web Uploader
  — supports all client browsers and operating systems (recommended, highest compatibility)
• Windows Uploader
  — works mostly just with Windows clients and IE (legacy mode, least compatible)

Also show in Upload.aspx replacement page

(Check box option)

When clicking SharePoint's built-in, out-of-box 'Upload Document' menu item (single-file upload), this always opens the Upload.aspx system page (which itself may or may not include another built-in, out-of-box 'Upload Multiple Documents' link). Tick this check-box option to also offer this Upload Action on the Upload.aspx page. (Also requires activated "UploadZen Upload.aspx Replacement Page" Site Collection feature.)

Show Mini Tutorial in the uploader

(Check box option)

Web Uploader: The upload area displays a number of helpful hints whenever (and as long as) there are any files marked for upload.

Windows Uploader: The UploadZen window displays a helpful Welcome page with Quick-Start steps whenever (and as long as) there are no files or folders marked for upload.

Untick this check box to never show the above Mini Tutorials to your users.

Show UploadZen link in the uploader

(Check box option)

Tick this check box for the uploader to show a link with a version number in the bottom right corner pointing to the UploadZen product web site.

Show Help link in the uploader

(Check box option)

The uploader shows a Help link in the bottom right corner pointing to select, end user-relevant documentation pages in this UploadZen Studio. Untick this check box to never show the Help link to your users.

"Web Uploader" tab:

If HTML5 is not supported, utilize client-side browser plugins

(Drop-down menu to pick from a set of choices)

The Web Uploader by default utilizes certain HTML5 features regarding file selection if the Web Browser used supports them, and only falls back to the specified plugins if not. The Web Uploader falls back to HTML4 (no selection of multiple-files in a single Browse File dialog) only if those plug-ins are not available either.

• Use Silverlight (and only if not available: use Flash)
• Use Flash (and only if not available: use Silverlight)
• Only use Silverlight
• Only use Flash

Overwrite existing files with the same name

(Check box option)

If ticked, uploading files will overwrite any pre-existing files with the same name in the target Document Library folder (but the uploader will highlight existing files prior to the upload so users are notified and can choose to remove the file from the upload). If unticked, if a file with the same name exists in the target Document Library folder, the uploaded file will be rejected by SharePoint.

Prior to uploading, change all file names to random unique sequences

(Check box option)

If ticked, this option will change the names of uploaded files to random, but unique sequences so that existing files will never be overwritten.

Replacement character

(Text box)

Specify a character or text used to replace the unsupported characters ~ " # % & * : <> ? / \ { | } in uploaded file or folder names. To simply remove (rather than replace) these characters, fully clear this setting. The default value is the underscore (_). (Thanks to this feature, your end users will never receive SharePoint's "The file name is invalid or the file is empty. A file name cannot contain any of the following characters..." message.)

Default value for new Upload Actions:

_

Auto-remove files marked for upload with blocked file extensions

(Check box option)

When users select files with name extensions that are "blocked by the administrator" (or by default) on the SharePoint server side (at the Web Application level [SPWebApplication.BlockedFileExtensions]), by default UploadZen will only warn about this (so users can remove the files from the listing) but will technically allow the upload, which SharePoint / IIS will however promptly refuse. Tick this option to have such files automatically removed from the listing when selected for upload, instead.

Note: changes to blocked file extensions at the Web Application level are only picked up by UploadZen after all web front-end servers are IIS-reset or restarted.

File type filters (multi-selectable, no selection = no filters)

(Drop-down menu to pick from a configurable set of choices)

To restrict which types of files end users can upload via this Upload Action, select one or more file name extension filter sets. If end users then select files whose extensions do not match the selected filters, these files will not even be added to the Upload Files listing and consequently cannot be uploaded.

With the newest Silverlight / Flash versions, these filters even permeate the file browsing dialog and will be offered as choices in there. As a result, users cannot even see or select file types not allowed by the selected filter sets.

(If you need different or custom file name extension filters not offered here, customize or extend the pre-defined filter sets in the Web Uploader section of the Configuration page in UploadZen Studio.)

The drop-down menu provides a set of choices that can be customized on the Configuration page of the UploadZen Studio.

Maximum file size (read description of this setting first)

(Text box)

You can optionally restrict the maximum size per file selected for upload. Files exceeding this limit will be automatically removed from the uploader file listing. Leave blank to allow files of any size.

Important: the format for this setting is 10B, 100KB, or 1000MB. So use any integer number (no fractional, floats or real numbers) and B for bytes, KB for kilobytes or MB for megabytes, no spaces or other non-numeric characters. (For GB use MB multiplied by 1024, ie. for 2GB use 2048MB instead.)

Also note that this setting is a limit for client-side file selection only. Independently of this setting, your SharePoint environment will be subject to server-side request length and upload file size limits on the IIS and SharePoint Web Application levels (refer to the UploadZen Deployment Checklist help topic for details on those limits). To allow uploads of files exceeding these server-side limits, you will need to enable Chunking below.

File chunk size (read description of this setting first)

(Text box)

To use this feature, you NEED TO READ the "Preparing a Web Application for the Chunking feature" section in the UploadZen Deployment Checklist help topic in additional to the following information.

While we highly encourage you to increase your server-side request length and upload file size limits as well as request time-outs (as described in the UploadZen Deployment Checklist help topic), you can use this setting to allow uploads of files whose size exceeds your server-side limits by splitting up such files into smaller separate individual chunks that will be put back together into the one original file by UploadZen at the server side once all chunks have been sent. If you choose to use this feature, you need to specify the file chunk size here and this should be slightly lower than your server-side request length / upload file size limits.

Example: your server-side limits establish that the maximum upload file size is 50 MB. You can set the chunk size here to "48MB". Then when uploading a 110 MB file, this will be split up into three chunks (pre-upload on the client side), the first two being 48 MB each and the last one being 14 MB, none of which exceeds your server-side limits. UploadZen receives all three chunks and puts them back together to restore the original 110 MB file which is then placed into the target Document Library folder.

Important: the format for this setting is 10B, 100KB, or 1000MB. So use any integer number (no fractional, floats or real numbers) and B for bytes, KB for kilobytes or MB for megabytes, no spaces or other non-numeric characters. (For GB use MB multiplied by 1024, ie. for 2GB use 2048MB instead.)

Auto-shrink images prior to upload (read description of this setting first)

(Text box)

This setting is only used if you specify three integer numbers separated by [,] commas, no other characters. The first number is the maximum image width, the second number is the maximum image height, the third number is the image quality for additional file size compression (1 = worst, 100 = best). For example, if this setting is set to 320,240,90 then all uploaded images will be resized pre-upload, aspect ratio maintained so that neither the maximum width nor the maximum height is exceeded.

Offer end users selectable options for server-side ZIP extraction

(Check box option)

This allows users to select for each individual ZIP archive file marked for upload whether to keep the ZIP in the target Library as is, extract it in-place or extract it in a new sub-folder.

If Silverlight is used, offer client-side zipping

(Check box option)

This allows users to define ZIPs to be uploaded in place of the corresponding files marked for zipping. The ZIPs will be generated on the fly just prior to their upload.

If supported, offer a file drop area

(Check box option)

This allows users to add files to their upload by dragging them from their Explorer or Finder window onto the drop area.

If applicable, by default automatically check in uploaded files as follows

(Drop-down menu to pick from a set of choices)

Only applies to Libraries that have check-out/check-in enabled. Select whether and how to automatically bulk check in uploaded files. Check-in will appear to have been done by the currently uploading user.

• No check-in (keep uploaded files checked out to uploading user)
• Check in as a minor new version (if minor versions are enabled)
• Check in as a major new version (if versions are enabled)
• Check in but keep previous version number ("overwrite current version")

If applicable, allow end users to change the above default check-in per file

(Check box option)

Only applies to Libraries that have check-out/check-in enabled. If this option is ticked, end users can select for each upload file whether and how to check it in, prior to the upload. The user interface for that selection will for all files default to the check-in option selected above.

Allow users to launch the Windows Uploader from the Web Uploader

(Check box option)

Shows a link (for Windows clients with Internet Explorer) that launches the legacy Windows Uploader.

"Windows Uploader" tab:

Show 'Options' tab in the Windows Uploader

(Check box option)

The Windows Uploader contains an 'Options' tab that lets users review or customize certain user-specific client-side UploadZen settings (such as overwriting of existing files). Untick this check box to never show the Options tab to any users.

Unzipping of uploaded ZIP archive files

(Drop-down menu to pick from a set of choices)

UploadZen can just put an uploaded ZIP archive file into the current Document Library target folder as a single file, or extract all of its files and sub-folders in place.

• Let users decide (recommended)
• Never unzip
• Always unzip

Allow users to store their SharePoint log-in password on their local PC

(Check box option)

Uploading users may be prompted to type their SharePoint user name and password in certain circumstances (see documentation), and can optionally elect to have UploadZen log them in automatically in the future. This will store their encrypted password in their Windows Registry "Local User" hive. Untick this check box to never let your UploadZen users store their password.

Allow users to change the target folder

(Check box option)

The uploader will be initialized to upload to the current Document Library folder, but users can change to another target folder right from within the uploader prior to uploading or between uploads, without having to navigate to that folder first via SharePoint. Untick this check box to never allow users to change the target folder.

Allow users to change the target Document Library

(Check box option)

The uploader will be initialized to upload to the current Document Library, but users can change to another target Document Library right from within the uploader prior to uploading or between uploads, without having to navigate to that Document Library first via SharePoint. Untick this check box to never allow users to change the target Document Library.