集成3D场景设计器

1. 概述

1.1 功能概述

通过iFrame容器技术，用户可将3D场景设计器无缝嵌入Web业务系统，来快速实现创建新的 3D 场景或者编辑已有的 3D 场景。

2. 操作步骤

2.1 新建 3D 场景

2.1.1 准备3D 场景 URL

1. 先准备好创建报表设计器的URL。例如：

   http://localhost:51980/scenes/create

2.1.2 添加用户令牌

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

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

   注意： 生成令牌时使用的用户，应具有创建仪表板的权限。

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

   
   

2.2 编辑已有的 3D 场景

2.2.1 获取 3D 场景的 URL

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

   
   

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

   原URL：http://localhost:51980/scenes/view/37311dc8-d6ed-41b1-ba50-2a369787d91c?theme=default&lng=zh-CN
   
   修改后的URL：http://localhost:51980/scenes/edit/37311dc8-d6ed-41b1-ba50-2a369787d91c?theme=default&lng=zh-CN

2.2.2 添加用户令牌

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

   例如：http://localhost:51980/scenes/edit/37311dc8-d6ed-41b1-ba50-2a369787d91c?theme=default&lng=zh-CN&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

2. 使用上面的链接打开后，效果如下图。在设计器中打开了指定的3D 场景。

   
   

   注意： 生成令牌时使用的用户，应具有创建仪表板的基本权限以及对目标3D场景的读写权限。