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