在OCIS中自定义新建文档格式选项的配置方法

2025-07-10 00:45:22作者：钟日瑜

在OCIS协作服务器的使用过程中，管理员可能会遇到需要定制化"新建"按钮下拉菜单中显示的文档格式选项的需求。本文将详细介绍如何通过配置app-registry.yaml文件来实现这一功能。

应用场景分析

在实际部署环境中，不同组织对文档格式有着不同的偏好和要求。有些组织可能完全使用Microsoft Office格式（如.docx、.xlsx等），而有些则可能偏好开放文档格式（ODF，如.odt、.ods等）。OCIS提供了灵活的配置机制，允许管理员根据实际需求定制这些选项。

配置原理

OCIS通过app-registry服务管理所有可用的文档类型及其相关配置。该服务会读取app-registry.yaml配置文件，根据其中的定义来决定哪些文档类型应该显示在用户界面上，以及它们的显示顺序。

具体配置方法

定位配置文件：在OCIS部署目录中找到config/ocis/app-registry.yaml文件
编辑mime类型配置：在配置文件中，可以找到类似以下结构的配置项：

mime_types:
  - mime_type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
    extension: .docx
    name: Microsoft Word 文档
    description: 创建新的Word文档
    icon: file-word
    allow_creation: true
    default_application: onlyoffice

关键配置参数说明：
- mime_type: 文档的MIME类型标识
- extension: 文件扩展名
- name: 显示在界面上的名称
- allow_creation: 是否允许通过"新建"按钮创建
- default_application: 默认使用的编辑器
排序控制：配置文件中定义的顺序即为界面显示顺序，可以通过调整条目位置来改变显示顺序

典型配置示例

如果只需要显示Microsoft Office格式，可以保留以下类型并移除ODF相关配置：

mime_types:
  - mime_type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
    # Word配置...
  - mime_type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
    # Excel配置...
  - mime_type: application/vnd.openxmlformats-officedocument.presentationml.presentation
    # PowerPoint配置...