SmartPlant Foundation二次開發及應用

摘 要：為了適應公司發展，盡快提高設計水平，并與國際接軌，我公司引進了美國Intergraph公司的SPE體系軟件。其中，SPF是一個針對工程信息管理的基礎平臺，具有開放的API開發接口，能夠根據用戶需求進行二次開發。本文著重介紹我公司使用VB.Net技術，對SPF進行的一系列開發，使SPF更加適應我公司實際，提高了軟件應用效率。

關鍵詞：SmartPlant Foundation；二次開發；API

1.前言

SmartPlant Foundation（簡稱SPF）軟件，是美國Intergraph公司SmartPlant Enterprise（簡稱SPE）體系軟件之一，是專門為工程公司、工廠業主、運營商設計的工程信息管理系統，能夠提高工程項目和工廠運營信息的有效性、完整性、準確性。

2.SPF的邏輯結構

SPF是基于數據庫的軟件。用戶可以從桌面客戶端或者瀏覽器界面，通過激活配置好的Method來調用處于API（應用程序接口，Application Programming Interface，簡稱API）層的Server API或Client API，從而實現對象的創建、更新、刪除、關聯等操作，并保存到數據庫中。SPF中的對象，都是由Schema這個概念實例化出來的。Schema是SPF的核心概念，描述了軟件的數據結構，以及SPE設計集成系統各個軟件之間進行數據傳遞的規則。它包括ClassDef、InterfaceDef、PropertyDef、RelDef等。

3.開發原理

開發工具：Microsoft Visual Studio.Net 2008

運行環境：SmartPlant Foundation 2009（04.03.01.05），.Net FrameWork 3.5

SPF是基于.Net技術開發的，具有開放的API開發接口，因此能夠根據用戶需求進行二次開發，并能與任何第三方平臺進行溝通。而進行二次開發的切入點就在SPF邏輯結構的API層。Server API開發能夠節省客戶端的執行時間，客戶端對對象的所有操作都由服務端負責，由服務端進行運算，性能較高；Client API的開發相對簡單一些，省時省力。在這個基礎上，我們使用VB.Net技術，結合公司實際需求，以Client API為接口進行了開發。

對SPF進行二次開發時，項目必須引用的系統自帶的幾個DLL，并繼承SPF.Client.APIs.Model這個基類，所有用戶操作時調用的Client API都繼承了這個基類。

通過程序開發生成的DLL，要經過SPF軟件的定制，才能被調用。要在SPF中創建一個Client API，其名字必須與程序中的類名相同，這樣SPF才能正常調用程序生成的DLL。而API是不能被用戶直接激活的，這就需要將Client API實例化成Method，并且由Menu作為Method的前臺觸發窗口，成為用戶使用二次開發功能的入口。

4.開發成果

4.1校審卡模塊

在文檔管理中，如何確保文檔質量就成了管理的關鍵問題。一般來說，設計都要有一套審核機制來保證設計成果及過程文件的質量。我們在SPF中定制了一套設校審流程，通過SPF工作流來對各個專業之間的資料、成果進行審核，保證各個專業之間提出去的資料都是經過審核的。雖然SPF能夠生成工作流程報告來查看校審記錄，但是其格式與樣式跟設計人員常用的校審卡表單差異較大，使用不方便，而且不能夠作為質量記錄由相關單位存儲。因此，必須通過開發，才能使軟件生成滿足公司質量記錄要求的校審卡表單。

開發的校審卡模塊能夠實現以下功能：

（1）提供用戶輸入界面：使設校審人員能方便地填寫校審意見，記錄校審過程中發現的文件錯誤數及等級評定，并將其存儲到數據庫中；

（2）提供校審卡預覽功能：能自動獲取信息并輸出到Excel，包括被校審文檔的文檔號和文檔類型、設校審人員填寫的校審意見、校審過程中發現的文件錯誤數及等級評定、校審人員名字及進行校審的時間，使設校審人員可以隨時查看被校審文檔的校審狀態及校審流程中各個步驟的校審意見；

（3）校審卡存檔：工程項目完成后，其責任人需對校審記錄進行收集、編號、整理歸檔。在軟件中存儲校審卡時，需按照一定規則對校審卡進行命名，并存放到相應文檔結構中，以便今后進行查閱；

（4）權限管理：使設校審人員各司其職，只能對自己的工作流步驟進行操作。

這樣，設校審人員在文檔流轉的過程中可以直觀的查看文檔的校審狀態，所填寫的相關信息也能夠存儲到數據庫，達到了使SPF自動生成滿足公司要求的校審卡表單的效果，從而保障校審工作優質高效的完成，確保設計質量進一步提高。

4.2文檔批量創建

工程設計項目涉及的專業多，產生的管理文件、交換文件、成果文件等各類資料數量較大，而這些文件都需要上傳到SPF中作為文檔進行管理。默認情況下，用戶只能通過手動操作填寫文檔屬性，將文檔一一創建到SPF中。面對龐大的文檔量，這樣的方式效率低下，是任何一個工程項目所不能容忍的。而文檔批量創建功能的開發，恰恰解決了這個問題。

用戶可以通過編輯Excel模版，在模板中填寫文檔必要屬性，然后從SPF菜單讀取Excel，將文檔批量創建到SPF中。Excel使用方便靈活，較之SPF表單繁復的操作，大大提高了工作效率。

4.3與公司一體化平臺結口

在引進SPF軟件之前，我公司一直使用上海金慧公司的一體化平臺進行項目管理。在使用SPF之后，我們對這兩個平臺進行了定位。目前，一體化平臺仍是公司企業級的項目管理平臺，SPF工作的重點以項目設計過程控制和數據管理功能開發為主。針對這個定位，一方面對一體化平臺進行修改，另一方面通過程序開發使SPF中的設計集成項目設計成果及過程文件也能通過一體化平臺進行存檔，保證了項目存檔的統一。

該功能的實現主要包括兩部分，一是將文檔從SPF中批量下載，二是將文檔批量導入至一體化平臺中。目前已經開發完成將SPF中的校審和互提文件自動導入到一體化平臺的功能，項目資料的接口正在開發中。

5小結

科學的管理必須與先進的技術相結合，落實到實踐中，才能發揮出事半功倍的效果。本文從SPF的邏輯結構、開發原理、開發成果等方面系統介紹了我公司在使用SPF軟件過程中，所做的二次開發工作，先后實現了校審卡模塊開發、文檔批量創建、與公司一體化平臺接口等功能。目前，這些功能已經在實際項目中得到了推廣，應用效果良好。

（作者單位：中石化石油工程設計有限公司）