介绍
当项目进行到评审阶段时，对应的评审内容沉淀在飞书文档上。同时围绕某个飞书文档评审时会产生一些评审意见，这些非常重要的评审意见需要有评估的流程来进一步跟踪。
借助飞书项目评论同步插件，可以实现将飞书云文档中的全文评论同步创建指定的飞书项目工作项数据。
250px|700px|reset
启用插件
管理员前往空间配置 → 插件管理 → 添加插件 → 启用“文档评论同步”插件完成插件启用。
250px|700px|reset
在插件列表选择或者搜索“文档评论”，找到“文档评论同步”插件，点击“添加插件”按钮，在弹层中确认权限清单后，点击“确认”按钮完成插件添加。
250px|700px|reset
插件配置
在使用此插件前，需要进行飞书应用凭证、插件规则配置，以下规则配置请不要省略跳过流程。
飞书应用凭证配置
配置飞书应用凭证
- 第一步：飞书项目空间管理员或开发者参考如何开发企业自建应用？文档创建一个飞书应用。
250px|700px|reset
- 第二步：飞书项目空间管理员或开发者申请文档、通讯录、账号相关权限。具体可参考：申请权限。
250px|700px|reset
- 第三步：飞书项目空间管理员或开发者进行免登流程内容填写，此选项设置是为了使用部分用户能够正常授权。前往安全设置中填写重定向 URL 为下方链接。具体参考：免登流程
250px|700px|reset
- 第四步：飞书项目空间管理员或开发者对应用进行发布，发布后该应用才能正式使用。具体可参考：应用发布与使用
250px|700px|reset
- 第五步：飞书管理员对应用应用审核，具体可参考：管理员如何审核应用？
250px|700px|reset
- 第六步：飞书管理员设置应用可用范围，将可用成员设置为“全部成员”，否则其他成员点击按钮会提示：你没有“xxxx”的使用权限，请联系企业管理员开通。
250px|700px|reset
- 第七步：完成发布后，开发者在飞书开发者后台中复制 APP ID 和 APP Secret。
250px|700px|reset
- 第八步：飞书项目空间管理员将复制的内容粘贴至下方 APP ID 和 APP Secret 选项中。
250px|700px|reset
如规则列表上方则提示“请先添加应用凭证，否则插件规则无法生效”，是因为未填写的应用凭证信息，填写即可。
规则配置
完成飞书应用配置后，接下来配置插件规则。以实现项目下关联的文档评论同步至评审管理为例：
- 第一步：点击插件规则列表中的配置选项，开始初步配置。
250px|700px|reset
- 第二步：点击右上的“添加规则”按钮，添加第一个规则。
250px|700px|reset
- 第三步：填写规则名称，类似 TR5 评审内容。
250px|700px|reset
- 第四步：在“目标文档评论”选项中选择目标工作项的文档链接。注意：请提前创建好该字段，并配置在对应的工作项详情页或节点表单上。
250px|700px|reset
- 第五步：选择“同步飞书项目”到某个工作项，以选择“评审管理”工作项为例，接着选择承接同步评论的处理流程。之后关联文档中的评论会自动在该工作项中创建一个评审问题。
250px|700px|reset
- 第六步：这一步，设置工作项自动关联，即在评审管理工作项中创建的评审内容，自动关联项目管理中当前项目（存放了评审链接的项目）。注意这一步需要配置好项目管理工作项与评审管理的关联关系，具体可以参考：[普通关系]工作项关联
250px|700px|reset
控件配置
前往项目管理工作项的详情页配置，在表单资源库中搜索“文档评论同步”控件，拖拽到右侧详情页。后续创建某个项目后，该项目详情页展示该同步按钮。
250px|700px|reset
至此，插件配置部分已经配置完成。
插件使用
配置步骤完成后，以一场评审会议为例来了解如何使用插件。
创建评审文档
250px|700px|reset
后续项目进入到评审环节，直接在该文档全文评论中留言具体问题即可。
操作授权
第一次点击“同步”按钮会跳转到授权页面。
250px|700px|reset
完成授权后即可开始同步。
250px|700px|reset
点击同步
接着点击“同步”按钮。
250px|700px|reset
飞书文档全文评论将自动同步评审工作项，且自动关联由该项目触发的项目。
250px|700px|reset
在同步过程中，可能会遇到以下情况：
- 你没有XXX、XXX的权限无法同步文档评论，请申请权限后再试：请获取到文档的阅读、编辑权限。
- XXX和XXX为字段名称，根据没有权限：请找空间管理员授权字段编辑权限。
- 请检查是否按照插件规则进行了正确配置后再试：插件规则配置错误，请重新参考插件配置。
常见问题
请求非法, 请联系应用开发者
请前往安全设置中填写重定向 URL。
文档评论删除后会双向同步么？
不会，历史评审记录仍然存在。
评审的创建人是谁？
默认为点击“同步”按钮的成员。
