doc/UPGRADE

   1 Wichtige Hinweise zum Upgrade von älteren Versionen
   2 ===================================================
   3
   4
   5 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
   6
   7 Upgrade auf v2.4.4
   8 ==================
   9
  10 Mit Version 2.4.4 wurde der Code zur Benutzerauthentifizierung neu
  11 geschrieben. Die Umstellung erfordert eine manuelle
  12 Konfiguration. Bestehende Benutzeraccounts können aber von Lx-Office
  13 automatisch übernommen werden.
  14
  15  Bevor Sie sich das erste mal einloggen
  16  --------------------------------------
  17
  18 Kopieren Sie bitte die Datei lx-erp.conf und ggfs. lx-erp-local.conf
  19 in das neue Unterverzeichnis config/. Die alte Datei im Lx-Office-
  20 Stammverzeichnis kann daraufhin gelöscht werdern.
  21
  22 Als nächstes muss die neue Datenbankauthetifikation konfiguriert werden.
  23 Diese Einstellungen werden in der Datei "config/authentification.pl"
  24 gemacht, für die ein kommentiertes Template bereitliegt.
  25
  26 Weitere Informationen zu dieser Datei finden Sie in der Dokumentation
  27 "doc/INSTALL/index.html" und dort in den Kapiteleln
  28 "Benutzerauthentifizierung und Administratorpasswort" sowie "Benutzer-
  29 und Gruppenverwaltung".
  30
  31 Nach der Einrichtung der Datei "config/authentication.pl" muss im
  32 Webbrowser das Administrationsinterface aufgerufen werden. Nach
  33 erfolgter Anmeldung werden Sie durch den Upgradeprozess geleitet.
  34
  35 Die weiteren erforderlichen Datenbankupgrades werden erst vorgenommen,
  36 wenn sich ein Benutzer erfolgreich anmeldet.
  37
  38
  39 Upgrade von v2.4.0 und neuer auf v2.4.3
  40 =======================================
  41
  42 Ein Upgrade von v2.4.0 oder neuer auf v2.4.3 aus zwei Teilen: den
  43 Dateien (einfaches Entpacken und Kopieren in das
  44 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
  45
  46  Neue Variablen in der Datei lx-erp.conf
  47  ---------------------------------------
  48
  49 Wenn Sie eine eigene Version der Konfigurationsdatei "lx-erp.conf"
  50 einsetzen und diese nicht mit der Standardkonfigurationsdatei
  51 überschreiben, so beachten Sie bitte, dass die folgenden neuen
  52 Variablen hinzugekommen sind und von Ihnen manuell ergänzt werden
  53 sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und
  54 $pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt
  55 werden, da sie nicht mehr benötigt wird.
  56
  57 Die Standardwerte für diese Variablen finden Sie in der Datei
  58 "lx-erp.conf.default".
  59
  60  Neue Abhängigkeiten von Perl-Modulen
  61  ------------------------------------
  62
  63 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
  64 der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module
  65 neu hinzugekommen:
  66
  67 - Achive::Zip
  68 - IO::Wrap (aus dem Paket "IO::Stringy")
  69 - Template
  70 - Text::CSV_XS
  71 - Text::Iconv
  72 - Time::HiRes
  73 - YAML
  74
  75 Nach Möglichkeit sollten auch die aktuellen Versionen der
  76 Datenbankpakete "DBI" und "DBD::Pg" installiert werden.
  77
  78  Datenbankupgrade
  79  ----------------
  80
  81 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
  82 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
  83
  84 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
  85
  86
  87 Upgrade von v2.4.0 auf 2.4.1 sowie von 2.4.1 auf 2.4.2
  88 ======================================================
  89
  90 Ein Upgrade von v2.4.0 auf v2.4.1 oder von v2.4.1 auf v2.4.2 besteht
  91 aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das
  92 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
  93
  94 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
  95 der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss
  96 sichergestellt werden, dass das Modul "YAML" installiert ist.
  97
  98 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
  99 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
 100
 101 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 102
 103 Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades
 104 auf 2.4.1 und 2.4.2 nur um automatisch ablaufende Scripte, die keine
 105 Benutzereingaben erfordern.
 106
 107
 108 Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0
 109 ======================================
 110
 111 Ein direktes Upgrade von den unmodifizierten Versionen 2.2.0, 2.2.1
 112 und 2.2.2 auf 2.4.0 ist möglich. Ein solches Upgrade besteht aus zwei
 113 Teilen: den Dateien (einfaches Entpacken und Kopieren in das
 114 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
 115
 116 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
 117 der Datei "doc/INSTALL".
 118
 119 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
 120 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
 121
 122 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
 123
 124 Das Datenbankupgrade enthält zwei interaktive Upgradepfade für neue
 125 Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.
 126
 127
 128
 129 Einführung von Einheiten
 130 ------------------------
 131
 132 In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
 133 Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
 134 Texte als "Einheit" angeben. Lx-Office 2.4.0 ändert dies nun. Der
 135 Administrator kann unter "System -> Einheiten -> Maßeinheiten" die bei
 136 Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
 137 Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
 138 Einheiten festlegen. Lx-Office 2.4.0 bringt bereits für beide Typen
 139 einige Standardeinheiten mit.
 140
 141 Einheiten können wiederum auf anderen Einheiten basieren. So ist
 142 z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
 143 muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
 144 einer Drop-Down-Liste auswählen. In den Einkaufs- und Verkaufsmasken
 145 werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
 146 angeboten, die sich in die in den Stammdaten hinterlegte Einheit
 147 umrechnen lassen. So würden z.B. für eine Ware, deren
 148 Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
 149 Auswahl aufgelistet, nicht aber "Stück" oder "Tag", "Stunde".
 150
 151 Das Datenbankupgrade muss nun alle im System verwendeten Einheiten in
 152 den Stammdaten sowie in den Einkaufs- und Verkaufsdaten so anpassen,
 153 dass dort nur noch Einheiten auftreten, die im System verwendet werden
 154 können. Da dies nur eingeschränkt automatisch möglich ist, werden dem
 155 Benutzer, der das Datenbankupgrade nach dem Login durchführt, einige
 156 Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
 157 kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
 158 lassen kann.
 159
 160 Zuletzt muss er noch für all die Waren, für die früher gar keine
 161 Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
 162 Erzeugnissen und Dienstleistungen festlegen, die statt dessen
 163 eingesetzt wird.
 164
 165
 166 Einführung von Steuerzonen und Buchungsgruppen
 167 ----------------------------------------------
 168
 169 In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
 170 Dienstleistungen jeweils ein Konto für Erlöse und ein Konto für den
 171 Aufwand hinterlegt. Über diese Konten wurde dann auch definiert
 172 welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
 173 und mal ohne Steuer verkaufen (Inland, Ausland), waren hierfür zwei
 174 Artikel notwendig.
 175
 176 In der Version 2.4.0 können nun bei jedem Artikel für die
 177 verschiedenen Fälle
 178 - Inland
 179 - EU mit UStId
 180 - EU ohne UStId
 181 - Außerhalb EU
 182 verschiedene Erlös- und Aufwandskonten definiert werden. Dadurch
 183 werden dann auch jeweils die richtigen Steuersätze berechnet.
 184
 185 Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
 186 müssen, werden alle Konten, die zu einer bestimmten Warengruppe
 187 gehören, in einer Buchungsgruppe zusammengefasst. Diese
 188 Buchungsgruppen werden zunächst unter "System" definiert und können
 189 dann den Artikeln und Dienstleistungen zugewiesen werden.
 190
 191 Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
 192 Erlös- und Aufwandskonten geholt, die bereits verwendet wurden. Für
 193 diese Kombinationen müssen im Upgradeprozess Buchungsgruppen angelegt
 194 werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
 195 Konten für nicht Inland sind mit den Standardkonten vorbelegt, können
 196 aber vor dem Speichern geändert werden.
 197
 198 Diese neu angelegten Buchungsgruppen werden automatisch den
 199 vorhandenen Artikeln und Dienstleistungen zugewiesen.  Buchungsgruppen
 200 können genau wie vorher die Kontenzuordnung nachträglich nicht mehr
 201 geändert werden.
 202
 203 Möchte man in der Buchhaltung eine neue Kombination von Erlös- und
 204 Aufwandskonten für bestimmte Artikel und Waren verwenden, legt man
 205 zunächst die entsprechenden konnten (z.B. 8401 und 3401) an und
 206 erstellt dann eine neue Buchungsgruppe mit diesen Konten.  Die
 207 Benennung der Buchungsgruppe kann frei erfolgen.
 208
 209 Beim Anlegen einer neuen Waren oder Dienstleistung werden dann durch
 210 Auswahl dieser Buchungsgruppe automatisch alle Konten auf einen Schlag
 211 korrekt zugeordnet.
 212
 213 Wird in einer Verkaufs- oder Einkaufsmaske eine andere Steuerzone als
 214 Inland ausgewählt, werden bei den Artikeln auch automatisch die
 215 anderen Erlös- und Aufwandskonten der Buchungsgruppe verwendet.
 216
 217 Dokumentenvorlagen, Umbennante Vorlagenvariablen
 218 ------------------------------------------------
 219
 220 Einige Variablen, die in Dokumentenvorlagen verwendet werden, mussten
 221 aufgrund von Namenskonflikten umbenannt werden. Dazu gehören:
 222
 223 * Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
 224   Variablen "company", "address" und "businessnumber" haben alle einen
 225   Präfix "employee_" bekommen und heißen nun "employee_company",
 226   "employee_address" und "employee_businessnumber".
 227
 228 Zu beachten ist außerdem, dass der Befehl <%include ...%> in
 229 Dokumentenvorlagen nicht mehr zur Verfügung steht.