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