Eplan API插件

Eplan API插件是針對EPLAN電氣設(shè)計軟件打造的，用于開發(fā)自定義功能和自動化任務(wù)。通過使用EPLAN API，用戶可以通過編程方式與EPLAN軟件進(jìn)行交互，以實現(xiàn)定制化的電氣設(shè)計和自動化流程。 EPLAN API提供了多個編程接口，包括 COM、.NET和C++等，以滿足不同開發(fā)需求和編程技術(shù)的選擇。用戶可以使用這些接口訪問和操作EPLAN軟件中的各種對象和數(shù)據(jù)，如項目、電路圖、設(shè)備、符號、線路等，以及進(jìn)行創(chuàng)建、修改和刪除等操作。 通過EPLAN API，用戶可以自動化執(zhí)行繁瑣重復(fù)的任務(wù)，提高工作效率和準(zhǔn)確性。例如，可以編寫腳本或程序來自動生成電路圖、創(chuàng)建數(shù)據(jù)報告、導(dǎo)入導(dǎo)出數(shù)據(jù)等。還可以與其他軟件和系統(tǒng)集成，實現(xiàn)數(shù)據(jù)的無縫傳輸和集成。 EPLAN API的開發(fā)需要一定的編程知識和技能，熟悉相關(guān)編程語言和開發(fā)環(huán)境。EPLAN還提供了詳細(xì)的開發(fā)文檔和示例代碼，以幫助開發(fā)人員進(jìn)行接口的學(xué)習(xí)和使用。 總之，Eplan API插件為開發(fā)人員提供了豐富的接口和功能，使他們能夠定制和擴(kuò)展EPLAN電氣設(shè)計軟件，以滿足各種特定需求和自動化任務(wù)。通過利用EPLAN API，用戶可以提高工作效率、減少錯誤，并實現(xiàn)更高級別的電氣設(shè)計和自動化流程。

功能介紹

1、產(chǎn)品模塊，EPLAN的重要業(yè)務(wù)之一是提供基于流程的工程解決方案，供您日后之需！EPLAN Electric P8可根據(jù)您的需求進(jìn)行靈活定制，比如說，您打算優(yōu)化當(dāng)前電氣設(shè)計，或?qū)⒃O(shè)計工具集成到現(xiàn)有的工程流程中。
2、直接編輯，“直接編輯”功能用于直接編輯文本，比如設(shè)備標(biāo)識符、功能文本或部件編號。激活該功能時，在原理圖中直接點(diǎn)擊元件，此時不會彈出設(shè)備屬性對話框，而是直接進(jìn)入編輯狀態(tài)，便于快速地修改文本。
3、項目方案選項，“項目方案選項”功能用于定義設(shè)備或機(jī)器的可選項，在EPLAN 中，將所有的可選項在導(dǎo)航器中創(chuàng)建為變量，通過簡單勾選來設(shè)定它的顯示和隱藏。只有激活的選項才會在圖紙中顯示，在生成報表的時候予以考慮。
4、逆向設(shè)計，通過”逆向設(shè)計“功能，無論在項目的何處進(jìn)行修改，其它相關(guān)聯(lián)的地方都會自動更改，無論使用的是面向圖形，還是面向?qū)ο蟮墓ぷ鞣绞?。工作方式與設(shè)計的流程密切相關(guān)，在項目進(jìn)行過程中可以隨時切換。
5、動態(tài)報表，使用動態(tài)報表，可以將報表放在原理圖中；也可以將多個報表合并到同一頁上。
6、宏變量/宏值集，僅需輕點(diǎn)鼠標(biāo)，就能對整個宏回路進(jìn)行替換(宏變量)，甚至可以對整個回路中的參數(shù)進(jìn)行快速分配(宏值集)，既高效、又低錯。

使用幫助

1、您正在閱讀的文檔分為兩部分：
-用戶指南向您介紹如何設(shè)置開發(fā)環(huán)境并開始開發(fā)或使用更高級的功能
-API參考。它詳細(xì)列出并詳細(xì)描述了EPLANAPI的所有名稱空間，類方法等。
API支持安裝程序以HTML和Microsoft幫助查看器格式安裝API幫助。通過這種方式，它可以在線訪問或從磁盤本地訪問（即在離線模式下）。
API幫助格式
在脫機(jī)模式下，可以通過桌面上的快捷方式（HTML格式）或VisualStudio（Microsoft幫助查看器）訪問API幫助，
后者是VisualStudio使用的標(biāo)準(zhǔn)幫助系統(tǒng)格式。這樣它可以作為本地安裝的另一個VS幫助來訪問，即按F1鍵。
有時，安裝程序無法在VisualStudio下正確注冊幫助。在這種情況下，可以使用以下步驟手動完成：
a）使用幫助->從VisualStudio中添加和刪除幫助內(nèi)容啟動MicrosoftHelpViewer
b）在'管理內(nèi)容'選項卡中，請選擇磁盤安裝源，然后從安裝了API幫助的目錄中瀏覽helpcontentsetup.msha文件。默認(rèn)情況下應(yīng)該在％ProgramData％\EPLAN\API-Support\\doc中
c）選擇'添加'鏈接，然后按'更新'按鈕
d）確保通過在MicrosoftHelpViewer中瀏覽EPLANAPI內(nèi)容來注冊幫助。
e）為了使用與VisualStudio集成的幫助，請將首選幫助設(shè)置為幫助查看器：
2、開發(fā)環(huán)境
這些主題介紹了如何使用集成開發(fā)環(huán)境創(chuàng)建EPLANAPI應(yīng)用程序。
開發(fā)EPLANAPI應(yīng)用程序的首選方法是使用.Net編程語言C＃（CSharp），托管C++，VisualBasic.Net或J＃直接在.Net項目中引用API程序集。您可以通過使用文本編輯器并從DOS框中調(diào)用編譯器來執(zhí)行此操作，如“在CSharp中創(chuàng)建加載項”或“在VisualBasic.Net中創(chuàng)建加載項”中所述。
更方便的開發(fā)方式涉及使用集成開發(fā)環(huán)境（IDE）。我們推薦使用MicrosoftVisualStudio.Net，但也有像SharpDevelop這樣的免費(fèi)開發(fā)環(huán)境?！癊PLAN.NetAPI”主題介紹了如何在VisualStudio中啟動API項目。
EPLANAPI已針對MicrosoftWindows7,8和10進(jìn)行了明確的測試和發(fā)布。
不建議在單獨(dú)的子線程中使用EPLANAPI。這可能會導(dǎo)致問題，因為此類配置未經(jīng)API設(shè)計人員測試或預(yù)測。
調(diào)試應(yīng)用程序
警告：當(dāng)前在調(diào)試應(yīng)用程序時，w3u.exe進(jìn)程在調(diào)試開始時分離。發(fā)生這種情況是因為ElectricP8文件夾中的w3u.exe調(diào)用了“平臺”文件夾中的eplan.exe。為了繼續(xù)調(diào)試，請附上“Platform”文件夾中的eplan程序。另一種解決方案是在'Platform'文件夾中開始調(diào)試eplan.exe，并使用'Variant'參數(shù)，例如：
/Variant:"Electric P8" 
3、EPLAN.NetAPI
EPLANAPI是使用Microsoft®.Net4.5.2技術(shù)創(chuàng)建的。
要使用EPLANAPI開發(fā)應(yīng)用程序，我們推薦使用MicrosoftVisualStudio2015,2013,2012。但是，它也應(yīng)該適用于Microsoft.Net框架4.5.2的其他開發(fā)環(huán)境。然而，EPLANAPI未經(jīng)其他IDE測試，而不是上面提到的那個。
要在MicrosoftVisualStudio2015中啟動新的EPLANAPI項目，請選擇菜單點(diǎn)File>New>Project...。在“新建項目”對話框中，首先選擇要使用的編程語言（C＃，VisualBasic或C++）。
接下來你決定，你想寫哪種類型的應(yīng)用程序：
對于加載項，您可以選擇“類庫”項目或使用EPLAN提供的加載項向?qū)?。主題“在VisualStudio中創(chuàng)建加載項”中介紹了如何繼續(xù)使用加載項向?qū)АＨ绻朐诓皇褂孟驅(qū)У那闆r下創(chuàng)建加載項，只需將引用添加到API程序集。您至少必須引用Eplan.EplApi.AF.dll和Eplan.EplApi.Base.dll。閱讀有關(guān)在加載項下面的主題中創(chuàng)建加載項的更多信息。在“配置屬性>調(diào)試”下的項目設(shè)置中，添加W3u.exe作為啟動程序（或帶有'Variant'參數(shù)的Eplan.exe），并確保在創(chuàng)建后將創(chuàng)建的dll復(fù)制到bin文件夾中。
例如，對于離線程序，您可以創(chuàng)建一個新的Windows應(yīng)用程序項目，并按照“在其他進(jìn)程中使用EPLANAPI程序集”主題中的描述繼續(xù)操作。確保路徑設(shè)置為EPLANbin目錄，或者您的代碼項目的工作目錄分別設(shè)置，否則可能會找不到dll。
備注
使用舊的EPLANAPI需要適合此版本框架的環(huán)境，
例如EPLANAPI的2.0.9版本是為Microsoft.NetFramework3.5開發(fā)的。
確保不要混合使用不同框架的EPLANAPI程序集。
4、API框架
API框架提供了將API加載項集成到EPLAN，處理腳本以及使用EPLAN系統(tǒng)的基礎(chǔ)技術(shù)（例如，創(chuàng)建操作，編寫系統(tǒng)消息和管理EPLAN設(shè)置。該框架包含名稱空間Eplan.EplApi.ApplicationFramework，Eplan.EplApi.Base，Eplan.EplApi.EServices，Eplan.EplApi.Gui，Eplan.EplApi.Scripting和Eplan.EplApi.System。
框架沒有提供電子技術(shù)功能。
5、API DataModel
電工技術(shù)數(shù)據(jù)模型（Eplan.EplApi.DataModel命名空間）包括屬于EPLAN項目的所有類/對象，例如項目本身，頁面，函數(shù)，布局等。每個類都從基類StorableObject派生并具有其特定屬性。與EPLAN21數(shù)據(jù)模型相反，EPLAN不嚴(yán)格區(qū)分圖形信息和邏輯信息。例如，一個頁面也保留了功能（邏輯）以及展示位置（圖形）的記錄。沒有設(shè)備對象，它存儲具有相同設(shè)備標(biāo)簽的功能。
注意類Function被命名為VisualBasic的關(guān)鍵字。為了在VB中不出現(xiàn)編譯錯誤，您需要始終使用其完整的名稱空間來引用一個Function對象：Eplan.EplApi.DataModel.Function或方括號：[Function]。我們建議您在不再需要時釋放Datamodel對象。尤其是在設(shè)置大量屬性的循環(huán)中。確保垃圾收集器可以通過經(jīng)常調(diào)用System.GC.WaitForPendingFinalizers（）來清理這些對象。
請注意，通常數(shù)據(jù)模型對象以毫米為單位存儲長度值，尺寸根據(jù)圖形坐標(biāo)系統(tǒng)存儲。
6、API高級電子技術(shù)服務(wù)
Eplan.EplApi.HEServices命名空間主要包含不直接連接到數(shù)據(jù)模型的功能。 有用于備份項目和主數(shù)據(jù)，創(chuàng)建報告或打印的類。 EPLAN的很多模塊都在這個名稱空間中表示，如標(biāo)簽?zāi)K和部件管理。