====== Schnittstelle 3021 – Umsatz-Kostenstellenzuordnungen exportieren ======

Die Schnittstelle **3021** schreibt vorhandene Zuordnungen aus ''UmsKstGr'' in eine Datei. Sie verändert keine fachlichen Datenbankzeilen. Die Exportdatei ist kein vollständiges Backup der Tabelle.

<WRAP center round important 100%>
Die Zieldatei muss bereits existieren. PEP4 öffnet sie vor dem Datenbankzugriff und leert sie ohne eigene Überschreibabfrage. Bei einem Verbindungsfehler kann eine leere Datei zurückbleiben. Arbeite mit einer Kopie.
</WRAP>

===== Eingabe und Ablauf =====

Wähle für ''PFAD'' eine vorhandene Datei; der Dialog schlägt ''UmsatzKostenstellen.pep'' vor, verwendet trotz Export einen Datei-Öffnen-Dialog. Die Schnittstelle liest mit ''SELECT * FROM UmsKstGr ORDER BY Kst'' alle Zuordnungen. Eine fachliche Stored Procedure wird nicht aufgerufen. Die Quelldatenbank wird nicht verändert.

===== Aufbau der Ausgabedatei =====

Jede Zeile hat die Form ''3020;Kst;Gr;von;bis;Prozent;''. Das letzte Semikolon erzeugt ein zusätzliches leeres Feld. Es gibt keine Kopfzeile und keine Anführungszeichen um die Werte. Der ''StreamWriter'' verwendet seine UTF-8-Standardeinstellung; ein explizites BOM oder Datums-/Zahlenformat legt der Code nicht fest. Konvertierungen können von der Laufzeitkultur abhängen.

^ Feld ^ Herkunft ^
| Satzart ''3020'' | Feste Kennung für Datensätze des späteren Imports. |
| ''Kst'' | ''UmsKstGr.Kst'' |
| ''Gr'' | ''UmsKstGr.Gr'' |
| ''von'', ''bis'' | Gültigkeitsgrenzen; SQL-NULL kann bei der Umwandlung bereits einen Fehler auslösen. |
| ''Prozent'' | Gespeicherter Multiplikator, keine automatische Division durch 100. |

''ID'', ''bis2'', ''ts'', ''UserID'' und ''ekgruppe'' werden nicht ausgegeben. Der Export erzeugt keine Löschsätze. Ein Rückimport über [[schnittstellen:3020|3020]] fügt Zuordnungen an, statt sie verlustfrei wiederherzustellen.

===== Ergebnis und Grenzen =====

Prüfe nach dem Lauf Inhalt und Zeilenzahl der Datei. ''Ausführen'' liefert im untersuchten Code auch bei erfolgreichem Export ''False''; ein Fehlerdialog ist deshalb kein Beweis für eine unveränderte Datei. Bei einer Ausnahme kann eine leere oder teilweise geschriebene Datei bleiben.

===== Technische Referenz =====

^ Merkmal ^ Wert ^
| Programmkennung | ''3021'' / ''ExpUmsatzKostenstellen'' |
| Einstieg | ''cSchnittExpKostenstellenUmsatz.Ausführen'' |
| Eingang | Alle Zeilen aus ''UmsKstGr''; genutzte Felder ''Kst'', ''Gr'', ''von'', ''bis'', ''Prozent'' |
| Ausgang | Vorhandene Datei, vollständig überschrieben |
| Fachliches SQL | ''SELECT * ... ORDER BY Kst''; keine fachliche SP |
| Systemeinstellungen | ''GLOBAL_LOGLEVEL'' und ''GLOBAL_LOGLEVELEVLOG'' betreffen nur Protokolle; Code-Defaults 50 und 0. ''SQL_TIMEOUT'' ist hier nicht zugewiesen. |

===== Siehe auch =====

  * [[schnittstellen:3020|Umsatz-Kostenstellenzuordnungen importieren (3020)]]
  * [[schnittstellen:schnittstellen|Übersicht der dokumentierten Schnittstellen]]

===== Prüfstand =====

Am 25.09.2026 statisch gegen den Quellcommit ''f1d82a003b62f2658f06eaa943dc685ab219bdf3'' geprüft. Kein Exportlauf, produktives Schema oder öffentlicher HTTP-Abruf bestätigt.