Eplan API插件

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

功能介紹

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

使用幫助

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