Beachten Sie vor Beginn der Aktualisierung die Hinweise zur Aktualisierung.
Planen der Aktualisierung
Informieren Sie die Anwender über die bevorstehende Aktualisierung und weisen Sie diese an, SmartTaxBalance zu beenden bzw. nicht zu benutzen. Wenn Sie SmartTaxBalance im Client-/Server-Betrieb nutzen, beenden Sie die Server-Anwendung bzw. den Server-Dienst.
Migration der HB-Umgliederungen beim Update von Version 19.0.x auf 20.0.x
In der SmartTaxBalance Version 20.0 wurde die Funktion entfernt, HB-Umgliederungen über die Umgliederungsspalte im Steuerbilanzcockpit anzulegen. Die dazu notwendige Migration der Daten ist mittels Datenbankskript nicht möglich. Daher ist es zwingend erforderlich die Datenbank vor dem Update von Version 19.0.x auf Version 20.0.x über ein Programm zu migrieren. Das Programm wird bei der Auslieferung bereitgestellt und steht zusätzlich hier zum Download zur Verfügung.
Vorbereitung
- Es muss ein Benutzer in der Datenbank angelegt sein, der global die Berechtigung "Alles bearbeiten" zugewiesen hat. Sollte dies nicht der Fall sein, muss dieser angelegt werden (siehe Allgemeine Informationen zu Benutzern und Rollen). Sollten Sie in den globalen Einstellungen in der Modulverwaltung die Option "Meilensteine mit benutzerspezifischen Rechten" aktiviert haben, müssen Sie sicherstellen, das der Benutzer in allen Meilensteinzuständen die Berechtigung "Alles bearbeiten" hat oder Sie deaktivieren diese Option während der Migration vorübergehend.
- Die Konvertierungssoftware benötigt Zugriff auf die SmartTaxBalance Datenbank. Dazu muss die Datei
connections.config
im Unterordner/config
angepasst werden wie unter Konfiguration und Wartung beschrieben. - Es wird dringend empfohlen eine Sicherung der Datenbank durchzuführen, bevor mit der Migration begonnen wird.
Durchführung der Migration
- Starten Sie das Programm
SmartTaxBalanceReclassificationConverter.exe
- Geben Sie die Anmeldedaten eines geeigneten Benutzers ein (siehe Vorbereitung)
- Die Migration wird anschließend durchgeführt. Der Fortschritt sowie eventuelle Fehler werden auf der Konsole ausgegeben. Nach Beendigung der Migration wird ausgegeben, für welche Gesellschaften neue Datensätze angelegt wurden. Darüber hinaus werden alle Ausgaben, die nach der Anmeldung des Benutzers ausgegeben werden, in der Datei
Migration.log
im Ordner der Ausführung gespeichert. - Nach Abschluss der Migration können Sie mit der Aktualisierung der Datenbank fortfahren, wie unten beschrieben.
Es kann während der Konvertierung zu einer Meldung wie dieser kommen:
Die Gesellschaft mit der ID 'a0d6f0c2-e96f-4e73-824a-a8035811e0b8' konnte nicht gefunden werden (wahrscheinlich handelt es sich um eine gelöschte Gesellschaft). Die Migration der Steuerbilanz 'Steuerbilanz 2017 [31.12.2017]' wird daher abgebrochen.
Diese Meldung tritt auf, wenn die betreffende Gesellschaft gelöscht ist.
In der Datei Migration.log
ist am Ende aufgeführt, wie viele Gesellschaften nicht gefunden wurden. Außerdem ist eine SQL Abfrage enthalten, die den Namen und die Gelöscht-Eigenschaft aller nicht gefundenen Gesellschaften ausgibt.
Sollten alle gefundenen Gesellschaften gelöscht sein, können diese Meldungen ignoriert werden.
Sollte es nicht gelöschte Gesellschaften geben oder sollte die Abfrage weniger Gesellschaften liefern als die Anzahl der nicht gefundenen Gesellschaften, wenden Sie sich bitte an unseren Support.
Datenbank
Erstellen Sie eine Sicherung der Datenbank, um bei einem eventuell aufgetretenen Fehler einen Datenverlust zu vermeiden.
Führen Sie das Skript database-setup.sql
aus dem Auslieferungspaket aus.
Deinstallation Server-Anwendung
Dieser Schritt ist nur notwendig, wenn Sie SmartTaxBalance im Client-/Server-Betrieb nutzen.
Entfernen Sie die Server-Anwendung. Folgende Schritte sind dabei auszuführen:
- Notieren Sie sich die bisherige Konfiguration des Servers. Weitere Informationen zur Konfiguration erhalten Sie auf der Seite Konfiguration und Wartung. Folgende Daten werden bei der Neuinstallation mindestens benötigt:
- Namen des Datenbankservers, der Datenbank und die Zugangsdaten zum Datenbankserver
- Serveradresse (IP-Adresse oder Host-Name und Port) des SmartTaxBalance-Servers
- Verwendung Single-Sign-On und ggf. die SSO-Methode
- Entfernen Sie den SmartTaxBalance-Server über den Windows-Dialog „Programme und Features“.
Stellen Sie sicher, dass das Installationsverzeichnis nach der Deinstallation leer bzw. nicht mehr vorhanden ist.
Wurde eine zusätzliche Schnittstelle installiert, ist der Unterordner
Interfaces
weiterhin vorhanden. Dieser wird in einem späteren Schritt entfernt.
Installation der Server-Anwendung
Dieser Schritt ist nur notwendig, wenn Sie SmartTaxBalance im Client-/Server-Betrieb nutzen.
Folgen Sie der Anweisung auf der Seite Installation SmartTaxBalance Server.
Verwenden Sie die zuvor notierten Konfigurationsparameter.
Deinstallation Client-Anwendung
Entfernen Sie die Client-Anwendung auf den Rechnern der Anwender. Folgende Schritte sind dabei auszuführen:
- Notieren Sie sich die bisherige Konfiguration des Clients. Weitere Informationen zur Konfiguration erhalten Sie auf der Seite Konfiguration und Wartung. Folgende Daten werden bei der Neuinstallation mindestens benötigt:
- Namen des Datenbankservers, der Datenbank und die Zugangsdaten zum Datenbankserver (sofern SmartTaxBalance nur im Client-Betrieb verwendet wird)
- Serveradresse (IP-Adresse oder Host-Name und Port) des SmartTaxBalance-Servers (sofern SmartTaxBalance im Client-/Server-Betrieb verwendet wird)
- Verwendung Single-Sign-On und ggf. die SSO-Methode
- Entfernen Sie den SmartTaxBalance-Client über den Windows-Dialog „Programme und Features“.
Stellen Sie sicher, dass das Installationsverzeichnis nach der Deinstallation leer bzw. nicht mehr vorhanden ist.
Wurde eine zusätzliche Schnittstelle installiert, ist der Unterordner
Interfaces
weiterhin vorhanden. Dieser wird in einem späteren Schritt entfernt.
Installation der Client-Anwendung
Folgen Sie der Anweisung auf der Seite Installation Client.
Verwenden Sie die zuvor notierten Konfigurationsparameter.
Schnittstellen
Dem Auslieferungsspaket kann ein zusätzliches MSI-Paket mit einer Import-Schnittstelle beiliegen. In diesem Fall muss auf dem Client und - sofern vorhanden - auf dem Server diese Schnittstelle ebenfalls aktualisiert werden.
- Entfernen Sie die Schnittstelle über den Windows-Dialog „Programme und Features“
- Installieren Sie die neue Schnittstelle.