Confluence的Excel插件Elements Spreadsheet安装

背景

Confluence是现在广泛使用的团队协作文档系统。虽然自身带了一些表格编辑功能,但表格的整体功能较弱,比如不能通过Excel文件进行导入导出,表格在复制到Excel时格式会比较奇怪等等。对于未完全整合流程到Confluence上的团队,信息从Excel到在线文档系统的流转是个巨大的工作量。

介绍

Elements Spreadsheet作为Confluence的插件可以有效的解决上面的部分问题,通过这个插件可以接近完美导入导出Excel到Confluence系统中(试了Excel太大的话会莫名其妙的编辑中崩溃),Excel文档可以完美嵌入到Confluence的网页中,同时支持在线编辑与占用提示,公式等等功能,参考Confluence的介绍与文档。Elements Spreadsheet for Confluence | Atlassian Marketplace

安装步骤

整个安装步骤参考Confluence安装Drawio插件 - MrHeartTired (ltang.me)

  1. 首先在官方链接下载当前版本支持的插件。(前面的官方链接进入Version页面选择)

  2. 其次,再IDE(Idea)中新建如下文件与对应的包目录:

AbstractSpreadsheetRestService.java文件与对应的包目录。

java 复制代码
package com.valiantys.software.spreadsheets.rest;  
  
import com.atlassian.upm.api.license.PluginLicenseManager;  
import com.valiantys.software.spreadsheets.rest.model.ErrorModel;  
import com.valiantys.software.spreadsheets.service.error.ErrorType;  
import com.valiantys.software.spreadsheets.service.error.SpreadsheetError;  
  
import javax.servlet.http.HttpServletRequest;  
import javax.ws.rs.core.Response;  
import javax.ws.rs.core.Response.Status;  
  
public abstract class AbstractSpreadsheetRestService {  
    public static final String ATLASSIAN_DEV_MODE = "atlassian.dev.mode";  
    private final PluginLicenseManager pluginLicenseManager;  
  
    protected AbstractSpreadsheetRestService(PluginLicenseManager pluginLicenseManager) {  
        this.pluginLicenseManager = pluginLicenseManager;  
    }  
  
    protected boolean isLicenseValid() {  
        return true;  
    }  
  
    private boolean isDevMode() {  
        String devMode = System.getProperty("atlassian.dev.mode");  
        return Boolean.parseBoolean(devMode);  
    }  
  
    protected ErrorModel toErrorModel(SpreadsheetError error) {  
        return new ErrorModel(error.getMessage());  
    }  
  
    protected Response toResponse(SpreadsheetError error) {  
        ErrorType type = error.getType();  
        if (type == ErrorType.DATA_CONVERSION_ERROR) {  
            return Response.status(Status.BAD_REQUEST).entity(new ErrorModel(error.getMessage())).build();  
        } else if (type == ErrorType.FORBIDDEN) {  
            return Response.status(Status.FORBIDDEN).entity(new ErrorModel(error.getMessage())).build();  
        } else if (type == ErrorType.MISSING_DATA) {  
            return Response.status(Status.NOT_FOUND).entity(new ErrorModel(error.getMessage())).build();  
        } else {  
            return type == ErrorType.INVALID_REQUEST ? Response.status(Status.BAD_REQUEST).entity(new ErrorModel(error.getMessage())).build() : Response.status(Status.INTERNAL_SERVER_ERROR).entity(new ErrorModel(error.getMessage())).build();  
        }  
    }  
  
    protected String getCharset(HttpServletRequest request) {  
        String characterEncoding = request.getCharacterEncoding();  
        return characterEncoding == null ? "UTF-8" : characterEncoding;  
    }  
}

ErrorModel文件与对应的包目录

java 复制代码
package com.valiantys.software.spreadsheets.rest.model;  
  
public class ErrorModel {  
  
    private String message;  
  
    public ErrorModel() {  
    }  
  
    public ErrorModel(String message) {  
        this.message = message;  
    }  
  
    public String getMessage() {  
        return this.message;  
    }  
  
    public void setMessage(String message) {  
        this.message = message;  
    }  
}

ErrorType文件与对应的包目录

java 复制代码
package com.valiantys.software.spreadsheets.service.error;  
  
public enum ErrorType {  
    DATA_CONVERSION_ERROR,  
    FORBIDDEN,  
    INVALID_REQUEST,  
    INTERNAL_ERROR,  
    MISSING_DATA;  
  
    private ErrorType() {  
    }  
}

SpreadsheetError文件与对应的包目录

java 复制代码
package com.valiantys.software.spreadsheets.service.error;  
  
import javax.ws.rs.core.Response;  
  
public class SpreadsheetError {  
    private ErrorType type;  
    private String message;  
  
    public SpreadsheetError() {  
    }  
  
    public SpreadsheetError(ErrorType type) {  
        this.type = type;  
    }  
  
    public SpreadsheetError(ErrorType type, String message) {  
        this.type = type;  
        this.message = message;  
    }  
  
    public static SpreadsheetError build(ErrorType type) {  
        return new SpreadsheetError(type);  
    }  
  
    public static SpreadsheetError build(ErrorType type, String message) {  
        return new SpreadsheetError(type, message);  
    }  
  
    public ErrorType getType() {  
        return this.type;  
    }  
  
    public void setType(ErrorType type) {  
        this.type = type;  
    }  
  
    public String getMessage() {  
        return this.message;  
    }  
  
    public void setMessage(String message) {  
        this.message = message;  
    }  
  
    public String toString() {  
        return "Error " + this.type.name() + ": " + this.message;  
    }  
  
    public Response build() {  
        return null;  
    }  
}

这一步中只有第一个AbstractSpreadsheetRestService编译出来的的class文件是需要的,其他只是为了解决编译报错。

  1. 在刚安装的jdk环境下,以下两个包会提示找不到,这两个包理论上是可以直接导入的
java 复制代码
import javax.ws.rs.core.Response;  
import javax.ws.rs.core.Response.Status;  

但是由于我对java不太熟悉,java环境都是新装的,所以这两个包我也是按步骤1的方式,补的文件用来编译。

Response文件与对应的包目录。

java 复制代码
  
package javax.ws.rs.core;  
  
import java.lang.annotation.Annotation;  
import java.net.URI;  
import java.util.Date;  
import java.util.Iterator;  
import java.util.List;  
import java.util.Locale;  
import java.util.Map;  
import java.util.Set;  
  
public abstract class Response {  
    protected Response() {  
    }  
  
    public static ResponseBuilder status(Status status) {  
        return  null;  
    }  
  
    public interface StatusType {  
  
    }  
  
    public enum Status implements Response.StatusType {  
  
        BAD_REQUEST,  
        FORBIDDEN,  
        NOT_FOUND,  
        INTERNAL_SERVER_ERROR,  
  
    }  
}

ResponseBuilder文件与包目录。

java 复制代码
package javax.ws.rs.core;  
  
import com.valiantys.software.spreadsheets.rest.model.ErrorModel;  
import com.valiantys.software.spreadsheets.service.error.SpreadsheetError;  
  
public class ResponseBuilder {  
  
    public SpreadsheetError entity(ErrorModel errorModel) {  
        return  null;  
    }  
}

不要在意具体的代码逻辑与包关系,目的只是为了编译AbstractSpreadsheetRestService.class。同样PluginLicenseManagerLicenseService也需要像参考文章一样补出,这里由于没有代码就不列出来了。

替换与安装

文件编辑完成后,使用7z打开elements-spreadsheet.obr文件,替换AbstractSpreadsheetRestService.class文件并保存。然后按参考文章的方式上传到Confluence安装即可(使用管理员账号登录confluence,找到插件管理 -> 上传插件 -> 选择修改后的obr包,点击上传)。安装成功后,虽然显示试用,但是这时候就已经可以在Confluence中导入并保存Excel文件了,真实的试用状态下Excel导入后是无法保存的。到此安装完成,可以尽情在网页中编辑Excel了。