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.7.2 von Microsoft.

Automatische Skalierung beim Import von DXF-Dateien

Mittels der EPLAN API ist es jetzt auch möglich, DXF-Dateien beim Import automatisch skalieren zu lassen. Dazu steht für die Methode DXFPage die neue Klasse DrawingLimits zur Verfügung.

Neue Möglichkeiten für Montagepunkte

In der Klasse Mate sind die beiden neuen Klassen GridMate und LineMate verfügbar, die bestimmte Montagepunkte repräsentieren.

Quelle und Ziel für jede Ader eines Kabels auslesen

Mittels der neuen Methode GetSourcesAndTargets in der Klasse Cable können für Kabel die Informationen zu Quelle und Ziel der Adern ermittelt werden.

Texte im Projekt ersetzen

Über die neue Methode Replace der Klasse Search können jetzt Wörter eines Projekts durch andere ersetzt werden.

Neue Methode zum Einfügen von 3D-Fenstermakros

In der Klasse Insert3D steht nun eine neue Variante der Methode WindowMacro zur Verfügung. Damit können Sie einen Anfasspunkt an einen bestimmten Montagepunkt eines anderen Objekts andocken lassen.

Alle Objekte eines bestimmten Typs ermitteln

Die Klasse DMObjectsFinder wurde um die neue Methode GetAll erweitert. Hierüber lassen sich alle Objekte eines bestimmten Objekttyps ermitteln.

Neue Klasse für das Erstellen benutzerdefinierter Eigenschaften in der Artikelverwaltung

Mit Hilfe der neuen Klasse MDUserDefinedPropertyDefinition lassen sich benutzerdefinierte Eigenschaften für die Artikelverwaltung erstellen. Lesen Sie hierzu auch den Abschnitt "Erweiterungen für benutzerdefinierte Eigenschaften".

Weitere Formate für die Aktion "ExportNCData"

Für den Export von NC-Daten über die Aktion ExportNCData stehen jetzt auch die Formate "Kupfer-NC", "Kupfer-DXF" und "Kupferbiegung" zur Verfügung.

Objektnamen in aktueller Oberflächensprache auslesen

Die neue Methode GetTypeName ermöglicht Ihnen, den Namen eines Objekttyps in der aktuell eingestellten Oberflächensprache auszulesen.

Neue Methode zum Erzeugen von Sammelschienen

In der Klasse BusBar gibt es eine neue Überladung der Methode Create mit einer einfachen Möglichkeit, Sammelschienen zu erzeugen.

Neue Eigenschaft zum Auslesen der Datenbankversion in der Artikelverwaltung

Zum Auslesen der Datenbankversion in der Artikelverwaltung steht Ihnen in der Klasse MDPartsDatabase die neue Eigenschaft Version zur Verfügung.

Neue Eigenschaften zum Auslesen der Kennbuchstaben

Zum Auslesen der Kennbuchstaben steht Ihnen in der Klasse FunctionDefinitionLibrary die neue Eigenschaft IdentifierSets zur Verfügung. Hierüber können Sie die Namen der Kennbuchstabensätze auslesen.

Darüber hinaus gibt es in der Klasse FunctionDefinition die neue Eigenschaft Identifiers, mit der Sie alle Kennbuchstaben (für alle verfügbaren Normen) ermitteln können.

Neue Methoden zum Suchen und Ersetzen von Ebenen

In der EPLAN-Plattform besteht jetzt die Möglichkeit, nach verwendeten benutzerdefinierten Ebenen zu suchen und diese zu ersetzen (siehe Abschnitt "Erweiterungen in der Ebenenverwaltung"). In der Klasse GraphicalLayerTable stehen Ihnen zu diesem Zweck jetzt neue Methoden für die Arbeit mit der Ebenenverwaltung zur Verfügung.

Neue Aktionen für das Registrieren / Deregistrieren von Add-ons

Für das Registrieren / Deregistrieren von Add-ons stehen Ihnen die beiden neuen Aktionen XSettingsRegisterAction und XSettingsUnregisterAction zur Verfügung.

Neue Methode zum Ermitteln von Montagepunkten

In der Klasse SelectionSet können Sie jetzt über die neue Methode Mates die aktuell in der 3D-Grafik oder im Bauraum-Navigator ausgewählten Montagepunkte ermitteln.

Verzeichnis einlesen über die Aktion "projectmanagement"

Die Aktion projectmanagement wurde erweitert. Mit dem neuen Parameterwert /TYPE:LOADDIRECTORY und den Parametern /PROJECTSDIRECTORY und /SCANSUBDIRECTORIES können Sie jetzt die Funktionalität Verzeichnis einlesen aus der Projektverwaltung über einen Befehlszeilenaufruf, per Script oder über die EPLAN API ausführen.

Zugriff auf den "ActionCallingContext" in Scripten mit Aktionen

Wenn Sie in einem Script eine eigene Aktion mittels des Attributs [DeclareAction] bereitstellen, so ist es jetzt alternativ möglich, den kompletten ActionCallingContext als Parameter der behandelnden Methode zu verwenden.

Koordinaten aller Eckpunkte für 3D-Artikelplatzierungen ermitteln

In der Klasse Placement3D gibt es jetzt die neue Eigenschaft Corners. Mit Hilfe dieser Eigenschaft können Sie für eine 3D-Artikelplatzierung die absoluten und relativen Koordinaten aller Eckpunkte ermitteln.

Makrokästen als Polylinien erstellen

Mittels der EPLAN API ist es jetzt auch möglich, Makrokästen als geschlossene Polylinien zu erstellen. Die Definition der Polylinien erfolgt über die Eigenschaft LogicalAreaSegments aus der Klasse MacroBox.

Position der Segmente im Vorplanungs-Navigator verändern

Über die EPLAN API können Sie jetzt die Position der Segmente (Knoten) in der Baumstruktur des Vorplanungs-Navigators verändern. Hierzu gibt es in der Klasse PrePlanningService die neuen Methoden MoveUp und MoveDown.

Dateinamen für Dateiauswahldialog vordefinieren

In der Klasse FileSelectDecisionContext können Sie jetzt mit Hilfe der neuen Eigenschaft DefaultFilename den Dateinamen für den Dateiauswahldialog vordefinieren.

Aktualisieren von Artikelplatzierungen im Bauraum

Zum Aktualisieren von Artikelplatzierungen im Bauraum mittels der EPLAN API gibt es jetzt in der Klasse Placement3DService die neue Methode UpdatePartPlacement.

Klasse "ConnectionPointPosition" um weitere Eigenschaften ergänzt

Die Klasse ConnectionPointPosition wurde um folgende Eigenschaften ergänzt:

• SocketSize
• MinTighteningTorque
• MaxTighteningTorque
• StrippingLength

Erweiterte Aktion "XPamsDeviceSelectionAction"

Die Aktion XPamsDeviceSelectionAction wurde erweitert. Werden für den Parameter /PROJECTNAME keine Angaben gemacht, dann wird jetzt das ausgewählte Projekt verwendet. Im Rahmen dieser Änderung wurde auch der Parameter /Mode anpasst.

• Mit dem Wert selectDevice wird ein neues Gerät für die vorhandenen Objekte ausgewählt. Dabei werden jetzt alle Gerätedaten einschließlich der Artikelreferenzdaten gelöscht und entsprechend der Geräteauswahl neu vergeben.
• Der Wert updateDevice aktualisiert nur die Gerätedaten der Artikel der vorhandenen Objekte. Dabei bleiben die Artikelnummern und die Artikelreferenzdaten erhalten. Die Funktionalität entspricht dem neuen Kontextmenüpunkt Gerätedaten aktualisieren im Stückliste-Navigator.

Aktuelle Auswahl im Makro-Navigator ermitteln

Es ist jetzt möglich, die aktuelle Auswahl im Makro-Navigator per EPLAN API zu ermitteln. Mit Hilfe der Methode Selection aus der Klasse SelectionSet können Sie Objekte des Typs MacroEntry ermitteln, die die ausgewählten Makros repräsentieren.

Neue Methode für die Korrektur von nicht zu übersetzenden Texten

In der Klasse Translate steht Ihnen jetzt die neue Methode Correct zur Verfügung, mit der Sie die Übersetzung der nicht zu übersetzenden Texte von Eigenschaften entfernen können. Im Dialog Einstellungen: Umfang der Benutzeroberfläche entspricht dies der Schaltfläche Korrektur (Menüpfad Optionen > Einstellungen > Projekte > "Projektname" > Übersetzung > Umfang).

Aktuelle Auswahl in der Ebenenverwaltung ermitteln

Mittels der neuen Eigenschaft Layers aus der Klasse SelectionSet können Sie jetzt die im neuen dockbaren Dialog Ebenenverwaltung aktuell ausgewählte Ebene ermitteln.

Exportieren der Adressraumbelegung

Über die neue Methode ExportAddressOverview aus der Klasse PlcService können Sie jetzt die Adressraumbelegung einer CPU exportieren. Im Dialog Adressen / Zuordnungslisten der Benutzeroberfläche entspricht dies dem Menüpunkt Adressraumbelegung exportieren unterhalb der Schaltfläche [Extras] (Menüpfad Projektdaten > SPS > Adressen / Zuordnungslisten).

Verknüpfung von Segmenten mit 3D-Artikelplatzierungen

Im Vorplanungs-Navigator können Segmente jetzt auch mit 3D-Artikelplatzierungen verknüpft werden. In der EPLAN API funktioniert dies über die Eigenschaft PlanningSegment aus der Klasse Function3D.