EditWordDocument¶
对上传的 Word(.docx)文档进行就地编辑:将一组按顺序排列的操作以原子方式应用到其实时副本,因此所有打开该文档的人都能立即看到更改,并且只要任一操作失败,什么都不会改变。先调用 ReadWordDocument,通过它报告的 ID 来定位段落、表格和块(这些 ID 不是数字)。如需修改措辞,使用 replaceText(一个段落内的精确文本;格式保持不变);使用 setText 重写整个段落;使用 formatText 设置粗体、斜体、下划线或删除线;使用 insertParagraph 添加段落(每行文本都会成为一个段落;样式可选);使用 setStyle 更改段落样式,如 Heading1;使用 delete 删除段落、表格或块;使用 addComment 在文本上添加 Word 评论。只有 insertParagraph 和 addComment 的文本可以包含换行符。表格单元格内的段落也按相同方式编辑。修订(redline):当 trackChanges 为 true 时,或者当文档已跟踪修订且省略 trackChanges 时,编辑会被记录为真实的 Word 修订(插入、删除、格式和样式更改),对方可以在 Word 中接受或拒绝;只要用户要求 redline、修订或标记,就传入 trackChanges true。修订和 addComment 评论以请求用户的姓名署名,而不是以你的姓名;仅在用户指定其他人(一家公司或另一个人)时才传入 author。addComment 评论保存在文件中,并随文件一起进入 Word;如果评论是写给文档接收者的,请使用它们,而 Comment 或 CommentOnText 用于 Macro 内部的讨论。返回变更后的块当前的内容,以及新段落的 ID;请检查这些内容。最多 50 个操作。
Parameters¶
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
documentId |
string | 是 | Word 文档 ID。 |
operations |
WordDocumentOperation[] | 是 | 按顺序一起应用的操作。 |
trackChanges |
boolean | 否 | 将编辑记录为修订(true)还是直接应用(false)。省略时遵循文档自身的 Track Changes 设置。 |
author |
string | 否 | 修订和评论所署的姓名。省略时使用请求用户的姓名。 |
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 macro3/macro