staging.inyokaproject.org

ElsterFormular

Archivierte Anleitung

Dieser Artikel wurde archiviert. Das bedeutet, dass er nicht mehr auf Richtigkeit überprüft oder anderweitig gepflegt wird. Der Inhalt wurde für keine aktuell unterstützte Ubuntu-Version getestet. Wenn du Gründe für eine Wiederherstellung siehst, melde dich bitte in der Diskussion zum Artikel. Bis dahin bleibt die Seite für weitere Änderungen gesperrt.


Anmerkung: Elsterformular steht letztmalig für das Jahr 2019 zur Verfügung, siehe Hinweis auf Elsterformular 🇩🇪. Für Steuererklärungen kann bereits heute Mein Elster genutzt werden, für Steuererklärungen für das Jahr 2020 und später wird nur noch Mein Elster angeboten. Ein vereinfachter Zugang ist über den Elektronischer Personalausweis möglich.

Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:

elsterformular.png ElsterFormular 🇩🇪 bietet sowohl Privatanwendern als auch Selbstständigen und Gewerbetreibenden an, ihre Steuerangelegenheiten elektronisch bei ihrem Finanzamt einzureichen. Weitere Hilfestellungen oder steuerberatende Funktionen bietet ElsterFormular nicht.

ElsterFormular wird nur für Windows entwickelt, kann jedoch mit Hilfe von Wine auch unter Ubuntu genutzt werden. Die folgenden Installationshinweise beziehen sich nur auf diese aktuelle Version, die auch ältere Steuerformulare verarbeiten kann (von 2010 bis heute).

Es gibt mehrere Wege, ElsterFormular zu installieren.

Installation mit Hilfe von Wine

Die aktuelle Version 20.3 von April 2019 von ElsterFormular wird von der Webseite 🇩🇪 als .msi-Installationsdatei bspw. in das Verzeichnis Downloads heruntergeladen. Es werden drei Varianten angeboten, die unterschiedlich heißen, aber identisch installiert werden. Im Beispiel wird die ElsterFormular-Variante für Privatanwender verwendet.

Installation der Wine-Software

Um das Elsterformular nutzen zu können wird Wine installiert:

  • wine-stable (universe)

  • winetricks (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install wine-stable winetricks 

Oder mit apturl installieren, Link: apt://wine-stable,winetricks

Notwendige Windows-Abhängigkeiten werden ebenfalls installiert, u.a. die Unterstützung für 32-bit Software, die für ElsterFormular notwendig ist.

ElsterFormular mit Wine installieren

Das ElsterFormular-Programm kann in ein eigenes Verzeichnis installiert werden, damit wird eine Abhängigkeit von anderen unter Wine installierten Programmen vermieden und die Versions-Pflege wird vereinfacht. Das erfolgt im Terminal mit den folgenden Befehlen:

mkdir ~/ElsterFormular
export WINEPREFIX=~/ElsterFormular 

Der zweite Befehl ("export ...") setzt das sog Wineprefix, das die Prozesse der Wine-Software in diesem Installations-Verzeichnis ausführt. Für alle weiteren Schritte sollte nicht das Terminal gewechselt werden.

Wenn die beiden Befehle oben nicht genutzt werden, wird das Programm ggfs. zu anderen Programmen in das Verzeichnis ~/.wine installiert.

Eine Abhängigkeit (Windows Runtime-Bibliotheken) wird mit dem folgenden Befehl installiert, damit ElsterFormular genutzt werden kann:

winetricks vcrun2017 

Mit dem folgenden Befehl wird die benötigte ElsterFormular-Variante installiert:

wine msiexec /i ~/Downloads/ElsterFormularPrivat.msi 

Bei der Installation müssen noch einige Schritte bestätigt werden:

  1. Setup-Fenster bestätigen mit "Weiter".

  2. Den Lizenzbedingungen ggfs. zustimmen und mit "Weiter" fortfahren.

  3. Das Installationsverzeichnis wählen (oder so lassen), mit "Weiter" fortfahren.

  4. Die zwei angebotenen Optionen ggfs. anwählen, mit "Weiter" fortfahren.

  5. Installation mit "Installieren" starten und mit "Fertigstellen" abschließen.

Ggfs. startet Elsterformular.

  1. Es erscheint noch der Hinweis auf Mein Elster, schließen bspw. mit "später erinnern".

  2. Dem ElsterFormular-Programm den Zugriff auf das Internet erlauben mit "Ja immer".

Nun kann das ElsterFormular genutzt werden.

Problembehebung unter Wine

Generell

Während der Installation können Warn-Meldungen und Hinweise auftreten, die i.A. die Funktion nicht beeinträchtigen. Diese sollten mit "Ok" bestätigt werden.

wineserver hängt

Bei der Installation zusätzlicher Softwarepakete mit winetricks im Terminal kann der Prozess stehenbleiben bei dem Hinweis

------------------------------------------------------
Running /usr/bin/wineserver -w. This will hang until all wine processes in prefix=/home/<user>/.wine terminate
------------------------------------------------------

Dieser Prozess kann mit Strg + C abgebrochen werden, die Bibliotheken sind zu diesem Zeitpunkt bereits installiert.

Installation mit PlayOnLinux

PlayOnLinux (PoL) ist eine grafische Oberfläche für die Wine-Kompatibilitätsschicht und bietet u.a. für ElsterFormular ein Installationsskript an, in dem eine kompatible Wine-Version ausgewählt und das virtuelle Laufwerk 'ElsterFormular' (ähnlich wie WINEPREFIX - s.o.) erstellt wird, notwendige Bibliotheken installiert und Konfigurationsschritte ausgeführt werden. In dieses separate Laufwerk wird das Programm ElsterFormular installiert:

Start von PlayOnLinux

  • Nach der Installation von PlayOnLinux, dieses starten (ggf. aus dem Menü → Anwendungen → Dienste-Anwendungen → PlayOnLinux)

  • Im Hauptfenster wird einfach 'Installieren' gedrückt, um ein Windows-Programm zu installieren.

  • Im Fenster 'PlayOnLinux Installationsmenü' wird für ElsterFormular ein Profil angeboten, das die Installation des Programms weitgehend automatisiert. Dafür wählt man den Bereich 'Büro' (obere Zeile) an, dann erscheint im Fenster der Eintrag 'ElsterFormular'. Diesen Eintrag auswählen und bestätigen mit 'Installieren'.

  • Die folgenden 2 Abfragen vom PlayOnLinux Assistenten (rechtliche und nützliche Hinweise) einfach mit 'Weiter' bestätigen.

Der PlayOnLinux Installations-Assistent

  • Willkommensgruß und Software Downloads bestätigen mit 'Weiter. Die Wine-Umgebung wird erstellt und die notwendige Software-Pakete werden heruntergeladen, oft auch erst nach expliziter Bestätigung durch den Anwender. Daher immer die Popup-Windows im Auge behalten.

  • Währenddessen wird auch der Webbrowser mit der ElsterFormular-Download Seite gestartet.

  • Bis zum Ende scrollen und den Lizenz-Vertrag akzeptieren.

  • Bei Fehler 'Download fehlgeschlagen' ggfs Download wiederholen, also 'nochmal' drücken.

  • Webbrowser minimieren und im PlayOnLinux Popup-Fenster die richtige ElsterFormular-Version anwählen (Privatanwender / Unternehmer / Komplett) und mit 'Weiter' bestätigen, die Software wird heruntergeladen.

das ElsterFormular Setup

  • Willkommensgruß, mit 'Weiter' bestätigen.

  • Lizenzvertrag zustimmen und 'Weiter' drücken

  • Installationsverzeichnis angeben ('default' lassen) und 'Weiter' drücken

  • 'Updates herunterladen' bestätigen und 'Weiter' drücken

  • Installation Fertigstellen - 'Installieren' anwählen

  • Die Installation abschließen und optional ElsterFormular starten

  • abschließend Zugriff für Updates auf das Internet erlauben

  • Hinweis auf Elster-online ggfs. bestätigen.

Das Programm ElsterFormular ist nun offen und kann genutzt werden.

Problemlösungen mit PlayOnLinux

Fehler in PICA - Nachinstallation von Abhängigkeiten

Erscheint bei der Steuerberechnung ein Fehler in PICA, fehlen vermutlich notwendige Abhängigkeiten. Diese können innerhalb der PlayOnLinux-Laufwerke einzeln nachinstalliert werden.

PlayOnLinux bietet hierzu unter Konfigurieren → <Tab> Installiere Komponenten eine Liste von Komponenten an. Sollte die Komponente vcrun2017 nicht enthalten sein, kann dies mit winetricks ebenfalls installiert[2] werden:

  • winetricks (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install winetricks 

Oder mit apturl installieren, Link: apt://winetricks

Im entsprechenden PlayOnLinux-Laufwerk werden die folgenden Kommandos abgesetzt:

cd ~/.PlayOnLinux/wineprefix/ElsterFormular/
WINEPREFIX="~/.PlayOnLinux/wineprefix/ElsterFormular/" winetricks vcrun2017 

allgemeine Problemlösungen

ElsterFormular per Icon starten

Das ElsterFormular legt den Starter "ElsterFormular.desktop" auf der Arbeitsfläche an. Nach dem Starten in dem geöffneten Fenster die Option "Vertrauen und starten" anwählen. Das ElsterFormular wird nun geöffnet. Dann wird auch das Icon vom ElsterFormular angezeigt.

Später nach einem Neustart bietet sich die Option "Zu Favoriten hinzufügen" an, die beiden von Wine angelegten Dateien können dann von der Arbeitsfläche gelöscht werden.

ElsterFormular-interne Aktualisierung schlägt fehl

Die Update-Funktion von ElsterFormular lädt neuere Plugins und Updates herunter, schlägt jedoch bei der Installation des Hauptprogrammes fehl mit der folgenden Fehlermeldung:

Das Hauptprogramm und die Steuerberechnung konnten nicht aktualisiert werden. Wenn Sie Windows XP verwenden, ist der Grund eventuell eine falsche Einstellung im Berechtigungsdialog [...]

Es besteht die Möglichkeit das Hauptprogramm manuell zu aktualisieren. Die Einstellung des simulierten Betriebssystems wird geändert über winecfg → <Tab> AnwendungenWindows-Version: und sollte mindestens eine offiziell noch unterstützte Windows-Version sein (bspw. Windows 10).

Wenn das Update in ElsterFormular fehlgeschlagen ist, aber die notwendigen Updates bereits heruntergeladen wurden, muss die vom Updater heruntergeladene ZIP-Datei im Elster-Verzeichnis nur entpackt und die vorhandenen Dateien damit überschrieben werden. Dazu wird zuerst der Log-Eintrag des fehlgeschlagenen Updates im log "installationsverwaltung.log" gesucht:

export WINEPREFIX=~/.wine/ElsterFormular
# Pfad entsprechend anpassen, möglich wäre bspw. auch export WINEPREFIX=~/.PlayOnLinux/wineprefix/ElsterFormular [bei PlayOnLinux]
cd $WINEPREFIX/drive_c/users/$USER/Application\ Data/elsterformular
grep -i "Fehler beim Entpa" pica/log/installationsverwaltung.log 
3/9/2019 19:49:56.699 ERROR [pluginManager\pluginManager.cpp:5243->PluginManager::unzipPlugin] : Fehler beim Entpacken der Datei "update_pica_25244_26125.zip" nach "C:\Program Files\ElsterFormular". Versuch: 1

Hier findet man nun mehrere Zeilen mit dem Namen der ZIP-Datei (hier: "update_pica_25244_26125.zip"), die nach "C:\Program Files\ElsterFormular" (oder ähnlich) entpackt werden muss.

Hinweis:

Eine vorherige Sicherung des Verzeichnisses "ElsterFormular" ermöglicht eine Wiederholung des Vorgangs, falls an die Dateien an falscher Stelle entpackt wurden oder ein anderes Problem auftritt!

Das ElsterFormular Update speichert die temporären Update-Dateien im Verzeichnis pluginmanager/tmp/.

# Die entsprechende Datei sollte nun in diesem Pfad zu finden sein:
ls $WINEPREFIX/drive_c/users/$USER/Application\ Data/elsterformular/pluginmanager/tmp/update_pica_25244_26125.zip
# wenn das korrekt ist, wird sie nun im Programmverzeichnis entpackt:
cd $WINEPREFIX/drive_c/Program\ Files/ElsterFormular
unzip $WINEPREFIX/drive_c/users/$USER/Application\ Data/elsterformular/pluginmanager/tmp/update_pica_25244_26125.zip 
Archive:  ../../users/x/Application Data/elsterformular/pluginmanager/tmp/update_pica_25244_26125.zip
replace lizenzvertrag.pdf? [y]es, [n]o, [A]ll, [N]one, [r]ename: A
  inflating: lizenzvertrag.pdf
  inflating: bin/bds2f80.exe
  inflating: bin/cert.efo
  [...]

Nachdem das Hauptprogramm nun manuell aktualisiert wurde, kann ElsterFormular wie üblich gestartet und das Update wiederholt werden, wobei die restlichen Plugins nun problemlos installiert werden.

Neuinstallation Elsterformular

Sollten diese Troubleshooting-Tipps nicht geholfen haben, gibt es immer die Möglichkeit, Elsterformular neu zu installieren:

  • Falls in ein eigenes Wine-Laufwerk installiert: Das Laufwerk mit dem Pfad der entsprechenden Umgebungsvariable WINEPREFIX löschen

export WINEPREFIX=~/.wine/ElsterFormular
rm -rf $(echo $WINEPREFIX) ~/Schreibtisch/ElsterFormular.desktop
# oder
rm -rf ~/.wine/ElsterFormular ~/Schreibtisch/ElsterFormular.desktop
# falls installiert wie oben vorgeschlagen 

  • In PlayOnLinux über die Löschfunktion des PlayOnLinux-Programms

  • Falls ElsterFormular neben anderen Windows-Programmen in ein allgemeines Wine-Laufwerk installiert wurde: Das Löschprogramm von ElsterFormular ausführen:

wine ~/.wine/ElsterFormular/dosdevices/c:/Program Files (x86)/ElsterFormular/bin/uninstall.exe  # man beachte das tatsächliche $WINEPREFIX 

Diese Revision wurde am 12. April 2021 19:59 von noisefloor erstellt.
Die folgenden Schlagworte wurden dem Artikel zugewiesen: Büro, Wine, Steuer