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.
Hinweise:
-
"EPLAN API Extension" ist im Rahmen unseres EPLAN Application Developer Network (EADN) als Entwicklerpaket erhältlich und kann außerdem für verschiedene Programmvarianten als optionales kostenpflichtiges Erweiterungsmodul lizenziert werden.
- 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.
Automatische Skalierung beim Import von DXF-Dateien
Mittels der EPLAN API ist es jetzt auch möglich, -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 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 die Informationen zu Quelle und Ziel der 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 eines bestimmten Objekttyps ermitteln.
Neue Klasse für das Erstellen benutzerdefinierter Eigenschaften in der Artikelverwaltung
Mit Hilfe der neuen Klasse MDUserDefinedPropertyDefinition lassen sich benutzerdefinierte 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 "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, 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 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 stehen Ihnen die beiden neuen 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 -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, als geschlossene 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 (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 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 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 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 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.