solidworks properties.txt 无法读取自定义属性？

Question

在使用SolidWorks进行工程图或模型属性批量导出时，用户常通过`properties.txt`文件定义需提取的自定义属性。然而，部分用户反馈生成的文件无法读取自定义属性，仅显示默认属性（如作者、修改日期等）。该问题通常源于自定义属性名称拼写错误、未正确关联到配置，或属性未在“自定义”标签页中明确定义。此外，SolidWorks PDM环境下若文件未检出，也可能导致属性读取失败。确保属性名称大小写一致、使用英文字符，并确认`properties.txt`路径及格式符合SolidWorks规范（每行一个属性名），可有效解决此问题。

Answer 1

1. 问题背景与常见现象

在使用 SolidWorks 进行工程图或模型属性批量导出时，用户常通过 properties.txt 文件定义需提取的自定义属性。然而，部分用户反馈生成的文件无法读取自定义属性，仅显示默认属性（如作者、修改日期等）。这一现象在制造、机械设计及PLM系统集成场景中尤为突出。

典型表现包括：

• 导出结果中缺少关键字段（如“零件编号”、“材料”）；
• 属性值为空或显示为“未知”；
• properties.txt 被正确放置但未生效；
• 脚本调用 API 时返回空值。

2. 基础排查路径：从拼写到格式

首先应确认自定义属性名称是否准确无误。SolidWorks 对属性名大小写敏感，且不支持中文命名。例如，“PartNumber”与“partnumber”被视为两个不同属性。

错误示例	正确做法
零件号	PartNumber
Material (小写m)	Material
Revision_#	Revision

同时，properties.txt 文件必须遵循以下规范：

1. 每行仅包含一个属性名；
2. 文件编码为 ANSI 或 UTF-8 without BOM；
3. 路径位于 SolidWorks 系统设置指定的“属性文件搜索路径”中；
4. 禁止添加注释或空格前缀。

3. 深层原因分析：配置关联与属性作用域

SolidWorks 中的自定义属性可绑定至特定配置（Configuration），若当前激活配置未定义该属性，则即使其他配置存在也无法读取。

// 示例：VBA 中获取特定配置属性
Dim swApp As Object
Set swApp = Application.SldWorks
Dim Part As Object
Set Part = swApp.ActiveDoc
Dim customProp As String
Part.GetCustomInfoValue "ConfigName", "PartNumber", customProp

此外，属性必须在“自定义”标签页中明确定义，而非仅存在于“配置特定”或“摘要信息”中。许多用户误将“材料”等信息填入“摘要”而非“自定义”，导致自动化工具无法识别。

4. 固有环境限制：SolidWorks PDM 的检出机制影响

在 SolidWorks PDM 环境下，若文件处于“未检出”状态，大多数外部程序和宏无法访问其自定义属性内容，这是出于数据一致性和并发控制的安全策略。

graph TD
    A[开始批量导出] --> B{文件是否已检出?}
    B -- 否 --> C[跳过或报错]
    B -- 是 --> D[读取properties.txt]
    D --> E[解析属性列表]
    E --> F[遍历模型获取值]
    F --> G[输出至CSV/Excel]

解决方案包括：

• 在批处理前自动执行“检出”操作；
• 使用 PDM API 替代本地文件访问；
• 配置服务账户权限以绕过部分锁定机制（需管理员授权）。

5. 高级调试建议与最佳实践

对于拥有5年以上经验的IT或CAD开发人员，建议采用日志追踪与API监控手段定位问题根源。

检查项	验证方法	推荐工具
属性是否存在	IPartExtension.GetCustomPropertyNames	SolidWorks API Logger
文件路径有效性	FileSystemObject.Exists	VBA + Scripting.FileSystemObject
PDM 权限状态	IEdmFile5.IsLocked	EPDM SDK 示例项目

建立标准化模板库，并结合企业级属性管理策略（如统一命名规范、强制填写规则），可从根本上减少此类故障发生率。