Neuerungen im Erweiterungsmodul "EPLAN API Extension"

Für die Produkte der EPLAN-Plattform steht eine einheitliche und besonders leistungsfähige Programmierschnittstelle (API, Application Programming Interface) zur Verfügung. Mit Hilfe dieses Erweiterungsmoduls – der EPLAN API – können Sie selbst, in der Zusammenarbeit mit EPLAN oder anderen Partnern, Ihre maßgeschneiderten Lösungen entwickeln. Weitere Informationen zur EPLAN API und zum EADN finden Sie auf den EPLAN-Internetseiten in der Rubrik "Lösungen > Integration > EPLAN Application Developer Network". Der nachfolgende Abschnitt informiert Sie über die verschiedenen Neuerungen in der EPLAN API. Um mit der neuen Version der EPLAN API eigene Anwendungen entwickeln zu können, benötigen Sie das .NET Framework 4.5.2 von Microsoft.

Hinweise:

Das Erweiterungsmodul "EPLAN API Extension" ist im Rahmen unseres EPLAN Application Developer Network (EADN) als Entwicklerpaket für folgende Programmvarianten optional erhältlich:
EPLAN Electric P8 Select, EPLAN Electric P8 Professional,
EPLAN Electric P8 Professional+, EPLAN Electric P8 Ultimate,
EPLAN Fluid, EPLAN Fluid Professional,
EPLAN Fluid Professional+, EPLAN Fluid Professional E,
EPLAN Preplanning P&ID, EPLAN Preplanning Professional,
EPLAN Pro Panel Professional, EPLAN Pro Panel Professional+.
Außerdem kann das Erweiterungsmodul "EPLAN API Extension" auch für "normale" Lizenzen erworben werden (mit Ausnahme von EPLAN Electric P8 Compact, EPLAN Fluid Compact).

Hinweis:

Wir empfehlen jedem API-Benutzer, seine Applikation frühzeitig mit der neuen Version der EPLAN API zu kompilieren und zu testen. Verwenden Sie noch veraltete Methoden in Ihrer Applikation, dann wird Ihnen beim Kompilieren eine entsprechende Compiler-Warnung hierzu angezeigt.

Wolke zeichnen

Mittels der EPLAN API ist es jetzt auch möglich, ein Rechteck oder eine geschlossene Polylinie in Form einer Wolke zu zeichnen. Dazu müssen Sie die Eigenschaft FillPattern in der Klasse Rectangle oder PolyLine entsprechend festlegen.

Entfernte Methoden zur Datenübernahme

Mehrere Methoden zur Datenübernahme aus EPLAN 21 und EPLAN 5 wurden in der EPLAN API entfernt.

Projektstammdaten aktualisieren

Mit Hilfe der neuen Aktion masterdata können Sie jetzt die Stammdaten über einen Befehlszeilenaufruf, per Script oder über die EPLAN API aktualisieren. Dabei legen Sie über den Parameter /TYPE:UPDATEPROJECT fest, dass die Projektstammdaten aktualisiert werden. In der Benutzeroberfläche der EPLAN-Plattform entspricht dies den Menüpunkten Dienstprogramme > Stammdaten > Aktuelles Projekt aktualisieren.

Neue Parameter für die Aktion "generatemacros"

Die Aktion generatemacros wurde um die folgenden optionalen Parameter erweitert:

PAGENAMEn : Namen der zu berücksichtigenden Seiten
INSTALLATIONSPACENAMEn : Namen der zu berücksichtigenden Bauräume
STRUCTUREn : Strukturkennzeichen der zu berücksichtigenden Bauräume
WINDOWMACRODIR : Verzeichnis für Fenstermakros
PAGEMACRODIR : Verzeichnis für Seitenmakros
FILTERSCHEME : Filterschema
OVERWRITE : Überschreibmodus.

Dabei steht "n" für eine Nummer.

Rohrleitungsdefinitionspunkte und Rohrleitungsanschlüsse erzeugen

In Analogie zu den Menüpunkten Einfügen > Rohrleitungsdefinitionspunkt und Einfügen > Rohrleitungsanschluss in der Benutzeroberfläche können Sie jetzt auch per EPLAN API Rohrleitungsdefinitionspunkte und Rohrleitungsanschlüsse erzeugen und bearbeiten. Dazu steht Ihnen im Namensraum Eplan.EplApi.DataModel die neue Klasse PipingDefinition zur Verfügung.

Beim Platzieren in die Schrankhierarchie eingliedern

Um beim Platzieren von Artikeln im 3D-Montageaufbau auch die Einstellung In Schrankhierarchie eingliedern in der EPLAN API berücksichtigen zu können, wurde die Klasse Placement3D um die zusätzliche Methode FindSourceMate erweitert.

Artikel über das EPLAN Data Portal aktualisieren

Mittels der EPLAN API ist es jetzt auch möglich, die Artikel in der Artikelverwaltung über das EPLAN Data Portal zu aktualisieren. Dazu wurde die Klasse MDPartsDataBase um die neue Methode UpdatePartFromDataPortal erweitert.

Bus-Schnittstellenname für Funktionsschablonen und Anschlussbild vergeben

Um für die Funktionsschablonen von Bus-Anschlüssen in der Artikelverwaltung auch per EPLAN API einen Bus-Schnittstellennamen vergeben zu können, steht Ihnen in der Klasse MDPlcTemplatePosition die neue Eigenschaft BusSystem zur Verfügung.

Da der Bus-Schnittstellenname auch in den Anschlussbildern der Artikelverwaltung und im Anschlussbild an bestimmten Funktionen (z.B. 3D-Artikelplatzierungen) eingegeben werden kann, wurden die Klassen MDConnectionPointPosition und ConnectionPointPosition entsprechend um die neue Eigenschaft PLCBusInterfaceName erweitert.

Funktionsschablonen als Schablonenverbund zusammenfassen

Mit Hilfe der neuen Methode TemplateGroup aus der Klasse MDFunctionTemplatePosition ist es jetzt per EPLAN API möglich, die Funktionsschablonen zusammengehöriger Funktionen in der Artikelverwaltung zu einem Schablonenverbund zusammenzufassen.

Numerische Werte als mehrsprachigen Text ausgeben

Die neue Methode GetDisplayString aus der Klasse PropertyValue ermöglicht Ihnen, für Eigenschaften anstelle numerischer Eigenschaftswerte mehrsprachige, aussagekräftige Texte aus der Benutzeroberfläche auszugeben.

Neue Pfadvariablen verwenden

Mittels der Klasse PathMap und der bereits bestehenden Methode SubstitutePath lassen sich jetzt auch alle neuen Pfadvariablen der EPLAN-Plattform verwenden (Programmvariablen, Projektvariablen und Umgebungsvariablen).

Auf Wertesätze aus Makros an Planungsobjekten zugreifen

Sie können jetzt auch per EPLAN API auf das an einem Planungsobjekt hinterlegte Makro und auf die im Makro definierten Platzhalterobjekte mit Wertesätzen zugreifen. Dazu steht Ihnen in der Klasse PlanningObject die neue Eigenschaft MacroPlaceHolderValueSets zur Verfügung.

Anschlussmaß in Funktionsschablonen festlegen

In einigen von der Klasse MDFunctionTemplatePosition abgeleiteten Klassen (z.B. MDTerminalTemplatePosition) steht Ihnen jetzt die neue Eigenschaft ConnectionDimension zur Verfügung. Mit Hilfe dieser Eigenschaft ist es jetzt auch per EPLAN API möglich, für einen Artikel in den Funktionsschablonen das Anschlussmaß festzulegen.