action42 blog

Einen iDempiere-Swing-Client für eine andere Plattform erstellen

Dirk Niemeyer — Tue, 24 Jan 2012 13:00:00 +0100

Zur Zeit nur in Englisch verfügbar:

Following the tutorial on http://www.globalqss.com/wiki/index.php/IDempiere/Creating_Installers_from_Eclipse I was able to create the installers for my development platform which is linux_gtk_x86_64.

To create one for the 32bit platform I generated the missing property file buckminster_linux_gtk_x86.properties and filled the target data accordingly. But the generation failed because of missing dependencies. There was no launcher lib avilable for the selected platform.

Reason is that my Eclipse is Helios (3.6.2) for Linux on x86_64 and has no idea of other platforms.

Some search took me to the Eclipse DeltaPack which is described as The delta pack contains all the platform specific resources from the SDK and is used for cross-platform exports of RCP applications.

It is available as a specific file for every Eclipse build via http://download.eclipse.org/eclipse/downloads/

I extracted it and added the directory as additional location to the projects target platform definition:

Based on that I could still not create the installer for another platform. In this case the Buckminster book was a helpful resource.

I had to turn on the option for a full rebuild and then it worked:

I took the generated file idempiereClient.gtk.linux.x86.zip to the other platform, unzipped it and started adempiere-client.sh

It gave me an Unable to access jarfile plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar error.

Replacing

plugins/org.eclipse.equinox.launcher_1.1.0.v20100507.jar

by the actually used

plugins/org.eclipse.equinox.launcher_1.1.1.R36x_v20101122_1400.jar

finally did it!

Adempiere: Belegverarbeitung im Verkauf

Dirk Niemeyer — Tue, 24 Jan 2012 11:48:51 +0100

Wie in einem anderen Eintrag beschrieben, kennt Adempiere standardmäßig eine Anzahl von Belegarten im Verkauf. Je nach Belegart wird durch den Anstoß der Belegverarbeitung unterschiedliches durchgeführt.

Wenn Sie Ihren Vorgang fertig eingegeben und gespeichert haben sehen Sie im Feld Belegart den Eintrag "** Neu **" und im Feld Belegstatus den Eintrag "Entwurf".

Das heisst, Ihr Vorgang ist zwar erfasst, hat aber ausser der Zuteilung einer Belegnummer im System noch keine weitere Auswirkung.

Sie müssen nun die Belegverarbeitung durch Klick auf die Schaltfläche "Belegverarbeitung" starten. Sie werden diese Schaltfläche nun vieleicht vergeblich suchen, denn je nach Statsu Ihres Dokumentes steht als Bezeichnung auf dieser Schaltfläche die Bezeichnung des aus Sicht des Systems notwendigen oder sinnvollen nächsten Verarbeitungsschrittes. Daher hat die Schaltfläche nun vermutlich die Bezeichnung "Fertigstellen".

Ein Klick auf "Fertigstellen" öffnet also nun ein kleines Fenster mit der Bezeichnung "Belegverarbeitung". Sie können hier eine andere Art der Belegverarbeitung in einem Ausklappmenü auswählen. Die Konsequenzen werden als kurze Information angezeigt. Wenn Sie die richtige Wahl getroffen haben, klicken Sie auf "OK" beziehungsweise das Symbol mit dem Haken.

Die aktuelle Belegart legt die möglichen Verarbeitungsregeln fest. Dazu eine kleine Übersicht:

Vorbereiten

reserviert Bestand und berechnet, wenn nötig, Steuern neu. Der Vorgang ist noch aktiv und es können noch Positionen hinzugefügt und geändert werden.

Fertigstellen

leitet verschiedene Vorgänge ein, die wiederum von der Belegart abhängen:

Typ Angebot: Schließt das Dokument. Es kann nicht kopiert oder in einen anderen Dokumenttyp umgewandelt werden, bis es reaktiviert ist.
Typ Verkauf: Der notwendige Bestand ist reserviert. Ermöglicht das Erstellen von Lieferscheinen und Rechnungen (abhängig von Liefer- und Rechnungsvereinbarungen)
Typ Lagerverkauf: Der Lieferschein ist generiert. Der Bestand wird angepasst. Die Rechnungen können erstellt werden (abhängig von Rechnungsvereinbarungen).
Typ Kreditverkauf: Lieferschein und Rechnung werden generiert. Der Bestand wird angepasst.
Typ Barverkauf: Lieferschein und Rechnung werden generiert. Der Bestand wird angepasst. Wenn die Zahlungsart "Bar" ist, wird automatisch ein Eintrag im Kassenbuch angelegt.

Der Beleg ist nun geschützt ("read only"), so dass nur noch geringe Änderungen durchgeführt werden können (z.B. Name, Adresse, Beschreibung, Zahlungsweg). Dies verschafft Ihnen eine gewisse Flexibilität, die nach dem Ausdrucken des Dokumentes evtl. nötig ist, z.B., um einen Druckfehler zu korrigieren.

Reaktivieren

öffnet den Beleg wieder und macht eventuell automatisch erzeugte Belege rückgängig. So können Sie Mengen oder Preise verändern oder auch ganze Positionen hinzufügen oder löschen. Anschließend müssen Sie den Beleg wieder fertigstellen (oder schließen).

Löschen

setzt alle Werte auf 0 und schließt den Vorgang ab. Er kann nicht reaktiviert oder weiterverarbeitet werden. Er ehät die Kennzeichnung "** Rückgängig gemacht". Damit können Sie dokumentieren, daß dieser Vorgang abgebrochen wurde und erhalten eine durchgängige Belegnummerierung im System.

Schließen

schließt den Vorgang endgültig ab. Er kann nicht reaktiviert werden. Den Status könnte man auch als "archiviert" bezeichnen.

Buchbesprechung "ADempiere 3.6 Cookbook" Teil 1

Dirk Niemeyer — Thu, 30 Jun 2011 17:40:00 +0200

Der Untertitel verspricht über 100 Rezepte um Adempiere über die Standardleistung hinaus zu erweitern oder anzupassen.

Kapitel 1 beschreibt, wie man seine eigene Entwicklungsumgebung aufsetzt. Dies ist die Basis, die für die meisten Rezepte - die wirklich deutlich über das Customizing hinausgehen - tatsächlich benötigt wird. Als Ergänzung gibt es noch Tips für die Konfiguration von unterschiedlichen Servervarianten.

Kapitel 2 und 3 zeigen an einem durchgehenden Beispiel das Customizing, was allein über die ADempiere-Oberfläche schon möglich ist. Dazu gehört das Erstellen von Fenstern mit mehreren Registern, die Aufnahme des Fensters ins Menü, der Umgang mit Datentypen und Referenzen auf andere Tabellen, sowie Steuerung der Zoom-Funktionalität und der Zugriffsrechte.

In Kapitel 3 wird unter anderem die Anzeige von Feldern in der Oberfläche und der Suchmaske gesteuert sowie das zugehörige Berichts-Layout angepasst. Dann kommt die erste Stufe der Erweiterung durch zusätzliche Java-Programmierung hinzu. Hierbei wird im Rahmen des gewählten Beispiels "Besprechungsprotokoll" demonstrative Business-Logik auf Feldebene und Eintragsebene angelegt sowie ein zusätzlicher Prozess erzeugt.

Alle Rezepte sind sehr schön strukturiert mit einer Übersicht und dem reichlich bebilderten Schritt-für-Schritt Vorgehen. Gegebenenfalls gibt es einen Abschnitt zur Beschreibung notwendiger Vorarbeiten und eine erklärende Zusammenfassung. An einigen Stellen verweist der Autor auch auf hilfreiche zusätzliche Information im ADempiere-Wiki oder Lernmaterial in der Wikiversity. Auf der Webseite zu diesem Buch bei Packt kann man sich auch den abgedruckten Sourcecode herunterladen.

Mit Kapitel 4 werden dann die Basics verlassen. Es bietet eine ausführliche Anleitung zur Einbindung von ADempiere in andere Programme mittels WebServices. Von den möglichen Varianten wird die von 3E beigetragene Erweiterung für "Model oriented Web Services" installiert. Mit Hilfe des einfachen soapUI-Programmes als "Konsument" wird wiederum Schritt für Schritt konfiguriert und die Nutzung des API für jegliche Art der Interaktion zum Lesen und Aktualisieren von Daten bis hin zur Prozessausführung demonstriert.

Fortsetzung folgt.

Kochen mit ADempiere

Dirk Niemeyer — Thu, 09 Jun 2011 21:50:00 +0200

Ich habe gerade von Packt Publishing ein Exemplar des Buches "Adempiere 3.6 Cookbook" von Ajit Kumar zur Besprechung zur Verfügung gestellt bekommen.

Beim ersten Durchblättern macht es schon mal einen sehr interessanten Eindruck. Ich werde mich in der nächsten Zeit ein wenig damit beschäftigen und dann hier darüber schreiben.

Frühjahrsputz

Dirk Niemeyer — Sun, 11 Apr 2010 22:12:31 +0200

Wir haben es endlich geschafft, unser Plone zu aktualisieren.

Und bei der Gelegenheit ist das Blog bei Plone mit eingezogen. Das bisher verwendete Nanoblog war zwar toll, weil schlicht, aber eben auch unpraktisch, weil separat.

Und dazu gibt es nun auch eine Blogroll.

Adempiere: Lieferarten im Auftrag

Dirk Niemeyer — Wed, 03 Mar 2010 11:55:00 +0100

Verfügbarkeit (Availability, die Standardeinstellung): Lieferscheine werden nur generiert, wenn (ausreichend) Lagerbestand im System verfügbar ist. Beachten Sie: Waren werden dadurch gegebenenfalls automatisch auf Nachbestellung gelegt, wenn nicht genug Lagerbestand verfügbar ist. Dies könnte automatisch zu Mehrfachlieferungen führen.
Komplette Position oder Kompletter Auftrag (Complete Line / Complete Order): Dies bedeutet, dass der Lieferschein nur dann generiert wird, wenn die komplette Auftrags-Position (oder der komplette Auftrag) versandt werden kann. Diese Optionen lassen keine Teillieferungen zu.
Nach Zahlungseingang (After Receipt): der Lieferschein wird nur dann erstellt, wenn die zugehörige Zahlung eingegangen ist.
Erzwungen (Force): Lieferscheine werden unabhängig von der verfügbaren Menge auf dem Lager generiert. Es kann dadurch also ein Negativbestand entstehen.
Manuell (Manual): Lieferscheine können nicht durch die Prozesse Menü > Vertrieb > Lieferscheine > Lieferscheine erstellen (manuell) (Menu > Quote-to-Invoce > Shipments > Generate Shipments (manual)) beziehungsweise Menü > Vertrieb > Lieferscheine > Lieferscheine erstellen (Menu > Quote-to-Invoce > Shipments > Generate Shipments) erstellt werden sondern müssen manuell im Fenster Menü > Vertrieb > Lieferscheine > Lieferschein (Kunde) (Menu > Quote-to-Invoce > Shipments > Shipment (Customer)) angelegt werden.

Wenn Lieferscheine nicht automatisch nach den Regeln für eine Verkaufs-Belegart generiert werden, könen Sie diese durch die unter Manuell aufgeführten Prozesse erstellen lassen.

Die Liefeart kann für jeden Kunden (und Lieferanten) in dessen Stammdaten vorbelegt werden und wird dann automatisch in den Verkaufs- oder Einkaufsvorgang übernommen.

Adempiere: Verkaufs-Belegarten

Dirk Niemeyer — Tue, 02 Mar 2010 09:45:00 +0100

Zur Orientierung ist auch jeweils die Originalbezeichnung und die ID im Mandant GardenWorld aufgeführt.

Unverbindliches Angebot (Proposal, C_DocType_ID=129): hat keine weiteren Konsequenzen im System und kann manuell in jede andere Verkaufsbelegart umgewandelt werden.
Verbindliches Angebot (Quotation, C_DocType_ID=128): duch Dokumentenverarbeitung (Vorbereiten/Prepare oder Fertigstellen/Complete) wird automatisch Bestand reserviert. Es kann in jede andere Verkaufsbelegart umgewandelt werden.
Verkauf (Standard Order, C_DocType_ID=132): Reserviert automatisch Bestand. Lieferschein und Rechnung können manuell erstellt werden.
Lagerverkauf (Warehouse Order, C_DocType_ID=134): Die Waren werden mit Lieferschein ausgeliefert. Diese Belegart generiert bei der Fertigstellung automatisch einen Lieferschein. Sie können die Rechnung dann später manuell erstellen.
Kreditverkauf (On Credit Order, C_DocType_ID=133): Die Waren werden mit Rechnung ausgehändigt. Diese Belegart generiert automatisch einen Lieferschein und eine Rechnung. Sind die Waren bezahlt, geben Sie die Zahlung manuell ein.
Barverkauf (POS Order, C_DocType_ID=135): Diese Belegart ist flexibler. Die Waren werden mit einer Rechnung ausgehändigt und optional bezahlt. Bei diesem Dokumenttyp wird automatisch ein Lieferschein generiert, eine Rechnung, und eine von den Zahlungsbedingungen abhängige Zahlung. Ist als Zahlungsart Bar ausgewählt, wird direkt ein Eintrag im Kassenbuch generiert. Zahlungsbedingung kann allerdings auch sein, dass aufs Konto überwiesen wird.
Vorauskasse (Prepay Order, C_DocType_ID=130): Die Rechnung wird bezahlt, bevor die Verakufspositionen versandt werden. Die Zahlung kann direkt im Verkauf vorgenommen werden oder dem Verkauf wird später eine Zahlung zugeordnet. Nach der Zahlung werden Lieferschein und Rechnung automatisch erzeugt.

Noch ein Tip: Wenn Sie einen Verkaufsvorgang fertigstellen, wird beim Drucken (Drucken-Schaltfläche auf der Symbolleiste) automatisch das höchste generierte Dokument gedruckt. Sie müssen dazu also kein weiteres Fenster öffnen.

Zwei Beispiele:

Wenn ein Kunde Ware durch einen Lagerverkauf erhält, wird die Rechnung verschickt. Wenn Sie nun die Drucken-Schaltfläche anklicken, wird automatisch der Lieferschein ausgedruckt.
In einem anderen Fall wird ein Barverkauf durchgeführt. Die Ware wird bar bezahlt und gleich mitgenommen. Wenn Sie in diesem Fall die Drucken-Schaltfläche anklicken, wird die Rechnung ausgedruckt.

Es wird also jeweils das passende Dokument gedruckt, um es dem Kunden mitgeben zu können.

Installation von Time4U auf Debian

Dirk Niemeyer — Mon, 19 Oct 2009 14:25:00 +0200

Auf der 2. ADempiere-Konferenz unterhielt ich mit einem Entwickler über Möglichkeiten der Übernahme von Abrechnungsdaten ("Stundenzettel") nach ADempiere.

Ich nutze gnotime um bequem bei der Arbeit am Computer mitzukoppeln, wieviel Zeit ich auf welche Tätigkeiten verwende. Was mich an dem Werkzeug stört ist, dass es für Übersichten nur HTML generieren kann. So muss ich die Ausgaben erst lange umfrisieren und dann in OOCaclc auswerten oder verdichten.

Er erwähnte Time4U, es sei von einer deutschen Firma entwickelt und er würde an einer Schnittstelle zur Übernahme von Daten nach ADempiere arbeiten.

Nun habe ich es endlich mal geschafft, mir dieses Werkzeug anzusehen. Die gegenwärtige Version ist (entgegen der Angabe auf der Homepage) 0.9.9.RC2-437 (siehe download-Seite auf sourceforge). Der Client bietet tatsächlich gegenüber gnotime bessere Eigenschaften: man kann mit "Continue Workitem" den gleichen Eintrag fortsetzen (das hab ich sehr vermisst) und man kann ToDos anlegen und zuordnen und damit z.B. auf die Tickets in OTRS referenzieren .

Da man im Client gar nicht an die Daten kommt ("irgendwo" läuft wohl Apache-Derby als Datenbank) wollte ich auch die zugehörige Serverkomponente testen auf die der Client seine Daten synchronisiert.

Also flugs mit

xen-create-image --hostname=time4u

einen neuen Server mit Debian Lenny angelegt (naja, in Wirklichkeit hab ich es erst auf einem existierenden, aber viel zu schwachbrüstigen Server probiert) und gestartet. Daran angemeldet und mit

alien

aus den rpm-Paketen time4u-server, time4u-server-apache und time4u-server-postgres debs gemacht (nachdem ich unter anderem http://forum.ubuntuusers.de/topic/kitchensync-in-kde4/ zum Thema "Unpacking of 'time4u-server-0.9.9.RC2-437.noarch.rpm' failed at /usr/share/perl5/Alien/Package/Rpm.pm line 155." gefunden und besagtes Perl-Skript um

| lzma -d

erweitert hatte).

Notwendige Pakete werden mit

apt-get install apache2 libapache2-mod-jk sun-java6-jdk postgresql-8.3 libpg-java

installiert.

Dann mit

dpkg -i time4u-server_0.9.9.RC2-438_all.deb time4u-server-apache_0.9.9.RC2-438_all.deb time4u-server-postgres_0.9.9.RC2-438_all.deb

die erzeugten Time4U-Pakete installieren.

Ein paar manuelle Anpassungen sind nötig:

Editieren von /etc/init.d/time4u

Alle Zeilen mit "rc" auskommentieren

Anpassen:

JAVAPTH=${JAVAPTH:-"/usr/lib/jvm/java-6-sun/bin"}

Anpassen:
```
JBOSSUS=${JBOSSUS:-"www-data"}
```

In /srv

Ausführen von

chown -R www-data. time4u-with-jboss

In /srv/time4u-with-jboss/bin/run.conf

Anhängen der Zeile

JBOSS_CLASSPATH="/usr/share/java/postgresql.jar"

Dann gemäß Anleitung unter ServerInstallSUSE das Aufsetzen der Datenbank durch

su postgres -c "psql -f /srv/time4u-with-jboss/time4u-postgres-init.sql"

. Und /etc/postgresql/8.3/main/pg_hba.conf erhÃ¤lt die zusÃ¤tzliche Zeile mit time4u.

Die Dateien für den Apache2 brauchen auch noch ein wenig Anpassung:

Verschieben der Datei time4u-workers.properties

mv /etc/apache2/conf.d/time4u-workers.properties /etc/apache2

Anpassen der Datei /etc/apache2/conf.d/time4u.conf

Auskommentieren der Zeile

LoadModule    jk_module  /usr/lib64/apache2/mod_jk.so

Edititeren des Verweises auf die Properties-Datei:

JkWorkersFile /etc/apache2/time4u-workers.properties

Auskommentieren der Zeilen mit
```
JkMount
```

Konfigurieren eines (virtuellen) Servers

In dessen Konfigurationsdatei die Zeilen mit

JkMount

einfügen

Dann Postgres, Time4U und Apache2 starten. Im Browser muss man die Anmeldeseite http://servername/time4u laden und sich mit admin/admin anmelden, um einen Nutzer-Account anzulegen. Dieser kann dann mit dem Client für die Synchronisierung verwendet werden. Über das Web-Interface kann dieser Nutzer dann auch diverse (mitgelieferte) Auswertungen nutzen.

ADempiere und GDPdU-Anforderungen

Dirk Niemeyer — Fri, 03 Jul 2009 12:50:00 +0200

Kunde "Saftladen GmbH" gibt im Juli per Rundschreiben bekannt, dass er ab August unter dem neuem Namen "Saftwerke GmbH & Co. KG" firmiert. Also werden schnell die Stammdaten für diesen Kunden geändert und alles ist gut.

Leider ist nicht alles gut, da wir ja - bedingt durch den Einsatz eines Datenverarbeitungs-Systems - unter anderem Forderungen der GDPdU (Grundsätze zum Datenzugriff und zur Prüfbarkeit digitaler Unterlagen) zu erfüllen haben. Angenommen, nächstes Jahr findet bei uns eine Aussenprüfung durch das Finanzamt statt und der Prüfer möchte ausgerechnet die Rechnungsdaten für den Kunden "Saftladen GmbH" aus dem System ziehen. Aber den gibt es dann ja nicht mehr!

Was können wir tun?

Zum einen können wir alle Dokumente immer ins Archiv drucken. Somit können wir jederzeit eine Rechnung für die "Saftladen GmbH" wieder im Originalzustand erzeugen. Dazu muss der Administrator im Fenster Mandant (Menü > System-Administration > Einstellungen Mandant > Mandant) auf dem Auswahlfeld "Automatische Archivierung" z.B. die Einstellung "Dokument" auswählen. Dann erhält man auf dem Fenster "Rechnung" bei Klick auf die Schaltfläche "Archivierte Belege und Berichte" eine weitere Schaltfläche mit der Bezeichnung "Dokumente (1)". Klickt man diese an, wird zu diesem Dokument der Archivbetrachter mit Anzeige des Originalausdrucks geöffnet. Nun kann diese Rechnung nochmals zu Papier gebracht werden.

Den Betriebsprüfer werden aber doch eher die Daten im System interessieren. Er braucht also einen entsprechenden Auszug aus allen am Vorgang der Rechnungsstellung beteiligten Tabellen wie Rechnung (C_Invoice) und der für unser Beispiel wichtigen Tabelle Geschäftspartner (C_BPartner). Damit dieser Eintrag dann auch in der korrekten, zum Zeitpunkt der Rechnungsstellung gültigen Version vorliegt müssen wir für die Historisierung unserer Daten sorgen.

Dazu muss der Administrator für die relevanten Tabellen über das Fenster "Tabelle und Spalte" (Menü > Application-Dictionary) die Selektion "Änderungen protokollieren" auswählen. Alternativ kann diese Selektion auch für eine Rolle vorgenommen werden (Menü > Systemadministration > Allgemeine Einstellungen > Sicherheit), so dass für alle Nutzer, die in dieser Rolle arbeiten alle Änderungen protokolliert werden.

Nun kann für den Eintrag in der Tabelle C_BPartner auch die zugehörige Änderungshistorie aus der Tabelle AD_Changelog zur Verfügung gestellt werden.

2. ADempiere-Konferenz

Dirk Niemeyer — Thu, 18 Jun 2009 09:20:00 +0200

Vom 21. bis zum 23. Juni 2009 findet in Berlin die 2. ADempiere-Konferenz statt.

Nach dem großen Erfolg der ersten Konferenz im Mai 2007 werden sich nach zwei Jahren erneut die Hauptentwickler und alle, die Interesse haben in Berlin für mehrere Tage treffen.

Auf der Tagesordnung stehen vor allem Diskussionen zu Stand und Richtung des Projektes sowie Vorträge zu Vorgehensweisen, Anwendungen und neuen Erweiterungen.

Organisiert wird die Konferenz vom ADempiere Deutschland e.V. action 42 ist förderndes Mitglied und stellt in meiner Person einen Vorstand des Vereins. Als Sponsor der Konferenz tragen wir einen Teil der Kosten, vornehmlich Reisekosten für einige der aus aller Welt anreisenden Teilnehmer.

Weitere Details sind im Wiki auf der Seite 2nd European ADempiere Conference zu finden.

Das Leben, das Universum und der ganze Rest...

Dirk Niemeyer — Wed, 17 Jun 2009 08:25:00 +0200

Hier werden Texte entstehen, die sich aus unseren Projekten, den Produkten mit denen wir umgehen und Allem was uns interessiert ergeben. Also Neuigkeiten, Tips, HowTos, Gedanken.

Inspieriert ist der Titel natürlich von der - inzwischen wohl fünfbändigen - Trilogie "Per Anhalter durch die Galaxis" vom leider viel zu früh verstorbenen Douglas Adams. Danach fragt die berühmte Frage, deren verblüffende Antwort der Supercomputer "Deep Thought" nach Jahren des Nachdenkens liefert:

Viel Spaß und viel Erfolg!