🕡 🤘 👩🏾‍✈️ EPLANの機能を拡張します。 Cで簡単なアドインを作成する＃ ✖️ 🗜️ 🌋

C＃のアドインでEPLAN機能を拡張する

EPLANは、電気工学、計装、油圧/空圧、およびメカニクス（キャビネットおよびケーブル設計）の業界をカバーするエンドツーエンドのエンジニアリングプラットフォームです。 EPLANは、オープンアーキテクチャと標準統合モジュールのおかげで、機械設計システム、ERPおよびPDMシステム、建築設計システム、工業プラント、船舶などの幅広いサードパーティソリューションとコスト効率よく統合できます。

EPLANアプリケーション

•自動車

•エンジニアリング

•冶金

•化学および製薬産業

•食品産業

•石油およびガスの生産

•パイプライントランスポート

•石油およびガス処理

•熱および発電

•送電および配電

•鉄道輸送

•給水と衛生

•工作機械産業

•軽工業

•ビルディングオートメーション

メインプラットフォームモジュール

•EPLAN Electric P8-電気工学、設計および作業文書の自動作成のためのモジュール式でスケーラブルなソリューション。

•EPLAN Fluid-空気圧/油圧機器、潤滑および冷却システムの設計、および適切な設計と作業文書の自動作成のためのソフトウェア

•EPLAN ProPanel-生産へのデータ転送を伴う電気キャビネットの3D設計。仮想3次元モデリング、2次元および3次元図面の作成、ワイヤおよびルート図の3次元画像、掘削機器の操作用パターンの存在、CNCマシンとの統合

•EPLAN PrePlanning-オブジェクトの予備（概要）設計およびプロジェクトドキュメントの生成のためのソフトウェア。

•EPLANエンジニアリングセンター-機能設計ソリューション。このモジュールでは、ユーザーがプロジェクトの境界パラメーターを設定し、デザイン自体が特定のルールに従ってシステムによって自動的に実行されます。

機能の拡張について

EPLANは、スクリプトとアドインで機能を拡張できる柔軟なプラットフォームです。スクリプト（スクリプト）はアクションの自由度がはるかに低いため、アドインのみを検討します。

アドインは、EPLANが提供する基本機能を補完および拡張するアドオンです。アドインはEPLAN APIを使用して作成されます。EPLANAPIは、dotNETを使用し、Visual Basic、C ++、C＃の3つのプログラミング言語をサポートします。アドインを作成する手順は、上記のすべての言語で同じです。 EPLAN API情報は、EPLAN APIサポートマニュアル（* .chm形式）で入手できます。このマニュアルは、ドキュメントに付属しています。

アドインを作成するプロセス

アドインを作成するプロセスを直接検討してください。

1.まず、dotNETが使用されているため、MS Visual Studioでクラスライブラリプロジェクトを作成します。

2.次に、EPLAN APIライブラリをプロジェクトに接続します。

3. Add-Ina初期化コードを作成します

Add-Inaを登録および初期化するには、クラスがIEplAddInインターフェイスを継承する必要があります（EPLAN API-Supportの詳細を参照）。 EPLANメインメニューでメニュー項目を作成し、アクションを1つ追加します。

using Eplan.EplApi.ApplicationFramework; using Eplan.EplApi.Gui; namespace Test { public class AddInModule:IEplAddIn { public bool OnRegister(ref bool bLoadOnStart) { bLoadOnStart = true; return true; } public bool OnUnregister() { return true; } public bool OnInit() { return true; } public bool OnInitGui() { Menu OurMenu = new Menu(); OurMenu.AddMainMenu("", Menu.MainMenuName.eMainMenuUtilities, "  ", "ActionTest", " ,    ", 1); return true; } public bool OnExit() { return true; } } }

OnRegisterメソッドとOnUnregisterメソッドは、Add-Inaに最初に接続および削除するときにそれぞれ1回呼び出されます。

EPLANaが閉じられると、 OnExitメソッドが呼び出されます。

OnInitメソッドは、EPLANaがロードされてアドインを初期化するときに呼び出されます。

OnInitGuiメソッドは、EPLANaが読み込まれてアドインとユーザーインターフェイスを初期化するときに呼び出されます。

4.メニューに表示されるアクションコード（Action）を作成します。 ActionはIEplActionインターフェイスを継承する必要があります（EPLAN APIサポートの詳細）。

 using System; using System.Windows.Forms; using Eplan.EplApi.ApplicationFramework; using Eplan.EplApi.DataModel; using Eplan.EplApi.HEServices; namespace Test.Action_test { public class Action_Test:IEplAction { public bool OnRegister(ref string Name, ref int Ordinal) { Name = "ActionTest"; Ordinal = 20; return true; } public bool Execute(ActionCallingContext oActionCallingContext) { SelectionSet Set = new SelectionSet(); Project CurrentProject = Set.GetCurrentProject(true); string ProjectName = CurrentProject.ProjectName; string ProjectCompanyName = CurrentProject.Properties.PROJ_COMPANYNAME; DateTime ProjectCreationDate = CurrentProject.Properties.PROJ_CREATIONDATE; MessageBox.Show(" : " + ProjectName + "\n" + " : " + ProjectCompanyName + "\n" + "  : " + ProjectCreationDate.ToShortDateString()); return true; } public void GetActionProperties(ref ActionProperties actionProperties) { } } }

OnRegisterメソッドは、指定された名前でActionを登録します。

EPLANプラットフォームからActionaが呼び出されると、 Executeメソッドが実行されます。この場合、 Executeメソッドは現在のプロジェクトを選択し、そこから3つのフィールド、つまりプロジェクト名、会社名、作成日を読み取り、それらをMessageBoxに表示します。

GetActionPropertiesメソッドは、 Actionaの説明を返します（ドキュメントのみ）。

5.コンパイルされたDLLの名前は、次の規則に従う必要があります。

Eplan.EplAddIn.XXXX.dll

XXXXはアドインの名前です