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 所支持的屬性和方法：

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-----------------------

審核編輯 ：李倩