ADempiere Deutsch Integration
Dieser Artikel ist ein erster Entwurf für eine Dokumentation, wie man aus einer Standard-ADempiere-Installation eine Version mit den hier beschriebenen Contributions erzeugen kann. Entstanden ist er, als wir von der ObjectCode GmbH den Versuch unternommen haben, die vorhandenen Bausteine zu einem geschlossenen Gesamtsystem zu integrieren. Sicher fehlt hier noch das eine oder andere, manches kann man noch besser dokumentieren, aber es soll ein Anfang sein. Ergänzungen, Korrekturen und Anmerkungen sind natürlich gerne und jederzeit willkommen, dies ist schließlich ein Wiki, das genau davon lebt.
Grundsätzliches
ADempiere ist so ausgelegt, dass gepatchte und angepasste Komponenten technisch mit Hilfe der Jar-Dateien customization.jar und patches.jar in das System integriert werden können, ohne das eigentliche System verändern zu müssen. Dies funktioniert, weil beide Jar-Dateien im Java-Classpath von ADempiere vor den Jar-Dateien aufgeführt sind, aus denen das eigentliche ADempiere-System besteht. Diese beiden Dateien sind dafür bestimmt, dass patches.jar für ADempiere-Patches d.h. Fehlerkorrekturen im jeweiligen Release verwendet werden soll, während individuelle, installationsspezifische Anpassungen und Erweiterungen in customization.jar zusammengefasst werden sollen. Diese Vorgehensweise erfordert eine gewisse Sorgfalt, wenn Komponenten erweitert werden, für die es auch Patches gibt, denn dann muss im Regelfall die Erweiterung auf Grundlage des gepatchen Quelltextes erfolgen und nicht auf Grundlage des Originalquellcodes aus dem Release.
Dieses Lokalisierungsprojekt ist derzeit so ausgelegt, dass am Ende eine patches.jar generiert wird, die dann im Application Server installiert wird.
Voraussetzungen
Was man benötigt:
- Die Quelltexte für ADempiere 342
- Die Contributions, die im Subversion-Repository unter contributions/Localizations/Germany abgelegt sind
- Eclipse; wir verwenden das Ganymede-Release 3.4.1
Für eine bessere Übersicht sinnvoll aber nicht unbedingt notwendig ist es, einen eigenen Workspace in Eclipse für diese Integrationsaufgabe einzurichten. Wenn man die Quelltexte in diesem Workspace mit TortoiseSVN auscheckt und die vorgeschlagenen Ordnernamen übernimmt, enthält dieser Workspace dann 2 Unterordner, nämlich
- adempiere342
- Germany
In beiden sind fertige Projektbeschreibungen für Eclipse, d.h. in beiden Ordnern liegen .project-Dateien, so dass sie via File -> Import -> General -> Existing Projects into Workspace nach Eclipse importiert werden können.
Vorarbeiten
Als erstes wird unter Eclipse das eigentliche ADempiere-Projekt mit Hilfe der build.xml unter utils_dev kompiliert; nähere Informationen finden sich hier. Wir hatten beim Kompilieren hin und wieder den unschönen Effekt, dass Sonderzeichen wie etwa in AmtInWords_FA dazu geführt haben, dass in Eclipse die Konsolenausgabe eingefroren und der Build-Vorgang ohne Fehlermeldung abgebrochen ist, lediglich eine Warnmeldung wies dann auf "unmappable characters" hin. Ein erneuter Build-Versuch gelang danach dann aber immer ohne weitere Probleme.
