SOLIDWORKS PDM XML 导入与导出规则说明

SOLIDWORKS PDM 专业版内置了大量可减轻繁琐文档整理与数据录入负担的功能。然而，若未正确理解、配置与实施，极少有工具能发挥应有作用。为此，智诚科技ICT通过本文将详细讲解 PDM 中 XML 导入 / 导出规则的用途、设置方法与故障排查思路。

一、什么是 XML 导入 / 导出规则，其作用是什么？

在深入主题前，有必要先理解 XML 导入 / 导出的核心逻辑。SOLIDWORKS PDM 专业版中的 XML 导入与导出规则，是用于自动化实现 SOLIDWORKS PDM 文件库与外部系统之间数据传输的功能。

导出：顾名思义，导出规则用于自动生成包含数据（特指物料清单 BOM）的 XML 文件，供 SOLIDWORKS PDM 文件库外部使用。这些 XML 文件可被企业资源计划（ERP）、产品生命周期管理（PLM）等其他系统读取解析。

导入：导入规则则用于通过变量赋值的方式，将 XML 文件中的数据导入并关联至 SOLIDWORKS PDM 文件库内的指定文件。

你可能仍会疑惑这项功能的价值所在。如前文所述，手动同步这类数据往往依赖人工录入，既容易引发数据人为错误，也会造成导入 / 导出流程的效率瓶颈。若两类系统无法通过软件接口直接协同，允许它们通过 XML 文件传递数据便是最优替代方案。

二、示例应用场景

单纯说 “可通过导入 / 导出规则实现 XML 数据在 PDM 内外的流转”，很难让你直观感受到其价值。为此，下文列举两种最常见的 XML 规则应用场景，后续讲解设置步骤时会再次结合这些场景说明。

场景 1：导出 —— 设计定稿后将零件 / 装配体数据发送至 ERP 系统

ERP 系统通常需要详细的装配体或零件数据，因此你的业务流程中可能包含这一环节：在零件或装配体完成审批后，提取其属性与数据，以 XML 文件形式传递至 ERP 系统。此类导出可通过状态过渡动作触发。

场景 2：导入 —— 将文件迁移至 PDM

假设你有一批在 PDM 文件库外创建的文件，其数据卡缺少对应信息。若这些数据在其他位置有记录，且可整理为合规的 XML 文件，即可通过 XML 规则将信息导入 PDM，数据卡上的变量值会在文件下一次状态过渡时自动更新。

三、创建规则

确定 XML 导入 / 导出规则的用途后，接下来的问题便是：如何创建规则？

打开 PDM 管理工具，展开数据导入 / 导出节点。

右键单击导出规则或导入规则，选择新建导出规则/新建导入规则。

导入规则参数

规则名称：设置该导入规则的名称。

轮询导入文件夹的频率：设定系统每隔多久（分钟）扫描指定文件夹，检测待导入的新文件。

建议：设置频率过高会拖慢系统性能，通常推荐 5–10 分钟扫描一次。

从以下文件夹导入：存储待导入文件的文件夹路径，一般为文件库外的目录。可直接粘贴路径，或点击浏览按钮选择目标位置。

重要要求：该路径必须能被运行 PDM 数据库服务器服务（非 SQL 服务）的账户访问，且账户具备完全读写权限；若使用网络位置，务必采用通用命名约定（UNC）路径，而非映射驱动器路径。

使用的变量别名集：若已创建变量别名集，可在此处选择（后文会详细说明）；若导入数据的字段标签 / 表头与 PDM 变量名一致，可选择不使用别名集。

导出规则参数

规则名称：设置该导出规则的名称。

将 XML 文件输出至以下文件夹：存储导出生成文件的文件夹路径，一般为文件库外的目录。可直接粘贴路径，或点击浏览按钮选择目标位置。

重要要求：该路径必须能被运行 PDM 数据库服务器服务（非 SQL 服务）的账户访问，且账户具备完全读写权限；若使用网络位置，务必采用通用命名约定（UNC）路径，而非映射驱动器路径。

输出 XML 文件名：可使用固定文本，和 / 或基于源文件的动态变量（通过 > 按钮插入），为每个文件生成唯一名称。

注意：若同名文件已存在，系统会自动在文件名末尾追加数字序号确保唯一；无需手动输入 .xml 后缀，系统会自动添加。

要导出的数据类型：

CAD BOM：为包含 CAD BOM 的工程图或装配体文件生成 XML 文件。XML 中包含 / 排除的变量、配置、参考关系由 BOM 布局决定，而非导出规则；工作流过渡必须启用动作中的针对文件运行选项，才能正常触发该导出。

计算 BOM：从计算 BOM 导出数据，只要已定义 BOM，可为所有文件生成 XML 文件；工作流过渡必须启用动作中的针对文件运行选项，才能正常触发该导出；若需导出切割清单或项目 BOM，需选择计算 BOM类型，并在下方下拉菜单中选用已配置好包含切割清单 / 项目的计算 BOM 模板。

命名 BOM：导出命名 BOM，与 CAD BOM 一致，变量由 BOM 模板布局定义，而非规则本身；工作流过渡必须启用动作中的针对命名 BOM 运行选项，才能正常触发该导出。

以表格格式导出 BOM：将输出格式化为与界面显示一致的平铺表结构；取消勾选则按装配体树状层级结构格式化数据。CAD BOM 与命名 BOM 固定为表格格式，不可修改。

仅导出已激活的 BOM：仅当 CAD BOM 或计算 BOM 标记为 “已激活” 时，才执行导出。

变量选项卡（仅选择计算 BOM 时显示）：

要导出的物料清单：选择需使用的 BOM 模板，模板在管理工具的物料清单节点中创建。

用于识别文件的变量：用于唯一标识文件的变量值，建议默认使用SOLIDWORKS PDM 文件 ID，文档编号、文件名等变量也可正常使用。

XML 文件中使用的别名集：若输出数据需要转换字段标签 / 表头，选择对应的别名集。

配置选项卡（仅选择计算 BOM 时显示）：选择需包含在导出中的配置。

文件参考选项卡（仅选择计算 BOM 时显示）：选择需包含的参考关系类型与版本。

变量别名集

若你的 ERP 或其他外部系统要求使用特定字段名接收数据卡已映射的变量值，但 PDM 变量名与外部系统字段名不匹配，可通过别名集将导出 XML 文件中的变量名替换为外部系统所需名称。操作方式为：在左侧选择 PDM 中的指定变量，在右侧输入对应外部系统的别名字段名。

别名集非必选配置，若未选择，系统将直接导出原变量名。

四、触发导入 / 导出规则

规则创建完成后，需指定触发规则的工作流状态过渡。设置步骤如下：

1、在 PDM 管理工具中，展开工作流，双击编辑目标工作流。

2、点击需运行 XML 规则的状态过渡。

3、切换至动作选项卡，点击添加动作。

4、在类型下拉菜单中，选择将数据导出至 XML或从 XML 导入数据。

• 若为将数据导出至 XML：选择已创建的导出规则。

• 若为从 XML 导入数据：指定待导入的文件名（无特殊需求可使用通配符 *，为默认值）。

按需配置其他动作参数，点击确定保存。

规则与动作配置完毕后，即可实现自动化数据流转。导出规则的运行逻辑相对简单：文件触发状态过渡后，系统按规则生成 XML 文件并保存至指定路径。

导入规则的运行流程更复杂：

将格式合规的 XML 文件放入指定导入文件夹。

数据库服务器服务通常会在 60 秒内检测到该文件。

数据库服务器服务将 XML 数据加载至数据库，等待调用。

当零件、装配体或工程图触发带有从 XML 导入数据动作的状态过渡时，系统将导入的数据写入对应文件的数据库记录。

五、导入所用的 XML 格式规范

上文示例仅展示了 XML 数据应用于模型 / 工程图文件的场景，但 XML 导入还可实现其他功能，具体用途由 XML 文件格式决定。

你可在 SOLIDWORKS 安装目录下查看示例导入文件及其格式，路径为：

…\SOLIDWORKS Downloads\SOLIDWORKS 20XX SPXX\SWPDMClient\Support\ERP

SOLIDWORKS 同时提供了通用格式规则，用于理解这些示例 XML 文件：

XML 文件头中声明的编码格式，必须与文件实际保存的编码格式一致。

每个 XML 文件中，所有 ID 按类型必须唯一（同类对象不可重复使用 ID）；不同类型对象（文件与文件夹）可使用相同 ID。

所有 ID 必须大于 0，1 及以上为有效值，0 无效。

属性值视为文本，必须用双引号包裹（字母数字属性均需加双引号，如 id="a"、id="3"）。

XML 保留字符不可直接使用，需替换为转义字符：

< → &lt;

> → &gt;

& → &amp;

' → &apos;

" → &quot;

XML 文件必须包含 DTD 声明（文档类型声明），通常在文件第一行或第二行通过 DOCTYPE 语句实现。

六、故障排除

以下是使用导入 / 导出规则时常见的问题及对应的解决步骤。

问题 1：导入失败

现象：导入后，文件应从导入文件夹中消失，若超过轮询间隔仍未消失，说明规则执行失败。

解决步骤：

确认 SOLIDWORKS PDM 数据库服务器服务 正在运行。

确认 PDM 数据库服务器服务对导入文件夹具备访问权限。

若导入文件夹位于网络位置，尝试将其移至运行 PDM 数据库服务器服务的服务器本地路径，并更新导入规则中的路径。

若必须使用网络位置，务必使用 UNC 路径，而非映射驱动器。

确认 XML 文件未设置为只读属性。

确认 PDM 数据库服务器服务的登录账户对目标文件夹具备读写权限。

查看托管数据库服务器的服务器中的事件查看器日志（事件查看器 → Windows 日志 → 应用程序），排查相关错误。

确认 XML 文件格式合规。

问题 2：XML 文件名缺失变量值

现象：导出文件名为 .xml、001.xml、002.xml 等，或部分文件名正确、部分显示为 变量名-序号.xml。

原因：输出文件名设置为 [变量名][序号].xml，但部分文件无该变量值，或该变量未在所有文件的数据卡上配置。

解决步骤：

检查输出 XML 文件名设置是否正确。

确认所有文件均包含文件名所用的变量，且变量已赋值。

问题 3：导入 XML 时特殊字符无法识别

现象：包含特殊字符的文件名、变量显示异常或缺失。

原因：XML 文件头使用错误编码（如 UTF-8），文件头声明编码与实际保存编码不一致。

解决步骤：

用记事本打开 XML 文件，检查文件头中的编码声明。

修正文件头编码，按正确编码重新保存文件。

问题 4：错误：找不到与节点 [document] id 属性匹配的变量值

现象：特定值导入失败，Windows 应用程序日志中出现错误，提示：

无法找到与节点 id 属性 DocNumber（变量 ID 142）匹配的变量值 S-2014-0034

指定的变量不存在

原因：导入规则需要通过唯一标识定位文件并更新变量值，若 XML 中的标识数据在 PDM 数据库中无匹配项，或变量名不对应，即触发该错误；也可能是 XML 格式问题（如匹配文件所用变量时，pdmweid 未设为 0，或配置专用变量未填写 idcfgname）。

解决步骤：

查看错误信息，定位未匹配的变量值。

确认文件标识变量与 XML 中的值一致。

检查 XML 中 pdmweid 与 idcfgname 字段设置是否正确。

问题 5：错误：数据库中未找到数据导入 / 导出项

现象：PDM 处理 XML 导出的 BOM 时出错，事件查看器提示：

无法处理数据库 [数据库名] 中的导出批处理

解决步骤：

该错误通常需要编辑 SQL 数据库解决，建议联系智诚科技IC技术支持协助安全处理或公司内容的技术。

问题 6：数据库服务未运行

现象：XML 导入 / 导出规则依赖 PDM 数据库服务器服务，服务异常时还会伴随以下症状：

• 通知无法发送（SMTP 与数据库类型通知均失效）

• 文件库视图不自动刷新（无法实时显示新文件、变量更新、检入 / 检出状态）

• 数据卡列表加载异常（SQL 列表显示旧数据或无法加载）

• 冷存储功能异常

• 定时复制失败（按需复制仍可正常运行）

解决步骤：

1、打开 Windows 服务，找到 SOLIDWORKS PDM 数据库服务器服务。

2、确认服务状态，未运行则尝试启动。

3、服务启动后，会自动处理积压的消息与导出任务，处理时长取决于队列长度。

若服务无法启动，说明存在深层问题，联系技术支持排查。

4、若服务已运行，检查事件查看器应用程序日志，排查 SQL 登录相关错误。

5、确认归档服务器服务与数据库服务器服务所用 SQL 用户名、密码正确，密码丢失可参考官方指南重置 SA 凭据。

七、最后说明

XML 导入与导出规则是实现 SOLIDWORKS PDM 数据内外迁移的灵活方案。除本文所述步骤外，该功能的成功配置与使用往往需要多次调试，建议在经验丰富的 PDM 管理员指导下实施。

有任何疑问可随时联系SOLIDWORKS经销商智诚科技ICT的技术支持团队获取协助！电话：400-886-6353