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