表单输入与选择节点的数据交接:formInputResult 与 selectResult 怎么走

梳理FastGPT表单输入与用户选择节点的交互顺序、输出归属和下游引用方式,结合必填缺项、选项分支与运行记录说明核对方法,区分用户选择和按字段自动比较的判断器。

表单提交后的字段从 formInputResult 读取,用户选定的选项从 selectResult 读取。两次交互完成后,流程沿已连接的节点继续。搭建时先确认材料收集和用户决定各发生在哪一步,再核对下游引用;按已有字段自动判断条件时,连接判断器。

表单输入节点触发交互时工作流发生了什么

表单输入节点在流程中承担交互入口的角色。它被触发后会进入等待状态,同时把当前工作流的状态记录下来,等待用户填写并提交。流程会在表单输入节点等待,用户提交后继续。理解这一点很关键,因为后续节点拿到的字段值,来源是这次提交的结果,不是表单配置里的默认值。配置时要确认表单输入节点确实被触发,且没有被上游条件跳过;如果上游分支没有走到该节点,后续节点自然取不到任何提交内容。核对动作是查看该节点在运行记录中是否出现等待与提交两个阶段,失败表现通常是后续节点变量为空,或者流程长时间停在表单输入节点没有继续。另一个容易忽略的点是表单输入节点记录的工作流状态与提交内容是绑定的,同一次运行中提交的结果才会被后续节点引用,跨运行或重复提交不会自动合并。

提交后字段如何传给后续节点

提交发生后,表单输入节点的字段结果会作为该节点的输出,供后续节点引用。引用形式通常以节点标识加字段名的方式出现,也就是 formInputResult 这一类结果对象。后续节点若要用到某个字段,需要在变量选择里指向表单输入节点的对应输出,不能手写一个同名字段就当作可用。配置时要逐个确认字段名与表单定义一致,字段类型也要匹配,比如选择型字段传给需要文本比较的节点时,值的形式会影响判断。核对动作是在后续节点的输入预览里查看实际取值,确认提交内容确实出现在引用位置。失败表现包括字段引用指向了错误节点、字段名拼写不一致、以及提交后字段被覆盖。若表单输入节点在流程中只作为交互展示,没有把结果接到后续节点,流程虽然能继续,但后续节点读到的是空值。把提交结果显式接到后续节点,是表单输入与后续逻辑衔接的基础动作。

用户选择节点等待哪次交互

用户选择节点触发后,对话进入交互状态,工作流保存当前状态并呈现已配置选项。用户完成选择,节点输出 selectResult,并沿选项对应的分支继续。配置时应同时核对显示文字、实际选项值和分支连线;显示相近的两个选项也要分别试跑,确认没有接反。

表单输入节点收集的是材料字段,用户选择节点收集的是本次决定。例如,先填写申请内容,再选择办理事项,下游可以同时取得表单对象与所选值。若办理事项已经由材料字段确定,需要自动比较申请类别或日期,把字段接入判断器并配置条件。用户选择和自动比较在画布上应有各自明确的位置。

运行时分别观察用户是否已经选定、selectResult是否生成、选定分支是否接到后续节点。没有走到用户选择节点时,应先检查上游路径;停在等待状态时,应检查交互是否完成;用户已经选择却走向异常时,再核对选项值与连线。

formInputResult 与 selectResult 的衔接方式

formInputResult 是表单输入节点提交后的对象结果,selectResult 是用户选择节点选定后的字符串结果。下游节点需要哪项内容,就在变量选择中定位对应来源节点:业务材料字段从表单结果对象中取,所选事项从用户选择结果中取。两种结果可以同时传入一个业务处理节点。

以收集申请材料后确认受理意向为例,先提交表单,再选择事项,最后由后续节点读取材料字段与选项值。下游需要按照材料自动比较时,再连接判断器。试跑记录中应分别保留提交对象、选择值和下游输入,核对它们来自本次流程中的正确节点;存在多个表单时,节点名称与引用路径也要逐一确认。

字段取不到时,先定位来源节点是否执行和交互是否完成,再检查引用目标与字段名称。选项值不符时,对照用户本次选择和节点输出。将这两条线分别核对,能把数据来源、用户决定及后续处理清楚地串起来。

核对顺序与常见失败表现

先从画布走一遍完整路径,确认表单输入和用户选择两个交互节点分别位于需要收集材料、需要用户决定的位置。随后在同一次试跑中提交表单,记录 formInputResult;再选定一个选项,记录 selectResult及实际进入的分支。最后查看下游节点输入,核对材料字段与选项值都来自这次交互。

第一组样本填写完整字段并选择预期事项,检查下游能否收到对应内容。第二组样本保留必填缺项,观察交互界面是否仍要求补齐信息,再补齐提交。第三组样本更换选项,核对分支连线与输出值是否随之改变。三个样本各记录提交内容、所选值和下游实际输入,避免只凭最终回答判断字段是否传到了。

若流程停在表单处,核对交互是否完成;若下游字段缺失,核对来源节点和字段路径;若用户选择后进入错误路径,核对选项绑定和连线。需要自动条件比较的步骤,则检查判断器实际拿到的字段类型和值。完成这些核对后,再用本业务中的跨材料问题检验后续处理是否用对了输入。

交互节点的字段交接

交互节点有两类输出:表单输入节点输出 formInputResult,用户选择节点输出 selectResult,两者都以字段值的形式交给后续节点,不会自动变成判断条件。把这两个输出当成“读表单字段判条件”的开关,是这一环最常见的误解。

交接时按三步核对:先在节点里确认字段名与类型,标明哪些是必填;再在后续节点里逐个引用这些字段,试跑一次确认能取到值;最后检查选择分支是否都连到了后续节点,没有连到的分支在试跑时会出现空值。交互状态由交互节点在运行中记录,不需要额外配置全局开关;表单提交后字段值进入后续节点的引用列表,选择节点则按所选分支继续。

验收样本可以准备三组:字段齐全、必填缺失、选择走另一条分支。每组记录提交内容、字段取值与后续节点实际收到的东西,三组都能对上才算交接完成。字段取不到值时先查引用是否正确,再查节点是否真的执行到这一步。

References

References