Skip over navigation

Uploading multiple files using WebDAV

Introduction

WebDAV stands for "Web-based Distributed Authoring and Versioning." It is a set of extensions to the HTTP protocol that lets users collaboratively edit and manage files on a remote web server.

Saving files directly to WebDAV (i.e., from within an application, such as Word, Excel, or Internet Explorer) does not work reliably. For best results, save the file to your computer first, and then upload it to your site.

The preferred method of bulk-uploading files to Roxen uses the Import command and a .zip file, as described in the Batch Uploading tutorial.

Warning

Files copied over WebDAV do not maintain their metadata. This metadata includes the title, keyword, description, version history, and associated XSL template file (if applicable). Without this XSL file, an XML file will not render with the website's theme and navigation.

Using WebDAV to copy a file back up to its original location will allow the Roxen CMS to reassociate the original metadata with the changed file. However, if a different location is chosen for the file during a WebDAV copy operation, a brand new file record with blank metadata is created. It is possible to manually recreate this information, but having to do this for an entire site is not practical.

Using Windows Vista

To add a shortcut to your Windows Vista computer that allows you to upload and access files in Roxen using WebDAV:

  1. Via the Windows Start Menu or via the Desktop icon (if displayed), right-click the Computer shortcut.
  2. Select Map Network Drive… from the pop-up menu.
  3. In the "What network folder would you like to map?" dialog that opens up, the pre-selected Drive letter is usually fine.
  4. In the "Folder" field, you need to figure out and enter the WebDAV URL for your particular edit server.
    1. For most users, who are on the “www-dept-edit” instance, enter the following URL 
      https://www-dept-edit.princeton.edu:1443/Main
    2. For other edit instances, look at the URL that you use to edit your site. Then take the https part, and the domain part, and add :1443/Main
      1. Example 1, if you edit your site at https://www-artmuseum-edit.princeton.edu/, then use https://www-artmuseum-edit.princeton.edu:1443/Main
      2. Example 2, if you edit your site at https://deptbedit.princeton.edu/history, then use
        https://deptbedit.princeton.edu:1443/Main
        In this example for the History site, they could also use
        https://deptbedit.princeton.edu:1443/Main/history
  5. Be sure to click on the link "Connect using a different user name" before clicking Finish.
  6. When prompted, enter your NetID (make sure you remove all domain prefixes like “PRINCETON\”) and your password. Due to several bugs in Windows Vista, the login step might need to be repeated several times.
  7. If you continue to receive connect errors, you may need to restart Vista and try again.
  8. After a successful login, click Next
  9. You will likely not want to check the "Reconnect at logon" butto
  10. Click the Finish button
  11. If the connection was successful, a window with folders should open up, and you can navigate to the folder for your website.

You should now be able to drag and drop files and folders between your computer and your site folder. You can also create new folders and delete items.

If you have difficulty dragging and dropping, right-click the file or folder you want to copy, and choose Copy. Then right-click the directory you want to put it in, and choose Paste.

You may need to refresh your browser for the file to appear in your directory in Roxen.

Within the Roxen Content Editor, you will need to commit (publish) any new files and/or directories or Discard Changes for files that were viewed, but not actually changed.

Using Windows 7

The instructions for Windows 7 are almost identical to those for Windows Vista. However, in the "What network folder would you like to map?" dialog (step 3), instead of the  "Connect using a different user name" link, there is a Connect using different credentials checkbox that will allow you to enter your NetID and password after you click the Finish button.

Using Windows XP

To use the Add Network Place Wizard to add a shortcut to your computer that allows you to upload and access files in Roxen using WebDAV:

  1. On the desktop, double-click My Network Places. If icon is not on desktop, check the Start menu.
  2. In the "Network Tasks" pane, click Add a network place.
  3. On the welcome screen, click Next.
  4. Select Choose another network location, and then click Next.
  5. In the "Internet or network address" field, you need to figure out and enter the WebDAV URL for your particular edit server.
    1. For most users, who are on the “www-dept-edit” instance, enter the following URL
      https://www-dept-edit.princeton.edu:1443/Main
    2. For other edit instances, look at the URL that you use to edit your site. Then take the https part, and the domain part, and add :1443/Main
      1. Example 1, if you edit your site at https://www-artmuseum-edit.princeton.edu/, then use
        https://www-artmuseum-edit.princeton.edu:1443/Main
      2. Example 2, if you edit your site at https://deptbedit.princeton.edu/history, then use
        https://deptbedit.princeton.edu:1443/Main
        In this example for the History site, they could also use
        https://deptbedit.princeton.edu:1443/Main/history
  6. Click Next, and when prompted, enter your NetID (make sure you remove all prefixes like “PRINCETON\”) and your password.
  7. After a successful login, click Next
  8. Click Finish

You may now drag and drop files and folders between your computer and the sites to which you just connected. However, you cannot delete items from a site by dragging them to the Recycle Bin on your desktop. To delete an item, right-click it and select Delete.

Using Mac OS X

There is currently no reliable free option for connecting to the Roxen CMS WebDAV servers via Mac OS X. While the Mac operating system can mount the WebDAV file system, attempts to copy files will result in errors. Free file transfer clients like Cyberduck also do not work.

There is a $34 commercial offering from Panic Software, called Transmit, that does transfer files reliably via WebDAV HTTPS. A fully-functional time-limited demo of Panic Transmit is available. Connections for Transmit would be the following (using history on Dept B as the example again):

Server: deptbedit.princeton.edu
User Name: punetid
Password: ••••••••••••••
Initial Path: Main/history
Port: 1443
(•) WebDAV with HTTPS

Transmit 4's “Transmit Disk” feature ("Mount as Disk"), which creates a mounted volume in the Finder for the connected server, is not fully compatible with our Roxen CMS environment, especially when copying over folders. It may create files with "0 bytes.”

screenshot of Transmit with WebDAV connection screen