Javascript Excel JS API：使用自定义函数从单元格写入、计算和加载值

其目的是将公式（自定义函数）写入单元格，进行计算，加载值并在单个函数中检索它们

function myFunc() {
    Excel.run(function (ctx) {
        var fExcel = '=SUM(1,2)';
        var fCustom = '=custFunc()';

        var rng = ctx.workbook.worksheets.getActiveWorksheet().getRange('A1');

        //rng.formulas = [[fExcel]]; // works OK          
        rng.formulas = [[fCustom]]; // values are #GETTING_DATA

        // try different calc calls

        rng.load("values");

        return ctx.sync().then(function () {
            console.log(rng.values);
        });
    });
}

对于内置的Excel函数，一切都按预期工作，

console

在

ctx.sync（）

之后记录一个值3。使用自定义函数（向外部服务器发送请求以计算结果），值为

“#获取_数据”

。在

rng.load（“值”）之前，我已经尝试了以下所有方法

触发计算，但到目前为止没有任何结果：

• rng.calculate（）
  

• var s=ctx.workbook.worksheets.getActiveWorksheet（）；
  s、 计算（真）
  

• ctx.workbook.application.calculate（'Full'）
  

是否有方法触发自定义函数的计算并确保值在

ctx.sync（）

之后可用？

有趣的场景

今天，利用onCalculate事件，这个可能是可行的，但需要注意的是，当自定义函数计算时，它将触发2次

• 这是因为您的自定义函数首先将显示一个#get#u数据，而它将在后台进行计算。
  • 这样，当您的功能仍在评估时，用户就可以重新控制，从而使应用程序更具响应性。此行为不同于可能挂起Excel的VBA或XLL UDF
• Excel完成计算后，将再次触发计算事件。这是通过解决承诺而获得结果的时候

这应该可以让您了解它的工作原理：

/*This gist works in combination with any registered Excel JS Custom function*/

$("#set-formulas").click(() => tryCatch(setFormulas));

var rangeToCheck;

async function setFormulas() {
  await Excel.run(async (context) => {
    //register for event
    context.workbook.worksheets.getActiveWorksheet().onCalculated.add(handleCalculate);

    //write to grid
    const sheet = context.workbook.worksheets.getItem("Sheet1");

    rangeToCheck = "A1";
    const range = sheet.getRange(rangeToCheck);
    range.formulas = [['=CONTOSO.CONTAINS(A1, Days)']];
    range.format.autofitColumns();

    await context.sync();
  });
}

async function handleCalculate(event) {
  //read cell
  console.log("calc ended - begin");

  console.log("Change type of event: " + event.changeType);
  console.log("Address of event: " + event.address);
  console.log("Source of event: " + event.source);

  //Read A1 and log it back to the console
  await Excel.run(async (context) => {
    //write to grid
    const sheet = context.workbook.worksheets.getItem("Sheet1");

    const range = sheet.getRange(rangeToCheck);
    range.load("values");

    await context.sync();

    if (range.values.toString() != "GETTING_DATA") {
      console.log("Success: " + range.values);
    }
  });
}

/** Default helper for invoking an action and handling errors. */
async function tryCatch(callback) {
  try {
    await callback();
  } catch (error) {
    OfficeHelpers.UI.notify(error);
    OfficeHelpers.Utilities.log(error);
  }
}