ExcelScript在Web应用报错但桌面端正常的问题求助

去年我写了个简单的ExcelScript脚本，作用是在工作表锁定保护的状态下，让用户点击指定按钮给表格插入新行。之前基本没报错，只有API调用失败或者用户参数错误的时候才出问题。但现在在Web端/浏览器环境里，脚本一直报错：

ERROR Line ##: Worksheet getProtection: Write Operation is not supported for Office when a modal dialog is open.
桌面端从来没出现过这个问题。

我是不是要改函数里的变量声明方式，或者漏了现在需要的某些方法？我搞不懂为啥就因为脚本调用的对话框在请求参数，就不让对文件执行写入操作。

我试过改成用pauseProtection和resumeProtection这些不同的工作表保护方法，没用；也试过把取消保护/暂停保护的逻辑嵌套到其他方法里，还是没改善。

下面是桌面端还能正常运行的原始代码：

function main(workbook: ExcelScript.Workbook, starting_row: number, quantity_newRows: number) {
    let selectedSheet = workbook.getWorksheet("Schedule");
    console.log(quantity_newRows + starting_row);
    // 取消Schedule工作表保护
    selectedSheet.getProtection().unprotect("1234");
    let schedule = workbook.getTable("Schedule");
    let rowAdd = starting_row - workbook.getTable("Schedule").getHeaderRowRange().getRowIndex() - 2;

    // 在表格schedule的指定索引处插入行
    for (let counter = 0; counter < quantity_newRows; counter++) {
        schedule.addRow(rowAdd);
    }

    selectedSheet.getRange().getFormat().autofitRows();
    selectedSheet.getProtection().protect({ allowAutoFilter: true, allowDeleteColumns: false, allowDeleteRows: false,
        allowEditObjects: false, allowEditScenarios: false, allowFormatCells: false,
        allowFormatColumns: true, allowFormatRows: true, allowInsertColumns: false,
        allowInsertHyperlinks: false, allowInsertRows: true, allowPivotTables: false,
        allowSort: false, selectionMode: ExcelScript.ProtectionSelectionMode.normal }, "1234");
}

这个报错的核心原因是Web端Excel在模态对话框打开时会阻断所有写入操作，而桌面端没有这个限制。你的脚本是通过带参数的对话框触发的，Web端此时处于模态对话框激活状态，导致unprotect/protect这类修改工作表状态的写入操作无法执行。

解决思路很明确：把参数收集和执行修改操作完全分开——先收集参数，等对话框关闭后再执行工作表修改逻辑。

方案1：拆分函数+内置输入框（简单实现） #

用ExcelScript内置的inputBox收集参数，确保对话框关闭后再执行修改：

async function run() {
    const workbook = await ExcelScript.getWorkbook();
    
    // 分步收集参数，对话框会依次弹出并关闭
    const startingRowInput = await workbook.getApplication().inputBox("请输入起始行:", "参数输入", "", 1, 1000, 1, ExcelScript.InputBoxType.number);
    const starting_row = startingRowInput.value as number;
    
    const quantityInput = await workbook.getApplication().inputBox("请输入新增行数:", "参数输入", "", 1, 100, 1, ExcelScript.InputBoxType.number);
    const quantity_newRows = quantityInput.value as number;

    // 此时所有对话框已关闭，执行核心逻辑
    let selectedSheet = workbook.getWorksheet("Schedule");
    selectedSheet.getProtection().unprotect("1234");
    
    let schedule = workbook.getTable("Schedule");
    let rowAdd = starting_row - schedule.getHeaderRowRange().getRowIndex() - 2;

    for (let counter = 0; counter < quantity_newRows; counter++) {
        schedule.addRow(rowAdd);
    }

    selectedSheet.getRange().getFormat().autofitRows();
    selectedSheet.getProtection().protect({ 
        allowAutoFilter: true, 
        allowDeleteColumns: false, 
        allowDeleteRows: false,
        allowEditObjects: false, 
        allowEditScenarios: false, 
        allowFormatCells: false,
        allowFormatColumns: true, 
        allowFormatRows: true, 
        allowInsertColumns: false,
        allowInsertHyperlinks: false, 
        allowInsertRows: true, 
        allowPivotTables: false,
        allowSort: false, 
        selectionMode: ExcelScript.ProtectionSelectionMode.normal 
    }, "1234");
}

方案2：自定义对话框（更灵活） #

如果需要更复杂的参数收集界面，可以用Office Dialog API弹出自定义HTML对话框，关闭后再执行逻辑：

// 第一步：弹出自定义对话框收集参数
async function openParameterDialog() {
    const dialogOptions = {
        height: 300,
        width: 400,
        displayInIframe: true
    };
    // 替换为你的自定义对话框HTML地址
    const dialog = await Office.context.ui.displayDialogAsync("https://your-custom-dialog-page.html", dialogOptions);

    // 监听对话框返回的参数
    dialog.addEventHandler(Office.EventType.DialogMessageReceived, async (args) => {
        const params = JSON.parse(args.message);
        dialog.close();
        // 对话框关闭后执行修改操作
        await executeRowInsertion(params.starting_row, params.quantity_newRows);
    });
}

// 第二步：执行插入行与保护逻辑
async function executeRowInsertion(starting_row: number, quantity_newRows: number) {
    const workbook = await ExcelScript.getWorkbook();
    let selectedSheet = workbook.getWorksheet("Schedule");
    
    selectedSheet.getProtection().unprotect("1234");
    let schedule = workbook.getTable("Schedule");
    let rowAdd = starting_row - schedule.getHeaderRowRange().getRowIndex() - 2;

    for (let counter = 0; counter < quantity_newRows; counter++) {
        schedule.addRow(rowAdd);
    }

    selectedSheet.getRange().getFormat().autofitRows();
    selectedSheet.getProtection().protect({ 
        allowAutoFilter: true, 
        allowDeleteColumns: false, 
        allowDeleteRows: false,
        allowEditObjects: false, 
        allowEditScenarios: false, 
        allowFormatCells: false,
        allowFormatColumns: true, 
        allowFormatRows: true, 
        allowInsertColumns: false,
        allowInsertHyperlinks: false, 
        allowInsertRows: true, 
        allowPivotTables: false,
        allowSort: false, 
        selectionMode: ExcelScript.ProtectionSelectionMode.normal 
    }, "1234");
}

关键注意点 #

• 绝对不要在模态对话框打开期间执行写入操作，Web端Excel的安全机制会直接阻断这类请求
• 避免用带参数的main函数直接触发修改逻辑，因为此时对话框大概率还处于激活状态
• 用异步函数+await确保参数收集完成、对话框关闭后，再执行工作表保护修改和行插入操作

内容的提问来源于stack exchange，提问作者Daniel Rodriguez