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