Diese Funktionalität ist nur in bestimmten Ausbaustufen verfügbar. Info / Copyright

Neuerungen für EPLAN API

Bereich Beschreibung
Methoden (API)

Nicht verwendete Strukturkennzeichen löschen

Die neue Methode Remove aus der Klasse Location ermöglicht es Ihnen, ein nicht verwendetes Strukturkennzeichen aus einem Projekt zu entfernen. Über die Eigenschaft IsUsed können Sie vorher prüfen, ob das Strukturkennzeichen verwendet wird.

Methoden (API)

Neue Methode zum Spiegeln von platzierten Objekten

Mit Hilfe einer neuen Überladung der Methode Mirror aus der Klasse Edit lassen sich jetzt nicht nur grafische Elemente, sondern alle Objekte (z.B. Symbole) im Grafischen Editor um eine frei gewählte Spiegelungsachse spiegeln. Dabei können Sie optional auswählen, ob beim Spiegeln eine Kopie der Originalobjekte entsteht.

Methoden (API)

SQL-Server-Datenbank für das Wörterbuch umstellen

Um die Datenbank für das Wörterbuch (Übersetzung) auf SQL-Server einzustellen oder von einer SQL-Server-Datenbank auf eine andere zu wechseln, steht Ihnen in der Klasse Translate jetzt die neue Methode SetSQLServerConnectionParameters zur Verfügung.

Methoden (API)

SQL-Server-Datenbank für die Projektverwaltung umstellen

Um die Projektverwaltungsdatenbank auf SQL-Server einzustellen oder von einer SQL-Server-Datenbank auf eine andere zu wechseln, steht Ihnen in der Klasse ProjectManagement jetzt die neue Methode SetSQLServerConnectionParameters zur Verfügung.

Methoden (API)

Freies Verlegen von Verbindungen

Mit Hilfe einer neuen Überladung der Methode RouteConnections aus der Klasse ConnectionService3D ist es jetzt möglich, einzelne Verbindungen im Bauraum per EPLAN API frei zu verlegen.

Methoden (API)

Eine geöffnete Seite schließen

Mit Hilfe der neuen Methode ClosePage aus der Klasse Edit können Sie jetzt eine im Grafischen Editor geöffnete Seite per EPLAN API schließen.

Klassen (API)

Neue Klasse für die Anschlussausführung

Mit Hilfe der neuen Klasse MDConnectionCategory aus dem Namensraum Eplan.EplApi.MasterData können Sie jetzt für die Anschlüsse eines Anschlussbildes in der Artikelverwaltung die Anschlussausführung per EPLAN API ermitteln und bei Bedarf auch ändern.

Aktionen (API)

Neuer Parameter für die Aktion "Edit"

Wird bei der Verwendung der Aktion edit über den Parameter PROJECTNAME ein Projekt geöffnet, können Sie jetzt mit Hilfe des neuen Parameters IGNOREWHENOPEN verhindern, dass eine Meldung ausgegeben wird, falls das Projekt bereits geöffnet war.

Methoden (API)

Neue Projektverwaltungsdatenbank erstellen

In der Klasse ProjectManagement steht Ihnen die neue Methode CreateDatabase zur Verfügung. Mit Hilfe dieser Methode können Sie eine neue Access- oder SQL-Server-Datenbank für die Projektverwaltung erstellen und direkt verwenden.

Aktionen (API)

Einlagern von Teilprojekten

Die Aktion subprojects wurde erweitert. Mit Hilfe des neuen Parameterwerts /TYPE:STORE können Sie jetzt Teilprojekte wieder in das Projekt einlagern.

Methoden (API)

Erweiterte Methode "GenerateProject"

Beim "Projekt auswerten" über die Methode GenerateProject aus der Klasse Reports werden jetzt auch ggf. Modell-Ansichten etc. ausgewertet. In der Benutzeroberfläche entspricht dies dem Verhalten der folgenden Befehle: Registerkarte Werkzeuge > Befehlsgruppe Auswertungen > Projekt auswerten.

Eigenschaften (API)

Benutzerdefinierte Ebenen eines Makro auflisten

In der Klasse Macro gibt es die neue Eigenschaft CustomLayerTable mit deren Hilfe Sie auflisten können, welche benutzerdefinierte Ebenen ein Makro enthält.

Eigenschaften (API)

Neue Eigenschaft "Quelle / Ziel" abfragen oder festlegen

Um die neue Anschlusseigenschaft Quelle / Ziel auch per EPLAN API abfragen oder manuell festlegen zu können, steht Ihnen in der Klasse Pin jetzt die neue Eigenschaft IsSourceOrTarget zur Verfügung.

Mehr lesen ...

Aktionen (API)

Aktuell ausgewählten Bauraum ermitteln

Mit Hilfe der Aktion selectionset können Sie jetzt auch den aktuell ausgewählten Bauraum ermitteln. Dazu gibt es den neuen Parameter /LAYOUTSPACES.

Eigenschaften (API)

Von einer Auswertung ausgegebenen Funktionen ermitteln

Mittels der neuen Eigenschaft Functions aus der Klasse ReportBlock können Sie jetzt ermitteln, welche Funktionen von einer bestimmen funktionsbezogenen Auswertung ausgegeben werden.

Eigenschaften (API)

Anschlussbild am Artikel ermitteln

Mittels der neuen Eigenschaft ConnectionPointInfo aus der Klasse MDPart können Sie jetzt ermitteln, welches Anschlussbild an einem Artikel hinterlegt ist.

Eigenschaften (API)

Drehwinkel oder Offset von 3D-Objekten ermitteln oder ändern

Mit Hilfe der neuen Eigenschaft RelativeTransformationOfMacro aus der Klasse Placement3D können Sie an 3D-Objekten in einem Bauraum den Drehwinkel oder die Koordinaten eines Offsets ermitteln oder ändern.

Methoden (API)

Neue Methoden aufgrund des Entfernens der E-Mail-Funktionalität

Für die Methoden Project und MasterData aus der Klasse Backup sowie für die Methode PublishProjectForSmartWiring aus der Klasse ProjectManagement" steht Ihnen jetzt jeweils eine neue Überladung ohne den Parameter eBakMedia zur Verfügung. Die ursprünglichen Methoden wurde als veraltet markiert. Die Aktionen backup und projectmanagement wurden entsprechend angepasst. Die Variablen Backup.Medium und ProjectManagement.Medium wurden ebenfalls als veraltet gekennzeichnet.

Methoden (API)

Veraltete Methode zum Veröffentlichen von Projekten

Zur aktuellen Version wurden in der EPLAN-Plattform der Menüpunkt Veröffentlichen sowie die dazugehörigen Dialoge zum Veröffentlichen von Projekten entfernt. Im Zuge dieser Umgestaltung wurde die Methode PublishProject aus der Klasse PartsService als veraltet gekennzeichnet und sollte von Ihnen nicht mehr verwendet werden.

Methoden (API)

Festlegen des Datensatztyps beim Erstellen eines eingelagerten Artikels

Wird mit Hilfe der Methode Create aus der Klasse Article für ein Projekt ein eingelagerter Artikel erstellt, dann wird für diesen Artikel die Eigenschaft Datensatztyp (ARTICLE_PARTTYPE) jetzt standardmäßig auf den Wert "Einzelteil" gesetzt.

Klassen (API)

Neue Klasse für den Normentausch

Mit Hilfe der neuen Klasse ChangeOfStandard aus dem Namensraum EPLAN.EplApi.HEServices ist es jetzt möglich, mittels EPLAN API einen Normentausch für ein Projekt oder für einzelne Seiten durchzuführen.

Aktionen (API)

Erweiterter Export der Fehlwortliste

Die Aktion translate wurde erweitert. Mit Hilfe des Parameterwerts /TYPE:EXPORTMISSINGTRANSLATIONS können Sie beim Export der Fehlwortliste jetzt mehr als eine Sprache ausgeben.

Methoden (API)

Neue Methode zum Platzieren von Funktionen

In der Klasse Function steht Ihnen die neue Methode Place zur Verfügung. Mit Hilfe dieser Methode können Sie Funktionen aus den Projektdaten-Navigatoren im Schaltplan platzieren. Dabei werden z.B. SPS-Kanäle korrekt abgebucht. In der Benutzeroberfläche entspricht dies dem Kontextmenüpunkt Platzieren.

Methoden (API)

Neue Methode zur Übergabe einer Auswahlliste

In der Klasse Decider gibt es eine neue Überladung der Methode Decide, die es ermöglicht, eine Auswahlliste mit mehreren Einträgen zu übergeben.

Klassen (API)

Das neue Menüband in der EPLAN API

In der Benutzeroberfläche der EPLAN-Plattform erfolgt die Auswahl der Befehle für die Navigatoren und grafischen Editoren jetzt mit Hilfe eines Menübands. Zur Anpassung dieses Menübands und zum Hinzufügen eigener Befehle mit Hilfe der EPLAN API stehen Ihnen im Namensraum Eplan.EplApi.GUI die folgenden vier neuen Klassen zur Verfügung:

  • RibbonBar (= "Menüband" in der Benutzeroberfläche)
  • RibbonTab (= "Registerkarte" in der Benutzeroberfläche)
  • RibbonCommandGroup (= "Befehlsgruppe" in der Benutzeroberfläche)
  • RibbonCommand (= "Befehl" in der Benutzeroberfläche)

Wie in der Benutzeroberfläche können Sie eigene Befehle nur einer benutzerdefinierten Befehlsgruppe hinzufügen.

Ein benutzerspezifisch angepasstes Menüband können Sie mit Hilfe der beiden neuen Aktionen MfExportRibbonBarAction und MfImportRibbonBarAction exportieren und auch wieder importieren.

Die überflüssig gewordenen Klassen für die Menüleiste und die Symbolleisten sowie die dazugehörigen Aktionen für die Symbolleisten wurden als veraltet gekennzeichnet (Menu Class, Toolbar Class, CopyToolBarAction, MfRemoveToolbarAction, MfExportToolbarAction, MfImportToolbarAction).

Aktionen (API)

Export und Import von Artikeldaten über die externe Bearbeitung

Mit Hilfe der neuen Aktion XMExportDCArticleDataAction können Sie jetzt alle Daten der Artikelverwaltung für die externe Bearbeitung über einen Befehlszeilenaufruf, per Script oder über die EPLAN API exportieren. Für einen Import können Sie die neue Aktion XMImportDCArticleDataAction nutzen. Dabei können Sie über den Parameter /IMPORTMODE festlegen, ob nur neue Daten importiert, vorhandene Daten aktualisiert oder neue Daten importiert und vorhandene Daten aktualisiert werden.

Methoden (API)

Neue Methode zum Filtern von Artikeln

Die Klasse MDPartsDatabase wurde um die neue Methode GetParts erweitert, mit der es möglich ist, Artikel nach verschiedenen Eigenschaften zu filtern.

Methoden (API)

Gefilterte Artikel in der Artikelverwaltung ermitteln

Die Klasse MDPartsDatabase wurde um die neue Methode GetPartsWithFilterScheme erweitert. Diese neue Methode ermöglicht es, die von einem feldbasierten Filterschema gefundenen Artikel zu ermitteln.

Methoden (API)

Neue Methoden für den Export und Import von Artikeldaten

Der Export von Artikeln erfolgt jetzt über die Klasse MDPartsDatabase. Diese wurde um die beiden neuen Methoden ExportParts und ExportPartsDatabaseItems erweitert. Die bisherigen Methoden zum Artikelexport in der Klasse PartsService wurden als veraltet gekennzeichnet.

Eigenschaften (API)

Eigenschaft für die Auswahl der Artikeldatenbank

Mit Hilfe der Eigenschaft SelectedPartsDatabase aus der Klasse MDPartsManagement lässt sich jetzt die aktuell in EPLAN verwendete Artikeldatenbank auf eine andere interne EPLAN- oder SQL-Datenbank umstellen. Diese Eigenschaft löst die bisherige Methode SetSQLServerConnectionParameters aus der Klasse PartsService ab.

Methoden (API)

Veraltete Methoden für die Artikelverwaltung

Für die neue Artikelverwaltung der EPLAN-Plattform wurde ein separates API geschaffen. Im Zuge dieser Änderung wurden Methoden aus der Klasse Eplan.EplApi.HEServices.PartsService, die die Artikelverwaltung betreffen, in Klassen innerhalb des Namensraums Eplan.EplApi.Masterdata verschoben und in der Klasse PartsService als veraltet gekennzeichnet.