caxlsx/axlsx跨工作表创建数据透视表报undefined method `row'如何解决

首先明确：caxlsx支持跨工作表创建数据透视表，你遇到的报错是由数据源引用方式错误、代码语法疏漏两个问题共同导致的。

错误原因 #

1. 跨表数据源不能直接传入Expenditures!A1:L100这类Excel风格的字符串引用，caxlsx内部解析该格式的跨表引用时存在逻辑缺陷，无法定位到对应的数据源工作表对象，读取行数据时就会抛出undefined method 'row' for nil:NilClass报错。
2. 代码存在两处语法疏漏：
   • 行配置中的ID未加引号，会被识别为未定义常量而非列名字符串
   • data配置的哈希缺少外层大括号，部分版本caxlsx解析时会出现格式错误

解决方法 #

先保存数据源工作表的实例，在定义透视表时手动指定data_sheet属性即可，正确实现代码如下：

# 提前保存数据源工作表的实例
expenditure_sheet = wb.add_worksheet(name: "Expenditures") do |sheet|
  # 原有写入支出数据的逻辑保持不变
  ...  
end
   
wb.add_worksheet(name: "Pivot Table") do |sheet|
  sheet.add_pivot_table 'M4:M4', 'A1:L100' do |pivot_table|
    # 手动指定数据源所属的工作表
    pivot_table.data_sheet = expenditure_sheet
    # 补充ID的引号，修正列名格式
    pivot_table.rows = ['Vendor', 'ID']
    pivot_table.columns = ['Month']
    # 补充data配置的外层大括号，符合规范格式
    pivot_table.data = [{ref: 'Amount', num_fmt: 4}]
    pivot_table.pages = ['Year']
  end
end

额外注意事项 #

确保Expenditures工作表A1:L100区域的首行列名，和透视表配置中用到的Vendor、ID、Month、Amount、Year完全匹配（大小写、空格都需要一致），否则会出现字段找不到的相关报错。

内容的提问来源于stack exchange，提问作者Dan Tappin