AWS FilePicker 2.1 Documentation
AWS FilePicker ` By Alex Avrutin and Juan López AWS FilePicker 2.1 Documentation Contents INTRODUCTION WHAT’S NEW? SYSTEM REQUIREMENTS INSTALLATION DEVELOPER’S GUIDE 5.1 PRELIMINARY NOTES 5.1.1 File system access issues 5.1.2 Known bugs 10 5.1.3 Source code compilation 10 5.2 DESIGN OF AWS FILEPICKER 11 5.3 HOW TO ADD AWS FILEPICKER INTO YOUR APPLICATION 12 5.4 CONFIGURING AWS FILEPICKER 14 General configuration properties 14 Appearance properties 15 Security properties 15 USER’S GUIDE 18 6.1 GENERAL VIEW 18 6.2 WORKING WITH FILES 20 6.2.1 Selecting files 20 6.2.2 Navigating the file system 21 6.2.3 Creating new folders 22 6.2.4 Renaming 23 6.2.5 Copying 24 6.2.6 Moving 25 6.2.7 Deletion 26 6.2.8 Refreshing the view 26 6.2.9 Reverse check 27 6.2.10 Previewing pictures 28 6.2.11 Uploading files 29 Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 6.2.12 Bulk file upload 30 6.2.13 File download 31 6.2.14 Bulk file download 31 THANKS 33 OTHER COMPONENTS BY AW/SYSTEMS 35 ABOUT AW/SYSTEMS 36 Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Introduction AWS FilePicker reminds of the “Open File” dialog in regular Windows applications This is an ASP.NET web control that lets users navigate a folder and its subfolders on the server to select a file Full-featured file manager AWS FilePicker has a full-featured file manager that lets you copy, move, rename, delete files and folders, upload files to a folder and create new folders Bulk file upload AWS FilePicker gives you unique capabilities, namely, the Bulk file upload feature With this you can upload as many files as you want at once by compressing them with your archiver (e.g WinZip) and then uploading the archive to the server As soon as it reaches the server, AWS FilePicker will extract the files from the archive automatically NEW! Bulk file download FilePicker 2.1 introduces another amazing capability—Bulk file download You can download an entire folder in a Zip archive with all the files and subfolders with one click No more pain with downloading 1,000s files You can download them all at once! Permission management You can easily adjust the permissions you grant each person You can prohibit uploading, renaming, deleting, and/or creating files and folders You also can limit the size Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation of files that can be uploaded and restrict the allowed file types by their extensions For example, you can restrict users to uploading pictures only (.gif and jpg) with a file size smaller than 50KB Picture preview When working with graphic files, it is often useful to preview the images you’re working with FilePicker can generate thumbnails for many types of images (JPG, GIF, BMP, PNG and TIFF) making it easier to manage them Multilingual and localized interface FilePicker comes with supported languages right out of the box: English, Spanish, Russian and Portuguese The default language is determined automatically (using client’s browser settings), and users can switch languages at any time Along with the language of the interface, all the regional settings (date and number representation, etc) will be changed as well Freeware & open source AWS FilePicker is free software You can freely modify and redistribute it The component is shipped with complete and well-commented source code Supported! Despite on the fact that this is free software, we support it If you have any questions or just want to share your thoughts feel free to write the authors: Alex Avrutin: alex@awsystems.biz (English & Russian) Juan López: jlopez@awsystems.biz (Spanish) Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation What’s new? AWS FilePicker 2.1 has got a number of cool features which many users of the control were anticipating: Ability to download files and entire folders (Finally!) Select/Unselect All checkbox lets you select or unselect all items in the file list By default, the file manager selects the file and closes itself after the file is uploaded This will save much time for the average user [You can disable this by resetting the checkbox called ‘Select the file upon upload’ on the Upload panel See the Upload files section for details.] Now FilePicker does not overwrite existing files upon upload but instead displays an error message [You can overwritte files by turning on the ‘Overwrite the file if already exists’ checkbox on the Upload panel See the Upload files section for details.] AWS FilePicker now speaks Portuguese! Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation System requirements AWS FilePicker requires no more resources than an average ASP.Net web control: • Microsoft.Net Framework 1.1+; • Microsoft Internet Information Services; • Visual Studio Net 2003 (not required but recommended for comfortable work); Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Installation The control installs with the help of the installation wizard that extracts and copies all the necessary files and creates the following IIS virtual directories • /FilePicker • /FilePickerDemoVB • /FilePickerDemoCS The first virtual directory (/FilePicker) points to folders containing the file manager part of FilePicker This folder does not have to be virtual for the component to work, but it is necessary for opening the FilePicker source code in Visual Studio.Net The last two directories point to Visual Basic Net and C# versions of the FilePicker demo application, respectively Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Developer’s guide 5.1 Preliminary notes 5.1.1 File system access issues If you not use authentication in your ASP.Net apps, all the file operations performed with AWS FilePicker (browsing, uploading, creating directories, etc) are made on behalf of the ASPNET (if you use IIS 5) or NETWORK SERVICE (if you use IIS 6) user account Generally, it is fine for browsing, but you are likely to get the “permission denied” error if you attempt to upload or delete a file or create a folder This happens because these accounts have insufficient privileges for writing operations To avoid this you should either: Grant the ASPNET (in the case of IIS 5) or NETWORK SERVICE (in the case of IIS 6) user account permission for writing to the folder you selected for uploaded files This is the easiest and most secure method We recommend this for a public web application or if your application resides in a shared web hosting environment Or, Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 10 Authenticate users and give the accounts and/or groups specific access permissions for the upload folder We recommend this for corporate Intranet applications where it is easy to control each user account In this case, you need to implement the Windows authentication for your web app and turn impersonation on in the web.config file () 5.1.2 Known bugs Problem Renaming folders in FilePicker causes loss of session variables if session state mode is set to InProc Comments When session state is set to InProc, (the default setting for session state), session variables are lost when a folder is renamed with the System.IO.Directory.Move() We believe that this is due to a bug in ASP.NET [Note: This error also appeared in previous versions of this component AWS FilePicker 1.x was a completely different file manager and it yielded the same results.] If one changes the session state mode to StateServer (that is, a separate state service is used), everything works fine Solution In order to avoid losing user’s session data while working with FilePicker, you can one of the following: • Use the StateServer or SQLServer session state mode instead of InProc For details on how to it, see the Session State page in the Net Framework SDK documentation (full path to the page: Net Framework SDK -> Building Application -> Creating ASP.NET Web Application -> ASP.NET State Management -> Session State) • Disable renaming in FilePicker Note, however, that disabling the renaming feature will make it impossible to rename both files and folders 5.1.3 Source code compilation Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Note: The name of the new folder will be different depending on the current language of the interface 6.2.4 Renaming To rename a folder or a file, click the Rename button in the Action column A text box will then appear where you can type a new name Have questions or comments? Feel free to contact us: support@awsystems.biz 23 AWS FilePicker 2.1 Documentation 24 To accept the new name, click the green checkmark that appears to the right of it instead of clicking the Rename button To cancel renaming, click the red ‘X’ near the green checkmark As a result, the file or folder will be renamed Note: When you rename a file, you can change its extension (the part after the dot) as well However, if a certain type of files is blocked due to FilePicker security settings, you will not be able use that file extension For example, if the current security settings not accept executables(.exe) or MP3 files (.mp3), you will not be able to give a file exe or mp3 extensions You cannot rename a file “my_file.txt” to “my_file.exe” or “my_file.mp3” 6.2.5 Copying AWS FilePicker allows copying files, folders and combination of both To copy files or folders, select the necessary items and click Copy on the toolbar Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 25 After that, go to the destination folder (the folder you want to copy the files to) and click the Paste button on the toolbar to have the items copied in this folder Hint: If you want to copy all the items in the folder, just click the ’Select/Deselect All’ checkbox located in the column header of the file list All the files and folders will be selected immediately You can also inverse selection (select non-selected items and vice versa) with help of the Reverse Check button on the toolbar Note: If you paste the files into the folder where you copied them from, they will be duplicated 6.2.6 Moving To move the files and/or folder from one location to another, select the items to be copied and click the Cut button on the toolbar Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 26 After that, go to the destination folder (the folder you want to move the files to) and click the Paste button on the toolbar to have the items moved in this folder 6.2.7 Deletion To delete certain folders or files, select the items to be deleted and click the Delete button on the toolbar Before the files are actually deleted, you will be asked to confirm the deletion 6.2.8 Refreshing the view Sometimes you may need to update the screen in order to get actual information about the files and folders It’s easy to with help of the Refresh button on the toolbar Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 27 6.2.9 Reverse check The Reverse Check feature allows you to inverse the selection, that is, to select nonselected items and deselect the selected ones This feature can be useful if you want to select all files in the folder except several of them Without Reverse Check, you would need to select each file, possibly hundreds of them, individually With this feature you need only select the excluded files and simply click Reverse Check to inverse the selection The pictures below illustrates this Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 28 6.2.10 Previewing pictures When working with graphic files, it is often useful to preview the images you’re working with FilePicker can generate thumbnails for many types of images (.JPG, GIF, BMP, PNG, TIFF) making it easier to manage them To turn thumbnail generation on, click the See thumbnails button on the toolbar Click it once again to hide thumbnails Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 29 6.2.11 Uploading files To upload a file to a FilePicker folder on the server, click the Toggle upload panel on the toolbar The upload panel will appear where you can specify the file to be uploaded and set several options which control how upload happens To select a file, click the Browse button and find the file on your computer By default, the file will be selected and the file manager will be closed after the upload is completed If you don’t want to file to be selected automatically, clear the Select the file upon upload checkbox By default, if a file with such name exists, it will not be overwritten and an error message will appear instead If you want to have the file overwritten, check the “Overwrite the file if already exists” checkbox To start upload, click the Upload file button (blue diskette near the Browse button) You can upload as many files at once as you want with help of the Bulk Upload feature of AWS FilePicker See the Bulk file upload section below for details Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 30 6.2.12 Bulk file upload To upload several files at once, the following: Compress the files you wish to upload into a ZIP archive (for example, use WinZip or WinRar archivers); Click the Toggle upload panel to display the upload panel if it is not shown yet Click the Browse button and select the ZIP archive you have just created If you would like the archive to be deleted after it is uploaded and extracted, select the Unzip and delete Zip archive option (see the picture below) If you would like to retain the archive on the server, select the Unzip and retain Zip file option Click the Upload file button (blue diskette near the Browse button) to start upload The archive will be extracted as soon as it reaches the server Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 31 6.2.13 File download To download a file, click the Download file icon in the Actions column 6.2.14 Bulk file download You can download an entire folder with all the files and subfolders in a zip archive Just click the Download entire folder in zip archive icon in the Action column Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Have questions or comments? Feel free to contact us: support@awsystems.biz 32 AWS FilePicker 2.1 Documentation 33 Thanks The idea of this component and a pair of routines inside were inspired by Tim Mackey's Web Based File Manager (www.scootasp.net) This is a very interesting and useful web application Also I'd like to thank Peter Blum (www.PeterBlum.com) who showed how a Real Web Control must be built with his DateTextBox control (unfortunately, no longer available) From that, I borrowed the framework (code for main routines and properties for rendering and pop up) and a few lines of JavaScript code Version 2.0 has been enriched with a very robust file manager developed by Juan López Using the opportunity I want to thank him a lot! Also I’m very thankful to Antonio Geraldo da Rocha Vidal for translation of the user interface of FilePicker into Portuguese Many thanks to the colleagues how has been sending extremely useful feedback: Alfonso Luciano Antonio Geraldo da Rocha Vidal Bryan Andrews Byron Richard Chad Micheal Lawson Cezar Floroiu David Puggie Denis Velikoseltcev Jens Gyldenkærne Clausen Jody Smith Nataliya Popova Robert Achmann Silvia Ilmer Steve Smith Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Yogev Priel Finally, thank you for using AWS FilePicker! Alex Avrutin, a developer of AWS FilePicker Have questions or comments? Feel free to contact us: support@awsystems.biz 34 AWS FilePicker 2.1 Documentation 35 Other components by AW/Systems AWS HTML Producer AWS HTML Wizard AWS HTML Producer is a robust HTML processing component that not only provides advanced HTML template parsing features, but also extracts tabular data from virtually any web site Extract the latest stock indices, currency rates, weather, news and more with a few lines of code! AWS HTML Wizard provides developers with a quick and easy way of designing multi-page web forms Using this component you can implement various registration, order building, data collecting routines in easy for users manner – dividing them in a number of simple steps that the user can go through, i.e as a wizard Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 36 About AW/Systems AW/Systems, LLC (formerly Advanced Web Systems) is an ASP.NET web development and consulting company located in the city of St.-Petersburg on the north-west of Russian Federation We give businesses opportunity to reduce cost of their web development projects by outsourcing them to the professionals of our company Experienced in web technologies Our specialization is web-based business applications We have expertise in developing eCommerce websites, content management and reporting systems, order placement systems and other Also we are skilled in developing software components including Net assemblies and ASP.NET web controls Focused at ASP.NET Our primary technology focus is ASP.NET and a wide range of other technologies and tools by Microsoft Corp which include NET Framework, Windows 2000/2003, SQL Server, BizTalk Server, Windows SharePoint Services, MS Office System and others Professional approach to software development We fully understand importance of productive development process for a project to be successful Therefore in our everyday activity we employ the Microsoft Solution Framework for software development projects and the Base Process for website Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 37 design projects Such applications as MS Project 2003 and MS Windows SharePoint Services let us organize project workflow and project team collaboration Satisfaction guaranteed We are committed to providing the best service level possible We guarantee customer satisfaction by numerous ways: free life-long bug fixes, from to months of free service, considerable discounts for returning clients You can always hope to get help from us if something goes wrong: we will not feel comfortable if our customers experience troubles Competitive rates Our rates are about two times lower than in the United States and Europe Got a web development project? Ask how we can help you: office@awsystems.biz Have questions or comments? Feel free to contact us: support@awsystems.biz ... contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation 14 < /AWS: FilePicker> 5.4 Configuring AWS FilePicker AWS FilePicker has a number of... to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation Have questions or comments? Feel free to contact us: support@awsystems.biz 32 AWS FilePicker 2.1 Documentation 33 Thanks... details.] AWS FilePicker now speaks Portuguese! Have questions or comments? Feel free to contact us: support@awsystems.biz AWS FilePicker 2.1 Documentation System requirements AWS FilePicker