<oXygen/> supports editing remote files, using the FTP and WebDAV protocols. The remote opened files can be edited exactly as the local ones. They can be added to the project, and can be subject to XSL and FO transformations.
![]() | Note |
---|---|
The WebDAV access is implemented using the Slide package of the Apache Software Foundation. The FTP part is using passive access to the FTP servers. Make sure the server you are trying to connect to is supporting passive connections. Also the UTF-8 encoding is supported and can be configured for communication with the FTP server if the server supports it. The FTP/WebDAV capabilities have been extensively tested with various servers running on Windows (IIS), Mac OS X and Linux (Apache). |
![]() | Note |
---|---|
If you have set a proxy server to be used by <oXygen/>, make sure it supports the WebDAV protocol. If it does not, make sure you uncheck the "Use proxy server" from the Options/Preferences/Proxy Configuration pane, otherwise you will not be able to connect to a WebDAV server. |
To open the remote files, choose from the main menu
-> The displayed dialog is composed of three parts.The first one is an editable combo box, in which it can be specified directly the URL to be opened or saved.
![]() | URLs that can be directly opened |
---|---|
You can type in here an URL like http://some.site/test.xml, in case the file is accessible through normal HTTP protocol, or ftp://anonymous@some.site/home/test.xml if the file is accessible through anonymous FTP. |
This combo box is also displaying the current selection when the user changes selection by browsing the tree of folders and files on the server.
The second part is controlling the access credentials. If you want to browse for a file on a server, you have to specify the user and password. This information is bound to the selected URL displayed in the "File URL" combo box, and used further in opening/saving the file. If the check box "Save" is selected, then the user and password are saved between editing sessions. The password is kept encrypted into the options file.
![]() | Note |
---|---|
Your password is well protected. In the case the options file is moved to another installation, on other machine, the password will become unreadable, since the encryption is user and machine dependent. This is also true if you add URLs having user and password to your project. |
The third part contains the server combo and the "Autoconnect" check box. Into the server combo it may be specified the protocol (HTTP, HTTPS or FTP), the name or IP of the server and, in case of WebDAV, the path to the WebDAV directory.
![]() | Server URLs | ||||
---|---|---|---|---|---|
When accessing a FTP server, you need to specify only the protocol and the host, like: ftp://server.com, ftp://ftp.apache.org, or if using a nonstandard port: ftp://server.com:7800/ etc. When accessing a WebDAV server, along with the protocol and the host, it must be specified also the directory of the WebDAV repository.
Ex: https://www.some-webdav-server.com:443/webdav-repository/, http://devel:9090/webdav/ |
By pressing the "Browse" button the directory listing will be shown in the component bellow. When "Autoconnect" is selected then at every time the dialog is shown, the browse action will be performed.
The last part consists of a tree view of the documents stored on the server. You can browse the directories, and make multiple selections. Additionally, you may use the "Rename", "Delete", and "New Folder" to manage the file repository.
Some FTP servers allow the modification of file permissions on the filesystem for the files that they serve over the FTP protocol. This feature of the protocol is accessible directly in the FTP/WebDAV file browser dialog by right-clicking on a tree node and selecting the Change permissions menu item which brings up the following dialog:
The usual Unix file permissions Read, Write and Execute are granted or denied in this dialog for the owner of the file, the group of the owner and the rest of the users. The aggregate number of the current state of the permissions is updated in the Permissions text field when a permission is modified with one of the check boxes.