SpreadJS结合GCExcel实现跨表格公式的引用

SpreadJS源生不支持跨workbook的公式引用，对一些用户在使用上会造成困扰，对此我们给出了解决方案，利用SpreadJS的自定义函数结合GCExcel后端workbook读取的功能，能够实现跨workbook的公式引用。首先，创建自定义函数中的异步函数，异步函数相较于普通的自定义函数的区别在于，当获取到结果后将会通过异步的方式推送信息至页面，不会占用页面进程导致页面卡顿。在异步函数中发送请求至后端，后端通过GCExcel去跨workbook读取信息。因为需要通过GCExcel在后端实现跨workbook的公式引用取数，所以推荐异步的函数去做。避免网络交互的时间导致页面卡顿影响用户体验
主要代码：

1. var CrossWorkbookFormula = function () {
   
2. };
   
3. CrossWorkbookFormula.prototype = new GC.Spread.CalcEngine.Functions.AsyncFunction("CROSSWORKBOOK", 4, 4,
   
4. {
   
5.     description: "跨表格取数公式",
   
6.     parameters: [{
   
7.         name: "repaortName",
   
8.         repeatable: false,
   
9.         optional: false
   
10.     },
    
11.     {
    
12.         name: "reportMonth",
    
13.         repeatable: false,
    
14.         optional: false
    
15.     },
    
16.     {
    
17.         name: "sheetName",
    
18.         repeatable: false,
    
19.         optional: false
    
20.     },
    
21.     {
    
22.         name: "range",
    
23.         repeatable: false,
    
24.         optional: false
    
25.     }]
    
26. });
    
27. CrossWorkbookFormula.prototype.defaultValue = function () { return '取数中...'; };
    
28. CrossWorkbookFormula.prototype.evaluate = function (context, repaortName, reportMonth, sheetName, range) {
    
29. 
    
30.     var formData = {
    
31.         repaortName: repaortName,
    
32.         reportMonth: reportMonth,
    
33.         sheetName: sheetName,
    
34.         range: range
    
35.     }
    
36.     $.post("spread/getReportRange", formData, function (data) {
    
37.         if (data != undefined && data != null) {
    
38.             context.setAsyncResult(data);
    
39.         }
    
40.         else{
    
41.             context.setAsyncResult("Error");
    
42.         }
    
43.     })
    
44. 
    
45. 
    
46. 
    
47. };
    
48. GC.Spread.CalcEngine.Functions.defineGlobalCustomFunction("CROSSWORKBOOK", new CrossWorkbookFormula());
    

复制代码

GCExcel根据请求中的参数，在后端读取对应的ssjson文件，然后获取里面workbook中对应的数据进行返回。

主要代码：

1. @RequestMapping(value="/getReportRange", method= RequestMethod.POST)
   
2.     public Object getReportDate(@RequestParam(value = "repaortName", required = true) String repaortName,
   
3.                                 @RequestParam(value = "reportMonth", required = true) String reportMonth,
   
4.                                 @RequestParam(value = "sheetName", required = true) String sheetName,
   
5.                                 @RequestParam(value = "range", required = true) String range) {
   
6. 
   
7.         String content = getTextFileContent("reports/" + repaortName + '/' + reportMonth + ".ssjson");
   
8.         Workbook workbook = new Workbook();
   
9.         workbook.fromJson(content);
   
10.         IWorksheet sheet = workbook.getWorksheets().get(sheetName);
    
11.         IRange dataRange = sheet.getRange(range);
    
12.         Object value = dataRange.getValue();
    
13.         return value;
    
14.     }

复制代码

最后通过异步函数的推送将内容推送至页面表格指定单元格中进行显示

1. context.setAsyncResult(data);

复制代码

完整demo如下：
点击跨表格取数按钮，弹出跨表格选择菜单,选择一个workbook进行加载


选择一个单元格的数据后点击选择按钮

之后会创建自定义异步函数，并将该值取到指定单元格