# eSaver Ausw Ersparnis v1.02.3 packages

Auswertung Ersparnis v1.02.3 - (c) <span style="color:blue"> GMarder </span>/[eSaver][312] GmbH  
https://www.esaver.eu/

[312]: https://www.esaver.eu/

## Motivation

Die Projektdaten werden derzeit in zwei unterschiedlichen VIDA-Datenerfassungen aufgezeichnet.

Für die Jahresauswertung müssen diese Daten zunächst in zwölf Monatsdateien aus dem VIDA-System exportiert werden.

Anschließend werden die enthaltenen Werte in eine Importdatei konvertiert und die Einheiten gegebenenfalls angepasst (z. B. Wh in kWh).

Die aufbereiteten Monatsdateien werden danach in die Jahresauswertung übernommen und dort in Excel weiterverarbeitet.

---

## Funktionsablauf

Alle benötigten Dateinamen und Ablageorte werden in einer Excel-Datei definiert, über die anschließend die Konvertierung erfolgt.

Zur Überprüfung der Verbindung zum Python-Programm wurde ein Button integriert.  
Bei erfolgreicher Verbindung wird eine entsprechende Rückmeldung ausgegeben.

Für die Verarbeitung der Daten stehen drei weitere Buttons zur Verfügung.  
Nach erfolgreicher Ausführung kehrt der jeweilige Button automatisch in seine Ausgangsposition zurück.

---
---

## Einstellungen in der Excel-Datei

### Hinterlegen der Projektkennung

| Parameter       | Wert              |
| --------------- | ----------------- |
| Projektname     | Name1-Name2       |
| Projekttyp      | G 63 M / 1000 kVA |
| Projektnummer   | PJJ0X0XX          |
| Datum           | 18.02.2026        |
|                 |                   |
| Jahresübersicht | 2025              |
| Datum Start     | 01.01.2025        |
| Datum Ende      | 31.12.2025        |
|                 |                   |
|                 |                   |

---

### VIDA-Version und Ablageorte

| Parameter         | Wert                                                   |
| ----------------- | ------------------------------------------------------ |
| VIDA-Version      | VIDA-SystemX                                           |
| Export VIDA       | Stundenverbrauch                                       |
| Path Export Files | C:\...\VIDA-Export-Path\...\eSaver_Ausw_Erspar\example |
| Path Import Files | C:\...\VIDA-Import-Path\...\eSaver_Ausw_Erspar\example |
|                   |                                                        |
|                   |                                                        |

Hinweis: Beide Pfade können identisch sein.

---

### Export-Dateien

| Parameter          | Wert                                                           |
| ------------------ | -------------------------------------------------------------- |
| Export_File_01_Jan | PJJ0X0XX Export_VIDA-Data_2025_0101_2025_0201_StdVerBer_GM.csv |
| Export_File_xx_mon | PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_yy01_StdVerBer_GM.csv |
| Export_File_12_Jan | PJJ0X0XX Export_VIDA-Data_2025_1201_2025_1201_StdVerBer_GM.csv |
|                    |                                                                |
|                    |                                                                |

→ Insgesamt 12 Dateien für die Jahresauswertung

---

### Import-Dateien

| Parameter          | Wert                                                            |
| ------------------ | --------------------------------------------------------------- |
| Import_File_01_Jan | PJJ0X0XX Import_VIDA-Data_2025_0101_2025_0201_StdVerBer_Imp.csv |
| Import_File_xx_mon | PJJ0X0XX Import_VIDA-Data_2025_xx01_2025_yy01_StdVerBer_Imp.csv |
| Import_File_12_Jan | PJJ0X0XX Import_VIDA-Data_2025_1201_2025_1201_StdVerBer_Imp.csv |
|                    |                                                                 |
|                    |                                                                 |

→ Insgesamt 12 Dateien für die Jahresauswertung

---

### Auswertungsdatei

| Parameter               | Wert                                                                   |
| ----------------------- | ---------------------------------------------------------------------- |
| PJJ0X0XX_Ersparnis_File | PJJ0X0XX_Name1-Name2 Ersparnis 2025_01-12 - Stundenbasiert ID.xlsx     |
|                         |                                                                        |
|                         |                                                                        |

→ Die Datei wird im Verzeichnis *Path_Import_Files* erwartet

---
---

## Bedienung der Excel-Datei

Zur Vereinfachung der Datenverarbeitung wurden entsprechende Bedienbuttons integriert.

### Verbindung zu Python testen

- Button „Test Main“

Dieser ruft die Funktion `xw_main_req` auf und schreibt eine Rückmeldung in die Excel-Datei.

---

### Verarbeitung der VIDA-Daten

#### Schritt 1: Initialisierung

- Funktion zur Vorbereitung der Importstruktur  
- Export-Dateien werden eingelesen und in Import-Dateinamen umgewandelt

---

#### Schritt 2: Generierung der Importdateien

- Exportdateien werden eingelesen  
- Werte werden geprüft und vereinheitlicht  
- Importdateien werden erstellt

---

#### Schritt 3: Import in die Auswertung

- Importdateien werden eingelesen  
- Daten werden geprüft  
- Werte werden in die Auswertungsdatei übertragen

---
---

## Programmstruktur

``` text
├── pyproject.toml
├── ... other config files ...
├── docs
│   ├── api_eS_Ausw_1_xlsm_Init_reads.md
│   ├── api_eS_Ausw_2_csv_to_excel_and_scan_kw.md
│   ├── api_eS_Ausw_2_xlsx_to_excel_and_scan_kw.md
│   ├── api_eS_Ausw_3_Imports_to_Ausw.md
│   ├── api_eS_Ausw_Erspar.md
│   ├── api_eS_Data_App.md
│   ├── api_eS_Data_XLS.md
│   ├── api.md
│   └── index.md
├── examples
├── ├── PJJ0X0XX_Empty
├── ├── ├── PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_xx01_StdVerBer_GM.csv
├── ├── ├── "="  // Muster-Dateien ohne Werte
├── ├── └── ...
├── ├── PJJ0X0XX_Values
├── ├── ├── PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_xx01_StdVerBer_GM.csv
├── ├── ├── "="  // Muster-Dateien mit Werten
├── ├── └── ...
│   ├── eSaver_Export_VIDA_Ausw_Erspar_SVB_PJJ0X0XX.xlsm
│   ├── PJJ0X0XX Export_VIDA-Data_2025_0101_2025_0101_StdVerBer_GM.csv
│   ├── PJJ0X0XX Export_VIDA-Data_2025_xx01_2025_xx01_StdVerBer_GM.csv
│   ├── PJJ0X0XX Export_VIDA-Data_2025_1201_2026_0101_StdVerBer_GM.csv
│   ├── PJJ0X0XX_Name1-Name2 Ersparnis 2025_01-12 - Stundenbasiert GMpk.xlsx
│   └── ...
├── src
│   ├── __init__.py
│   ├── eSaver_Ausw_1_xlsm_Init_reads.py
│   ├── eSaver_Ausw_2_csv_to_excel_and_scan_kw_v.py
│   ├── eSaver_Ausw_2_xlsx_to_excel_and_scan_kw_v.py
│   ├── eSaver_Ausw_3_excel_Imp_to_excel_Ausw.py
│   ├── eSaver_Data_App.py
│   └── eSaver_Data_XLS.py
└── tests
    ├── __init__.py
    └── test_eSaver_Data_App_pytest.py.py
```

## Installation

```bash
# Build and Install (local)
pip install -e .
```

---
End of File
