Einführung des Modules "Template" als schnellere Alternative (Faktor 9) zu "HTML...
[kivitendo-erp.git] / 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
8 Upgrade von v2.4.0 und neuer auf v2.6.0
9 =======================================
10
11 Ein Upgrade von v2.4.0 oder neuer auf v2.6.0 aus zwei Teilen: den
12 Dateien (einfaches Entpacken und Kopieren in das
13 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
14
15 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
16 der Datei "doc/INSTALL". Besonders nach einem Upgrade auf 2.4.2 muss
17 sichergestellt werden, dass das Modul "YAML" installiert ist. v2.6.0
18 benötigt zusätzlich die Module "Text::CSV_XS", "IO::Wrap" (aus dem
19 Paket "IO::Stringy") sowie "Template" (Paket "Template-Toolkit").
20
21 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
22 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
23
24 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
25
26 Anders als beim Upgrade auf 2.4.0 handelt es bei den Datenbankupgrades
27 auf Versionen nach 2.4.0 nur um automatisch ablaufende Scripte, die
28 keine Benutzereingaben erfordern.
29
30
31 Upgrade von v2.2.0 bis 2.2.2 auf 2.4.0
32 ======================================
33
34 Ein direktes Upgrade von den unmodifizierten Versionen 2.2.0, 2.2.1
35 und 2.2.2 auf 2.4.0 ist möglich. Ein solches Upgrade besteht aus zwei
36 Teilen: den Dateien (einfaches Entpacken und Kopieren in das
37 Installationsverzeichnis genügen) sowie dem Datenbankupgrade.
38
39 Bitte beachten Sie auch die Liste der benötigten Perl-Module am Anfang
40 der Datei "doc/INSTALL".
41
42 Das Datenbankupgrade wird automatisch gestartet, wenn sich der erste
43 Benutzer nach dem Upgrade der Dateien an Lx-Office anmeldet.
44
45 ** BITTE FERTIGEN SIE VOR DEM UPGRADE EIN BACKUP IHRER DATENBANK(EN) AN! **
46
47 Das Datenbankupgrade enthält zwei interaktive Upgradepfade für neue
48 Features in Lx-Office 2.4.0: Einheiten sowie Buchungsgruppen.
49
50
51
52 Einführung von Einheiten
53 ------------------------
54
55 In Versionen von Lx-Office vor 2.4.0 konnte der Benutzer bei den
56 Stammdaten aber auch in den Einkaufs- und Verkaufsdialogen beliebige
57 Texte als "Einheit" angeben. Lx-Office 2.4.0 ändert dies nun. Der
58 Administrator kann unter "System -> Einheiten -> Maßeinheiten" die bei
59 Waren und Erzeugnissen verwendbaren und bei "System -> Einheiten ->
60 Dienstleistungseinheiten" die bei Dienstleistungen verwendbaren
61 Einheiten festlegen. Lx-Office 2.4.0 bringt bereits für beide Typen
62 einige Standardeinheiten mit.
63
64 Einheiten können wiederum auf anderen Einheiten basieren. So ist
65 z.B. "kg" als das 1000fache der Einheit "g" definiert. Der Benutzer
66 muss beim Anlegen von Artikeln in den Stammdaten eine Einheit aus
67 einer Drop-Down-Liste auswählen. In den Einkaufs- und Verkaufsmasken
68 werden dann dem Benutzer nur noch diejenigen Einheiten zur Auswahl
69 angeboten, die sich in die in den Stammdaten hinterlegte Einheit
70 umrechnen lassen. So würden z.B. für eine Ware, deren
71 Stammdateneinheit "kg" ist, nur die Einheiten "g", "kg", "t" zur
72 Auswahl aufgelistet, nicht aber "Stück" oder "Tag", "Stunde".
73
74 Das Datenbankupgrade muss nun alle im System verwendeten Einheiten in
75 den Stammdaten sowie in den Einkaufs- und Verkaufsdaten so anpassen,
76 dass dort nur noch Einheiten auftreten, die im System verwendet werden
77 können. Da dies nur eingeschränkt automatisch möglich ist, werden dem
78 Benutzer, der das Datenbankupgrade nach dem Login durchführt, einige
79 Masken angezeigt, in denen er neue Einheiten in der Datenbank anlegen
80 kann, und in denen er "alte" Einheiten durch "neue" Einheiten ersetzen
81 lassen kann.
82
83 Zuletzt muss er noch für all die Waren, für die früher gar keine
84 Einheit eingetragen wurde, eine Standardeinheit getrennt nach Waren /
85 Erzeugnissen und Dienstleistungen festlegen, die statt dessen
86 eingesetzt wird.
87
88
89 Einführung von Steuerzonen und Buchungsgruppen
90 ----------------------------------------------
91
92 In den Versionen von Lx-Office vor 2.4.0 wurden bei Artikeln und
93 Dienstleistungen jeweils ein Konto für Erlöse und ein Konto für den
94 Aufwand hinterlegt. Über diese Konten wurde dann auch definiert
95 welcher Steuersatz zu berechnen ist. Wollte man einen Artikel mal mit
96 und mal ohne Steuer verkaufen (Inland, Ausland), waren hierfür zwei
97 Artikel notwendig.
98
99 In der Version 2.4.0 können nun bei jedem Artikel für die
100 verschiedenen Fälle
101 - Inland
102 - EU mit UStId
103 - EU ohne UStId
104 - Außerhalb EU
105 verschiedene Erlös- und Aufwandskonten definiert werden. Dadurch
106 werden dann auch jeweils die richtigen Steuersätze berechnet.
107
108 Damit jetzt nicht bei jedem Artikel mehrere Konten definiert werden
109 müssen, werden alle Konten, die zu einer bestimmten Warengruppe
110 gehören, in einer Buchungsgruppe zusammengefasst. Diese
111 Buchungsgruppen werden zunächst unter "System" definiert und können
112 dann den Artikeln und Dienstleistungen zugewiesen werden.
113
114 Beim Datenbankupdate werden aus der Datenbank alle Kombinationen von
115 Erlös- und Aufwandskonten geholt, die bereits verwendet wurden. Für
116 diese Kombinationen müssen im Upgradeprozess Buchungsgruppen angelegt
117 werden, indem man den einzelnen Kombinationen einen Namen zuweist. Die
118 Konten für nicht Inland sind mit den Standardkonten vorbelegt, können
119 aber vor dem Speichern geändert werden.
120
121 Diese neu angelegten Buchungsgruppen werden automatisch den
122 vorhandenen Artikeln und Dienstleistungen zugewiesen.  Buchungsgruppen
123 können genau wie vorher die Kontenzuordnung nachträglich nicht mehr
124 geändert werden.
125
126 Möchte man in der Buchhaltung eine neue Kombination von Erlös- und
127 Aufwandskonten für bestimmte Artikel und Waren verwenden, legt man
128 zunächst die entsprechenden konnten (z.B. 8401 und 3401) an und
129 erstellt dann eine neue Buchungsgruppe mit diesen Konten.  Die
130 Benennung der Buchungsgruppe kann frei erfolgen.
131
132 Beim Anlegen einer neuen Waren oder Dienstleistung werden dann durch
133 Auswahl dieser Buchungsgruppe automatisch alle Konten auf einen Schlag
134 korrekt zugeordnet.
135
136 Wird in einer Verkaufs- oder Einkaufsmaske eine andere Steuerzone als
137 Inland ausgewählt, werden bei den Artikeln auch automatisch die
138 anderen Erlös- und Aufwandskonten der Buchungsgruppe verwendet.
139
140 Dokumentenvorlagen, Umbennante Vorlagenvariablen
141 ------------------------------------------------
142
143 Einige Variablen, die in Dokumentenvorlagen verwendet werden, mussten
144 aufgrund von Namenskonflikten umbenannt werden. Dazu gehören:
145
146 * Adress- und Kontaktinformationen des angemeldeten Mitarbeiters. Die
147   Variablen "company", "address" und "businessnumber" haben alle einen
148   Präfix "employee_" bekommen und heißen nun "employee_company",
149   "employee_address" und "employee_businessnumber".
150
151 Zu beachten ist außerdem, dass der Befehl <%include ...%> in
152 Dokumentenvorlagen nicht mehr zur Verfügung steht.