定期刷新 IMPORTXML() 电子表格函数

Periodically refresh IMPORTXML() spreadsheet function

我有一个大型 sheet,大约有 30 个 importxml 函数,这些函数从通常一天更新两次的网站获取数据。

我想 运行 importxml 函数及时(每 8 小时)为我的 Google Spreadsheet 将数据保存在另一个 sheet。保存已经生效,但是更新没有!

我在 Google Spreadsheet row update 中读到它可能 运行 每 2 小时一次,但我不相信这是真的,因为自从我将它添加到我的 sheet 后,一切都没有改变或更新,当点差sheet 未打开时。

我如何 "trigger" 我的 Google 中的 importxml 函数以简单的方式传播 sheet,因为我有很多 importxml 函数在里面?

Google Spreadsheet row update 问题及其答案涉及 "Old Sheets",其行为与 Google Sheets 的 2015 版不同。 "New Sheets" 没有自动刷新内容;现在仅评估更改以响应编辑。

虽然表格本身不再提供此功能,但我们可以使用脚本来刷新 "import" 公式(IMPORTXMLIMPORTDATAIMPORTHTMLIMPORTANGE).

实用脚本

要定期刷新 IMPORT 公式,请将此函数设置为 time-driven trigger

注意事项:

  • 导入函数在刷新期间其他脚本或用户对电子表格所做的公式更改可能会被覆盖
  • 重叠刷新可能会使您的电子表格不稳定。为了缓解这种情况,实用程序脚本使用 ScriptLock。这可能会与脚本中该锁的其他用途发生冲突。

/**
 * Go through all sheets in a spreadsheet, identify and remove all spreadsheet
 * import functions, then replace them a while later. This causes a "refresh"
 * of the "import" functions. For periodic refresh of these formulas, set this
 * function up as a time-based trigger.
 *
 * Caution: Formula changes made to the spreadsheet by other scripts or users
 * during the refresh period COULD BE OVERWRITTEN.
 *
 * From: 
 */
function RefreshImports() {
  var lock = LockService.getScriptLock();
  if (!lock.tryLock(5000)) return;             // Wait up to 5s for previous refresh to end.
  // At this point, we are holding the lock.

  var id = "YOUR-SHEET-ID";
  var ss = SpreadsheetApp.openById(id);
  var sheets = ss.getSheets();

  for (var sheetNum=0; sheetNum<sheets.length; sheetNum++) {
    var sheet = sheets[sheetNum];
    var dataRange = sheet.getDataRange();
    var formulas = dataRange.getFormulas();
    var tempFormulas = [];
    for (var row=0; row<formulas.length; row++) {
      for (col=0; col<formulas[0].length; col++) {
        // Blank all formulas containing any "import" function
        // See https://regex101.com/r/bE7fJ6/2
        var re = /.*[^a-z0-9]import(?:xml|data|feed|html|range)\(.*/gi;
        if (formulas[row][col].search(re) !== -1 ) {
          tempFormulas.push({row:row+1,
                             col:col+1,
                             formula:formulas[row][col]});
          sheet.getRange(row+1, col+1).setFormula("");
        }
      }
    }

    // After a pause, replace the import functions
    Utilities.sleep(5000);
    for (var i=0; i<tempFormulas.length; i++) {
      var cell = tempFormulas[i];
      sheet.getRange( cell.row, cell.col ).setFormula(cell.formula)
    }

    // Done refresh; release the lock.
    lock.releaseLock();
  }
}

要回答您的问题以轻松 "trigger" 强制重新加载函数:

向您正在加载的 url 添加一个额外的未使用参数,同时为该参数的值引用一个单元格。 更改该单元格的内容后,该函数会重新加载。

示例:

importxml("http://www.example.com/?noop=" & $A,"...")

不幸的是,您不能将日期计算函数放入引用的单元格中,这会引发不允许这样做的错误。

我对 Mogsdad 的回答做了一些调整:

  • 修复了 releaseLock() 调用位置
  • 更新(或添加)查询字符串参数到导入函数中的 url(而不是存储、删除、等待 5 秒,然后恢复所有相关公式)
  • 适用于您传播中的特定 sheetsheet
  • 显示上次更新时间

...

function RefreshImports() {
  var lock = LockService.getScriptLock();
  if (!lock.tryLock(5000)) return;             // Wait up to 5s for previous refresh to end.

  var id = "[YOUR SPREADSHEET ID]";
  var ss = SpreadsheetApp.openById(id);
  var sheet = ss.getSheetByName("[SHEET NAME]");
  var dataRange = sheet.getDataRange();
  var formulas = dataRange.getFormulas();
  var content = "";
  var now = new Date();
  var time = now.getTime();
  var re = /.*[^a-z0-9]import(?:xml|data|feed|html|range)\(.*/gi;
  var re2 = /((\?|&)(update=[0-9]*))/gi;
  var re3 = /(",)/gi;

  for (var row=0; row<formulas.length; row++) {
    for (var col=0; col<formulas[0].length; col++) {
      content = formulas[row][col];
      if (content != "") {
        var match = content.search(re);
        if (match !== -1 ) {
          // import function is used in this cell
          var updatedContent = content.toString().replace(re2,"update=" + time);
          if (updatedContent == content) {
            // No querystring exists yet in url
            updatedContent = content.toString().replace(re3,"?update=" + time + "");
          }
          // Update url in formula with querystring param
          sheet.getRange(row+1, col+1).setFormula(updatedContent);
        }
      }
    }
  }

  // Done refresh; release the lock.
  lock.releaseLock();

  // Show last updated time on sheet somewhere
  sheet.getRange(7,2).setValue("Rates were last updated at " + now.toLocaleTimeString())
}

您还可以将每个XML公式作为注释放在各自的单元格中,并录制一个宏以将其复制并粘贴到同一单元格中。稍后使用脚本,然后使用触发器功能来安排此宏。