ServiceNow脚本生成自定义Excel文件方法求助

核心原因 #

xls/xlsx是二进制压缩格式，并非csv那样的纯文本文件。你直接将字符串形式的xlsData传入GlideSysAttachment.write()时，系统会按文本编码处理内容，破坏了Excel文件的二进制结构，导致下载后文件损坏。

可行解决方案 #

方案1：用HTML生成兼容Excel的表格（适合简单场景） #

如果只需要生成简单表格，可构造Excel能直接识别的HTML内容，通过指定正确的MIME类型让系统自动转换为合法的xls文件：

var grRec = new GlideRecord("table"); 
grRec.addQuery("sys_id", sys_id); 
grRec.query(); 
if (grRec.next()) { 
  // 构造HTML表格结构
  var excelHtml = `
    <table>
      <tr><th>姓名</th><th>部门</th><th>职位</th></tr>
      <tr><td>张三</td><td>技术部</td><td>开发工程师</td></tr>
      <tr><td>李四</td><td>财务部</td><td>会计</td></tr>
    </table>
  `;
  var grAttachment = new GlideSysAttachment(); 
  // 使用Excel标准MIME类型，系统会自动处理HTML转Excel
  grAttachment.write(grRec, "员工信息.xls", 'application/vnd.ms-excel', excelHtml); 
}

方案2：用GlideExcelBuilder2生成标准xlsx文件（适合复杂场景） #

如果需要生成带样式、多工作表等复杂结构的Excel文件，使用ServiceNow官方提供的GlideExcelBuilder2API，它能直接生成合法的二进制xlsx数据：

var grRec = new GlideRecord("table"); 
grRec.addQuery("sys_id", sys_id); 
grRec.query(); 
if (grRec.next()) { 
  // 初始化Excel构建器
  var excelBuilder = new GlideExcelBuilder2();
  // 创建工作表
  var sheet = excelBuilder.createSheet("员工信息表");
  
  // 设置表头（第1行，索引从0开始）
  sheet.setCell(0, 0, "姓名");
  sheet.setCell(0, 1, "部门");
  sheet.setCell(0, 2, "职位");
  
  // 填充数据行
  sheet.setCell(1, 0, "张三");
  sheet.setCell(1, 1, "技术部");
  sheet.setCell(1, 2, "开发工程师");
  
  sheet.setCell(2, 0, "李四");
  sheet.setCell(2, 1, "财务部");
  sheet.setCell(2, 2, "会计");
  
  // 生成二进制Excel数据
  var excelBinary = excelBuilder.build();
  
  // 附加到记录，使用xlsx标准MIME类型
  var grAttachment = new GlideSysAttachment();
  grAttachment.write(
    grRec, 
    "员工信息.xlsx", 
    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 
    excelBinary
  );
}

关键注意事项 #

• 不要使用application/xls这种非标准MIME类型，xls对应application/vnd.ms-excel，xlsx对应application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
• 禁止直接将纯文本字符串当作xls/xlsx内容传入GlideSysAttachment.write()，必须使用二进制数据或系统认可的转换格式（如HTML）
• GlideExcelBuilder2支持更多高级功能，比如设置单元格样式、合并单元格、冻结窗格等，可根据需求扩展

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