「脚本」小程序

脚本小程序是维格表推出的扩展功能，支持在线编程和表格交互数据，借助于这一能力，你可以快速地完成各种重复的工作，大幅度提高工作效率。

官方小程序 开源

• 用不到 30 行的代码完成一个支持指定字段查找替换的小程序
• 根据自定义的规则校验表格内的数据，例如验证邮箱是否合法、找出符合规则的身份证号或手机号
• 快速调用任意 API，支持 GET、POST 等各种方法
• ...

⚡️ 面向日常工作生活中各种重复和繁杂的任务，脚本都可以更快地完成代码编写，从而实现快速交付！

🧐 同时对于刚上手编程技能的开发者也非常友好，只需要熟悉 JavaScript 的编写和拥有一个 浏览器 即可快速开始！

安装「脚本」小程序​

打开一张维格表，点击右侧的「小程序」按钮展开「小程序面板」，然后点击「添加小程序」按钮。

在出现的「小程序中心」中找到「脚本」小程序并安装。

如何使用「脚本」小程序​

「脚本」小程序总共分为四个功能区：

• 代码编辑区：编写修改代码的主要区域，支持代码智能提示
• 文档区：用于展示脚本 API 的相关文档内容，无需切换页面即可查看
• 预览区：用于展示脚本的标准化 UI
• 控制台：用于打印脚本运行时的信息，例如 Console.log() 的打印内容

示例​

下面是一段简单的示例代码，支持在指定列中查找并替换指定的文本

const findText = await input.textAsync('请输入想查找的文本:');const replaceText = await input.textAsync('想替换查找文本为：');// 需要通过 Space API 获取当前激活的表格，并作为一个参数传入到 input.fieldAsyncconst datasheet = await space.getActiveDatasheetAsync();const field = await input.fieldAsync("请选择想要查找的维格列名", datasheet);// 获取维格列的 idconst fieldId = field.id;const records = await datasheet.getRecordsAsync();const finalData = [];// 遍历 recordsfor (let record of records) {  const recordId = record.id;  // 获取 record 指定 field 的数据为 cellValue  const cellValue = record.getCellValueString(fieldId);  // 如果获取的数据为空，则跳出此次循环，直接执行下一次  if (cellValue == null) continue;  // 替换 cellValue 中的 findText 为 replaceText，并使用新的变量——newCellValue  const newCellValue = cellValue.replaceAll(findText, replaceText);  // 判断替换前的数据是否和替换后的数据一致  if (cellValue !== newCellValue) {    // 不一致则代表表格内对应记录需要用 newCellValue 替换 cellValue，需要将数据加入到 finalData 数组中    finalData.push({      id: recordId,      valuesMap: { [fieldId]: newCellValue }    })  }}// 判断 finalData 里面是否有数据，没有数据则无需替换if (finalData.length) {  await datasheet.updateRecordsAsync(finalData);  output.text('替换完成！')} else {  output.text('没有找到需要替换的数据')}

最终效果如下：

如果你想要获取更多示例或者了解如何通过「脚本」小程序进行开发，可以到我们的开发者中心查看相关文档。