Uploading documents

BSCW lets you upload a local file to a folder as a document on the BSCW server. If you use a Web browser with integrated file uploading functionality (e.g. Mozilla Firefox, Microsoft Internet Explorer or Apple’s Safari), you need no additional software to upload documents.

If you have to upload large documents or a great number of documents regularly, you should consider using one of the BSCW upload helpers available (for details see 13.5 BSCW upload helpers).

For uploading files via your browser,

      select  File    New    Document  to display the ‘Upload Docu­ment’ form, which has three sec­tions ‘General’, ‘Auto-Versioning’ and ‘Attributes’.

      In the ‘General’ section you may select a file from your local file system, using the usual ‘Open file’ dialog. The directory path and the name of the file you select are auto­matically copied into the form. The name will be used by BSCW as the document name unless you enter a different name in the ‘Name’ field. Choose a telling docu­ment name, so the other members of the work­space will know what the document is about.

Special characters in the document name like accents or umlauts should be avoided when you plan to cooperate across different platforms, e.g. Windows and Macintosh. The file extension used to indicate the file type on some platforms should be kept in the document name, be­cause it facilitates the recognition of the file type when the do­cu­ment is downloaded again by other members of the workspace: the BSCW docu­ment name is the default local file name!

      You may enter freely chosen keywords in the ‘Tags’ field to characterize the new documents. These tags may be used in searches. Several tags are separated by blanks. There is no dis­tinc­tion between upper and lower case in tags.

      In the ‘Description’ field you may enter a description of the document’s contents or instruc­tions for its use.

      You may provide an assessment of the docu­ment’s qua­li­ty by selecting one of the ratings offered. You may also rate the document later or change your rating using action  Change    Rate . BSCW shows all ratings in the document’s info page; the median of all ratings is shown as an icon in the ‘Rating’ column of the document entry (with only two ratings, the average rating is taken).

      In addition, you may specify the MIME type of the document (stan­dardized desig­nation of a file type on the Internet). In general, Web browsers and BSCW up­loaders will detect the correct MIME type and attach it to the document automatically. Some­times, however, it may be necessary to select the correct MIME type explicitly. Simi­lar­ly, a possible encoding ap­plied to the file is detected correctly in most cases. Occasionally you may need to specify the encoding in the respective field. You may change MIME type and encoding later on, using action  Change    Properties  in the action menu of the document.

      The section ‘Auto-Versioning’ will only appear if you are to become the owner of the new document, i.e. if you are the owner of the folder in which the new document is created. In this section, you may enter the versioning options for the new document that may differ from the automatic versioning options valid for the current folder. For further details see 8.3.6 Automatic versioning.

      In the section ‘Attributes’ you may specify metadata attributes for the new document. These attributes may also be used in searches. The first set of attributes is predefined: the key and re­cipient attributes are used for encryption and the DC-attributes for docu­ment classi­fication according to the Dublin Core (see 3.9.1 Metadata attributes). With these at­tributes you may add further values by clicking on the add icon add. The category and priority attributes are indicated in folder listings in which the document appears, when the respective columns are activated via  View    Columns  in the top menu.

      You may also define your own attributes by giving name and value of the attribute. Add more attributes by clicking on [New attribute]. Delete attributes already entered by deleting the name. Also user-defined attributes may be used in searches.

      Hit [OK] to finally upload the new document.

You may change all the information you entered about the new document by selecting action  Change    Properties  in the action menu of the document, which uses the same action form as the uploading action above.

After uploading, an additional PDF presentation of the new document may be generated if con­version to PDF has been configured for the document’s MIME type on your BSCW ser­ver.

      Select action  Change    Properties  in the action menu of the document.

      In section ‘General’, unfold the ‘MIME type’ field if not unfold already.

      Check the check box ‘Generate a PDF presentation for the document’ and confirm with [OK].

The PDF representation of a document is maintained along with the original document within BSCW. Whenever you click on the document name in a folder listing, this PDF representation is shown. When you, however, use action  Open  or action  Change    Edit  in the action menu of the document, you get the original document in the appropriate application or for download. The PDF repre­sentation may be revoked by unchecking the respective check box again.

Attention: If you upload a document to a folder, that already contains a document with the same name and the same MIME type, the existing document is replaced by the uploaded docu­ment. To prevent overwriting of a document

      select action  Access    Set Lock  in the action menu of the document to set a (re­mov­able) lock.

If a document is under version control it cannot be overwritten by uploading a document with the same name and MIME type; instead, a new version of the docu­ment is created.

Note: When you upload documents to a shared workspace that you do not own, the uploaded do­cuments will belong to the owner of the workspace and not to you, the creator. The disk space used by these documents is added to the disk quota of the workspace owner. When disk space control (‘quota system’) has been activated for your BSCW server, the upload of large do­cuments by members of a workspace may lead to prob­lems for the owner (violation of the disk space limit). Because workspace owners are in general also workspace managers, they can of course destroy large documents, should problems arise. If disk space control is ac­ti­vat­ed for your BSCW server, select  File    Info  in the top menu of your home folder to inspect the disk space used by all objects that you own.