Word Add-In如何检测Track Changes状态避免插入内容被标记修订

修订功能激活状态判断方法 #

Word JavaScript API 中可通过Document.trackRevisions属性直接判断「Track Changes（修订）」功能是否处于激活状态，该属性为布尔类型，返回值true对应功能已激活，false对应功能未激活，最低支持的API版本为1.1。

插入内容被标记为修订的解决方案 #

你遇到的插入内容自动带修订标记的问题，可通过临时修改修订状态，操作完成后恢复原有配置的方式解决，流程如下：

• 执行插入文件操作前，先读取当前文档的trackRevisions属性值做临时存储
• 临时将trackRevisions设置为false，关闭修订功能
• 调用insertFileFromBase64完成文件内容插入
• 执行完所有需要避免生成修订的操作后，将trackRevisions属性恢复为之前存储的原始值

示例代码如下：

await Word.run(async (context) => {
  // 读取当前修订状态
  const document = context.document;
  document.load("trackRevisions");
  await context.sync();
  
  // 暂存原始修订状态
  const originalTrackRevisionsState = document.trackRevisions;
  
  try {
    // 临时关闭修订
    document.trackRevisions = false;
    await context.sync();
    
    // 清空文档正文
    document.body.clear();
    await context.sync();
    
    // 插入base64格式的文件内容，yourBase64File替换为实际的文件base64数据
    document.body.insertFileFromBase64(yourBase64File, Word.InsertLocation.replace);
    await context.sync();
  } finally {
    // 无论操作是否成功，都恢复原始修订状态
    document.trackRevisions = originalTrackRevisionsState;
    await context.sync();
  }
});

内容的提问来源于stack exchange，提问作者Rulo Pimentel