山海鲸可视化

部署后的项目修改

在项目进行过程中,我们往往需要进行多次的项目部署和返工修改。
在山海鲸可视化中,当项目复杂度不变时(使用付费组件(如鲸孪生)或资源属于复杂度变化),登录同一个账号给同一个项目码反复导出,不会重复收费。
通过山海鲸可视化导出的部署文件,经过多次返工导入的部署文件,在山海鲸可视化中都属于同一个项目。
image.png

1. 基于本地同一个项目反复修改导出

如果我们一直在本地维护同一个项目,反复在这个项目基础上修改和导出部署文件(.dt-deploy 文件),那么就不会涉及到项目 ID 的变化,此时我们只需要注意导出时候用相同的项目码即可。

如果一开始就能确认最终部署的机器,那么我们就直接在这个部署机器上安装山海鲸查看器,复制查看器中未使用的项目码,然后使用这个项目码进行项目部署。
如果一开始无法确认最终部署的机器,那么我们可以先在某台固定机器或服务器上安装山海鲸查看器,然后复制查看器中未使用的项目码,先进行项目临时部署,等后期确认了最终部署的机器,再进行项目迁移。
关于项目迁移请参考这个教程:部署后的项目迁移

【重要提示】
(1)一旦在某个项目版本上进行了部署文件导出,那么后续所有修改都要在这个项目版本上进行,如果需要在其他机器上编辑项目,需要将这个项目版本另存为本地项目文件(.dt 格式),然后在其他机器上导入这个项目文件(.dt 格式),再在此基础上进行修改和导出部署文件(.dt-deploy 文件),否则会产生新的导出部署费用。

(2)因为项目迁移是通过山海鲸查看器进行的,所以如果需要进行项目迁移,那么被迁移的设备一定要确保能够一直处于正常运行状态,不要重装软硬件系统,否则将无法进行项目迁移。

2. 在本地和客户之间反复修改导出

部署文件部署教程中我们介绍过,导出部署文件时可以选择是否开放编辑修改权限,如果开放了编辑修改权限,那么接收方就可以直接通过山海鲸可视化导入进行修改;如果未开放编辑权限,就只有导出这个项目的账号可以修改这个项目。
【1】如果给客户提供的是可编辑的部署文件(.dt-deploy 文件),那么建议客户那边通过山海鲸可视化导入后进行编辑修改,然后通过“另存为”保存为本地项目文件(.dt 文件),再返回修改。
image.png

【2】如果给客户提供的是不可编辑的部署文件(.dt-deploy 文件),当客户将项目部署到客户本地后,可能会进行数据源替换等操作,此时如果需要返工修改,我们建议您基于客户本地的项目进行修改,这样就可以避免下次发给客户时还需要重复数据源替换的操作。
如果需要客户导出部署文件(.dt-deploy),可以在山海鲸查看器中点击项目缩略图上的“另存为”菜单。
image.png

在设置窗口中,客户可以选择是否将动态数据源转换为静态数据源(适用于数据库和 API)。
如果当前项目已经接入了本地动态数据源,如 API 或数据库,那么客户导出后我们这边很有可能就打不开项目,此时客户可以选择将动态数据源转换为静态数据源,系统会自动提取动态数据源前 100 条数据,然后转换为静态 JSON 文件,这样我们接收项目后就可以正常打开了。
image.png

3. 注意事项

3.1 项目码一致性问题

从山海鲸可视化中导出部署文件时,填写的项目码一定要从部署项目的设备上安装的山海鲸查看器中复制,否则导出的部署文件会因为项目码不一致无法导入。
image.png

如果已经导出了部署文件并且产生了扣费,那么后续导出部署文件时一定要使用这个项目码继续导出,这样才不会产生新的费用。(如果项目已经完成了迁移,在山海鲸可视化中导入迁移后的部署文件,再次导出部署文件时会自动使用迁移后的项目码,这个时候也是不需要额外付费的)

3.2 项目修改问题

接受客户返工的项目文件/部署文件后,我们可以在山海鲸可视化中导入进行修改(如果之前导出的是不可编辑的部署文件,那么接收时要用之前导出部署文件的账号来导入,其他账号无法导入该部署文件)。
需要注意的是,导入项目后在山海鲸可视化中对项目进行的改动不会影响本地接收的文件,如果想要将修改后的项目发给其他人,则需要修改之后进行项目保存,再导出新的部署文件。
image.png

举个例子:
假设客户接收到部署文件 A,当客户在山海鲸可视化或山海鲸查看器中导入后,无论进行了什么改动,都不会影响本地电脑接收的这个文件 A。
当客户需要返工修改时,不能直接将这个文件 A 发回,而是需要在山海鲸可视化中另存为一个新的项目文件 B,或者在山海鲸查看器中另存为一个新的部署文件 C。
然后将文件 B 或文件 C 发回来进行修改。

3.3 数据源替换问题

客户导入项目之后如果进行了本地数据源的替换,那么项目中就包含了客户本地的真实数据源,再导出返工修改时务必选择将动态数据源转换成静态数据源,这样我们接收到新项目后才能打开项目,并且可以在这个基础上进行修改。
image.png

再发给客户时,客户只需要在导入项目时勾选“还原动态数据源”,就可以完成数据源对接,而不需要反复进行数据源替换。
image.png

3.4 账号一致性问题

如果在导出部署文件时选择了不开放编辑修改权限,那么导入部署文件的山海鲸可视化的账号必须与导出这个部署文件的山海鲸可视化主账号一致才能导入。
image.png

【举个例子】
假设有主账号 A 和三个子账号 A1、A2、A2,还有主账号 B 和三个子账号 B1、B2、B3,如果主账号 A 或者任一子账号给客户 C 导出了一个部署文件(未开放编辑修改权限),那么当客户 C 导出部署文件进行返工修改时,只有账号 A 和子账号 A1、A2、A3 能导入,B 账号和子账号 B1、B2、B3 无法导入该部署文件。
5.png