Functoid输入链接拖不动主因是参数超限、类型不匹配或Functoid被锁定；常量须通过配置对话框添加；Table Looping与Table Extractor须成对且左右布局；自定义Functoid ID需＞6000且全局唯一。
Functoid 输入链接拖不动？大概率是参数超限或类型不匹配
在 BizTalk Mapper 中，把源架构节点拖到 Functoid 上却没反应，或光标变成带斜杠的圆圈（?），说明当前无法建立有效输入链接。常见原因有三个：
• 拖放目标 Functoid 已达到最大输入数（例如 Value Mapping 最多 2 个输入，String Concatenate 最多 100 个）；
• 源节点数据类型与 Functoid 期望类型不兼容（如把日期字段拖给只接受字符串的 Lowercase，虽能连上但运行时报错）；
• 当前网格页未激活，或目标 Functoid 被锁定（右键属性中勾选了 Locked）。
解决方法：先双击 Functoid 打开 配置 <functoid></functoid> 对话框，确认 SetMinParams / SetMaxParams 设置，再检查源节点是否为可展开的重复记录（如循环节点需配合 Table Looping 而非直接拖入逻辑判断类 Functoid）。
常量参数必须用“配置 Functoid”对话框添加
你无法通过拖拽方式往 Functoid 添加常量值——所有 "Hello"、123、true 这类硬编码输入，都必须进 配置 <functoid></functoid> → Functoid 输入 选项卡，点击 + 按钮手动插入新行，再填入值。
• 常量会显示为 Input[2] 这类索引项（而非连线），顺序会影响逻辑（例如 Equal functoid 中，第一个输入是左操作数，第二个是右操作数，常量放错位置会导致恒假）；
• 若常量含空格或特殊字符（如 "Order ID"），必须加英文双引号；
• 数字常量不要加引号，否则会被当字符串处理（5 ≠ "5" 在 Greater Than 中结果不同）。
表循环（Table Looping）和表提取（Table Extractor）必须成对出现且严格左右布局
Table Looping 和 Table Extractor 不是独立可用的 functoid，它们构成一个「数据驱动循环」单元：
• Table Looping 必须放在左侧，接收源架构中的**重复记录**（如 /Orders/Order）作为第一输入；
• 它的输出**不能连到任意目标节点**，只能连到右侧的 Table Extractor 输入口；
• Table Extractor 必须放在 Table Looping 右侧，且每个输出端口对应表中一列（你在 配置 Table Looping 中定义的列数，必须和 Table Extractor 连出的目标字段数一致）；
• 如果漏掉 Table Extractor，或者把它连到别的 functoid 上，映射编译会通过，但运行时生成的 XSLT 会丢弃循环体内容，目标实例中只出现空记录。
自定义 Functoid 的 ID 必须 >6000 且全局唯一
如果你开发了继承自 BaseFunctoid 的自定义 functoid，部署后在工具箱里看不到它，最可能的原因是 ID 设置违规：
• Identify 属性值必须是大于 6000 的整数（如 6001），小于等于 6000 的 ID 被 BizTalk 内部保留；
• 同一解决方案中所有自定义 functoid 的 ID 绝对不能重复，否则后加载的会覆盖前一个，Mapper 只显示一个；
• 修改 ID 后必须重新编译、GAC 注册、重启 Visual Studio，且确保 SetupResourceAssembly 指向正确的资源程序集（命名格式应为 YourProjectName.Resources）。
这个 ID 错误不会报编译异常，只会让 functoid “隐身”，排查时容易绕远路。
真正麻烦的从来不是怎么连线，而是连完之后 XSLT 输出和你预期不一致——因为 BizTalk Mapper 的可视化逻辑和底层 XSLT 生成规则之间存在几处关键断层，比如输入参数顺序、常量求值时机、Nil 处理优先级。动手前务必打开 配置 <functoid></functoid> 看清每个 Input[n] 的实际来源，而不是依赖连线位置做判断。
