"EPLAN API Extension"插件中的更新

针对 EPLAN 平台的产品提供统一、性能优良的编程接口(API,Application Programming Interface,应用程序接口)。通过此扩展模块（EPLAN API）可与 EPLAN 或其它合作伙伴合作开发为您量身定制的解决方案。有关 EPLAN API 和 EADN 的更多信息，请参阅 EPLAN 网页中的"解决方案 > Integration > EPLAN Application Developer Network"栏目。下面一节将向您介绍在 EPLAN API 中的不同更新。为了可以通过新版本的 EPLAN API 开发自己的应用该程序，需要具备 Microsoft 的 .NET Framework 4.5.2。

说明：

"EPLAN API Extension" 插件在我们的 EPLAN Application Developer Network (EADN) 框架中可作为下列程序变量的开发包选购:
EPLAN Electric P8 Select、EPLAN Electric P8 Professional、
EPLAN Electric P8 Professional+、EPLAN Electric P8 Ultimate、
EPLAN Fluid、EPLAN Fluid Professional、
EPLAN Fluid Professional+、EPLAN Fluid Professional E、
EPLAN Preplanning P&ID、EPLAN Preplanning Professional、
EPLAN Pro Panel Professional、EPLAN Pro Panel Professional+。
此外，也可针对"标准"许可"获取EPLAN API Extension"插件（EPLAN Electric P8 Compact、EPLAN Fluid Compact 除外）。

提示：

我们建议每位 API 用户，及早通过新版本的 EPLAN API 汇编和测试自己的应用程序。如果仍在应用程序中使用过时的方法，汇编时会为此显示一条相应的程序编译器警告。

绘制云

借助 EPLAN API，现在也可以以云的形式绘制长方形或多边形。为此，必须对 FillPattern 属性在 Rectangle 或 PolyLine 类别中进行相应地确定。

移除的数据导入方法

在 EPLAN API 内，已从 EPLAN 21 和 EPLAN 5 中移除了多个数据导入方法。

更新项目主数据

借助新动作 masterdata，您可以现在将主数据通过脚本的命令行调用或通过 EPLAN API 更新。此时，通过 /TYPE:UPDATEPROJECT 参数确定要更新项目主数据。在 EPLAN 平台的用户界面中对应于工具 > 主数据 >更新当前项目菜单项。

用于"generatemacros"操作的新参数

已为 generatemacros 操作扩展了以下可选参数：

PAGENAMEn : 待考虑页的名称
INSTALLATIONSPACENAMEn : 待考虑布局空间的名称
STRUCTUREn : 待考虑布局空间的结构标识符
WINDOWMACRODIR : 窗口宏的目录
PAGEMACRODIR : 页宏的目录
FILTERSCHEME : 筛选器配置
OVERWRITE : 覆盖模式。

在这里，"n" 代表一个数字。

生成管路定义点和管路连接点

类似于用户界面中的插入 > 管路定义点和插入 > 管路连接装置菜单项，现在也可以通过 EPLAN API 生成并编辑管路定义点和管路连接装置。为此,可在 Eplan.EplApi.DataModel 命名空间中使用新的 PipingDefinition 类别。

在放置时归入箱柜层结构

为了在 3D 安装布局中放置部件时也可以考虑 EPLAN API 中的归入箱柜层结构设置，已为 Placement3D 类别扩展了附加方法 FindSourceMate。

通过 EPLAN Data Portal 更新部件

借助 EPLAN API，现在也可以通过 EPLAN Data Portal 更新部件管理中的部件。为此，等级 MDPartsDataBase 已扩展了新的 UpdatePartFromDataPortal 方法。

为功能模板和连接点排列样式分配总线接口名称

为了也能够通过 EPLAN API 为部件管理中总线端口的功能模板分配一个总线接口名称，可使用 MDPlcTemplatePosition 类别中的新属性 BusSystem。

由于总线接口名称也可以在部件管理的连接点排列样式中以及特定功能上的连接点排列样式中输入(例如 3D 部件放置)，因此已相应地为 MDConnectionPointPosition 和 ConnectionPointPosition 类别扩展了新属性 PLCBusInterfaceName。

将功能模板合并为模板复合

借助新方法 TemplateGroup (来自 MDFunctionTemplatePosition 类别)，现在可以通过 EPLAN API 在部件管理中将配套功能的功能模板合并为一个模板复合。

将数值输出为多语言文本

使用 PropertyValue 类别中的 GetDisplayString 新方法，可从用户界面中输出多语言、有意义的属性文本，而不是数字属性值。

使用新路径变量

借助 PathMap 类别和已有的 SubstitutePath 方法，现在 EPLAN 平台的所有新路径变量均可用（程序变量、项目变量和环境变量）。

从规划对象的宏访问值集

现在还可通过 EPLAN API 访问存储在规划对象上的宏以及宏中定义的带值集的占位符对象。为此可在 PlanningObject 类别中使用新的属性 MacroPlaceHolderValueSets。

在功能模板中确定接线能力

在从 MDFunctionTemplatePosition 类别中派生出的某些类别（例如 MDTerminalTemplatePosition）中，现在可使用新的 ConnectionDimension 属性。借助此属性，现在可通过 EPLAN API 在功能模板中确定某个部件的接线能力。