Projekte Positionen - Export anhand Vorlage

Mit dieser Funktion können anhand von Vorlagen die Projektpositionen als CSV Datei exportiert werden. Die Vorlage bestimmt welche EleLa Spalten exportiert werden und wie die Spalten im Export betitelt werden. Zusätzlich können Formatierungen für den Export durchgeführt werden. EleLa exportiert alle in der Projekt Position sichtbaren Zeilen, außer die Zeilen mit dem Status "n.v.".

Mit dieser Funktion lassen sich Dateien individuell für z.B. Bestückungsautomaten generieren. Das Dateiformat ist aufgebaut wie bei eine INI Konfigurationsdatei und lieg im Vorlageordner von EleLa. Der Dateiname muss in diesem Format sein: "ProjektExp_XXXXX.ini", wobei man XXXXX mit den eigenen Bezeichnern für den Export verwenden muss.

Ausgeführt wird diese Funktion unter Projekt > Positionen > Import/Export Taste > Export Vorlage > Auswahl der Vorlage Datei

Der Aufbau der Konfigurationsdatei:

INI Datei Eintrag	Default	Beschreibung
[General]		Dateiübergreifende Einstellungen
Separator	;	Der Separator zwischen den Spalten, 1 Zeichen. z.B. ; oder , oder \t für Tab
ExportDatei		Pfad und Dateiname für den Export. Wenn der Dateiname leer gelassen wird so erstellt EleLa einen anhand der Projektbezeichnung. Wenn diese Parameterzeile nicht existiert, so wird die Datei nicht erzeugt. Environment Variablen werden erkannt und ersetzt.
ExportDateiTop		Pfad und Dateiname für den Export aller Zeilen der Lage "Top". Wenn der Dateiname leer gelassen wird so erstellt EleLa einen anhand der Projektbezeichnung. Wenn diese Parameterzeile nicht existiert, so wird die Datei nicht erzeugt. Environment Variablen werden erkannt und ersetzt.
ExportDateiBottom		Pfad und Dateiname für den Export aller Zeilen der Lage "Bottom" (nicht "Top"). Wenn der Dateiname leer gelassen wird so erstellt EleLa einen anhand der Projektbezeichnung. Wenn diese Parameterzeile nicht existiert, so wird die Datei nicht erzeugt. Environment Variablen werden erkannt und ersetzt.
Dateiendung	csv	Endung der Datei nach dem Export, sofern diese nicht bereits im Parameter "ExportDatei" im Dateiname enthalten ist.
Codierung	UTF-8	Dateicodierung nach dem Export. Mögliche Einstellungen: UTF-8, UTF-8BOM, UCS-2LE, UCS-2BE, Ansi, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-7, ISO-8859-9, ISO-8859-10, ISO-8859-13, ISO-8859-14, ISO-8859-15, ISO-8859-16, cp1250, cp1251, cp1252, cp1253, cp1254, cp1255, cp1256, cp1257, cp1258, cp437, cp850, cp852, cp865, cp866, cp874, cp932, cp936, cp949, cp950, KOI8-R, KOI8-U, KOI8-RU, Macintosh
DecimalSeparator		Bei Ausgabe des Float Zahlenwertes wird dieses Zeichen als Komma Trennzeichen verwendet. Erlaubte Eingaben: , . Wenn nichts eingegeben wird, so wird das Default Komma Zeichen vom Betriebssystem verwendet.
[Calculator]		Zusätzliche Berechnungen der Positionsdaten (Optional)
Flip	0	Spiegeln der Daten. Dabei wird PosX = PosX * -1 gerechnet und Top/Bottom wird getauscht 0: nicht / 1: Flip aktiv
FlipBottom	0	Spiegeln der Lage Bottom, dabei wird PosX = PosX * -1 und PosR = Rest(-PosR-180, 360) 0: nicht / 1: FlipBottom aktiv Wenn "Flip" und "FlipBottom" aktiviert ist, wird bei der Bottom Lage "FlipBottom" ausgeführt und "Flip" nur auf der Top Lage.
Rotate	0	Drehen der Platine. Das Drehen wird nach dem Flip berechnet. Erlaubte Werte sind 0, 90, 180, 270, -90, -180, -270, die Maßeinget ist °. Optional kann der Text CW (clock wise) oder CCW (counter clock wise) mit verwendet werden. Per Default rechnet EleLa "CCW", 90° linksdrehend. Beispiel: 90CW ist identisch mit -90CCW
[Spalte1]		Die erste Spalte
Titel		Bezeichnung / Überschrift der Spalte. Dieser Parameter muss vorhanden sein.
Feld		EleLa Datenbank Feldname, der in diese Spalte exportiert wird. Dieser Parameter muss vorhanden sein, wenn nicht "Wert" verwendet wird. Besonderheit bei TecData Felder: Um auf Daten der technischen Daten zugreifen zu können kann man in EleLa <Feldname>.<TecData Bezeichner> als Feldname eingeben.
Format	0.00##	Bei Format kann die Formatierung gesetzt werden wenn der Typ des Feldes in der Datenbank ein "Float" ist. Wenn der Parameter nicht verwendet wird so wird der EleLa Standard für das jeweilige Feld verwendet. Beispiele: 0 ist eine Stelle mit fester Zahl # ist eine optionale Zahl . ist das Trennzeichen
Ersetzen1		Hiermit kann ein Textzeichen in ein anderes gewandelt werden. Formatierung: "<ZuErsetzen>\|<NeuerText>" In diesem Beispiel wird der Text "<ZuErsetzen>" in den Text "<NeuerText>" gewandelt. Der Trenner ist das \| Zeichen und ein \| kann daher nicht gewandelt werden. Mit "Ersetzen2" ... "ErsetzenX" können mehrere Ersetzen Regeln hinzugefügt werden. "Ersetzen" wird beim Feldtyp "Float" ignoriert.
Wert		Konstante wenn im Export eine Spalte benötigt wird, die nicht in EleLa vorhanden ist. Beispiel: Wert=NO Schreibt in diese Spalte immer ein "NO". Der Parameter wird ignoriert wenn der Parameter "Feld" benutzt wurde.
IfNULL		Wenn der Feld Wert NULL is, so kann stattdessen dieser Ersatzwert ausgegeben werden. Dieser Wert wirkt auch bei TecData Felder, die nicht vorhanden sind.

Wenn der Wert nicht gesetzt ist, so nimmt EleLa automatisch den Default als Wert.

Während dem Export logt EleLa im Log welche Spalten für einen Export verfügbar sind und wohin die exportierte Datei geschrieben wurde. In der Regel wird diese Datei im EleLa Temp Ordner abgelegt.

Beispiel der Konfiguration:

[General]
Separator=,
ExportDatei=D:\Temp

[Spalte1]
Titel=ID
Feld=BV_ID

[Spalte2]
Titel=Footprint
Feld=Gehause

[Spalte3]
Titel=SMD
Feld=GH_Smd
Ersetzen1=0|No
Ersetzen2=1|Yes

[Spalte4]
Titel=PosX
Feld=PosX
Format=0.000

[Spalte5]
Titel=PosY
Feld=PosY
Format=0.000

[Spalte6]
Titel=PosR
Feld=PosR
Format=0.000

Beispiel General:
Exportiert wird die Datei in den Ordner D:\Temp, den Dateiname legt EleLa selbst fest. Der Separator in der CSV Datei ist ein ",". Wenn in einer Spalte ein Text enthalten ist, der ebenfalls ein "," enthält, so wird der Text in " gesetzt. Wenn man das nicht möchte kann man mit dem "ErsetzenX" Parameter das "," in ein anderes Zeichen ersetzen.

Beispiel Spalte 3:
In EleLa sind die Infos für eine gesetze Information als Zahlenwerte in der Datenbank, hier werden die Zahlen in Text umgesetzt.

Bespiel Spalte 4:
Das Feld ist ein Float Feld, daher wird der Parameter "Format" verwendet.

Wenn der Abschnitt [Calculator] verwendet wird, dann werden die PosX, PosY und Top anhand der hinterlegten Formeln erst umgerechnet bevor die Ausgabe erfolgt.

Hinweis zum Dateiformat: Bei UTF-8BOM, UCS-2LE, UCS-2BE wird in die Datei der Typ der Codierung in die ersten Zeichen geschrieben. Anhand dieser Codes kann ein Texteditor das Format eindeutig erkennen, diese Zeichen werden automatisch ausgeblendet. Doch andere Programme, die nicht die Codierung lesen können funktionieren eventuell nicht korrekt. Diese Zeichen können nur in einem Hex-Editor gesehen werden:

0xEF 0xBB 0xBF	Dateiformat: UTF-8BOM
0xFF 0xFE	Dateiformat: UCS-2LE
0xFE 0xFF	Dateiformat: UCS-2BE

Wenn diese Codierung zu Anfang nicht steht muss das Programm die Text-Datei analysieren und selbst die Art der Codierung heraus finden. Die bessere Methode ist dass diese Codierung mit drin steht. Leider haben die ganzen ältere Codierungen alle keine eindeutige Kennzeichnung am Dateianfang, was zum Teil zu komischen Effekten bei der Darstellung von Sonderzeichen führt.

Ansi Format: Unicode Sonderzeichen, werden automatisch gelöscht da diese nicht in ein 7/8-Bit Zeichensatz passen. Das µ Zeichen wird automatisch zu einem u konvertiert.

Tipp Hex-Editor: Beim Notepad++ kann man sich das Plugin "HEX-Editor" dazu installieren.