Accessing templates and web resources via WebDAV

Managed by | Updated 3 years ago.

NOTE: These instructions apply to Funnelback 15.20 or newer.

These instructions detail how to access the template and web resources using various tools.

You can also browse the WebDAV folder structure directly by entering the URL into your browser (note this is read only). e.g. https://localhost:8443/admin-api/file-management/v1/webdav/

See also: Funnelback documentation - Managing templates and web resources using WebDAV

Using Cyberduck

These instructions apply to Cyberduck on Windows and MacOS.

Cyberduck can be downloaded from https://cyberduck.io/

Windows users can skip straight to step 5.

1. Open Cyberduck
2. Click 'Open Connection'

3. Enter the following details

   • Server: <FUNNELBACK_SERVER> (e.g. search.mycompany.com)
   • Port: <FUNNELBACK ADMIN HTTPS PORT> (e.g. 8443)
   • Username: <FUNNELBACK ADMIN INTERFACE USER ID> (e.g. jsmith)
   • Password: <FUNNELBACK ADMIN INTERFACE PASSWORD>
   • Check the 'Add to keychain' option (MacOS only)
4. Click connect. You will receive an error similar to Listing / Directory failed - Unexpected response (501 Method PROPFIND is not defined in RFC 2068 and is not supported by the Servlet API). Please contact your web hosting service provider for assistance. You can ignore this and set up the bookmark as outlined below. This step is purely required to add your password to the keychain.
5. Create a new bookmark by selecting new bookmark from the bookmark menu.
6. The bookmark configuration screen opens. Select WebDAV (HTTPS) from the dropdown menu.

7. Enter the following details into the bookmark configuration screen:

   • Server: <FUNNELBACK_SERVER> (e.g. search.mycompany.com)
   • Port: <FUNNELBACK ADMIN HTTPS PORT> (e.g. 8443)
   • Username: <FUNNELBACK ADMIN INTERFACE USER ID> (e.g. jsmith)
   • Path: /admin-api/file-management/v1/webdav/
8. Save the bookmark
9. Double click on the bookmark to connect to the server. On Windows you will be prompted for a password on your first connection attempt. Ensure you check the save password option before continuing. Mac users won't be prompted (you have already saved the password in your keychain).
10. The file window will display, showing collections at the root. Expanding this will show all the collections that you have access to, with subfolders for each profile, then live and offline views, and then templates and web resources.
11. Navigate to a collection's templates folder (in a preview folder). Right click on the simple.ftl then select edit with from the popup menu and choose a suitable text editor.
12. The file will open in your text editor. You can make changes and save the file in your text editor and the file on the Funnelback server will be updated. Note: when you save a file this way it overwrites the file on the server without creating an automatic backup of the file. Changes will be reflected when viewing the file on the Funnelback server. If you wish to publish the file you will need to do this from the admin interface.
13. Navigate to a web-resources folder, again beneath a preview profile. Create a new folder inside this (select new folder from the menu).
14. Navigate into this folder and add an image file to it.

If you log in to the admin interface you should see the same files existing on the preview profile of the collection you've been modifying via WebDAV.

Using MacOS Finder

1. Open Finder.
2. Select connect to server from the go menu or press Command-K.
3. Enter the path to the WebDAV endpoint into the server address field: https://<FUNNELBACK_SERVER>:<FUNNELBACK ADMIN HTTPS PORT>/admin-api/file-management/v1/webdav/ e.g. https://localhost:8443/admin-api/file-management/v1/webdav/
4. (optional) add to your favourites by clicking the + button.
5. Click connect.
6. Enter your Funnelback administration interface username and password when prompted (optional: select the add to KeyChain option).
7. You should be able to then browse the files and folders located on the Funnelback server via your Finder window.

NOTE: Finder will not let you create any new files in the live folders but will allow you to open the files and edit them. If you try to save a file that is located in the live folder (which is read only) the operation will not succeed and you will not receive any feedback to indicate that it has failed. This means that it will look like the file has saved normally but you will silently lose the changes.

Using Windows File Explorer

1. Right click on 'computer' in the start menu and select map network drive.
2. Enter the path to the WebDAV endpoint into the network location field: https://<FUNNELBACK_SERVER>:<FUNNELBACK ADMIN HTTPS PORT>/admin-api/file-management/v1/webdav/ e.g. https://localhost:8443/admin-api/file-management/v1/webdav/
3. (optional) check the reconnect on logon option if you wish the drive to be auto-mounted on boot.
4. Click connect.
5. Enter your Funnelback administration interface username and password when prompted (optional: select the save password option).
6. You should be able to then browse the files and folders located on the Funnelback server via Windows explorer.