跳转至

GetListContainsItem 列表包含元素判定节点

节点核心功能 (What is it?)

GetListContainsItem 节点是一个实用的列表元素存在性校验工具。它能够检查给定的母列表中是否存在指定的特定目标元素，并输出布尔值（True 或 False）作为判定结果。

典型适用场景 (When would I use it?)

在以下情况下使用 GetListContainsItem 节点：

  • 检查列表中是否包含某个关键数据或特定值；
  • 验证集合数据中是否已包含必要的前提字段；
  • 构建基于元素存在性判定的条件分支工作流（Conditional Branching）；
  • 依据元素是否存在来动态触发过滤、截断或告警流程；
  • 监视动态演算列表中是否浮现出特定的终止信号或错误标记。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 GetListContainsItem 节点。
  2. 将待检查的母列表接入 items 输入插槽。
  3. 将待判定的目标元素接入 item 输入插槽。
  4. 节点将自动完成匹配并从 contains_item 输出布尔判定结果。

参数输入插槽 (Parameters)

  • items：待检查的目标母列表（list 类型输入端）。
  • item：待检测存在性的目标元素项（支持任意数据类型 any）。

输出引脚 (Outputs)

  • contains_item：布尔类型输出标志位（boolean）：若在列表中找到了该项则输出 true，未找到则输出 false。

典型工作流示例 (Example)

在待办事项列表中核查特定任务是否已列入：

  1. 在画布中添加 GetListContainsItem 节点。
  2. 将任务清单列表连入 items 输入插槽。
  3. 将包含 "发布版本上线" 的文本节点连入 item 输入端。
  4. 节点的 contains_item 引脚将即时返回 true（已包含）或 false（未包含）。

关键技术特性 (Important Notes)

  • 精确全等匹配 (Exact Matching)：底层使用精准等值比较逻辑来检索元素；
  • 全自动响应式更新：只要输入列表的内容或待查项发生变更，判定布尔值立即自动重新推算；
  • 纯布尔标量输出：输出端始终为强类型的标准布尔值，方便直接接入逻辑门或分支条件；
  • 严格防御未连接状态：若母列表或待查项任意一个引脚未连接，输出默认安全返回 false。

常见问题与排查 (Common Issues)

  • 字符串大小写敏感 (Case Sensitivity)：字符串比对严格区分大小写（例如 "OK" 与 "ok" 不会被视作包含）。
  • 数据类型严格匹配 (Type Mismatch)：注意避免将数值 1 与字符串 "1" 混合检索，两者类型不同判定为 false。
  • 非法输入容错 (Invalid Input)：若传入的不是合法的列表容器，节点将安全地返回 false 而不报错中断。