Projekt

Allgemein

Profil

Herunterladen (9,49 KB) Statistiken
| Zweig: | Markierung: | Revision:
590d623e Moritz Bunkus
Wichtige Hinweise zum Upgrade von ?lteren Versionen
===================================================


** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **

3001e127 Moritz Bunkus
Upgrade auf v2.6.0
8c7e4493 Moritz Bunkus
==================

3001e127 Moritz Bunkus
Mit Version 2.6.0 wurde der Code zur Benutzerauthentifizierung neu
8c7e4493 Moritz Bunkus
geschrieben. Die Umstellung erfordert eine manuelle
Konfiguration. Bestehende Benutzeraccounts k?nnen aber von Lx-Office
automatisch ?bernommen werden.

0e6ac5bb Sven Schöling
Bevor Sie sich das erste mal einloggen
--------------------------------------

a13d2254 Moritz Bunkus
Kopieren Sie bitte die Datei "lx-erp.conf" und
ggfs. "lx-erp-local.conf" in das neue Unterverzeichnis "config/". Die
alte Datei im Lx-Office-Stammverzeichnis kann daraufhin gel?scht
werdern.
0e6ac5bb Sven Schöling
8d3529cd Moritz Bunkus
Als n?chstes muss die neue datenbankgest?tzte Benutzerverwaltung
konfiguriert werden. Die daf?r notwendigen Einstellungen werden in der
Datei "config/authentification.pl" vorgenommen, f?r die eine
kommentierte Vorlage in "config/authentication.pl.default"
bereitliegt.
0e6ac5bb Sven Schöling
Weitere Informationen zu dieser Datei finden Sie in der Dokumentation
8d3529cd Moritz Bunkus
"doc/INSTALL/index.html" und dort in den Kapiteln
8c7e4493 Moritz Bunkus
"Benutzerauthentifizierung und Administratorpasswort" sowie "Benutzer-
und Gruppenverwaltung".

Nach der Einrichtung der Datei "config/authentication.pl" muss im
Webbrowser das Administrationsinterface aufgerufen werden. Nach
erfolgter Anmeldung werden Sie durch den Upgradeprozess geleitet.

Die weiteren erforderlichen Datenbankupgrades werden erst vorgenommen,
wenn sich ein Benutzer erfolgreich anmeldet.

65a609b5 Moritz Bunkus
Neue Perl-Module
----------------

Mit Version 2.6.0 werden zus?tzlich die folgenden Perl-Module ben?tigt,
die bis Version 2.4.3 inklusive noch keine Voraussetzung waren:

* Digest::MD5
* PDF::API2

8c7e4493 Moritz Bunkus
44472690 Moritz Bunkus
Upgrade von v2.4.0 und neuer auf v2.4.3
a939b727 Moritz Bunkus
=======================================
f4ee2556 Moritz Bunkus
44472690 Moritz Bunkus
Ein Upgrade von v2.4.0 oder neuer auf v2.4.3 aus zwei Teilen: den
a939b727 Moritz Bunkus
Dateien (einfaches Entpacken und Kopieren in das
31119ad2 Moritz Bunkus
Installationsverzeichnis gen?gen) sowie dem Datenbankupgrade.

Neue Variablen in der Datei lx-erp.conf
---------------------------------------

Wenn Sie eine eigene Version der Konfigurationsdatei "lx-erp.conf"
einsetzen und diese nicht mit der Standardkonfigurationsdatei
?berschreiben, so beachten Sie bitte, dass die folgenden neuen
Variablen hinzugekommen sind und von Ihnen manuell erg?nzt werden
sollten: $html2ps_bin, $ghostscript_bin, $pg_dump_exe und
$pg_restore_exe. Die Variable '$jscalendar' kann hingegen entfernt
werden, da sie nicht mehr ben?tigt wird.

Die Standardwerte f?r diese Variablen finden Sie in der Datei
"lx-erp.conf.default".

Neue Abh?ngigkeiten von Perl-Modulen
------------------------------------

Bitte beachten Sie auch die Liste der ben?tigten Perl-Module am Anfang
der Datei "doc/INSTALL". Seit Version 2.4.0 sind die folgenden Module
neu hinzugekommen:

- Achive::Zip
- IO::Wrap (aus dem Paket "IO::Stringy")
- Template
- Text::CSV_XS
- Text::Iconv
- Time::HiRes
- YAML

Nach M?glichkeit sollten auch die aktuellen Versionen der
Datenbankpakete "DBI" und "DBD::Pg" installiert werden.

Datenbankupgrade
----------------

Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.

** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **


Upgrade von v2.4.0 auf 2.4.1 sowie von 2.4.1 auf 2.4.2
======================================================

Ein Upgrade von v2.4.0 auf v2.4.1 oder von v2.4.1 auf v2.4.2 besteht
aus zwei Teilen: den Dateien (einfaches Entpacken und Kopieren in das
a1880fd9 Moritz Bunkus
Installationsverzeichnis gen?gen) sowie dem Datenbankupgrade.
f4ee2556 Moritz Bunkus
3a280667 Moritz Bunkus
Bitte beachten Sie auch die Liste der ben?tigten Perl-Module am Anfang
f6e5b55a Moritz Bunkus
der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss
31119ad2 Moritz Bunkus
sichergestellt werden, dass das Modul "YAML" installiert ist.
3a280667 Moritz Bunkus
f4ee2556 Moritz Bunkus
Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.

** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **

Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades
31119ad2 Moritz Bunkus
auf 2.4.1 und 2.4.2 nur um automatisch ablaufende Scripte, die keine
Benutzereingaben erfordern.
f4ee2556 Moritz Bunkus

590d623e Moritz Bunkus
Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0
ccf2eedc Moritz Bunkus
======================================
590d623e Moritz Bunkus
Ein direktes Upgrade von den unmodifizierten Versionen 2.2.0, 2.2.1
f4ee2556 Moritz Bunkus
und 2.2.2 auf 2.4.0 ist m?glich. Ein solches Upgrade besteht aus zwei
590d623e Moritz Bunkus
Teilen: den Dateien (einfaches Entpacken und Kopieren in das
Installationsverzeichnis gen?gen) sowie dem Datenbankupgrade.

3a280667 Moritz Bunkus
Bitte beachten Sie auch die Liste der ben?tigten Perl-Module am Anfang
der Datei "doc/INSTALL".

590d623e Moritz Bunkus
Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.

** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **

Das Datenbankupgrade enth?lt zwei interaktive Upgradepfade f?r neue
Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.



Einf?hrung von Einheiten
------------------------

In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
Texte als "Einheit" angeben. Lx-Office 2.4.0 ?ndert dies nun. Der
Administrator kann unter "System -> Einheiten -> Ma?einheiten" die bei
Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
Einheiten festlegen. Lx-Office 2.4.0 bringt bereits f?r beide Typen
einige Standardeinheiten mit.

Einheiten k?nnen wiederum auf anderen Einheiten basieren. So ist
z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
einer Drop-Down-Liste ausw?hlen. In den Einkaufs- und Verkaufsmasken
werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
angeboten, die sich in die in den Stammdaten hinterlegte Einheit
umrechnen lassen. So w?rden z.B. f?r eine Ware, deren
Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
Auswahl aufgelistet, nicht aber "St?ck" oder "Tag", "Stunde".

Das Datenbankupgrade muss nun alle im System verwendeten Einheiten in
den Stammdaten sowie in den Einkaufs- und Verkaufsdaten so anpassen,
dass dort nur noch Einheiten auftreten, die im System verwendet werden
k?nnen. Da dies nur eingeschr?nkt automatisch m?glich ist, werden dem
Benutzer, der das Datenbankupgrade nach dem Login durchf?hrt, einige
Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
lassen kann.

Zuletzt muss er noch f?r all die Waren, f?r die fr?her gar keine
Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
Erzeugnissen und Dienstleistungen festlegen, die statt dessen
eingesetzt wird.


Einf?hrung von Steuerzonen und Buchungsgruppen
----------------------------------------------

fe7d7b5e Moritz Bunkus
In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
Dienstleistungen jeweils ein Konto f?r Erl?se und ein Konto f?r den
Aufwand hinterlegt. ?ber diese Konten wurde dann auch definiert
welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
und mal ohne Steuer verkaufen (Inland, Ausland), waren hierf?r zwei
Artikel notwendig.

In der Version 2.4.0 k?nnen nun bei jedem Artikel f?r die
verschiedenen F?lle
7e7b0f89 Philip Reetz
- Inland
- EU mit UStId
- EU ohne UStId
- Au?erhalb EU
fe7d7b5e Moritz Bunkus
verschiedene Erl?s- und Aufwandskonten definiert werden. Dadurch
werden dann auch jeweils die richtigen Steuers?tze berechnet.

Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
m?ssen, werden alle Konten, die zu einer bestimmten Warengruppe
geh?ren, in einer Buchungsgruppe zusammengefasst. Diese
Buchungsgruppen werden zun?chst unter "System" definiert und k?nnen
dann den Artikeln und Dienstleistungen zugewiesen werden.

Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
Erl?s- und Aufwandskonten geholt, die bereits verwendet wurden. F?r
diese Kombinationen m?ssen im Upgradeprozess Buchungsgruppen angelegt
werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
Konten f?r nicht Inland sind mit den Standardkonten vorbelegt, k?nnen
aber vor dem Speichern ge?ndert werden.

Diese neu angelegten Buchungsgruppen werden automatisch den
vorhandenen Artikeln und Dienstleistungen zugewiesen. Buchungsgruppen
k?nnen genau wie vorher die Kontenzuordnung nachtr?glich nicht mehr
7e7b0f89 Philip Reetz
ge?ndert werden.
fe7d7b5e Moritz Bunkus
M?chte man in der Buchhaltung eine neue Kombination von Erl?s- und
Aufwandskonten f?r bestimmte Artikel und Waren verwenden, legt man
zun?chst die entsprechenden konnten (z.B. 8401 und 3401) an und
erstellt dann eine neue Buchungsgruppe mit diesen Konten. Die
Benennung der Buchungsgruppe kann frei erfolgen.

Beim Anlegen einer neuen Waren oder Dienstleistung werden dann durch
Auswahl dieser Buchungsgruppe automatisch alle Konten auf einen Schlag
korrekt zugeordnet.

Wird in einer Verkaufs- oder Einkaufsmaske eine andere Steuerzone als
Inland ausgew?hlt, werden bei den Artikeln auch automatisch die
anderen Erl?s- und Aufwandskonten der Buchungsgruppe verwendet.
ccf2eedc Moritz Bunkus
73fb84d7 Moritz Bunkus
Dokumentenvorlagen, Umbennante Vorlagenvariablen
------------------------------------------------
ccf2eedc Moritz Bunkus
Einige Variablen, die in Dokumentenvorlagen verwendet werden, mussten
aufgrund von Namenskonflikten umbenannt werden. Dazu geh?ren:

* Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
b2d25cea Moritz Bunkus
Variablen "company", "address" und "businessnumber" haben alle einen
Pr?fix "employee_" bekommen und hei?en nun "employee_company",
"employee_address" und "employee_businessnumber".
73fb84d7 Moritz Bunkus
Zu beachten ist au?erdem, dass der Befehl <%include ...%> in
Dokumentenvorlagen nicht mehr zur Verf?gung steht.