中止图形节点
概述
Abort Graph节点用于立即停止整个图的执行。它可以"成功"中止图(提前退出),也可以"错误"中止图。这对于在某些条件下停止图执行或处理错误非常有用。
- 输入
- 输出
- 编辑器设置
输入项
标题 | 数据类型 | 描述 | 默认值 | 备注 |
---|---|---|---|---|
Data or Error | any | The data or error message to be used when aborting the graph. If it's a string, it will be used as the error message for error aborting. | N/A | None |
Successfully | boolean | Determines whether the graph should be aborted successfully or with an error. | true | Only available if the "Successfully Abort" setting is toggled on in the node's settings. Otherwise, the node's setting value will be used. |
输出
此节点没有任何输出。
编辑器设置
设置 | 描述 | 默认值 | 使用输入切换 |
---|---|---|---|
成功中止 | 确定图形应成功中止还是以错误中止。 | true | Yes |
错误信息 | 当因错误中止图形时要使用的错误消息。仅在未勾选"成功中止"时使用。 | (空) | 否 |
示例1:成功中止一个图形
- 在您的图表中添加一个Abort Graph节点。
- 确保勾选了"Successfully Abort"设置。
- 将任意节点连接到Abort Graph节点的
Data or Error
输入。这可以是一个条件、一个值或其他任何内容。 - 运行您的图形。图形将在处理完Abort Graph节点后立即中止,后续节点将不会执行。
示例2:中止带有错误的图形
- 在您的图表中添加一个Abort Graph节点。
- 取消勾选"Successfully Abort"设置。
- 可选地,在"Error Message"设置中输入错误信息。当图表中止时,此消息将用作错误信息。
- 将任何节点连接到Abort Graph节点的
Data or Error
输入。如果该节点输出字符串,当图形中止时,该字符串将用作错误消息。 - 运行您的图形。图形将在处理Abort Graph节点后立即中止,后续节点将不会执行。将显示错误消息,可能是来自
Data or Error
输入的错误消息,也可能是来自"Error Message"设置的错误消息。
错误处理
中止图节点本身不会产生任何错误。然而,当它被处理时,无论成功还是出错,都会导致整个图停止执行。
常见问题
问:如果我将非字符串节点连接到Data or Error
输入会怎样?
A: 如果节点输出一个字符串,当图形中止时该字符串将被用作错误信息。如果节点没有输出字符串,该输出将被强制转换为字符串。
问:如果我将节点连接到Successfully
输入端口,但未勾选"Successfully Abort"设置,会发生什么?
A: Successfully
输入将被忽略,图表将因错误而中止。
问:如果我没有连接任何内容到Data或Error
输入端口,或者将"Error Message"设置留空会怎样?
A: 图形将被中止,并显示默认错误消息"Graph aborted with error"。