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