技术文章

在本文中,您将学习如何使用API生成文档中的注释,以便能够浏览注释、回复注释并使用自己的按钮/方法而不是编辑器按钮关闭注释。

简介

新添加的连接器API类允许与外部的文本文档、电子表格、演示和可填表单进行交互。

这样,您可以创建一个特殊的连接器,允许您直接链接您的自定义接口到文档并执行其中的任何操作。

可能的情况和案例包括:

• 管理一个地方的所有文件的评论提要;

• 自动填写从数据库导出的数据;

• 从外部管理审查过程(接受/拒绝建议的修改);

• 更多。

如何开始

连接器API类包含在高级API中,从7.2版开始,可用于单室文档开发人员版本的新版本。

所以,首先,你需要一个新的执照 开发人员版 (在 使用空气污染指数 部分选择 先进的 option).

如果你想先试一试,就开始一个新的30天试用期的办公室文档开发人员版本,或者通过联系我们的销售团队要求一个演示。 销售额@ .您也欢迎直接联系您的专业销售经理.

你需要做的是

要实现注释提要并使用您自己的按钮/方法处理注释,您需要创建连接器。去做,用 创造者 文档编辑器对象的方法:

var connector = docEditor.createConnector()

以下是连接器可用的最重要的方法:

•  附加物 允许添加以前只能从插件获得的事件监听器。提供完整的清单 在这里 .其中,您会发现改变内容控制等事件(onChangeContentControl )或点击该元素(onClick ).

•  呼叫命令 允许执行文档生成器脚本来构建和修改文档.建设者文档脚本提供了超过1,500种方法,它们都可以在连接器中执行。文件、电子表格和介绍的方法清单可供查阅 在这里 .

•  执行者d 允许使用连接器执行某些编辑器方法。这些方法执行一组复杂的文档生成器命令。与纯文档生成器命令不同,它们与编辑器中的焦点位置相连接。例如,GetSelectedText 方法允许检索所选内容,以及MoveToComment 方法将焦点移到注释上。

逐步实施

跟踪这些操作并运行指定的命令,以便在文档之外的一个地方管理注释。

在你的文件中得到所有的评论:

connector.executeMethod("GetAllComments", null, function(comments) { /**/ })

为光标突出显示的元素添加一个新的注释:

connector.executeMethod("AddComment",[{Text: comment, UserName: userName, Time: datetime}]);

修改现有的任何评论:

connector.executeMethod("ChangeComment", [commentId, newData]);

删除现有的任何评论:

connector.executeMethod("RemoveComments", [commentId]);

订阅更改评论活动:

connector.attachEvent("onChangeCommentData",  function (data) { /**/ })

订阅附加评论活动:

connector.attachEvent("onAddComment",  function (comment) { /**/ })

订阅删除注释事件:

connector.attachEvent("onRemoveComment",  function (data) { /**/ })

这个例子表明,新的高级API提供了通过程序代码更改和控制文档的多种能力。