维格小程序 - Excel追加导入

可以从 .xlsx .csv .xls 文件追加导入更多数据

📄 使用指南

导入文件的首列标题需要和被导入的维格表内的列标题一致，示例如下：

模板示例：https://vika.cn/share/shrzWKKTvijSdqyE0EAlB/fodFCh1bgBuhe

需要注意的是：

• 不支持导入计算字段，“计算字段”的意思是，不允许用户主动写入值的字段类型。（比如：自增数字、公式、神奇引用、修改时间、创建时间、修改人、创建人）
• 不支持导入附件、成员、神奇关联字段
• 由于 SDK 的限制，单多选暂时不支持导入新选项（PS：导入多选列时，多个选项需要用 "," 符号分隔）
• 导入的文件里如果含有日期字段，格式需要为：YYYY-MM-DD hh:mm:ss 或 YYYY/MM/DD hh:mm:ss
• 不可在仪表盘使用
• 使用 Excel 或 WPS 生成的文件进行导入，才能得到最佳体验

数字与货币导入

数字、货币和评分字段支持真正的数值，以及 28,800.00、$1,200.50、-1,200.50、1.2e3 等文本格式。空白单元格保持为空，数值 0 不会被清空。

如果存在无法解析的数字或金额，导入会在写入任何记录之前停止，并提示单元格地址、行号和字段名，不再将错误数据静默写成空值。文本和账号字段的处理不变；账号应使用文本字段。

验证与发布

运行测试需要 Node.js 18 或更新版本。在 Windows 下执行：

npm.cmd ci --ignore-scripts
npm.cmd test
npm.cmd run typecheck

测试覆盖 .xlsx、.xls、.csv 文件的读取和导入入口，使用模拟的 SDK 写入接口，不操作线上数据。发布仍通过原有的 npm.cmd run release，需要另行安装 widget-cli 并具备对应小程序的发布权限。

本地修复与测试不会更新线上小程序，也不会恢复已导入的空值。发布后补录已有记录时，请避免重复追加整份文件。

🎯 更新日志

• 2022年3月21日 补充只读权限下的处理
• 2022年3月20日 补充空数据的判断
• 2022年3月17日 修复多选字段导入问题 && 修复undefined问题 && 优化获取数字的正则，加入评分字段判断
• 2022年3月14日 优化百分比字段的导入
• 2022年3月10日 增加大数量下导入的提示 && 针对大数据下的导入进行初步优化
• 2022年3月9日：改进报错提醒 && 兼容货币符号的导入 && 针对大数据下的导入进行初步优化
• 2022年2月28日：发布首个版本

🌈 动手党的天堂

如果你是一名编程人员或者是对开发维格小程序感兴趣的爱好者，欢迎访问GitHub的项目库，👉 Github-widget-import-from-excel。

如果你在开发小程序的过程中遇到阻碍，希望得到更多的帮助与启发，或者想要学习一下其他开发者的作品，欢迎访问维格官方的项目宝藏库，👉 Github：awesome-vikadata。

PS：如果你也有关于维格表小程序的项目开源，欢迎给我们提交PR，我们会将优秀作品收录到官方宝藏库，独乐乐不如众乐乐😍😍😍