WebDAV

WebDAV 扩展组件的主要功能是通过 WebDAV 协议 访问位于 文件存储 的文件。支持用户使用本地桌面应用程序（Word，Excel，LibreOffice 等）方便地打开和编辑文件，而无需从 Web 应用下载和上传。

该组件还提供下列附加功能：

  • 文档版本控制。每次更新文档时，都会在服务器创建文档的一个新版本。

  • 可自定义的冲突解决策略，支持文档协作编辑。

  • 可以控制文档的访问权限。

  • 管理文件和版本的 UI 组件。

  • 使用静态链接从外部系统无缝访问文件。

安装

此扩展组件需要企业版 订阅。如果没有企业版订阅，可以按照 企业版试用 介绍的方法试用。

请按照 扩展组件 章节的介绍通过 Jmix 市场自动安装。

手动安装步骤：

  1. 配置 premium 仓库的访问：

    • 在 build.gradle 添加 premium 仓库：

      repositories {
    // ...
    maven {
        url = 'https://global.repo.jmix.io/repository/premium'
        credentials {
            username = rootProject['premiumRepoUser']
            password = rootProject['premiumRepoPass']
        }
    }
}

    • 将 premium 仓库的凭证记录在 ~/.gradle/gradle.properties 文件中：

      premiumRepoUser=123456123456
premiumRepoPass=abcdefabcdef

      仓库的凭证可以通过许可秘钥获取：秘钥中短横前的部分为用户名，短横后的部分为密码。例如，如果你的秘钥是 123456123456-abcdefabcdef，则用户名是：123456123456，密码是 abcdefabcdef。

  2. 在 build.gradle 中添加依赖：

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

应用程序使用单一菜单模式

如果你的应用程序使用的是 单一菜单模式，需要在扩展组件安装完成后手动添加菜单项。

  1. 在 Jmix Studio 中打开 菜单设计器。

  2. 切换至 Structure 标签页。

  3. 左侧面板显示可用的菜单项。

    add menu items

  4. 添加菜单项：

    • 左侧选择需要添加的菜单项后，点击 > 按钮添加至右侧。

    • 或者也可以直接从左侧拖拽菜单至右侧结构中。

当应用程序是 单一 菜单模式时，Studio 不会自动合并组件的菜单，因此必须手动执行该步骤。

HTTPS

桌面 Office 应用程序通过 WebDAV 连接服务时使用基本认证方式，因此需要为 Web 应用程序配置 HTTPS。参阅 配置 HTTPS 章节，了解如何在 localhost 配置 HTTPS 用于开发测试。

要求

由于 Microsoft 365 应用程序最近禁用了基本认证（参阅 https://learn.microsoft.com/en-us/microsoft-365-apps/security/basic-authentication-prompts-blocked），WebDAV 无法兼容 Microsoft Office 的最新版本。

能通过 WebDAV 协议打开文档的最低版本 Microsoft Office 需要是 MS Office 2010 SP2。LibreOffice 要求的最低版本是 6.3。

如需检查 Microsoft Office 和 Service Pack（SP） 的版本，打开 MS Word，从 File → Help 菜单打开 Product Information。MS Office 2010 SP2（或以上版本）会显示 14.0.7015.1000（或更高版本号）。如需升级 Service Pack，请访问 微软文档。