OrgTree — 使用手册

OrgTree — 使用手册

OrgTree 是一款 Zoho CRM 小组件，帮助您在一张交互式树形图中直观查看客户的账户层级结构与联系人汇报关系，无需在多个记录间来回切换。


目录

  1. 安装与激活
  2. 从账户或联系人打开 OrgTree
  3. 侧边栏摘要面板
  4. 完整图形视图
  5. 工具栏功能说明
  6. 节点操作
  7. 设置面板
  8. 导出图形
  9. 循环引用警告
  10. 常见问题


1. 安装与激活

1.1 从 Zoho Marketplace 安装

  1. 访问 Zoho Marketplace，搜索 OrgTree。
  2. 点击 立即安装，按照提示完成授权。
  3. 安装完成后，前往 Zoho CRM → 设置 → Marketplace → 已安装的扩展，确认 OrgTree 状态为”已启用”。


2. 从账户或联系人打开 OrgTree

OrgTree 支持在 账户（Accounts） 和 联系人（Contacts） 详情页使用。

  1. 在 Zoho CRM 中打开任意一条账户或联系人记录。
  2. 在页面右侧（或底部）的小组件区域，找到 OrgTree 面板。
  3. 小组件加载后，侧边栏摘要面板会自动显示当前记录的概要信息。

提示： 如果小组件未显示，请联系管理员确认 OrgTree 已在当前布局中启用。


3. 侧边栏摘要面板

侧边栏摘要面板提供当前账户的快速概览，无需打开完整图形即可掌握基本信息。

摘要面板显示以下内容：

信息项

说明

账户名称

当前记录的名称

子账户数量

该账户下的直接及间接子账户总数

联系人数量

关联该账户的联系人总数

点击摘要面板中的 打开图形（Open Graph） 按钮，即可进入完整的交互式树形视图。


4. 完整图形视图

点击”打开图形”后，OrgTree 将在弹窗中展示完整的树形结构图。

4.1 图形结构说明

树形图由两类节点组成：

  • 账户节点（矩形）：代表一个账户（Account），子账户作为子节点递归展开。
  • 联系人节点（圆角矩形）：代表一个联系人（Contact），挂载在其所属账户节点下方，按 Reporting_To（汇报关系）形成子树。

4.2 加载说明

OrgTree 采用并行加载策略，同一层级的子账户会同时获取，相比逐级加载速度提升 3–10 倍。加载过程中会显示进度提示。


5. 工具栏功能说明

完整图形视图右侧提供浮动工具栏，包含以下操作按钮：

图标

功能

快捷说明

🔍＋

放大

放大图形视图

🔍－

缩小

缩小图形视图

⊡

适应屏幕

将图形缩放至适合当前窗口大小

📸

导出 PNG

将当前图形导出为高清 PNG 图片

⚙️

设置

打开设置面板，配置深度和自定义标签字段

所有工具栏按钮均支持键盘操作（Tab 键选中，Enter 或 Space 键激活）。


6. 节点操作

6.1 点击节点

在图形视图中，点击任意账户节点或联系人节点，Zoho CRM 将直接跳转打开该记录的详情页。

6.2 拖拽与平移

在图形空白区域按住鼠标左键并拖动，可平移整个图形视图。

6.3 滚轮缩放

在图形区域滚动鼠标滚轮，可放大或缩小图形。


7. 设置面板

点击工具栏中的 ⚙️ 设置 按钮，打开设置面板，可配置以下选项：

7.1 最大层级深度（Max Depth）

控制树形图展开的最大层级数，取值范围 1–10，默认值为 5。

  • 较小的值适合大型组织架构，避免加载过多数据。
  • 较大的值适合需要查看完整层级的场景。

修改后点击 保存 即可生效，图形将自动重新加载。

7.2 联系人自定义标签字段（Custom Label Field）

选择联系人模块中的任意字段，作为联系人节点上的标签角标显示。

常用配置示例：

字段

显示效果示例

职位（Title）

节点角标显示”市场总监”

部门（Department）

节点角标显示”销售部”

手机（Mobile）

节点角标显示手机号

自定义字段

显示您自定义的任意内容

选择字段后点击 保存，图形视图中所有联系人节点的角标将同步更新。


8. 导出图形

  1. 在完整图形视图中，点击工具栏中的 📸 导出 PNG 按钮。
  2. 系统将自动将当前可见图形导出为高清 PNG 图片。
  3. 图片将通过浏览器下载保存到本地。

提示： 导出前建议先点击”适应屏幕”按钮，确保图形完整显示，以获得最佳导出效果。


9. 循环引用警告

当账户或联系人的汇报关系形成闭环时（例如：A 的上级是 B，B 的上级是 A），OrgTree 会自动检测并处理，不会崩溃或卡死。

循环引用的提示方式：

  • 发生循环的节点上会显示 ⚠️ 图标角标。
  • 页面底部会弹出一条提示消息，说明检测到循环引用。
  • 图形会在循环节点处中断展开，避免无限递归。


10. 常见问题

Q：打开图形后显示空白，没有任何节点？

A：请确认当前账户在 Zoho CRM 中存在子账户或联系人数据。若数据存在但仍空白，请刷新页面后重试，或检查网络连接是否正常。


Q：联系人节点没有显示在图形中？

A：联系人节点仅在其 Account Name（所属账户） 字段有值时才会显示。请确认联系人已正确关联到对应账户。


Q：设置了深度限制后，部分账户看不到了？

A：这是预期行为。当层级深度超过设定的最大值时，更深层的节点将不再展开。如需查看更深层的结构，请在设置面板中增大”最大层级深度”的值。


Q：导出的图片显示不完整？

A：请在导出前点击工具栏中的”适应屏幕”按钮，确保整个图形处于可见区域内，再执行导出操作。


Q：界面语言如何切换？

A：OrgTree 会自动读取您的浏览器语言设置。若浏览器设置为中文，界面将显示为中文；若为英文，则显示为英文。目前支持简体中文和英文两种语言。


联系支持

如遇到问题或有功能建议，请通过以下方式联系我们：


文档版本：v1.1.