Aufbau der exportierten Excel-Datei
Die Anwendung erzeugt die DGL-Datei vollständig im Code (Bibliothek ClosedXML) — es wird keine Vorlagendatei mitgeliefert oder kopiert. Dieses Kapitel beschreibt, wonach sich der Code richtet, für den Fall, dass der Export angepasst werden muss.
Zwei Bestandteile der offiziellen Konzernvorlage DGL_00-2023-0_Konzernvorlage.xlsx
lassen sich im Code nicht nachbilden: die customXml-Metadaten und die
hinterlegten Druckertreiber-Einstellungen. Die erzeugte Datei sieht aus
wie die Vorlage und lässt sich genauso ausfüllen, ist formal aber nicht
dieselbe Datei. Prüft der Auftraggeber die DGL maschinell auf
Vorlagenkonformität, ist das vorab zu klären.
Blatt und Seiteneinrichtung
| Eigenschaft | Wert |
|---|---|
| Blattname | Dokumentengesamtliste |
| Schriftart | Arial, durchgehend |
| Ausrichtung / Papier | Querformat, A4 |
| Skalierung | 83 % |
| Wiederholungszeilen beim Druck | Zeile 1–9 |
| Fixierung | oberhalb Zeile 10 |
Kopfbereich (Zeilen 1–9)
Zwei Füllfarben trennen den Kopfbereich inhaltlich:
| Farbe | Hex | Bedeutung |
|---|---|---|
| Gelb | #FFFF99 | allgemeiner Kopfbereich, Eintragungen des AN |
| Orange | #FFCC99 | Bereich P4:R9 — ausschließlich Eintragungen des Auftraggebers |
Die Zuordnung der Eingabefelder zu den Zellen:
| Zelle | Inhalt |
|---|---|
D2 | Dokumentnummer des AN |
E2 | Dokumentnummer des AG |
N2 | DGL-Ausgabe |
P3 / Q3 / R3 | Name AG-Planer / AG-Auftragsnummer / Kostenstellen-Nr. |
B4 | Teilenummer |
A6 / B6 | AG-Inventarnummer / AG-Benennung der Inv.-Nr. |
D5 | Firma des Erstellers |
D6 / E6 | Erstellt von (Name) / Erstellt am (Datum) |
D7 / E7 | Geändert von (Name) / Geändert am (Datum) |
Die Zellen A1 (Formularstand 00-2023-0) und A2
(„Dokumentengesamtliste (DGL)") werden fest geschrieben — sie gehören zum
Formular, nicht zu den Daten. Datumsangaben stehen im Format TT.MM.JJ.
Der Kopfbereich enthält außerdem 20 Zellkommentare mit den offiziellen
Ausfüllhinweisen des Konzerns — sie werden beim Export automatisch gesetzt.
Datenzeilen (ab Zeile 10)
Die Spalten des DataGridView im Hauptfenster entsprechen eins zu eins den Spalten A bis R der Excel-Datei:
| Spalte | Inhalt | Format |
|---|---|---|
| A | Aktualisiert zur Ausgabe | Text |
| B | Dokumentbenennung | Standard |
| C | Bemerkung | Text |
| D | Dokumentnummer des AN | Text |
| E–M | AG-Nummer, in Teile zerlegt (F, H, L feste Trennzeichen -/-//) | Text |
| N | Werkstückgebundene Baugruppe (W) | Text |
| O | E / G / N (entfällt / geändert / neu) | Text |
| P | Hinweis zur Ausführung | Standard |
| Q | Hinweis zur Archivierung | Text |
| R | Formel — setzt die AG-Nummer aus E, G, I, J, K, M zusammen | — |
Fast alle Zellen sind als Text formatiert (@). Werte wie 000 oder
001 müssen ihre führenden Nullen behalten. Leere Zeilen aus dem Raster
werden beim Export übersprungen, nicht als Leerzeile mit ausgegeben.
Dateiname und Ablage
Siehe Exportieren für den Aufbau des
Dateinamens und den Zielordner C:\VWGCBS_DGL_Export\.
Klassenaufbau im Code
Die Klasse ExcelExport ist bewusst in klar benannte Schritte aufgeteilt:
BlattAnlegen() Blattname, Standardschrift, Fixierung, Seiteneinrichtung
SpaltenEinrichten() Breiten
KopfbereichAufbauen() Zeilen 1–9: Verbünde, Texte, Füllungen, Rahmen
KommentareSetzen() die 20 Ausfüllhinweise
KopfdatenSchreiben() Werte aus den Eingabefeldern
ZeilenSchreiben() Datenzeilen ab Zeile 10 inklusive Formel
Alle festen Texte, Breiten und Höhen stehen als Konstanten am Anfang der Klasse. Wer den Export erweitert, sollte dieselbe Aufteilung beibehalten.