本文档旨在指导用户如何使用 Google Apps Script 编写脚本，以实现对 Google Sheets 中两列数据（支票号码和金额）的核对功能。该脚本能够识别支票号码不一致、支票号码相同但金额不一致的情况，并输出相应的日志信息，帮助用户快速发现并纠正数据错误。
支票号码和金额核对脚本详解
本教程将详细介绍如何使用 Google Apps Script 编写一个用于核对支票号码和金额的脚本。该脚本可以帮助你快速识别两份数据中不一致的支票信息，提高数据处理效率。
1. 脚本结构
首先，我们需要了解脚本的整体结构。脚本主要分为以下几个步骤：
- 获取工作表和数据范围： 从 Google Sheets 中获取需要比较的两个工作表，并确定包含支票号码和金额的数据范围。
- 循环遍历数据： 遍历其中一个工作表的数据，并与另一个工作表的数据进行比较。
- 比较支票号码和金额： 判断支票号码是否一致，如果一致，则进一步比较金额是否一致。
- 记录不一致的信息： 如果发现支票号码或金额不一致，则记录相关信息，例如行号和错误类型。
- 输出结果： 将所有不一致的信息输出到日志中，供用户查看。
2. 脚本代码
以下是一个示例脚本，可以实现上述功能：
function CHK_BothChecks_V3() {
// 获取当前工作簿
const ss = SpreadsheetApp.getActive();
// 获取两个工作表，分别命名为 "OpenCheckDataBase" 和 "IncomingChecks"
const sh1 = ss.getSheetByName("OpenCheckDataBase");
const sh2 = ss.getSheetByName("IncomingChecks");
// 获取两个工作表中包含支票号码和金额的数据范围
// C1:D" + sh1.getLastRow() 获取C列和D列所有数据
var rg1 = sh1.getRange("C1:D" + sh1.getLastRow()).getValues();
var rg2 = sh2.getRange("C1:D" + sh2.getLastRow()).getValues();
// 初始化计数器，用于记录匹配的支票数量、无效的支票数量和无效的金额数量
var correctChecks = 0;
var invalidChecks = 0;
var invalidAmounts = 0;
// 循环遍历第一个工作表中的数据
for (var i = 0; i < rg1.length; i++) {
// 比较两个工作表中对应行的支票号码是否一致
if (rg1[i][0] == rg2[i][0]) {
// 如果支票号码一致，则增加匹配的支票数量
correctChecks++;
} else if (rg1[i][0] !== rg2[i][0]) {
// 如果支票号码不一致，则增加无效的支票数量，并记录行号
var index = sh1.getRange(i + 1, 2).getRow();
invalidChecks++;
console.log("Row " + index + " has an inconsistent check number");
}
}
// 输出统计结果
console.log("Total number of valid check numbers is " + correctChecks);
console.log("Total number of invalid check numbers is " + invalidChecks);
console.log("Total number of invalid amounts is " + invalidAmounts);
}3. 代码解释
- SpreadsheetApp.getActive(): 获取当前激活的 Google Sheets 工作簿。
- getSheetByName(sheetName): 根据名称获取工作表。
- getRange(range): 获取指定范围的数据。"C1:D" + sh1.getLastRow() 表示获取 C 列和 D 列的所有数据，直到最后一行。
- getValues(): 获取范围内的所有数据，以二维数组的形式返回。
- console.log(): 将信息输出到 Google Apps Script 的日志中。
4. 脚本优化
上述脚本只实现了支票号码的核对，没有实现金额的核对。为了完善脚本功能，我们需要添加金额比较的逻辑。以下是一个改进后的脚本：
function CHK_BothChecks_V3() {
const ss = SpreadsheetApp.getActive();
const sh1 = ss.getSheetByName("OpenCheckDataBase");
const sh2 = ss.getSheetByName("IncomingChecks");
var rg1 = sh1.getRange("C1:D" + sh1.getLastRow()).getValues();
var rg2 = sh2.getRange("C1:D" + sh2.getLastRow()).getValues();
var correctChecks = 0;
var invalidChecks = 0;
var invalidAmounts = 0;
// 将rg2的数据存储到Map中，方便查找
let checkMap = new Map();
for (let i = 0; i < rg2.length; i++) {
checkMap.set(rg2[i][0], rg2[i][1]);
}
for (var i = 0; i < rg1.length; i++) {
let checkNumber = rg1[i][0];
let amount = rg1[i][1];
// 检查checkNumber是否存在于rg2中
if (checkMap.has(checkNumber)) {
// 检查金额是否一致
if (checkMap.get(checkNumber) === amount) {
correctChecks++;
} else {
invalidAmounts++;
console.log("Row " + (i + 1) + " has an inconsistent check amount");
}
} else {
invalidChecks++;
console.log("Row " + (i + 1) + " has an inconsistent check number");
}
}
console.log("Total number of valid check numbers is " + correctChecks);
console.log("Total number of invalid check numbers is " + invalidChecks);
console.log("Total number of invalid amounts is " + invalidAmounts);
}改进说明：
- 使用 Map 对象存储 rg2 的数据，提高查找效率。
- 首先检查 rg1 中的支票号码是否存在于 rg2 中。
- 如果支票号码存在，则比较金额是否一致。
- 根据比较结果，输出相应的日志信息。
5. 使用注意事项
- 确保两个工作表都存在，并且名称正确。
- 确保支票号码和金额位于 C 列和 D 列。
- 根据实际情况调整数据范围。
- 运行脚本后，可以在 Google Apps Script 的日志中查看结果。
6. 总结
通过本教程，你学习了如何使用 Google Apps Script 编写一个用于核对支票号码和金额的脚本。该脚本可以帮助你快速识别两份数据中不一致的支票信息，提高数据处理效率。你可以根据实际需求，对脚本进行修改和优化，使其更好地满足你的工作需求。
