PartsToErp

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.

Anwendungsinstallation

Die Anwendung wird als MSI Paket geliefert und kann herkömmlich über Starten des Installationsassistenten, über die Windows Befehlszeile oder individuell angepasst, über ein Software Verteilungstool installiert werden.

Installationsassistenten

Starten Sie den Installationsassistenten mit einem Doppelklick auf die Datei PartsToErp_5.x.x.x.msi und folgen Sie den Anweisungen im Assistenten.

Parametrisierte MSI-Installation

Sämtlich Einstellungen für PartsToErp lassen sich bereits bei der Installation über das MSI-Paket für alle Benutzer vordefinieren. Darunter fällt auch der Installationsort und der/die Freischaltschlüssel für die Anwendung. Die Werte lassen sich entweder direkt im MSI-Paket, mittels des Tools Orca, anpassen oder über Befehlszeilenparameter übergeben.

Folgende Parameter stehen dabei zur Verfügung:

Beispiel Befehlszeile:

msiexec -i "%USERPROFILE%\Downloads\PartsToErp_4.0.0.95.msi" IBK_LICENCEKEY="MYLICENCE" IBK_ERPEXPORTPATH="\\SRV01\EPLAN\PartsToErp" IBK_EXPORTTYPE="SAP" IBK_SAPFILENAMEHEADER="header.txt"

Lizenz Freischaltung

Wurde noch kein Freischaltschlüssel bei der MSI-Installation hinterlegt, wird jeder Benutzer beim Start der Anwendung aufgefordert, einen Freischaltschlüssel einzugeben. Den Freischaltschlüssel finden Sie in Ihrem Benutzerkonto im Shop unter shopforprocess.com/account/downloads. Handelt es sich um einen Freischaltschlüssel für die PartsToErp Version 3 oder älter, muss zusätzlich noch ein Upgrade-Schlüssel eingegeben werden.

Scripte laden

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

Methode 1:
In EPLAN laden: Dienstprogramme > Scripte > Laden... > Script auswählen.

Methode 2:
Mit der Scripterweiterung LoadUnloadScripts mehrere Scripte in einem Arbeitsgang laden, entladen oder neu laden.

Methode 3:
Sie können sie Scripte mittels der AddOn-Technik verteilen. Damit können Sie das Script an mehreren Arbeitsstationen automatisch laden und müssen nicht jede Station manuell laden. Diese Methode ist für Firmennetzwerke zu empfehlen.

Wenn Sie Fragen haben, oder Unterstützung benötigen nehmen Sie Kontakt mit uns auf.

Einstellungen

Name
Damit die mitgelieferte Toolbar funktioniert, muss der Name PartsToErp eingetragen werden. Wenn Sie einen anderen Namen verwenden, muss die Toolbar angepasst werden (siehe unten).

Befehlszeile
Die Befehlszeile kann kopiert werden und für den Aufruf zum Beispiel in eine Schaltfläche (Toolbar) eingefügt werden.

Programmpfad
Hier muss die Datei PartsToErp.exe ausgewählt werden.

Schemata
Hier wird ein Schema bzw. mehrere Schemata eingestellt, dass für die Stücklistenstruktur und die Artikelinformationen verantwortlich ist. Hierbei ist nur der Schemaname zu hinterlegen. Werden die mitgelieferten Schemata angepasst, müssen sie wieder in das PartsToErp Verzeichnis im EPLAN Scripte Ordner exportiert werden.

Benutzerdefinierte Zieldateien
Ist die Einstellung aktiv, können Sie über das Schema "PartsToErp_Destination", den Ordner und die Dateinamen für die Exportdateien definieren.

Schema Name Excel Vorlage
Ist ein Schema angegeben, wird dieses als Vorlage für den Excel-Export genutzt.

Eigenschaftsname
Per EPLAN API-Addin (Runtime muss auf ibKastl signiert sein) können Sie den Stücklistennamen in die Artikelreferenzdaten zurückschreiben. Hierfür bietet sich am besten das Feld Stücklistengruppe <22289> an, da diese Eigenschaft als eigener Knoten im Stücklistennavigator angezeigt werden kann. Es kann aber auch ein Benutzer-Zusatzfeld für Artikelreferenzen verwendet werden. Ein Benutzer-Zusatzfeld mit dem absoluten Namen wird automatisch von PartsToErp angelegt, wenn es im Projekt noch nicht vorhanden ist.

Vorbereitungen in EPLAN

Beschriftungsschema Artikelstückliste
Die Beschriftungsschemata müssen in folgendem Pfad abgelegt werden und den vordefinierten Namen haben:
EPLAN_DATA**\Skripte[FIRMENKENNUNG]\PartsToErp\Schemes

Strukturkennzeichen oder auch andere für die Stücklisten identifizierende Werte müssen vor dem ersten TAB-Trennzeichen eingestellt werden. Zusatzfelder können über "Bearbeiten" geändert werden. Das Beschriftungsschema exportiert eine tabulatorgetrennte Textdatei mit bis zu 33 Spalten und Spaltenüberschriften.

Die Spalten werden wie folgt interpretiert:

Benutzerdefinierte Zieldateien
Sollen das Ausgabeverzeichnis und die Dateinamen dynamisch aus z.B. Projekteigenschaften zusammengesetzt werden, kann hierfür ein Beschriftungsschema vom Typ Inhaltsverzeichnis, mit dem Namen PartsToErp_Destination erzeugt werden. Die Ausgabedatei muss 3 Zeilen enthalten. Hierfür kann der Kopfbereich des Schemas verwendet werden. Die Etiketten bleiben leer.

1. 1. Zeile: Ausgabeverzeichnis
   2. Zeile: Dateiname Stückliste
   3. Zeile: Dateiname Stückliste Gesamt

Für EPLAN Versionen 2.7 und älter werden drei PartsToErp-spezifische Platzhalter interpretiert.

• • {#Date#}: Datum Format yyyy-MM-dd
  • {#Time#}: Uhrzeit Format HH-mm-ss
  • {#Username#}: Windows Benutzername

Ab der EPLAN Version 2.8 können hierfür EPLAN Pfadvariablen verwendet werden.

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

Funktionsbeschreibung

Benutzeroberfläche
Die Benutzeroberfläche besteht aus vier Fenstern, welche nach Bedarf angeordnet werden können.

Übersicht

Das Übersichts-Fenster zeigt alle Artikelgruppierungen, welche anhand des Gruppierungsmerkmals (Spalte 1) gebildet wurden. Hier können Stücklisten definiert und Differenzen zu gespeicherten Ständen gebildet werden.

Stücklisten bilden

Stücklisten werden durch die Vergabe von Namen für Artikelgruppierungen gebildet. Durch mehrfache Verwendung des gleichen Namens können weitere Artikelgruppierungen einer Stückliste hinzugefügt werden. Im Stücklistenkopf kann eine Beschreibung hinterlegt werden. Mit dem Haken im Stücklistenkopf lässt sich die jeweilige Stückliste für den Export auswählen. Die hinterlegten Informationen werden in PartsToErp gespeichert. Nicht gespeicherte Änderungen werden farblich gekennzeichnet und am Wert der Spalte "Gruppierung" wird ein * angezeigt.

Differenzen Bilden

Über das Hauptmenü "Bearbeiten" oder das Rechtsklick-Kontextmenü in der Übersicht kann die Differenz für alle Artikelgruppierungen oder für eine Auswahl erstellt werden. Im sich öffnenden Dialog "Vergleichsdatei öffnen" kann ein Stand für den Vergleich ausgewählt werden. Die Stände können auf den jeweiligen Benutzer gefiltert werden. Bei aktivem Haken "Nur passende Dateien anzeigen", werden nur Stände angezeigt, in denen die ausgewählten Artikelgruppierungen enthalten sind.

In den Einstellungen kann festgelegt werden, dass stets mit dem letzten Stand verglichen wird. Bei Aktivierung der Option wird der oben gezeigte Dialog nicht geöffnet.

Die Spalte "Statistik" zeigt die Menge der Artikel gesondert nach Stückzahl und Längen an, welche aktuell exportiert werden. Die Menge kann durch gebildete Differenzen und/oder durch manuelle Anpassung je Artikel beeinflusst werden.

Artikelgruppierungen, für welche eine Differenz aktiviert wurde, werden grün eingefärbt.

Filterspalten konfigurieren

Um Artikelgruppierungen leichter auffinden zu können, lassen sich bis zu 10 Filterfelder definieren. Diese können über das Beschriftungsschema in EPLAN festgelegt werden, (siehe Beschriftungsschema Artikelstückliste). Die Filterspalten können dann über das Rechtsklick-Kontextmenü "Spalten Konfigurieren", hinzugefügt werden.

Validierung von Stücklistennamen

Der Aufbau des Stücklistennamens (Syntax) kann über einen regulären Ausdruck festgelegt werden. Somit kann überprüft werden, ob ein valider Stücklistenname festgelegt wurde und Tipp- oder Kopierfehler werden vermieden. Sowohl der Stücklistenkopf als auch das Feld werden rot markiert. Zusätzlich wird im Meldungsfenster eine entsprechende Meldung generiert.

Reguläre Ausdrücke sind zwar nicht ganz einfach zu lesen sind jedoch ein äußerst effektives Werkzeug bei der Erkennung von Text-Syntax. Sie kommen in Suchfunktionen von diversen Anwendungen zum Einsatz und können sogar in EPLAN Filtern verwendet werden.

Regulärer Ausdruck	Beispiele	Beschreibung
^(ET-|M-)[0-9]{8}$	ET-00512672 M-10237910	- ganzer Ausdruck wird geprüft ^$ - beginnt mit ET- oder M- - gefolgt von Nummern im Bereich von 0 bis 9 [0-9] - genau 8 Stellen {8}
^[0-9]{10}-[0-9]{4}$	0987654321-0001 0123456789-0002	- ganzer Ausdruck wird geprüft ^$ - Nummern im Bereich von 0 bis 9 [0-9] - genau 10 Stellen {10} - gefolgt von einem - - gefolgt von Nummern im Bereich von 0 bis 9 [0-9] - Nummern im Bereich von 0 bis 9 [0-9] - genau 4 Stellen {4}

Längenvariable Bauteile

Ein Artikel wird als "längenvariabel" erkannt, wenn der Wert welcher in Spalte 10 der Stückliste steht, als Zeile in der folgenden Datei gefunden wird: $(MD_SCRIPTS)\PartsToErp\Templates\LengthVariableCharacteristics.txt. Wird PartsToErp nicht aus EPLAN heraus gestartet (z.B. Befehlszeilenaufruf aus anderem ECAD System), kann der Dateipfad als Argument übergeben werden.

Mit den Beschriftungseinstellungen aus der Tabelle oben könnte die Datei folgenden Inhalt haben:

Kabel/Allgemeine
Gehäusezubehör Innenanbau/Tragschiene
Kabelkanäle/Allgemeine
Gehäusezubehör Innenanbau/C-Profilschienen
Sammelschienen/Schiene
Benutzerdefinierte Schiene/Allgemeine
Verbindungen/Allgemeine

Befehlszeilenaufruf

PartsToErp kann auch ohne EPLAN aus anderen CAE-Anwendungen wie z.B. ELCAD gestartet werden. Voraussetzung hierfür ist eine entsprechend der oben gezeigten Tabelle befüllte und tabulatorgetrennte Stückliste.

Beispielaufruf aus eine Batch-Datei:

"C:\Program Files\ibKastl\PartsToErp\PartsToErp.exe" ^
/header:"\\SRV01\ECAD\Projects\MyProject.edb\Doc\PartsToErp" ^
/project:"\\SRV01\ECAD\Projects\MyProject.edb" ^
/file:"C:\Temp\PartsToErp\MyProject_BOM.txt"

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