用户自定义组件允许创建自定义的组件序列并在 RFEM 6 中使用。除了在 Dlubal 中心中提供的序列，还可以集成公司特定的设计逻辑和细部验算。
前提条件
创建和计算用户自定义组件需要满足以下条件：
- Dlubal API 的基础订阅
- 在外部网创建 API 密钥
- 在 RFEM 中集成 API 密钥
在外部网创建 API 密钥
- 打开外部网
- 导航到 API & Cloud → API II → My API Keys
- 选择 Create new API key
- 指定名称并生成密钥
- 保存
在 RFEM 中集成 API 密钥
- 打开 RFEM
- 打开菜单 视图 → 控制台
- 选择 Python | Dlubal API | gRPC
- 选择钥匙符号
- 输入 API 密钥（名称 + 密钥）
- 确认
密钥将保存在 config.ini 文件中。
创建用户自定义组件
您可以按以下方式激活用户自定义组件的输入：
- 打开 组件序列 对话框。
- 勾选 用户自定义 选项。
由此，所有输入字段都将被解锁。
类别（元数据）
- 分配类型（例如对象分配）
- 制造商 / 新制造商
- 规范及输出
- 功能 / 类别
- 材料
配置文件（文件）
1. 图片
- 添加任何图片或系统简图
- 用途：组件的可视化呈现
2. 参数结构（JSON 文件）
- 输入结构的分组
- 定义参数分配
重要字段：
| group |
|
|
|
|
|
| key |
|
| caption |
|
|
|
| symbol, unit |
|
| type |
|
可以随意添加其他组。
3. 参数数据（Excel 文件）
- 数据定义参数结构。
- 每行都必须唯一命名。
- 列可自由定义，但需保持一致使用。
4. 可视化（RFEM 6 文件）
- 允许在 RFEM 工作窗口中详细可视化
- 但组件也可以在没有可视化文件的情况下生成
Python 脚本（计算后脚本）
计算后脚本控制组件的验算。
函数： define_design_checks
- 定义验算类别
- 类型 = 在 RFEM 中的显示（可自由选择）
- 描述、类别和子类别可自由定义
函数： evaluate_single_check
- 将利用率传递给 RFEM
函数： setup_component_series_data()
- 执行设计验算
- 通过 properties_parameters 读取参数
- 密钥必须与 JSON 和 Excel 完全相同
- 定义和计算之间的类型必须一致
在 Dlubal 中心保存和重复使用组件
您可以将用户自定义组件保存为模板，以便在其他项目中使用。
请按以下步骤操作：
- 在 组件序列 对话框中点击下方的
按钮。 - 将出现“保存组件序列”窗口，建议的保存文件夹为 文档 → Dlubal Software → Component Series。
- 指定文件名，然后点击 保存 按钮确认。
用户自定义组件会在 Dlubal 中心的 组件序列 类别中补充。在 Owner → 用户自定义 条目下，您可以选择相应的组件并分配给一根杆件。
或者，您也可以使用 组件序列 对话框下方的
按钮，从文件中读取组件。
