WebDAV

The main purpose of the WebDAV add-on is to give access to files located in the file storage through the WebDAV protocol. This allows users to seamlessly open and edit files using their desktop applications (Word, Excel, LibreOffice, etc.) without the need to download and upload files to the web application.

The add-on provides the following additional features:

  • Document version control. If the versioning is enabled for a document, a new version of the document is created on the server each time the document is updated.

  • Configurable conflict resolution policies that help in collaborative work on documents.

  • Granting and restricting access to certain documents.

  • UI components to work with files and versions.

  • Access to files from external systems using static links.

Installation

This add-on requires the Enterprise subscription. If you don’t have the subscription, see how to get the trial version below.

For automatic installation through Jmix Marketplace, follow instructions in the Add-ons section.

For manual installation, follow the steps below.

  1. Configure access to the premium repository.

    • Добавьте премиум-репозиторий в свой build.gradle:

      repositories {
          // ...
          maven {
              url = 'https://global.repo.jmix.io/repository/premium'
              credentials {
                  username = rootProject['premiumRepoUser']
                  password = rootProject['premiumRepoPass']
              }
          }
      }
    • Добавьте учетные данные премиум-репозитория в ~/.gradle/gradle.properties:

      premiumRepoUser=123456123456
      premiumRepoPass=abcdefabcdef

      Получите учетные данные репозитория из вашего лицензионного ключа: первая часть ключа перед тире – это имя пользователя репозитория, часть после тире – пароль. Например, если ваш ключ выглядит как 123456-abcdef abcdef, имя пользователя – 123456, а пароль – abcdef abcdef.

  2. Add dependencies to your build.gradle:

    implementation 'io.jmix.webdav:jmix-webdav-starter'
    implementation 'io.jmix.webdav:jmix-webdav-rest-starter'
    implementation 'io.jmix.webdav:jmix-webdav-ui-starter'

Trial Version

You can get a trial version of the add-on by visiting the add-on page on the Jmix Marketplace website.

Пробная версия дополнения доступна в течение 28 дней после первого запроса. Ее можно установить и использовать в тестовом проекте в течение этого периода.

По истечении пробного периода приложение, использующее дополнение, запускаться не будет.

Пробные дополнения можно использовать только с последней версией фреймворка Jmix. Мы рекомендуем создавать новый тестовый проект и устанавливать пробное дополнение в него.

HTTPS

Desktop applications use basic authentication when connecting to the server through WebDAV, so you have to setup HTTPS for your web application. See Configuring HTTPS for an example of setting up HTTPS on localhost for development purposes.

Minimal Requirements

The minimum version of Microsoft Office required for opening documents via the WebDAV protocol is MS Office 2010 SP2 or higher. The minimum version of LibreOffice is 6.3.

To check which versions of Microsoft Office and Service Pack (SP) are installed on your computer, launch MS Word and open the Product Information section from File → Help. Service Pack 2 for MS Office 2010 (and later versions) should have the following number: 14.0.7015.1000 (or greater). To update your Service Pack, follow this link.