1. 简介

本工具是一个嵌入在 Zoho CRM 中的小部件应用，专为解决跨环境（如从沙箱环境到生产环境）跨数据中心迁移自定义模块配置的痛点而设计，也可以复制当前账号的模块。通过此工具，用户可以一键导出模块结构，并在目标环境中可视化地调整和重建模块，无需手动重复创建字段，极大地提升了系统部署和维护的效率。

2. 核心功能

本工具主要提供以下核心能力：

• 配置导出：支持将自定义模块的完整结构（包括字段属性、相关列表等）导出为 JSON 文件或复制到剪贴板。
• 跨环境导入：在目标环境中加载导出的 JSON 配置，自动解析模块结构。
• 可视化编辑：在应用导入前，允许用户修改模块名称、字段标签、API 名称、必填属性等。
• 高级字段支持：

• 选项列表 (Picklist)：支持增删改下拉选项值。
• 查找字段 (Lookup)：支持重新关联目标环境中的模块，并配置相关列表名称。
• 公式字段：暂不支持导入，系统会自动跳过。

• 智能应用逻辑：自动检测字段是否存在，智能处理新增、跳过（如公式字段）和关联验证。
• 结果反馈：提供详细的执行报告，展示每个字段的创建状态（成功、失败、跳过）及原因。

3. 操作流程

3.1 安装 Widget

安装链接

• CN：https://crm.zoho.com.cn/market/installPrivatePlugin.do?portalName=extensions2&nameSpace=clonecustomconfig&versionIndex=4561276000000225002
• COM：https://crm.zoho.com/market/installPrivatePlugin.do?portalName=extensions2&nameSpace=clonecustomconfig&versionIndex=4561276000000225002
• 其他 DC 修改 CRM.zoho.com 为对应 DC 域名

3.2 打开主页面

1. 在模块列表中找到【克隆模块】并点击打开。
2. 也可以从插件的【设置】入口打开。
   

3.3：导出模块（在源数据环境中操作）

1. 打开导出数据页面。
2. 选择【导出模块】：

• 系统会自动加载当前环境下的所有自定义模块。
• 使用顶部的搜索框输入模块名称，快速定位需要迁移的模块。

3. 选择模块：勾选模块列表左侧的复选框，支持批量选择多个模块。
4. 执行导出：

• 导出到文件（推荐）：点击按钮生成 .json 配置文件并下载到本地。
• 复制到剪贴板：点击按钮将配置 JSON 复制到剪贴板，适合快速操作。
• 单模块复制：也可以点击列表中单个模块右侧的“复制信息”按钮。
  
  

3.4：导入数据（在目标环境中操作）

1. 切换功能：点击顶部的「导入数据」标签页。

1. 加载数据：

• 点击「导入数据」按钮。
• 方式 A：文件上传：选择第一步导出的 .json 文件。
• 方式 B：手动输入：将剪贴板中的 JSON 内容粘贴到文本框中。
• 点击“导入”确认，系统将解析并展示待创建的模块信息。

3.5：配置与调整（关键步骤）

导入后，您可以在界面上对即将创建的结构进行预处理：

1. 模块基本信息调整：

• 点击模块名称（蓝色下划线），可修改模块的复数标签、单数标签和 API 名称。
• 提示：系统会标识模块是 [新建] 还是 [已存在]。

2. 字段属性编辑：

• 基本属性：直接点击表格中的“字段名称”或“API 名称”进行修改；点击开关切换“是否必填”。
• 下拉选项 (Picklist)：点击操作列的“修改选项”，可以添加新选项、删除旧选项或修改显示值与实际值。
• 查找字段 (Lookup)：

• 点击“修改查找模块”。
• 从下拉列表中选择目标环境中对应的关联模块。
• 输入或选择在目标模块中显示的“相关列表名称”。

3.6：应用更改

1. 执行创建：

• 确认所有配置无误后，点击「应用导入的数据」按钮。

2. 系统处理逻辑：

• 已存在：如果字段 API 名称已存在，系统将跳过创建。
• 新增：不存在的字段将尝试创建。
• 跳过：部分特殊字段（如公式 Formula、多选查找 Multiselect Lookup）目前版本会自动跳过。
• 关联检查：如果 Lookup 字段关联的模块在系统中找不到，该字段将标记为“关联模块不存在”并跳过。

3. 查看结果：

• 操作完成后会弹出结果对话框。
• 摘要统计：查看成功、失败和跳过的字段总数。
• 详细日志：查看每个字段的具体执行结果，失败的字段会显示红色并附带错误信息。

3.7：清理数据（可选）

• 如果需要开始新的任务，点击「清空数据」按钮，重置所有导入状态。

4. 常见问题与注意事项

1. 查找字段关联：跨环境导入时，请务必检查 Lookup 字段关联的模块是否存在。如果源环境关联了 "Module_A"，但目标环境没有 "Module_A"，该字段将创建失败。请在导入编辑阶段手动修正关联目标。
2. 字段名称冲突：导入前建议检查目标环境是否有同名但类型不同的字段，以免产生冲突。
3. 系统模块：工具目前仅显示可见且支持 API 的模块，部分系统内部模块可能无法导出。
4. 公式字段支持：公式字段暂不支持导入，会被自动跳过；如需迁移，请在目标环境中手动创建。
5. 执行建议：建议先在沙箱或测试环境完成验证，再在生产环境执行导入。

5. 其他操作

5.1：在设置页面显示

1. 复制插件链接：

• 在【设置】->【模块和字段】->【页签】中，找到【克隆模块】，复制链接。
  

2. 创建小部件：

• 在【设置】->【小部件】中，点击【添加小部件】。
• 选择【自定义小部件】，输入名称（如“克隆模块”），选择类型“外部”，URL 中填入 刚才复制的链接 + /custome_module.html
• 最终的格式是这样的 https://78aca958-fb85-4a20e.zappsusercontent.com/appfiles/v2/78a3686bcb020e/1.0/99f32a895c52c3c3f7bceccfdd9be43a7530f5e1d491c3/app/custome_module.html
  

3. 定制设置：

• 在设置页面中，点击【定制设置】-> 点击【新增菜单】。
• 输入名称（如“克隆模块”），选择类型“小部件”，选择刚才新建的小部件
• 点击保存即可