Mit Hilfe von Konfigurationsdateien können Sie den Export und Import von Daten der Artikelverwaltung beeinflussen. Die Konfigurationsdatei kann dabei in den Dialogen Datensätze importieren und Datensätze exportieren (Dienstprogramme > Artikel > Verwaltung > [Extras] > Importieren und ... > Exportieren) durch Klick auf [...] im Feld Dateityp ausgewählt werden, wenn als Dateityp einer der Einträge "CSV für <...>", "ECAD" oder "Text" gewählt wurde.
Hinweis:
Beim CSV-Format haben Sie mehrere Möglichkeiten für Ex- und Import: Sie können die Bereiche "Adressen", "Artikel", "Anschlussbilder", "Bohrbilder", "Zubehörlisten" und "Zubehörplatzierungen" auswählen. Diese Bereiche dürfen in einer CFG-Datei hintereinander definiert werden.
Um Konfigurationsdateien zu erstellen, öffnen Sie die gewünschte Artikeldatenbank (beispielsweise durch Doppelklick im entsprechenden Verzeichnis), wählen die Tabelle, deren Daten Sie im- oder exportieren möchten (beispielsweise "tblFunctionTemplate" für die Tabelle der Funktionsschablonen), und übertragen alle relevanten Felder mit Ausnahme der Spalte "id" in die *.cfg-Datei (im Editor).
Am Anfang der cfg-Datei müssen folgende Angaben gemacht werden:
- Spaltentrenner, beispielsweise "separator=," um das Komma-Zeichen als Spaltentrenner zu definieren
- Der Eintrag "skipLeadIn" muss alle Überschriften berücksichtigen; da "fieldTitle" und "header" jeweils eine Titelzeile erzeugen, muss "skipLeadIn" also mindestens 2 sein.
- Die Anzahl Zeilen für einen Datensatz wird über den Eintrag "rowsPerRecord" festgelegt.
- "header" definiert die Titelzeile, d.h., es wird als Titel das ausgegeben, was hinter dem "=" steht. Der Eintrag muss in "skipLeadIn" berücksichtigt werden.
- Definieren Sie "fieldTitle=1", damit die Namen der Felder als Spaltenkopf mit ausgegeben werden. Der Eintrag muss in "skipLeadIn" berücksichtigt werden.
- Definieren Sie "trim=1", damit beim Import Leerzeichen vor und hinter dem eigentlichen Text entfernt und der Text linksbündig in das EPLAN-Datenfeld übertragen wird.
- Definieren Sie "convert-region-dependent=1", damit beim Import die Zahlendarstellung der Systemsteuerung verwendet wird. Für das Gebietsschema "Deutsch (Deutschland)" bedeutet dies beispielsweise, dass der Punkt "." als Tausender- und das Komma "," als Dezimaltrennzeichen verwendet wird (z.B. "1.200,00").
- Hinter diesen Angaben wird der Name der jeweiligen Tabelle in der Form "table=<Tabellenname>" (beispielsweise "table=tblFunctionTemplate") festgesetzt.
Hinweis:
Standardmäßig wird ein " als "" importiert, beispielsweise "Bezeichnung 1: PC mit 15"" Monitor". Sie können jedoch das Zeichen verändern, indem Sie in der cfg-Datei folgende Zeile eingeben:
textquote=‘
Dann wird das " als ein " importiert.
Die Einträge für die einzelnen Datenbankfelder, die auf die Definition des Tabellennamens folgen, sind folgendermaßen aufgebaut:
variant=[1!#189]
Dabei ist in diesem Beispiel "variant" das Feld aus der Datenbank. Alles nach dem "=" ist der gewünschte Wert. In den eckigen Klammern "[ ]" wird die Position angegeben, wobei alles vor dem "!" die Anzahl Zeilen festlegt, da ein Datensatz auch in mehreren Zeilen ausgegeben werden kann. Nach dem "#"-Zeichen folgt die Angabe der Spalte.
Es können auch feste Texte für Felder vergeben werden. Das sieht beispielsweise so aus:
variant="text vorher" + [1!#6] + "text nachher" oder partnr="Loz."+[1!#4] oder partnr="Siemens".
Der Wert in den eckigen Klammern "[ ]" kann auch ein fest formatiertes Feld enthalten, beispielsweise variant=[6,5]. Hier ist die erste Zahl die Spaltenangabe, die 2. Zahl nach dem Komma gibt die Länge des Textes an, d.h., hier werden in Spalte 6 fünf Zeichen eingelesen / ausgegeben.
Im Verzeichnis ...\Artikel\EPLAN befindet sich die Datei csvimportexport.cfg, die unter anderem die Daten für die Funktionsschablonen enthält:
separator=,
skipLeadIn=3
rowsPerRecord=1
header=Header
fieldTitle=1
table=tblFunctionTemplate
variant=[1!#189]
connectionDesignation=[1!#190]
pos=[1!#191]
terminalNr=[1!#192]
idx1=[1!#193]
idx2=[1!#194]
characteristics=[1!#195]
functiondefcategory=[1!#196]
functiondefgroup=[1!#197]
functiondefid=[1!#198]
intrinsicsafety=[1!#199]
Achtung:
Beachten Sie unbedingt, dass die Tabelle "tblFunctionTemplate" nur als Ganzes ex- oder importiert werden darf. Auch wenn diese Tabelle anscheinend mehrere Felder beinhaltet, so werden diese dennoch wie ein Feld behandelt. Wird also beim Import beispielsweise ein Feld auskommentiert, so wird ein eventuell vorhandener Eintrag in der Artikelverwaltung gelöscht!
Beim Import von Artikeldaten mit den Dateitypen "CSV für <...>" und "Text" können Sie außerdem in der Konfigurationsdatei festlegen, in welcher Sprache die Texte importiert werden sollen. Dazu wird in der Konfigurationsdatei bei dem entsprechenden mehrsprachigen Feld die gewünschte Sprachkennung mit angegeben.
description1="DE_de@" + [1!#26] + ";EN_us@" + [1!#27] + ";RU_ru@" + [1!#28] + ";"
Hier ist die Information für Bezeichnung 1 (description1) in drei Spalten verteilt: Spalte 26 = Deutsch, Spalte 27 = Englisch und Spalte 28 = Russisch. Diese drei Spalten werden durch obige Konfiguration zusammengefasst.
Beim Import von freien Eigenschaften und Attributen ist zu beachten, dass die Kennung in der CSV-Datei der Feldname ist. Zusätzlich wird bei den Tabellen eine Zeilennummer angehängt.
Eine mögliche Festlegung in der Konfigurationsdatei:
table=tblFreeProperty
description.1=[1!#207]
val.1=[1!#208]
unit.1=[1!#209]
Das ".1" steht hier jeweils für die erste Zeile in der Tabelle Freie Eigenschaften. Die Attribute werden analog bearbeitet.
Beim Import von freien Eigenschaften ist es darüber hinaus möglich, alle zu importierenden freien Eigenschaften in einer Zeile zu platzieren. Dazu müssen in der zugehörigen Konfigurationsdatei die zu importierenden freien Eigenschaften mit entsprechender Zeilennummer in der Registerkarte Freie Eigenschaften aufgelistet werden. Die jeweilige Zeilennummer wird dabei mit einem Punkt "." hinter den Feldbezeichnungen description, val und unit eingegeben.
Eine mögliche Festlegung in der Konfigurationsdatei:
table=tblFreeProperty
description.1=[#3]
val.1=[#4]
unit.1=[#5]
description.2=[#6]
val.2=[#7]
unit.2=[#8]
Siehe auch
Stücklisten: Felder in der Exportdatei
Artikelverwaltung: CSV-Import und -Export für Artikel
Artikelverwaltung: CSV-Import und -Export für Adressen
Artikelverwaltung: CSV-Import und -Export für Anschlussbilder