mapforce不支持直接读取excel文件，必须先转换为xml、数据库或规范csv。推荐用python或power query转xml/sqlite，csv需严格遵循rfc 4180并设utf-8编码；多sheet或动态文件需借助外部脚本预处理。
Excel数据源在MapForce里必须转成XML或数据库中间层
MapForce本身不支持直接读取.xlsx或.xls文件作为原生数据源——它只认结构化、可解析的格式，比如XML、JSON、数据库表、CSV（需严格限定）、EDIFACT等。Excel文件本质是二进制容器（.xlsx）或复合文档（.xls），MapForce无法直接提取sheet结构和类型信息。
所以实际做法不是“让MapForce连Excel”，而是先做一层转换：
- 用Power Query、Python
pandas.read_excel()或 Excel自带“另存为CSV”导出为.csv（注意：仅适用于单sheet、无公式/合并单元格/多表头的简单场景） - 更稳妥的方式是用脚本（如Python）把Excel转成
.xml，并确保根节点、重复元素命名与MapForce目标结构对齐 - 或者把Excel导入到SQLite / SQL Server LocalDB，再通过MapForce的
Database连接器接入（适合多sheet、有关系、需类型校验的场景）
用CSV中转时必须手动处理分隔符和编码问题
很多人导出CSV后在MapForce里加载失败，报错类似Unexpected character encountered或字段错位，根本原因不是MapForce问题，而是CSV生成不规范。
关键控制点：
- Excel「另存为」时选
CSV (UTF-8)，不是CSV (MS-DOS)或默认的CSV (Comma delimited)（后者常是ANSI编码，中文会乱码） - 确保所有字段内容含逗号、换行、双引号时，被
"包裹，且内部双引号写成""（这是RFC 4180标准，MapForce CSV解析器严格依赖此规则） - 在MapForce中添加CSV数据源后，双击打开配置面板，手动确认
Field delimiter设为,、Text qualifier设为"、Encoding选UTF-8
映射时别直接拖Excel字段名，要核对CSV/XML里的实际标签
MapForce界面里看到的字段列表，来自你提供的CSV头行或XML Schema，不是原始Excel的列名。如果Excel列名含空格、括号、斜杠（如客户名称(最新)），导出CSV后可能变成客户名称_最新_或截断，XML里更可能被转义成。
正确做法：
- 导出CSV后，用文本编辑器打开第一行，确认真实字段名；导出XML后，用浏览器或VS Code打开，看
<row></row>下子元素名 - 在MapForce中右键CSV或XML数据源 →
Edit Schema，检查每个element的name属性是否与你期望一致 - 若不一致，不要强行改映射线，而应回源头修正导出逻辑（比如pandas导出时用
df.columns = ['cust_name', 'order_date']统一重命名）
动态Sheet或多个Excel文件需要用External Functions绕过限制
MapForce不支持运行时切换Excel文件路径或读取不同sheet——它的数据源路径是静态配置的。如果你需要“每次跑不同月份的data_202405.xlsx”，或“自动遍历Sheet1到Sheet3”，纯MapForce做不到。
可行方案只有两个：
- 写一个Shell/PowerShell脚本，用
libreoffice --headless --convert-to csv或in2csv批量转所有Excel为CSV，再让MapForce固定读取输出目录下的merged.csv - 在MapForce中调用外部函数：
system-command执行Python脚本（如python excel_processor.py input.xlsx output.xml），然后让MapForce读取该脚本生成的output.xml——这要求你的MapForce许可证支持External Functions模块
这个环节最容易被忽略：你以为加个变量就能换Excel路径，其实MapForce的“变量”只影响XSLT或输出路径，不影响输入源绑定。
