十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

NocoBase CRM 实战:基于状态联动的线索销售管道(Pipeline)设计与实现

NocoBase CRM 实战:基于状态联动的线索销售管道(Pipeline)设计与实现 NocoBase CRM 实战基于状态联动的线索销售管道Pipeline设计与实现【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase本文是 NocoBase「如何实现 CRM 的线索转化」系列教程的续篇聚焦销售管道中最核心的环节——线索的跟进流程与状态管理。通过阅读本文你可以完整掌握线索Leads集合的字段结构设计、表格区块与详情区块的组合方式、基于记录状态status驱动的 10 个操作按钮联动规则以及利用 Markdown 区块中的 Handlebars 语法$nRecord作用域变量实现动态文案提示和关联对象跳转链接的技巧最终在 NocoBase 中搭建出一个状态流转清晰、防误操作的 CRM 线索跟进页面。本教程承接上一篇关于线索转化的基础内容创建数据集合、配置数据管理页面、实现线索到公司/联系人/商机的转化完整系列文档可参考 线索转化基础篇。本节的原始教程文档为 CRM 销售管道可视化。1. 系列背景与本章目标在上一篇教程中我们已经介绍了线索转化的基础知识包括创建所需的各数据集合Leads、Account 公司、Contact 联系人、Opportunity 商机配置数据管理页面实现从线索到公司、联系人和商机的转化功能。本章则重点关注线索的跟进流程和状态管理以「状态」字段为中枢驱动页面表单的显示变化、操作按钮的隐藏/激活/禁用以及转化完成后关联对象的展示与跳转。通过线索跟进和状态管理你可以提升业务效率实现对销售过程更精细的控制。2. Leads 集合结构说明在线索跟进功能中status状态字段扮演着至关重要的角色它不仅反映线索的当前进展未达标、新线索、处理中、跟进中、交易进行中、完成还驱动整个页面表单的显示与变化。下表完整给出线索集合Leads collection的字段结构Field name字段显示名称Field interfaceDescriptionidIdInteger主键account_idaccount_idInteger公司表 ACCOUNT 外键contact_idcontact_idInteger联系人表 CONTACT 外键opportunity_idopportunity_idInteger商机表 OPPORTUNITY 外键name线索名Single line text潜在客户的姓名company公司名Single line text潜在客户所在的公司名称email电子邮箱Email潜在客户的电子邮箱地址phone联系电话Phone联系电话status状态Single select线索当前状态默认为「未达标」未达标、新线索、处理中、跟进中、交易进行中、完成Account公司Many to one关联到公司Contact联系人Many to one关联到联系人Opportunity商机Many to one关联到商机设计上值得注意的两个要点外键字段与关联字段并存account_id/contact_id/opportunity_id三个 Integer 外键字段与Account/Contact/Opportunity三个 Many to one 关联字段并存。外键字段用于在转化流程中保存关联记录的 id后文生成跳转链接时直接引用$nRecord.account_id等关联字段则用于在表单中展示与维护关联关系。status使用 Single select单选字段状态值集合固定且有序后续所有联动规则按钮显隐、Markdown 文案切换、防修改保护都以它作为唯一判断依据这是状态机式页面联动的关键前提。3. 创建 Leads 表格区块与详情区块第一步是搭建页面骨架创建一个Leads 的 table block表格区块用于展示必要的字段列在页面右侧配置一个详情区块当点击某条记录时右侧会自动显示对应的详细信息。这种「左侧列表 右侧详情」的布局是销售管道类页面的典型形态销售人员从列表中选中一条线索右侧即可展开该线索的完整跟进面板状态提示文案、操作按钮、关联对象等都在详情区块中完成配置。4. 配置操作按钮10 个按钮的状态联动规则为了满足各种操作需求本页共创建10 个按钮。每个按钮都依据记录的状态status采用不同的显示方式隐藏、激活或禁用从而引导用户按照正确的业务流程操作。4.1 按钮配置总表按钮样式操作联动规则编辑按钮编辑操作—当记录的 status 为 Completed已完成时自动禁用防止不必要的编辑。未达标 按钮激活状态Unqualified 更新记录的 status 为 Unqualified。默认展示若 status 为 Completed则按钮被禁用。新线索 按钮未激活更新数据操作New 将 status 设置为 New更新成功后显示 New 的提示。如果记录的 status 不为 Unqualified 则隐藏即记录已处于 New 或之后状态应为激活状态。新线索 按钮激活状态更新数据操作New 更新记录的 status 为 New。当 status 为 Unqualified 时隐藏若 status 为 Completed则按钮禁用。处理中 按钮未激活更新数据操作Working 将 status 更新为 Working并显示 Working 成功提示。当记录的 status 不为 Unqualified、New 时隐藏。处理中 按钮激活状态更新数据操作Working 更新记录的 status 为 Working。当 status 为 Unqualified、New 时隐藏若 status 为 Completed则按钮禁用。跟进中 按钮未激活更新数据操作Nurturing 将 status 设置为 Nurturing并显示 Nurturing 成功提示。当记录的 status 不为 Unqualified、New、Working 时隐藏。跟进中 按钮激活状态更新数据操作Nurturing 更新记录的 status 为 Nurturing。当 status 为 Unqualified、New、Working 时隐藏若 status 为 Completed则按钮禁用。转化 按钮编辑操作transfer图标为√弹出转化表单表单提交时更新记录的 status 为 Completed。当记录的 status 为 Completed 时隐藏以防重复转移。转化完成 按钮激活状态查看操作transfered图标为√仅用于展示转化完成后的信息不具备编辑功能。仅在记录的 status 为 Completed 时显示其他状态时隐藏。4.2 联动规则的设计模式从上面的配置表可以提炼出这套联动规则的通用模式每个状态迁移都配一对按钮以「新线索 → 处理中 → 跟进中」为例每个节点都提供「未激活」可点击迁移到该状态成功后给出成功提示与「激活」表示记录已处于该状态两种按钮样式二者依据 status 显隐互斥切换终态Completed统一禁用/隐藏一旦线索转化完成除「转化完成」展示型按钮外其余按钮全部禁用或隐藏从 UI 层杜绝回退或重复操作第 9 节还会再加一层整体保护迁移按钮即「更新数据操作」这些按钮本质是预配置了status字段新值的更新操作点击即把记录的状态推进到下一个节点无需二次确认表单保证销售流程的低摩擦。4.3 按钮配置总结每项功能均提供未激活和激活状态下的不同按钮样式利用联动规则根据记录的 status 动态控制按钮的显示隐藏或禁用从而引导销售人员按照正确的工作流程进行操作。提示教程中的按钮文案以英文Unqualified / New / Working / Nurturing / Completed为准而状态选项集合在集合定义中以中文展示未达标、新线索、处理中、跟进中、交易进行中、完成。实际搭建时联动规则中比较的字符串必须与 Single select 字段中真实定义的选项值严格一致否则规则不会命中——这是实施时最容易踩的坑。5. 表单联动规则设置按钮之外表单本身的展示内容也随状态变化规则 1仅展示名称当记录未确认时表单只展示名称字段隐藏其余字段避免过早暴露尚不确定的信息。规则 2「新线索」状态下的显示优化在 status 为「新线索」时页面将隐藏公司名并展示联系方式——新线索阶段往往只有联系人层面的初步信息邮箱、电话公司归属尚未确认因此该阶段优先突出联系渠道。这两条规则说明NocoBase 的表单联动能力允许「同一表单、多套视图」所有切换逻辑仍由 status 单字段驱动与第 4 节的按钮联动共用同一判断源。6. 页面 Markdown 动态文案Handlebars 语法实战在详情页中教程使用Handlebars 语法根据记录的状态动态展示不同的跟进提示。$nRecord是当前记录的作用域变量{{#if (eq ...)}}...{{/if}}是条件块。以下是各状态下的完整示例代码当状态为「未达标」时{{#if (eq $nRecord.status 未达标)}} **跟踪你那些不合格线索的相关信息。** 如果你的线索对产品不感兴趣或已离开相关公司则可能是不合格的。 - 记录经验教训以供今后参考 - 保存外联细节和联系方式 {{/if}}当状态为「新线索」时{{#if (eq $nRecord.status 新线索)}} **收集更多关于这条线索的信息。** - 了解潜在客户的需求和兴趣点 - 收集基础联系资料和公司背景 - 确定后续跟进的优先级和方式 {{/if}}当状态为「处理中」时{{#if (eq $nRecord.status 处理中)}} **主动联系线索并初步评估需求。** - 通过电话/邮件与潜在客户建立联系 - 了解客户面临的问题和挑战 - 初步判断客户的需求与公司产品/服务的匹配度 {{/if}}当状态为「跟进中」时{{#if (eq $nRecord.status 跟进中)}} **深入挖掘客户需求进行线索培育。** - 提供相关产品资料或解决方案建议 - 回答客户的问题消除顾虑 - 评估线索的转化可能性 {{/if}}当状态为「转化完成」时{{#if (eq $nRecord.status 转化完成)}} **线索已成功转化为客户。** - 确认已创建相关的公司和联系人记录 - 创建商机记录设置跟进计划 - 将相关资料和沟通记录传递给负责的销售人员 {{/if}}6.1 源码视角Markdown 变量替换是如何工作的上述$nRecord.xxx插值并非 Markdown 区块私有魔法而是由 NocoBase 的求值器evaluators包统一支撑的。从源码结构看在 packages/core/evaluators/src/utils/index.ts 中evaluate()函数会先用正则{{\s*([\w$.-])\s*}}扫描表达式中所有形如{{变量名}}的插值从传入的 scope即包含$nRecord等记录作用域变量的上下文中按路径取值替换为真实数据后再交给底层求值引擎执行。文中{{$nRecord.account.name}}、{{$nRecord.account_id}}这类写法正是走这条替换路径同一个包中还通过appendArrayColumn()对数组作用域做了列式展开适配把数组映射为「同名字段集合」使得对关联数组的取值也能按点路径解析在 packages/core/evaluators/src/client/index.tsx 中客户端以 Registry 注册了formula.js、math.js、string三类求值引擎。Markdown 区块中的条件与比较表达式如eq $nRecord.status 处理中即在客户端求值后决定是否渲染对应文本块。这解释了两个实用细节插值变量名支持$前缀和作用域点路径正则字符类为[\w$.-]而作用域中不存在的变量会被替换为空字符串因此「状态不匹配时不显示任何内容」是这类条件文案能干净工作的基础。更多 Markdown 变量与技巧可参考系列中的 Markdown 区块技巧 与 Markdown 变量。7. 展示转化完成后的关联对象及跳转链接转化完成后希望直接展示关联对象公司、联系人、商机并能从线索详情页一键跳转到对应对象的详情弹窗。7.1 详情弹窗链接的结构做法是打开任一详情弹窗比如公司复制其链接。在不同弹窗或页面中详情链接格式的最后部分filterbytk之后的数字代表当前对象的 id例如{Base URL}/admin/{页面token}/popups/{弹窗token}/filterbytk/{id}其中filterbytk/{id}相当于「按主键过滤出一条记录」的定位参数这是生成跳转链接的关键。7.2 用 Handlebars 动态拼接关联链接分别针对公司、联系人、商机三段在 Markdown 区块中按「状态 已完成」的条件渲染带链接的关联对象公司{{#if (eq $nRecord.status 已完成)}} **公司:** {{$nRecord.account.name}} {{/if}}联系人{{#if (eq $nRecord.status 已完成)}} **联系人:** {{$nRecord.contact.name}} {{/if}}商机{{#if (eq $nRecord.status 已完成)}} **商机:** {{$nRecord.opportunity.name}} {{/if}}几个要点链接目标 固定弹窗路径 动态 idpopups/xxx/filterbytk/前的 token 是复制详情弹窗链接时得到的固定部分filterbytk/之后则通过{{$nRecord.account_id}}等外键字段动态注入——这正是第 2 节中外键字段与关联字段并存设计的回报名称取关联对象$nRecord.account.name定位取外键 id$nRecord.account_id仅在终态渲染三段代码都包裹在eq $nRecord.status 已完成条件下未转化的线索不会看到这些链接避免跳转到尚不存在的记录。8. 隐藏关联对象但保留值为确保转化完成后能正常展示关联信息需要将「公司」「联系人」「商机」三个字段的状态设置为**「隐藏保留值」**。这样尽管这些字段不在表单中显示但其值依然会被记录和传递——即前端表单不再编辑这三个关联字段但$nRecord作用域中仍保有它们的值供第 7 节的 Handlebars 链接模板读取。若错误地设为完全隐藏不保留值跳转链接将取不到名称与 id。9. 防止转化完成后状态修改为了防止转化完成后意外更改状态教程为所有按钮统一添加了一个判断条件当状态为「已完成」时所有按钮将被禁用。这是对第 4 节逐按钮规则的兜底即使后续新增按钮、或某个按钮遗漏了单条状态判断全局的「已完成 → 全部禁用」条件也能保证终态记录不可再被流转形成销售管道的「单向不可逆」保护。10. 总结状态驱动型页面上手要点完成以上步骤后线索跟进转化功能即告完成。回顾本章NocoBase 中「状态表单变化联动」的实现可以归纳为四层数据层Single select 状态字段 外键/关联字段并存的结构第 2 节交互层更新数据操作按钮 按状态显隐/启用的联动规则第 4 节展示层表单字段级联动规则 Markdown 区块中的 Handlebars 条件文案第 5、6 节保护层「隐藏保留值」策略 终态全局禁用第 8、9 节。这套模式不仅适用于 CRM 线索管道同样可以迁移到审批流、工单流转、项目阶段管理等任何「有限状态、顺序流转」的业务场景只要把 status 的选项换成你的业务阶段按同样的四步配置就能在 NocoBase 的低代码页面中快速搭出带状态机的业务系统。【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表