在Google Apps脚本中定义多个范围

Question

我在GAS中定义多个范围时遇到困难。

我需要执行以下简单功能：

var dataRange = sheet.getRange(checkRange);
var values = dataRange.getValues();
for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j] == false) {
      values[i][j] = true; 
    }
  }
}
dataRange.setValues(values);

我的范围实际上是由另一个函数定义的：

var checkRange = [];

  for(var i = 0; i<checkboxes.length; i++) {
  if(checkboxes[i]) {

  checkRange.push('C' + (i+9));
  Logger.log(checkRange);
  }
  }

现在，可以很好地创建所需范围，正如我在日志中看到的那样。 但是，很明显，单元格范围所需的GAS格式不同，因为我的范围未定义。 此外，我试图找出在GAS中编写范围的精确可接受的方法。 如果我将范围设为“ C9：C11”，则脚本可以正常运行。 如果我输入类似“ C9，C10”或“ C9”，“ C10”等的列表，则不会。 也没有多个范围（“ C9：C11”，“ C13：C14”）等...不太确定我该怎么写

Answer 1

从Google Apps脚本访问范围时，每个范围必须是一个连续的块，您不能将离散范围（如C9：C11和C13：C14）选择为单个范围对象。 您需要分别访问这些范围。

修改现有代码的一种简单但可能效率不高的方法是遍历checkRange数组并一次访问它们：

for(var j = 0; j < checkRange.length; j++){
   dataRange = sheet.getRange(checkRange[j]);
   var values = dataRange.getValues();
   for (var i = 0; i < values.length; i++) {
     for (var j = 0; j < values[i].length; j++) {
       if (values[i][j] == false) {
         values[i][j] = true; 
       }
     }
   }
 }

如果每个范围只是一个单元格，则可以将getValues（）切换为getValue（），然后就不需要遍历values数组。

但是，如果您访问的是一个较大的范围或一系列较小的范围，则效率将非常低下。 最好使用一些逻辑来构建多单元格范围，或者将整个工作表作为单个范围读取（ sheet.getDataRange().getValues() ），然后使用数组符号访问单元格您有兴趣，然后再写回整个数组。

Answer 2

使用Rangelist类最容易地对可能不相交的Range执行相同的操作，并且不需要直接访问成员Range 。 但是，即使操作不同（或有条件），也可以使用RangeList来优化Spreadsheet Service的使用，而不必重复调用Sheet#getRange 。

根据您的代码，我们可以确定目标是在与“真实”复选框相关的一组范围内进行操作：

var checkRange = [];
for (var i = 0; i < checkboxes.length; i++) {
  if (checkboxes[i]) {
    checkRange.push('C' + (i+9));
    Logger.log(checkRange);
  }
}

然后，您（似乎）对相关范围的值进行了有条件的更改：

var dataRange = sheet.getRange(checkRange);
var values = dataRange.getValues();
for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j] == false) {
      values[i][j] = true; 
    }
  }
}
dataRange.setValues(values);

实例化RangeList是通过对工作表上的范围的字符串引用Array来完成的，例如[ "A1:A10", "C2", "D6:E8", "R5C9:R100C9" ] 。 因此，您当前的checkRange似乎已经具有所需的格式。

然后，您的消费代码如下所示：

const rl = sheet.getRangeList(checkRange);
rl.getRanges().forEach(function (rg) {
  // Assumption: only single-cell ranges, based on the above checkRange code
  if (rg.getValue() == false) // matches false, null, undefined, 0, or ""
    rg.setValue(true);
});