Einführung

Scripting bezeichnet die Möglichkeit, einzelne Befehle bzw. Programmcode in EPLAN auszuführen. Dies geschieht über die sogenannte API (Application Programming Interface, dt. Programmierschnittstelle). Hinter der EPLAN-API verbergen sich alle Funktionen, die in der Plattform (Electric P8, Fluid, Pro-Panel usw.) vorhanden sind. Diese Programme bauen alle auf dem gleichen Programmcode auf und sind dadurch untereinander kompatibel. In den verschiedenen Applikationen sind ähnliche bzw. gleiche Funktionen enthalten, z. B. kann man Beschriftungen sowohl in Fluid als auch in Electric P8 erzeugen. Einziger Unterschied ist der Inhalt.

Diese Abläufe werden in EPLAN Actions (Aktionen) genannt. Diesen wird der Abschnitt "Actions ausführen" gewidmet, da es mehrere Wege gibt, solche Actions auszuführen. Das Wort Scripting bezieht sich meistens nur auf Scripte, welche in jeder Ausbaustufe (Lizenz) von EPLAN genutzt werden können. Um weitere Befehle oder Funktionen ausführen zu können, benötigt man das API-Modul von EPLAN.

Was sind Scripte?

Scripte sind kleine Programmcodes. In EPLAN können diese in zwei Programmiersprachen erstellt werden:

• Microsoft C# (C-Sharp)

• Microsoft VB.NET (Visual Basic.NET)

In den folgenden Kapiteln werden nur Beispiele in C# bereitgestellt, da EPLAN mit dieser Sprache fertigen Code generiert und dadurch eine optimale Vorlage liefert. Ein Script ist nicht allein ausführbar. Es muss in Verbindung mit EPLAN gestartet werden.

Was können Scripte?

Scripte können vieles, aber nicht alles. EPLAN stellt eine Reihe von Befehlen bereit, schränkt diese aber auf einen überschaubaren Bereich ein. Dadurch wird Anwender:innen der Einstieg enorm erleichtert. Auf diese Weise wird auch sichergestellt, dass keine ungewollten Aktionen, z. B. auf das Projekt, ausgeführt werden.

Wir kennen alle die wiederkehrende Aufgabe, Beschriftungen auszugeben. Je Projekt sind mehrere Exporte nötig. Jedes Mal muss das Beschriftungsschema neu ausgewählt, zusätzlich der Ordner benannt und ein Dateiname vergeben werden. Mit einem Script können wir all diese Arbeitsschritte zusammenfassen und z. B. auf einen Button im Menüband legen. Über diese Funktion können wir auch mehrere Beschriftungen nacheinander erzeugen. Auch der PDF-Export kann automatisiert werden. Du möchtest z. B. beim Schließen des Projekts automatisch ein PDF zur Änderungsverfolgung erzeugen? Mit einem Script lässt sich dies problemlos realisieren. Es werden Schnittstellen im Unternehmen benötigt, um Informationen außerhalb von EPLAN, z. B. im ERP-System, zu nutzen? Gar kein Problem! Über die Möglichkeiten im Scripting geht das auf Knopfdruck. Oft muss zwischen verschiedenen Einstellungen hin und her gewechselt werden. Das Suchen in den unzähligen Einstellungen in EPLAN ist mühselig. Dafür schreiben wir uns stattdessen ein Script für die Konfigurationen und erledigen dies unter der Projektierung.

Dies ist eine kleine Auflistung der Möglichkeiten, die mit Scripten realisiert werden können:

• Beschriftungen automatisieren
• PDF-Export
• Backup
• eigene Registerkarten im Menüband erstellen
• grafische Formulare, z. B. mit Buttons, Checkboxen und Auswahldialogen, erstellen
• Eigenschaften verändern
  • Projekteigenschaften
  • Seiteneigenschaften
• Einstellungen
  • Lesen
  • Schreiben
• Artikeldaten verändern

Das sind noch längst nicht alle Funktionen. Durch das Erweitern des Programmcodes können noch mehr Funktionen hinzugefügt werden.

Unterschied Scripting & API

Um den Unterschied etwas deutlicher zu machen, findest du im Folgenden eine kleine Auflistung der wichtigsten Merkmale des API-Moduls in EPLAN:

• Zugriff auf das komplette EPLAN-Datenmodell
• einfacheres Lesen von Objekten
• Zugriff auf mehr Objekte
• direkter Zugriff auf Projekteigenschaften/Projekteinstellungen
• mehr verfügbare Actions