MacroTool

Dateien kopieren

Der Speicherort für das Script (*.cs-Datei) kann beliebig gewählt werden. Die Daten für das Script müssen in das Skripte-Verzeichnis der EPLAN-Stammdaten kopiert werden:

EPLAN_DATA\Skripte\Firmenkennung\

Das Verzeichnis muss den Namen des Produktes haben und an die angegebene Stelle kopiert werden. Achten Sie beim entpacken des Zip-Archives darauf, dass ein Verzeichnis mit dem Namen des Archives (Produktname) erstellt wird. Wird das Verzeichnis umbenannt, oder an falscher Stelle abgelegt, kann die Toolbar keine Bilder laden und die Scripte haben keinen Zugriff auf notwendige Daten (Konfigurationen, Schematas, Filter, ...).

In ScriptSettings einrichten

Das Script muss in der Anwendung ScriptSettings mit dem Freischaltcode vom Shop aktiviert werden.
Den Freischaltcode finden Sie im Shop unter: Mein Konto ▸ Downloads
Weitere Anleitungen zum Einrichten der Scripte finden Sie unter ScriptSettings.

API-AddIns laden

Die API-AddIns müssen in EPLAN geladen werden. Dies können Sie mit folgenden Methoden umsetzen:

Methode 1: 
In EPLAN laden: Dienstprogramme > API-AddIns... > Laden > API-AddIn auswählen.

Methode 2: 
Sie können die API-AddIns mittels der AddOn-Technik verteilen. Damit können Sie das API-AddIn an mehreren Arbeitsstationen automatisch laden und müssen nicht jede Station manuell laden. Diese Methode ist für Firmennetzwerke zu empfehlen.

Einstellungen

Hinweis: Im Lieferumfang sind alle Schemas und Settings nach unserer Empfehlung eingestellt... ohne Änderungen sofort einsetzbar!

Funktionen

MacroToolCreateAction

Voraussetzung: Es ist die Hauptfunktion oder 3D-Element in einem Schaltplanprojekt ausgewählt, welche nur eine Artikelnummer eingetragen hat. Möglich im grafischen Editor & Bauraum.

Ist der hinterlegte Artikel noch nicht in der Artikelverwaltung, wird dieser automatisch erzeugt und angezeigt. Bei einem bestehenden Artikel wird die Funktionsschablone aktualisiert.

Die Makrodatei wird ab EPLAN Version 2.7 automatisch erzeugt.

Electric P8

Es werden alle Darstellungen des Gerätes gesammelt. Pro Seite und Darstellungsart wird eine Seite im Makroprojekt erstellt. Die Struktur wird automatisch über das eingestellte Beschriftungsschema Structure gesetzt. Die Dokumentenart (&) ist immer die Darstellungsart der Makro-Variante. Die Seitenbeschreibung der Hauptfunktion wird gemäß der Einstellung MainFunctionText gesetzt.

Auf den Seiten wird automatisch ein Makrokasten eingefügt welcher die Informationen automatisch über das eingestellte Beschriftungsschema MacroTool_MacroBox füllt:

• • Name (Pfad)
  • Version
  • Quelle
  • Beschreibung

Pro Panel

Es wird automatisch eine Modell-Ansicht erzeugt in der Struktur welche das Schema MacroTool_InstallationSpace festlegt. Hier wird das Makro im Scripte Verzeichnis unter:

MacroTool\Macros\InstallationSpace.ema

eingefügt. Die Dokumentenart wird auf ''3D'' gesetzt. Zusätzlich wird ein Bauraum erzeugt, welcher den Namen wie im Schema eingestellt bekommt. Die Struktur erbt der Bauraum von der Seite. Bauraum und Seite wird ohne Rückfrage überschrieben.

Folgende Eigenschaften werden an den Bauraum geschrieben:

• • Bauraumname
  • Name (Pfad)
  • Version
  • Quelle
  • Beschreibung

Hinweis: Es wird "Modell-Ansicht nicht aktuell" angezeigt. Hier handelt es sich um einen Fehler in der EPLAN API (Stand 2.7)

MacroToolCreateNeutralAction

Voraussetzung: Es ist die Hauptfunktion oder 3D-Element in einem Schaltplanprojekt ausgewählt, welche nur eine Artikelnummer eingetragen hat. Möglich im grafischen Editor & Bauraum. Es öffnet sich ein Dialog. Selektieren Sie die Zielstruktur im Seiten-Navigator und drücken OK.

Es wird die Action MacroToolCreateAction ausgeführt, mit dem Unterschied, dass die Ziel-Struktur auf die ausgewählte Struktur gesetzt wird. Die Struktur kann im Dialog angepasst werden. Als Standardwerte dienen die Werte, welche vom Artikel ermittelt werden für MacroToolCreateAction.

MacroToolSetPageMacroAction

Voraussetzung: Es ist eine oder mehrere Seiten im Seitennavigator markiert (nur im Makroprojekt).

Es werden folgende Seiteneigenschaften über das Beschriftungsschema MacroTool_PageMacro gefüllt:

• • Name (Pfad)
  • Version
  • Quelle
  • Beschreibung

MacroToolSetMacroBoxAction

Voraussetzung: Es ist ein Makrokasten markiert oder eine Seite (nur im Makroprojekt).

Es werden alle gefunden Makrokästen mit folgenden Informationen automatisch über das eingestellte Beschriftungsschema MacroTool_MacroBox füllt:

• • Name (Pfad)
  • Version
  • Quelle
  • Beschreibung

MacroToolSetInstallationSpaceAction

Voraussetzung: Es ist mindestens ein Bauraum markiert (nur im Makroprojekt).

Folgende Eigenschaften werden an den Bauraum geschrieben:

• • Bauraumname
  • Name (Pfad)
  • Version
  • Quelle
  • Beschreibung

MacroToolUpdateMacroPathAction

Voraussetzung: Es ist eine Hauptfunktion oder Bauteil im Bauraum mit Artikel markiert (nur im Makroprojekt).

Es wird der Makrodateiname aus dem Makrokasten/Bauraum ausgelesen und an alle Artikel geschrieben, welche das gleiche Makro tragen wie der Artikel in der Selektion.

MacroToolNewVariantAction

Voraussetzung: Es ist ein Makrokasten markiert oder eine Seite oder ein Bauraum (nur im Makroprojekt).

Es wird ein Dialog angezeigt, zur Auswahl der Darstellungsart und Variante der neuen Makro-Variante. Es wird die nächste freie Variante der Darstellungsart automatisch ausgewählt. Nach bestätigen mit OK wird die Seite erzeugt und ein Makrokasten mit gefüllten Informationen eingefügt.

MacroToolLinkModelViewToInstallationSpaceAction

Voraussetzung: Es ist eine Modell-Ansicht oder Bauraum bzw. Bauräume ausgewählt (nur im Makroprojekt).

Es werden alle Bauräume mit den Modell-Ansichten verbunden, welche die gleiche Struktur besitzen.

MacroToolSelectMacro

Voraussetzung: Es ist ein Makrokasten oder eine Seite (mit gefüllter Eigenschaft Makro) markiert. Oder es wird der Kontextmenüpunkt in der Artikelverwaltung ausgeführt.

Es wird das Makroprojekt geöffnet und an die Seite des Makros gesprungen.

Hinweis: Aus der Artikelverwaltung wird immer die ScriptSettings Variante mit dem Namen ''MacroTool'' herangezogen, um Makroprojekt und Einstellungen zu ermitteln.

MacroToolSelectMacroFromFile

Voraussetzung: Das Makroprojekt und die Seite im Projekt wurden weder verschoben noch umbenannt.

Ohne weitere Befehlszeilenparameter wird ein Datei-Öffnen Dialog angezeigt. Nach dem Auswählen einer Makrodatei durch den Benutzer, wird das passende Makroprojekt geöffnet und die Seite mit der ersten Darstellungsart und Variante des Makros angezeigt.

Mit dem Parameter MacroFile kann der Pfad zu einer Makrodatei direkt übergeben werden.  

MacroToolMacroPlacerDeviceAction

Es öffnet sich die Artikelverwaltung. Nach Auswahl eines Gerätes wird dies in der Struktur ''=MacroTool'' mit allen Darstellungsarten & Varianten erstellt.

MacroToolMacroPlacerFileAction

Es öffnet sich ein Datei-Öffnen-Dialog. Nach Auswahl des Makros wird dies in der Struktur ''=MacroTool'' mit allen Darstellungsarten & Varianten erstellt.

Einstellungen EPLAN

Da alle Sonderzeichen durch einen Unterstrich ersetzt werden, müssen diese Projekteinstellungen im Makroprojekt aktiv sein. _ÖöÄäÜüßẞ

Hinweis: Bei der benutzerdefinierten Struktur wird ein Punkt bei der Sonderzeichenersetzung berücksichtigt. Somit ist es möglich Artikelnummer wie TEST.123 ohne Schachtelung zu erstellen (wird zu TEST_123).

Es können mehrere Varianten vom MacroTool erstellt werden. Somit ist es möglich z.B. mehrere Makroprojekte zu nutzen.

Unterkennzeichen müssen auf Punkt stehen.

Die Symbolbibliotheken müssen im Schaltplanprojekt und im Makroprojekt auf gleicher Position stehen:

Optionen > Einstellungen > Projekte > Projekt > Verwaltung > Symbolbibliotheken

Platzhalter in Beschriftungen

Folgende Platzhalter können in den Beschriftungsschemata verwendet werden:

• • <#FileExtension#> Dateierweiterung aus ScriptSettings
  • <#Date#> Datum
  • <#Time#> Uhrzeit
  • <#User#> Benutzername (inkl. Domäne)

Script ausführen

Bis EPLAN 2.9: Aufruf über Toolbar

Über Rechtsklick (Menü) > Importieren können Sie die im Lieferumfang enthaltene Toolbar importieren.

Die Toolbar finden Sie unter: EPLAN_DATA\Skripte\Firmenkennung\Produktname
Wird ein vom Auslieferzustand abweichender Name in ScriptSettings verwendet, muss die Befehlszeile der mitgelieferten Toolbar angepasst werden.
Über Rechtsklick (Menü) > Anpassen... und einem Doppelklick auf das Icon der Toolbar können Sie die Schaltfläche bearbeiten.

In die Befehlszeile der Schaltfläche müssen Sie die in ScriptSettings erstellte Befehlszeile eintragen, um die Funktion über die Toolbar auszuführen.

Bis EPLAN 2.9: Aufruf über MenuCreator

Mit Hilfe der Scripterweiterung MenuCreator können Sie in EPLAN das Hauptmenü erweitern und die Action (Befehlszeile) leicht per Drag and Drop in das Menü ziehen. Über die integrierte Rechteverwaltung können Sie entscheiden, welche EPLAN Anwender das Menü erhalten.

Ab EPLAN 2022: Aufruf über ScriptSettingsToRibbon

Über ScriptSettings können Sie automatisiert eine Registerkarte in EPLAN erzeugen lassen. Hierfür muss folgendes Script geladen werden: EPLAN-Plattform/Skripte/ScriptSettings/ScriptSettingsToRibbon.cs

Folge Seite zeigt Ihnen, wie sie ScriptSettings in EPLAN 2022 und neuer einrichten können:

/Shop-Service/EPLAN-Erweiterungen

Ab EPLAN 2022: Aufruf über Menüband

Über Menüband > Rechtsklick > Menüband anpassen... können Sie einen Befehl in einer Registergruppe hinzufügen. Hier empfiehlt es sich eine eigene Registerkarte zu erstellen.

Erstellen Sie je nach Bedarf eine Befehlsgruppe und fügen einen beliebigen Befehl aus der Kategorie "Aktionen" ein. 

• Bild: Finden Sie im Verzeichnis EPLAN-Plattform/Skripte/ScriptSettings/Images alle SVG-Dateien der Produkte
• Anzeigename: Dieser Text wird direkt in der Benutzeroberfläche angezeigt
• Befehlszeile: Hier wird die Befehlszeile aus ScriptSettings eingefügt
• QuickInfo: Wird angezeigt wenn der Mauszeiger über dem Befehl steht
• Beschreibung: Wird angezeigt wenn der Mauszeiger über dem Befehl steht

Für Fragen stehen wir Ihnen gerne zur Verfügung.