BizTalk Server XML映射器生成BTS2000格式.btm文件而非标准XSLT；拖拽字段不生成Value Mapping Functoid主因是源/目标节点类型不匹配，需手动添加转换Functoid；Looping Functoid仅声明循环处理，实际迭代由源maxOccurs和绑定决定；Scripting Functoid要求public static方法且返回明确类型；命名空间未配置会导致XML缺失xmlns声明。
BizTalk Server 的 XML 映射器（Mapper）不是通用 XSLT 编辑器，它生成的是编译后可执行的 BTS2000 格式映射文件（.btm），而非标准 XSLT；直接手写或外部导入 XSLT 到 Mapper 界面会失败，必须通过“导出为 XSLT”或“导入 XSLT 模板”方式间接协作。
为什么拖拽字段后没生成预期的 Value Mapping Functoid？
常见于源/目标节点类型不匹配：比如源是 xs:string、目标是 xs:integer，Mapper 默认不自动插入类型转换 functoid。它只在严格同类型（如 string→string）或存在内置隐式转换规则时才连线；否则连线呈虚线且无法保存。
- 手动拖拽前，先右键目标节点 → Properties → 检查
Data Type是否与源一致 - 若需转换，从左侧工具箱拖入
String Concatenate、Format Number或Scripting Functoid，再分别连接源和目标 - 避免对重复节点（
maxOccurs > 1）直接拖拽单个子元素——应先拖拽父节点，再在目标端展开其循环结构
Looping Functoid 连接后目标实例数仍不对？
Looping Functoid 不控制循环次数，只声明“此处需循环处理”，实际迭代由源节点的 maxOccurs 和绑定关系决定。如果源是单例但目标要求多实例，Mapper 会静默忽略 Looping Functoid；反之，若源有多个实例但未正确绑定到 Looping Functoid 输入，则只取第一个。
- 确保 Looping Functoid 的**第一个输入**连到源循环节点（如
/Root/Order/LineItem），而非其子元素 - Looping Functoid 的**输出**必须连到目标循环节点（如
/Root/Invoice/Item），不能连到其内部字段 - 若源数据运行时可能为空（
minOccurs=0），需配合Logical Existence Functoid过滤，否则空源仍触发一次循环
如何让 Scripting Functoid 正确调用 C# 脚本并返回值？
Scripting Functoid 默认使用 Inline C# 模式，但函数签名和返回逻辑极易出错：它不接受 void 方法，所有脚本必须声明为 public static 且返回明确类型；参数顺序严格按连线顺序传入，无命名绑定。
public static string GetFormattedDate(string inputDate)
{
if (string.IsNullOrEmpty(inputDate)) return "";
DateTime dt;
return DateTime.TryParse(inputDate, out dt)
? dt.ToString("yyyy-MM-dd")
: "";
}- 脚本中禁止使用
Console.WriteLine、Debug或任何依赖上下文的对象（如Microsoft.BizTalk.Message.Interop.IBaseMessage） - 若需多参数，Funcoid 上方显示的参数框顺序必须与脚本方法签名完全一致，否则抛
ArgumentException - 调试建议：先在 Visual Studio 中验证脚本逻辑，再粘贴进 Funcoid；运行时报错信息只显示行号，不显示具体异常类型
Mapper 最容易被忽略的是命名空间处理——源/目标 Schema 若含 targetNamespace，但映射中未勾选 Use Default Namespace 或未在 functoid 中显式设置，会导致生成的 XML 缺失 xmlns 声明，下游系统解析失败。这个细节不在 UI 显眼位置，却直接影响生产集成稳定性。
