通过openness功能启动SiVArc服务

TIA portal openness 应用程序允许将 SiVArc 实例化。必须使用客户端应用程序访问 TIAportal，并通过 openness 功能启动 SiVArc 服务。

设置应用程序 :

要设置客户端应用程序，请按照以下步骤操作：

1. 创建控制台应用程序。从  _deployedTIAPV15SP1_11010001PublicAPIV15.1 936Siemens.Engineerin.dll 或安装的二进制位置 PublicAPIV15.1 937 Siemens.Engineerin.dll 添加公共 API (Siemens.Engineering.dll) 的参考。

2. 将组态详细信息添加到组态文件中。

3. 要访问 Sivarc 服务，请使用下述 API：

using (TiaPortal  tia = new TiaPortal(TiaPortaMode.WithUserInterface))

{

 Project myProject = tia.Projects.Open(new FileInfo(@"C:Usersz003exveDocumentsAutomationProject_DemoProject_Demo.ap15));

 //if SiVArc is not installed, user will not be able to access SiVArc service (compiler error)

 Sivarc sivarc =myproject?.GetService():

 if (sivarc !=null)

  {

  }

}

 SiVArc 服务属性 :

下表列出了 SiVArc 所支持的属性和方法：

AlarmRules	所有报警规则对象的锚对象	AlarmRulesBrowsable
ScreenRules	所有画面规则对象的锚对象	ScreenRulesBrowsable
TextlistRules	所有文本列表对象的锚对象	TextlistRulesBrowsable
TagRules	所有变量规则对象的锚对象	TagRulesBrowsable
CopyRules	所有复制规则对象的锚对象	CopyRulesBrowsable
报警规则	枚举所有即时的一级报警规则	AlarmRuleComposition
组	枚举所有即时的一级报警规则组	AlarmRuleGroupComposition
ScreenRules	枚举所有即时的一级画面规则	ScreenRuleComposition

ScreenRulesGroup	枚举所有即时的一级画面规则组	ScreenRuleGroupComposition
TextlistRules	枚举所有即时的一级文本列表规则	TextlistRuleComposition
TextlistGroups	枚举所有即时的一级文本列表规则组	TextlistRuleGroupComposition
TagRules	枚举所有即时的一级变量规则	TagRuleComposition
TagRulesGroups	枚举所有即时的一级变量规则组	TagRuleGroupComposition
CopyRules	枚举所有即时的一级复制规则	CopyRuleComposition
CopyRulesGroups	枚举所有即时的一级复制规则组	CopyRuleGroupComposition

 SiVArc 生成:

要求

● 启动 TIA portal openness 应用程序。有关连接的更多信息，请参见 TIA portal 用户指南。 

● 已存在连接到 HMI 设备的 TIA portal 项目，且已组态 PLC。

重要注意事项:

● 确保 PC 上已安装 SiVArc 许可证，否则生成期间会出现例外情形 -“SiVArc 许可证缺失，修改数据必须使用 SiVArc 许可证”。

● 确保使用有效的设备名称，否则会出现例外情形 -“未找到 HMI 设备的‘deviceName’”。

● 确保调用有效的 PLC 名称，否则会出现例外情形 -“未找到 PLC 设备的

‘plcDeviceName’”。

● 确保调用受支持的设备名称，否则会出现例外情形 -“不支持 HMI 设备的‘deviceName’”

● 确保调用受支持的 PLC 名称，否则会出现例外情形 -“不支持 PLC 设备的

‘plcDeviceName’”

● 确保传递有效的 GenerationOption 参数。如果未传递参数，将生成 SiVArc 并为 SiVArc生成使用默认的 TIAP 项目设置 

● 确保使用未用于先前生成的有效 PLC 名称，否则系统将冻结。 

要生成 SiVArc，请使用以下 API：

sivarc.Generate("HMI_1", new List  {PLC_1},

GenerateOptions.AllTags | GenerateOptions.FullGeneration);

生成成功后，SiVArc 生成将使用以下属性：

● IsGenerationSuccessful - 通知是否成功生成 SiVArc。 

● WarningCount - 生成 SiVArc 后的警告总数 

● ErrorCount - 生成 SiVArc 后的错误总数 

● 消息 - 形成反馈消息 

要生成 SiVArc 结果，请使用以下 API：

生成成功后，SiVArc 生成将使用以下反馈消息：

● 路径：反馈消息的标头文本（标头消息始终具有空白描述字段） 

● DateTime：反馈消息的日期时间 

● MessageType：反馈消息类型 

● 说明：反馈消息描述/内容（仅限于路径为空的情况，确保不是标头消息） 

● WarningCount：标头消息的警告数 

● ErrorCount：标头消息的错误数 

● 消息：形成反馈消息 (SivarcFeedbackMessage

可以使用以下代码片段查看递归的反馈消息：

----------------------END-----------------------

 

审核编辑 ：李倩