- VS2022 Community Edition
- mit Visual C++ ATL für x86 und x64
- mit Visual C++ MFC für x86 und x64
- passende Windows SDK (14.3 Plattform empfohlen)
- aktuelle ERiC-SDK
- downloaden unter https://www.elster.de/elsterweb/infoseite/entwickler
- z.B. in "C:\Program Files (x86)\Elster" entpacken (.jar-Archive können z.B. mit 7zip entpackt werden)
- ericapi.lib und .h Dateien in das Solution-Verzeichnis kopieren
- siehe unten bei ERiC Update Checkliste
- ECTElster.sln in VS2022 öffnen
- Bei den Projekteigenschaften -> Konfigurationseigenschaften -> Bibliotheksverzeichnisse sicherstellen, dass die ein geeignetes SDK für die ucrt library enthalten ist, z.B. "C:\Program Files (x86)\Windows Kits\10\Lib\10.0.17763.0\ucrt\x86"
- gleiches unter C/C++ -> Allgemein -> zusätzliche Header-Dateien, z.B. "C:\Program Files (x86)\Windows Kits\10\Include\10.0.17763.0\ucrt"
- wenn man Visual Studio nicht ständig als Admin laufen lassen will, kann es die .ocx-Datei nicht während des Build-Vorgangs mit registrieren. Das ist nicht schlimm. Man kann es einmal manuell mit regsvr32.exe ECTElster.ocx im Debug-Verzeichnis machen und dann den Fehler ignorieren:
# für 32-bit den regsvr32 aus dem SysWOW64 benutzen!
c:\windows\SysWOW64\regsvr32.exe "C:\Pfad\zu\meinen\Softwareprojekten\ECTElster\Debug\ECTElster.ocx"
ericapi.dll, ericxerces.dll und eSigner.dll aus dem ERiC-SDK ( z.B. C:\Program Files (x86)\Elster\ERiC-XX.X.X.X\Windows-x86\dll ) sowie das gesamte plugins2-Verzeichnis in das Debug-Unterverzeichnis kopieren. Dort auch Kopien der Dateien des EC&T-Hauptprogramms ablegen (EasyCT.exe, EasyCTXP.dll, ECTIFace.dll, CrashSender1402.exe und crashrpt_lang.ini werden benötigt). Das .ocx der Schnittstelle zum Hauptprogramm registrieren:
# für 32-bit den regsvr32 aus dem SysWOW64 benutzen!
c:\windows\SysWOW64\regsvr32.exe "C:\Pfad\zu\meinen\Softwareprojekten\ECTElster\Debug\EasyCTX.ocx"
Siehe dazu auch die beiden .bat-Dateien im Projektverzeichnis.
- InnoSetup herunterladen ( http://www.jrsoftware.org/isdl.php )
- InnoSetup starten
- ECTElster.iss öffnen
- ggf. eigenes Software-Signaturzertifikat bei SignTool= anpassen
- ggf. Pfade und AppVerName= anpassen
Die eigentliche Musik bei der Oberfläche spielt in ElsterDlg.cpp. Es wird dort im Kern eine ListCtrl Abwandlung namens QuickList verwendet und darin der Aufbau des Formulars nachgeahmt. Wenn eine Validierung via ERiC-API erfolgreich ist, kann es mit dieser API versendet werden, was in den 'Formularlogik'-Klassen geschieht.
- aktuelle Version des ERiC-SDK downloaden (wofür man erst einmal ein Passwort anfragen muss): https://www.elster.de/elsterweb/entwickler/infoseite/eric (als entwickler einloggen)
- common.zip nach C:\Programme (x86)\Elster entpacken
- windows-x86.jar mit 7zip öffnen, Setup.exe entpacken & starten
- Windows-x86\dll Verzeichnis mit Vorversion anhand ECTElster.iss abgleichen (manchmal gibt es neue DLLs, die eingebunden werden müssen oder aber DLLs fallen weg)
- Windows-x86\dll\plugins2 Verzeichnis checkUStVA_20XX.dll und commonData.dll mit Vorversion anhand ECTElster.iss abgleichen (oft sind nur die neuen Jahres-Versionen der DLLs zu ergänzen, manchmal gibt es aber auch neue DLLs, die eingebunden werden müssen oder aber DLLs fallen weg -- achte insbesondere auf alle Dateien, das nicht mit "check" anfangen). Zur Sicherheit die aktuellsten fünf checkUStVAs im Installer einbinden.
- Änderungen in ECTElster.iss anpassen und Pfad ändern (replace all "C:\Program Files (x86)\Elster\ERiC-##.#.#.#", neue checkUStVA_20XX.dll nicht vergessen!)
- VC_redist.x86.exe aus dem alten ERiC-Basisverzeichnis ins neue kopieren (da speichere ich es zumindest immer zu Archivzwecken, ansonsten von Microsoft herunterladen).
- checken, ob eriapi.dll immer noch die VC2017 runtime version benutzt (steht in Dokumentation\ERiC-Entwicklerhandbuch.pdf, in ERiC v31 auf Seite 26 im Abschnitt "2.4.5 Mindestanforderungen an benötigte Software"; im Zweifel Suche im PDF nach "Visual C++ Redistributable")
- Windows-x86\lib\ericapi.lib nach ECTElster kopieren
- Windows-x86\include\*.h nach ECTElster kopieren
- Version in den ECTElster-Ressouces und der .iss hochsetzen, copyright in About-Dialog aktualisieren
- #define TESTVERBINDUNG in ElsterDlg.cpp -- Kommentarzeichen entfernen
- ECTElster.sln mit Debug-Konfiguration neu bauen, ggf. Compilerfehler beseitigen (Abwärtskompatibilität ist nicht vorgesehen, es kann jedesmal Überraschungen geben; common\ERiC-Aenderungsdokumentation.pdf ist dann ein Blick wert) -- ggf. .ocx dorthin kopieren, wo es registriert ist
- Test-Datei mit aktuellem Buchungsjahr übertragen
- // #define TESTVERBINDUNG -- wieder auskommentieren, um Plugin scharf zu schalten
- ECTElster.sln mit Release-Konfiguration neu bauen
- .iss bauen und installieren
Dank gebührt Olaf Stüben von Winston, der bei der ersten Version des Plugins behilflich war. Außerdem wird folgende Software vom Plugin verwendet:
- ERiC-API der bayrischen Finanzverwaltung
- XMLite: leichtgewichtige Klassen für XML-Parsing von Cho Kyung Min
- CRegExp: Klasse für reguläre Ausdrücke von Henry Spencer, CodeGuru-Post durch Zafir Anjum
- QuickList: CListCtrl replacement von PEK