= Adempiere =

Adempiere ist ein freies [WarenWirtschaft]ssystem (ERP) unter Linux.



== Wo steht Adempire (auch im Vergleich zu anderen Lösungen) ==

Im allgemeinen wird Adempire (zusammen mit ~OpenERP) als das leistungsfähigste der "echten" Open Source ERP-Systeme genannt. (Ausgenommen hiervon sind Produkte, die zwar open source sind nur von einer einzigen Firma entwickelt werden.) Eine Übersicht über Möglichkeiten unter Linux gibt es auf der Seite WarenWirtschaft.

Es gibt einen [deutschen Verein|http://adempiere.de/], der sich um Adempire kümmert. Auf dessen Webseite gibt es im Prinzip aber auch nur Links zu den englischen Community-Sites. Andererseits vermittelt die Mitgliederliste des Vereins das Gefühl, das es deutsche Firmen gibt, die Adempiere ernsthaft einsetzen. Eine Referenzliste fehlt aber leider.



== technische Grundlagen ==

Es basiert auf einem JBoss Application Server (in Java) und bietet einen Java Client sowie alternativ einen Webclient mit gleicher Funktionalität. Darüberhinaus gibt es verschiedene Erweiterungen, z.B. für POS oder Produktionsplanung, die zumeist auch Java- oder Webclients bieten.



== Demo / deutsche Installation ==

Eine Live-Demo gibt es unter http://www.testadempiere.com/startdemo.html. Diese ist allerdings nur in Englisch und Spanisch.

Um ein Gefühl für das Programm zu bekommen, wollte ich mir eine Demo ansehen. Leider gibt es auf den Community-Seiten nirgendwo eine eingedeutschte Version. Also habe ich den harten Weg gewählt. Dazu bin ich in folgenden Schritten vorgegangen:



=== Überblick verschaffen ===

Zuerst habe ich mir auf http://www.adempiere.com einen Überblick verschafft. Um das Programm zu testen, sind dort drei Möglichkeiten genannt: Eine Online-Demo (siehe oben), ein fertiges Image und eine komplett manuelle Installation. Für den Anfang habe ich mich für den Zweiten Weg entschieden.



=== AVA-Installation ===

Das bedeutet, ich habe die [AVA-Installation|http://www.adempiere.com/ADempiere_Virtual_Appliance] (Adempiere Virtual Appliance) gewählt. Hier lädt man ein virtuelles System herunter, das man dann mit VirtualBox ausführen kann. Diese VM liegt im "OVF"-Format vor, so das man sie mit unterschiedlichen Virtualisierungs-Programmen ausführen kann. (sprich: man kann sich VMWare oder VirtualBox aussuchen). Leider benutzt der Erzeuger dieser Dateien wohl VMWare und testet den Start mit VirtualBox nicht. Deshalb gibt es auf o.g. Wikiseite einen Absatz "In case the ovf file does not work". Dank Wiki hat dort jemand reingeschrieben, wie man das Festplattenimage auch ohne die vorgefertigte OVF-Datei zum Laufen bekommt.

Hilfreich ist auch das Dokument "AVA.pdf", das man aus dem Wiki-Artikel heraus laden kann.

Ein weiteres Problem war, das das Festplatten-Image der AVA aus mehreren Dateien besteht und die Verknüpfungen zwischen diesen irgendwie so waren, das man keinen anderen Pfad verwenden darf. Ich weiss nicht, ob man das anpassen kann, habe das Problem aber anders gelöst: Ich habe einfach den Namen der virtuellen Maschine in VirtualBox gleich dem Original gewählt und dann das Festplatten-Image von Hand in das Verzeichnis der Virtualbox-Images kopiert. Dann hat er diese Festplatte schließlich auch akzeptiert.

Nachdem die AVA-Installation lief, habe ich wie im Wiki beschrieben die Netzwerk-Konfiguration des virtuellen Systems angepasst. Leider kam der Adempiere-Server allerdings nicht damit klar, das das Interface jetzt eine andere Adresse hatte. Runterfahren des Servers ging auch nicht, so das ich die ganze virtuelle Maschine nochmal rebootet habe. Danach konnte ich (nach Eintrag des DNS in meine "/etc/hosts", wie in der Anleitung beschrieben) direkt auf http://adempierehost.com:8080 zugreifen und alles war gut.

Die Version des AVA zur Zeit (13.11.2011) ist übrigens die 3.5.3a vom 21.12.2008. Ein Upgrade per ava_agent, wie in der Dokumentation angegeben, ging in Ermangelung ebendieses ava_agent-Binaries nicht.



=== deutsches Sprachpaket ===

Die AVA-Installation war zuerst mal nur englisch. Deshalb bin ich der Anleitung auf http://www.adempiere.com/Sprachpaket_Deutsch gefolgt und habe das deutsche Sprachpaket installiert. Die Datei, die ich dazu aus dem  heruntergeladen habe, habe ich über http://www.adempiere.com/German_Language_Pack gefunden. Das dürfte (soweit ich das verstanden habe) die Übersetzungen der aktuellen Version (z.Zt. 3.7.0) beinhalten. Ich habe sie dennoch installiert und das Ergebnis sah weitgehend gut aus.


=== aktuelle Installation ===>>
<<
Um ehrlich zu sein, hat die Installation einer aktuellen Version aus dem Sourcecode in Eclipse auch nicht viel länger gedauert. Dafür habe ich jetzt eine Version 3.7.0, die sich wirklich an einigen Punkten geändert hat. Im Grunde bin ich dazu den Anweisungen auf http://www.adempiere.com/Create_your_ADempiere_development_environment mit dem Unterschied, das das Projekt inzwischen von Subversion auf Mercurial umgestiegen ist und man den Sourcecode also so erhält, wie auf http://www.adempiere.com/Mercurial_Test_Environment beschrieben.

Leider muss man immer noch von Hand die deutschen Sprachdateien installieren. Allerdings sind sie im Eclipse-Projekt im Verzeichnis "data" direkt enthalten, so das man wenigsten keine Angst hat ,das die Versionen nicht zusammenpassen...



== <<Baukasten-Prinzip ==

Man kann ADempiere auf zwei Weisen betrachten: Zum einen ist es ein fertiges ERP-System, zum anderen ist es ein ERP-Baukasten. Es erlaubt, recht einfach neue Tabellen in der Datenbank anzulegen, dafür dann automatisiert eine GUI zu erzeugen und so ganz schnell verknüpfte Daten zu verwalten. Wer dann hierzu über die reinen Daten noch "Business Logic" einfügen will, kann das dann in Java machen. Natürlich kann man seine eigenen Klassen dann mit dem vorhandenen verknüpfen, indem man die bestehenden Tabellen z.B. um Referenzen auf neue, eigene Objekttypen erweitert.



== Skript-Programmierung ==

Die Unterstützung von Skripten scheint relativ neu implementiert zu sein und daher nicht so recht dokumentiert. Im Grunde geht es darum, das man sogenannte "Callouts", das sind externe Funktionen in einer Skriptsprache direkt in der GUI schreiben kann. Ein Einstieg ist z.B. hier http://www.adempiere.com/Script_Process Ich habe auch ein wenig damit herumgespielt. Dabei hat es an einigen Stellen gehakt, die ich hier erklären möchte: Zuerst erstellt man eine "Rule" (Regel). Da steht das Skript drin. Diese Regel kann man jetzt einer Datenbank-Spalte zuordnen. Dort muss man "@script:" gefolgt von dem Namen der Regel eintragen. Dieser beginnt z.B. mit "groovy:". Nun kann man das Groovy-Skript ausführen. Es sollte am Ende die Variable "result" auf einen leeren String setzen. (NULL ergibt auf jeden Fall einen Fehler, was mit einem anderen Rückgabewert geschieht, habe ich noch nicht ausprobiert). Also könnte ein erstes Skript z.B. so aussehen:

{{{
 A_Tab.setValue('description', 'Hello, World!');
 result=""
}}}

Leider gibt es diese Callout-Schnittstelle nur bei der Änderung von Feldern. Außerdem kann man Regeln als Befehle über das Menü aufrufen (probiere ich später aus). Man kann allerdings kein Skript ausführen, das beim Speichern eines Datensatzes läuft. (das kommt aber bestimmt noch.)



== lose Enden ==

Folgende Dinge sollten noch weitergehend untersucht werden:

* Auf http://www.adempiere.com/ADempiere_Deutsch_Integration gibt es Doku zu einigen deutschen Integrationen, die über die reine Übersetzung der GUI hinausgehen. Ich weiss nun nicht, ob die in der aktuellen Version schon enthalten sind oder ob man das mit einpflegen muss oder was das genau ist.
* Die Firma Metas scheint in der deutschen Umsetzung recht aktiv zu sein. Es gibt dort ein Wiki mit einem rudimentären Handbuch in deutsch: http://adempiere.metas.de/mediawiki/index.php/ADempiere_Handbuch
* Eine Sammlung von deutschsprachigen Artikeln gibt es unter http://www.adempiere.com/De_DE/start
* http://www.adempiere.com/ManPageX_InitialClientSetup - Erster Schritt, um einen eigenen Mandanten einzurichten
* http://en.wikiversity.org/w/index.php?title=Special%3ASearch&search=adempiere - Es gibt viele technische Artikel auf http://wikiversity.org


-- ThomasBayen