集成活页夹设计器

1. 概述

1.1 功能概述

通过iFrame容器技术，用户可将文档活页夹设计器无缝嵌入业务系统，来快速实现创建新的活页夹或者编辑已有的活页夹。

2. 操作步骤

2.1 新建活页夹

2.1.1 准备创建活页夹 URL

1. 先准备好创建活页夹的 URL。例如：

   http://localhost:51980/documentBinders/create

2.1.2 添加用户令牌

1. 在获取到 URL 后，需要添加用户令牌来进行身份认证和权限认证，其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后，将其添加到目标 URL 的末尾，并使用“?token=” 进行连接，得到最终的 URL 字串。

   例如：http://localhost:51980/documentBinders/create?token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

   注意 生成令牌时使用的用户，应至少具有查看报表的权限或查看仪表板的权限。具备哪种文档的查看权限则在创建活页夹时就可以选择哪种文档。

2. 使用得到的URL即可直接打开一个全新的空活页夹设计器。

   
   

2.2 编辑已有的文档活页夹

2.2.1 获取文档活页夹的 URL

1. 在文档门户中，选择需要集成的活页夹，单击页面操作栏的在新窗口中浏览活页夹按钮 按钮，即可在新窗口中打开活页夹，然后将活页夹的 URL 地址拷贝粘贴到记事本中待用。

   
   

2. 在记事本中将URL中 的 view 改为 edit ，例如：

   原URL：http://localhost:51980/documentBinders/view/e32828fd-352e-4a0f-bc9a-963706aa458c?theme=default&lng=zh-CN
   
   修改后的URL：http://localhost:51980/documentBinders/edit/e32828fd-352e-4a0f-bc9a-963706aa458c?theme=default&lng=zh-CN    

2.2.2 添加用户令牌

1. 在获取到 URL 后，需要添加用户令牌来进行身份认证和权限认证，其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后，将其添加到目标 URL 的末尾，并使用 “&token=” 进行连接，得到最终的URL字串。

   例如：http://localhost:51980/documentBinders/edit/e32828fd-352e-4a0f-bc9a-963706aa458c?theme=default&lng=zh-CN&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6  

2. 使用上面的链接打开后，效果如下图。在设计器中打开了指定的活页夹。

   
   

   注意： 生成令牌时使用的用户，应具有查看仪表板的基本权限或查看报表的基本权限以及对目标活页夹的读写权限。