iDempiere de - Benutzerbeiträge [de]

JasperReportsClassic

2025-07-16T11:09:54Z

TBayen: JasperReports über den Berichts-Button in der Toolbar mit *RecordIDs*

[[http://jasperforge.org/projects/jasperreports Jasperreports]] ist ein Reportgenerator, dessen Möglichkeiten weit über die der in Adempiere eingebauten Report-Fähigkeiten hinausgehen. Die klassische Integration geht über das Plugin "org.adempiere.report.jasper", das hier beschrieben wird. Es gibt eine neuere Implementierung [[JasperReportsFreiBier]], die etwas modularer aufgebaut ist.

Allgemeine Informationen gibt es auf der Seite [[JasperReports]].

== Aufruf in iDempiere ==

Man erzeugt einen neuen Datensatz im Fenster "Bericht & Prozess". Dort schreibt man in das Feld "Jasperbericht" den Namen seines Berichtes. Dieser Name muss den Pfad enthalten und auf ".jasper" enden. (Die Endung ".jrxml" sollte grundsätzlich auch gehen - einerseits verlangsamt das den Start unnötig andererseits kann aber eine *.jasper-Datei, die mit einer anderen Version (also z.B. aus einem neueren iReport) übersetzt ist, zu Ärger führen). Der Name kann auch mit "http:", "https:", "attachment:", "resource:", "file:" anfangen, um zu erklären, wo er herkommt. Je nach Auswahl kann es übrigens zu einigen Besonderheiten kommen, was das Nachladen von Unterdateien (Subreports, Bilder) betrifft. In dem Fall empfehle ich das Studium des Sourcecodes von ReportStarter.java.

Man muss noch bei "Bericht" ein Häkchen machen. Dieses Häkchen führt einerseits dazu, das immer die Klasse <code>org.compiere.report.ReportStarter.java</code> automatisch ausgeführt wird. Es muss also keine Prozess-Klasse mehr angegeben werden. Andererseits wird hierdurch der Bericht in einigen Pull-Down-Menüs überhaupt erst angezeigt, wo man Berichte auswählen kann.

Man kann übrigens auch noch eine Prozess-Klasse angeben, diese wird dann zusätzlich ausgeführt. Das ist eigentlich blöde, wenn man einen Bericht auf eine andere Weise als mit dem ReportStarter starten will, weil man dazu "Bericht" ausschalten muss und dann nicht mehr in den Pull-Down-Menüs steht (Es hilft wahrscheinlich, es erst einzuschalten, dann auszuwählen und dann auszuschalten).

Ein solcher "Bericht & Prozess" kann nun im Fenster "Fenster, Register & Feld" in einem Register als "Vorgang" angegeben werden. Ist das geschehen, ist im entsprechenden Fenster der "Print Preview" und der "Print" Button aktiviert und der Report wird gestartet.

Nach der Philosophie von ADempiere ist der Report, den man mit dem Print-Button aufruft übrigens immer einer, der einen einzelnen Datensatz ausgibt. Will man eine Liste ausgeben, nimmt man dazu den Bericht-Button (links daneben). Dieser startet normalerweise den ADempiere-internen Berichtsgenerator. Der ist auch ganz nett, was hier aber nicht das Thema ist. Man kann dort daher mit dem Werkzeug-Icon den Bericht konfigurieren und im sich öffnenden Fenster "Druckformat" einen "Jasperprozess" auswählen (also einen Prozess, bei dem "Bericht" eingeschaltet ist). Ab diesem Moment wird man nicht mehr vom internen Berichtsgenerator behelligt.

Wer das später anpassen oder vorher direkt konfigurieren will, kann das im Fenster "Druck Format" machen. Die aus dem Programm heraus konfigurierten Einträge werden nicht global gespeichert und können auch nur von einem Mandanten aus wieder geändert werden. Ich denke jedoch, das man auch im System-Mandanten globale Druck-Formate einstellen kann. Ich habe noch nicht raus, wie ein bestimmtes Register-Tab nun mit einem bestimmten Druckformat verbunden ist. Vielleicht geht das nur über die gemeinsame Tabelle.

Wer will, das ein Report möglichst dem Inhalt des Fensters ähnlich sieht, sollte sich [http://www.adempiere.com/JasperReports_with_Window_Sql-Clauses JasperReports with Window Sql-Clauses] ansehen.

== Subreports ==

Ein Sureport ist ein "Report im Report", also eine Art Unterliste. Wenn ich z.B. einen Report erzeuge, der meine Rechnungen ausgibt (und dazu über Datensätze aus der Tabelle C_Order iteriert), braucht man einen solchen Subreport, um die Liste der Artikelzeilen anzuzeigen.

Wer komplexe Dinge mit Subreports und anderen externen Resourcen (Bilder, Properties-DAteien, etc.) machen möchte, möchte sich vielleicht das neuere Plugin [[JasperReportsFreiBier]] ansehen.

=== Subreport iDempiere-freundlich einrichten ===

Siehe hierzu zuerst einmal die entsprechende Dokumentation von iReport. Die '''Subreport Expression''' ist:

$P{SUBREPORT_DIR} + "Kundendaten_subreport1.jasper"

und hat die Class '''java.lang.String'''. Dieser Ausdruck sorgt dafür, das der Subreport im gleichen Verzeichnis gesucht wird wie der Hauptreport - unabhängig davon, ob es sich um einen Pfad bei dem einen oder dem anderen Entwickler, aus iReport oder innerhalb iDempiere oder sogar aus dem Classpath eines Java JAR-Files heraus handelt.

Die '''Connection Expression''' ist <code>$P{REPORT_CONNECTION}</code> (also die gleiche Datenbank-Verbindung benutzen wie der Hauptreport).

Dann kann man '''Parameters''' definieren. Das ist eigentlich das wichtigste am Subreport, weil hier die Verbindung zum Mutter-Report hergestellt wird. Wenn wir hier einen Parameter '''RECORD_ID''' einrichten und dort unser Schlüsselfeld eintragen (z.B. C_BPartner_ID), sorgen wir dafür, das sich das für den Subreport genauso anfühlt, als sei er ganz alleine für sich aus ADempiere heraus aufgerufen worden. Der Subreport kann also auch alleine aus ADempiere heraus aufgerufen werden. Wird diese Konvention überall beachtet, erhält man so eine Sammlung von Modulen, die alle austauschbar und ineinander schachtelbar sind.

Über das Kontext-Menü des Subreport-Elements kann man nun den Subreport öffnen und selber definieren. Hier macht es u.U. Sinn, alle möglichen Footer- und Header-Bereiche auszublenden. Anosnsten erzeugt man auch hier zuerst einen Parameter mit dem Namen "RECORD_ID" und verwendet diesen dann in einem Query in der Form $P{RECORD_ID}. Also alles wie beim Mutter-Report.

=== weitere Probleme beim Auffinden von Subreports ===

Leider zeigten meine Tests, das das Auffinden von Subreports mit Hilfe des Parameters <code>SUBREPORT_DIR</code> nicht so gut funktioniert, wie man sich das denkt. Ein Blick in den Quelltext ergab, das man in <code>JasperReports/src/org/compiere/report/ReportStarter.java</code> suchen muss, wenn man Antworten haben will. Ich konnte dort nicht finden, wo (und ob) SUBREPORT_DIR gesetzt wurde.

Ich habe den Kern des Problems erst nach einigen Versuchen und dem Quellcode-Studium verstanden und versuche mal, es hier zu beschreiben: Wenn ein Report einen Subreport aufrufet, enthält dieser einen Ausdruck, der den Subreport beschreibt. Das ist im Normalfall ein String mit einem Dateinamen. Nun liegen bei einer ADempiere-Installation, die per Webstart gestartet wird, die *.jrxml- und die *.jasper-Dateien ja nicht einfach in der Gegend herum, sondern sind normalerweise im Classpath (oder vielleicht auf einem Server per HTTP). Außerdem weiss man ja auch nie, ob eine *.jrxml oder eine *.jasper vorliegt, ob also noch etwas compiliert werden muss. Also müssen diese Dateien zuerst heruntergeladen und aufbereitet werden. Dann liegen sie in einem definierten Verzeichnis (und zwar /tmp) und können ausgeführt werden. Dabei gibt es nun zwei Probleme:

1. ADempiere muss wissen, welche Dateien es herunterladen und aufbereiten muss
2. Reporte müssen etwas über die Umgebung, in der sie laufen, wissen (den Pfad der Subreporte)

Der erste Punkt hört sich erstmal trivial an, ist er aber nicht (und ist damit der Kern des Problems). Sowohl im Web als auch im Classpath gibt es keine Möglichkeit, ein Verzeichnis aller Dateien zu bekommen (Man könnte die Information über die Subreports aus dem Hauptreport extrahieren, hat man aber nicht). Also gibt es folgende Konvention (im Quellcode ab Zeile 474, Code von [[trifon]]): Zu einem im Paket "de.bayen.freibier.reports" befindlichen Report "MeinBericht.jrxml" sucht ADempiere eigenständig die Datei "MeinBerichtSubreport1.jrxml" und wiederholt das mit den Zahlen 1-9. Diese Datei wird dann ggf. übersetzt und auch in das Zielverzeichnis (also /tmp) kopiert. Dann wird der Dateipfad in den Parameter "de_bayen_freibier_reporte_MeinBerichtSubreport1" geschrieben.

Was heisst das nun?

Wir nennen unseren Subreport zu "MeinBericht" schon in iReport "MeinBerichtSubreport1". Dann erzeugen wir im Hauptreport einen Parameter mit dem Namen "de_bayen_freibier_reporte_MeinBerichtSubreport1" und dem Default-Wert "./MeinBerichtSubreport1.jasper". Das läuft dann sowohl in iReport als auch in ADempiere, wenn man das in das angegebene Paket installiert.

Was es dazu noch zu sagen gibt:

Übrigens habe ich gesehen, das auch eine System-Property "org.compiere.report.path" gesetzt wird. Diese enthält dann "/tmp". Aber wie gesagt - da ist eh nur das drin, was ADempiere vorher bereits identifizieren konnte. Also fällt das z.B. für eingebettete Grafiken etc. aus.

Alles in allem ist die Methode, wie hier Dinge nachgeladen werden, nicht so toll. Eigentlich kann man in JasperReports hierfür Handler definieren. Dann könnte man z.B. auch eingebettete Grafiken etc. aus dem Classpath laden. Hier gibt es noch Raum für Verbesserungen.

Zur Benutzung des /tmp-Verzeichnisses siehe auch [http://www.adempiere.com/ADempiere_on_a_terminalserver ADempiere on a terminalserver].

=== Reporte komplett modularisieren ===

Wenn man Reporte komplett modularisieren will, bedeutet das, das der Report, den man offiziell aufruft, eigentlich keinen einzigen Tintenklecks Inhalt enthält, sondern lediglich Subreports aufruft, die dann z.B. den Header, den Footer und verschiedene, kombinierbare Inhalte enthält. Dabei gibt es verschiedene Dinge zu beachten:

* Wie rufe ich die Unterreporte richtig auf? (siehe oben zu Suchpfaden für externe Dateien)
* Wie übergebe ich Parameter an den Subreport?
* Wie definiere ich Queries in Subreporten (genauso wie immer, aber halt im Subreport und nicht im Hauptreport)
* Wie sorge ich für ein anständiges Seitenlayout? (Siehe unten)

Um ein ordentliches Seitenlayout hinzubekommen, bietet es sich an, z.B. den Header als einen eigenen Subreport zu implementieren. Hier kann man dann einen eigenen Query benutzen, um den Namen der Firma, den Benutzer, ein Logo oder sonstige Informationen zu erhalten. Der Vorteil ist hier vor allem, das man - auch wenn man sehr viele Reporte erstellt - diesen Seitenkopf recht schnell an einer einzigen Stelle anpassen kann.

Wenn man nun aber seine eigentlichen Reporte auch modularisiert, kann man diese später mit mehreren zusammensetzen. Dazu ruft man den Report, der die eigentliche Logik (den Query etc.) enthält, als Subreport auf. Dieser Subreport enthält dann keine Seitenheader und -footer. Er hat eine Breite, die bereits direkt ohne Rand gerechnet ist (der Rand ist im Haupt-Report definiert). Ein Trick hierbei liegt in der Frage, wo dieser Subreport nun hingehört. Man kann ihn nicht in die Bänder "Title" oder "Summary" setzen. Wird der Subreport länger als eine Seite, wird dann nämlich kein Seitenheader und -footer erzeugt. Also muss er zwischen Header und Footer. Als "Columnheader" kann man ihn auch nicht nehmen. Dieser darf (wie der Seitenheader) nicht länger als eine Druckseite sein (logisch, weil die neue Seite ja einen neuen Header auslösen würde). Also muss er in das "Detail"-Band. Dieses wird allerdings nur ausgegeben, wenn es Daten gibt (und zwar für jede Zeile einmal). Also muss ich dafür sorgen, das der Hauptreport genau eine Zeile Daten enthält. Dazu stelle ich den Query dort auf "SELECT 1;". Dann geht's! :-)

Etwas schwieriger ist es wohl, Informationen über die aktuelle Seitenzahl oder gar ein "Seite x von y" an einen Header-Subreport zu übergeben. Ich habe es noch nicht probiert, könnte mir aber vorstellen, das man mit der Übergabe entsprechender Parameter eine Seitenzahl schaffen könnte (glaube aber nicht, das das mit der Gesamtzahl auch geht).

=== Links mit Beispielen von Subreports und Datasets ===

* http://stackoverflow.com/questions/3681704/ireport-passing-parameters-from-a-main-report-query-to-a-dataset-query-for-a-ta
* http://alexandru-ersenie.com/2009/12/10/ireport-using-main-dataset-parameters-in-subdatasets-in-jasper-reports/

== Vorbereiten von *.jasper-Dateien mit unterschiedlichen JasperReports-Versionen ==

Grundsätzlich kann man unkompilierte *.jrxml-Dateien benutzen. Diese werden vom ReportStarter (die Programmklasse, die JasperReports in iDempiere integriert) automatisch kompiliert und dann ggf. gecachet. Eigentlich gibt es also keinen Grund, vorkompilierte Dateien zu benutzen. Wer das dennoch möchte, kann das mit dem "Classic" ReportStarter folgendermassen machen. Das folgende Beispiel ist für ADempiere 361 (Ich habe es nicht angepasst, weil ich inzwischen [[JasperReportsFreiBier]] benutze, das dieses Problem etwas anders löst.)

Meine Report-Dateien (*.jrxml) speichere ich in das Eclipse-Projekt meines Plugins. Dort habe ich dann ein Ant-buildskript erstellt. Dieses kompiliert die XML-Datei in eine *.jasper-Datei und benutzt dazu die Version der Bibliothek, die sich im benachbarten Projekt der ADempiere-Basis befindet.

Hier meine '''build.xml''':

<pre>
<project default="jasperreports">

<path id="classpath">

<fileset dir="../adempiere361/JasperReportsTools/lib">
<include name="**/*.jar"/>
</fileset>
<fileset dir="../adempiere361/tools/lib">
<include name="**/*.jar"/>
</fileset>
</path>

<taskdef name="jrc" classname="net.sf.jasperreports.ant.JRAntCompileTask">
<classpath refid="classpath"/>
</taskdef>

<target name="jasperreports">
<jrc srcdir="src">
<classpath refid="classpath"/>
<include name="**/*.jrxml"/>
</jrc>
</target>
</project>
</pre>

== Parameter in Berichten ==

ADempiere übergibt verschiedene Parameter an JasperReports. Diese muss man nicht benutzen, kann es aber, indem man sie in iReport als Parameter definiert. Dabei muss man einfach einen Parameter des angegebenen Namens (Gross- und Kleinschreibung beachten) anlegen. Um seine Reporte auch in iReport sinnvoll testen zu können, sollte man dann noch einen intelligenten Default-Wert angeben, der einem beim Test halbwegs sinnvolle Daten in die Ausgabe zaubert. Natürlich kann es von Fall zu Fall auch sinnvoll sein, einen Default-Wert im SQL-Code, der diese Parameter benutzt, z.B. mit COALESCE(...) zu erzeugen.

Ich konnte keine Dokumentation zu den Parametern finden und habe dann <code>JasperReports/src/org/compiere/report/ReportStarter.java</code> als authoritative Quelle benutzt.

* '''AD_CLIENT_ID''' - Erlaubt Zugriff auf den Mandanten, der momentan aktiv ist. Leider gibt es kein direktes Feld für die Organisations-ID, beide kann man allerdings auch über AD_PINSTANCE_ID extrahieren.
* '''AD_ROLE_ID''' - Die Rolle, als der der Benutzer gerade eingeloggt ist. Rollen bieten Zugriff auf Rechte und erlauben es daher, in einem Report gewisse Abstufungen zu machen, auf welche Tabellen man zugreift oder nicht.
* '''AD_USER_ID''' - Die Benutzer-ID erlaubt z.B. Zugriff auf den Benutzernamen.
* '''AD_PINSTANCE_ID''' - Erlaubt Zugriff auf eine Tabelle für Prozess-Instanzen. Dort gibt es z.B. Zugriff auf die Organisation.
* '''RECORD_ID''' - Wird nur ausgefüllt, wenn momentan ein Record ausgewählt ist. Das ist z.B. der Fall, wenn der Report aus einem normalen Datensatz-Fenster heraus mit einem Druck auf den "Drucken"-Button aufgerufen wird.
* '''CURRENT_LANG''' - enthält den String der eingestellten Sprache (z.B. "en-US")
* '''REPORT_LOCALE''' - enthält das <code>java.util.Locale</code>-Objekt zur eingestellten Sprache
* '''RESOURCE''' - enthält ein Objekt vom Typ <code>java.util.PropertyResourceBundle</code>, aber nur, wenn eine entsprechende Properties-Datei der Art ''MeinReportName_de.properties'' vorhanden ist. Man kann hiermit Mehrsprachigkeit eines Reports verwirklichen, indem man statische Texte in entsprechende Properties-Dateien auslagert und dann über dieses Objekt anspricht. (Habe ich selber noch nicht ausprobiert)
* Subreports - Für jeden erkannten Subreport wird ein Parameter mit dem entsprechenden Pfad angelegt (siehe oben).
* Prozess-Parameter - Sind im ADempiere Application Dictionaty Parameter definiert, so werden diese selbstverständlich auch an den Report übergeben. Diese werden für gewöhnlich vom Benutzer eingegeben, nachdem er einen Report aus dem Menü heraus gestartet hat. Handelt es sich um From-To-Parameter, so werden z.B. aus "zeitraum" die Parameter "zeitraum1" und "zeitraum2" erzeugt. (Im Quelltext werden übrigens ProcessParameters und ProcessInfoParameters eingefügt, deren Unterschied mir bisher nicht ganz klar ist...)

Wer den patch von [http://www.adempiere.com/JasperReports_with_Window_Sql-Clauses JasperReports with Window Sql-Clauses] schon integriert hat, bekommt auch noch:

* '''CONTEXT''' - This parameter keeps the ADempiere Context. This has nothing to do with the issue talked about at this page but you could use that if you want.
* '''REPORT_WHERE''' - This parameter contains the whole WHERE clause that gives you the records that are actual shown in your tab. It does not contain the word "WHERE" so you can use it in a wider term and combine it with AND to filter it even more if you want. If there is not defined any search this parameter contains "TRUE" so you can safely insert it in your WHERE clause at any point.
* '''REPORT_ORDERBY''' - This parameter contains the ORDER clause that is defined in the Application Directory's Tab definition. You can use it in your Query and combine inside a wider term too. If there is defined no order you get the term "0-1". In PostgreSQL (and I believe in Oracle too) you can use this inside a ORDER BY clause and it does nothing. So it does not harm if you use this variable to construct your query.
* '''REPORT_SORT''' - If you changed the sorting inside the Tab by clicking on a column header you get a sort description here. It is similat to the REPORT_ORDERBY value. If you did not sort your table it contains also the value "0+1" so you can safely insert it into your query string.
Während der obere Teil dieses Absatzes etwas älter ist, habe ich in 2025 in iDempiere11 nochmal genau nachgeschaut, welche Parameter an JasperReports übergeben werden. Dazu kann man folgenden Befehl in einem Textfeld benutzen:
$P{REPORT_PARAMETERS_MAP}.keySet().toString()
Bei mir ergaben sich folgende Felder, die nur teilweise oben bereits dokumentiert sind:
[IS_IGNORE_PAGINATION, REPORT_CONNECTION, IDEMPIERE_PARAMETER_PI, reportvariant, AD_CLIENT_ID, IDEMPIERE_PARAMETER, REPORT_LOCALE, JASPER_REPORT, AD_ROLE_ID, REPORT_TIME_ZONE, SUBREPORT_DIR, reportvariant_Info, CONTEXT, REPOSITORY_CONTEXT, JASPER_REPORTS_CONTEXT, *RecordIDs*, REPORT_FORMAT_FACTORY, REPORT_PARAMETERS_MAP, *RecordIDs*_Info, AD_USER_ID, REPORT_VIRTUALIZER, AD_PINSTANCE_ID, CURRENT_LANG]
Während es oben angegebener Patch zu den SQL-Clauses nicht in den Core geschafft hat, meine ich, das es aber Informationen über die Abfrage des Fensters im iDempiere-Kontext gibt (den man ja über CONTEXT) erreichen kann. Was aber viel interessanter ist, ist die neu eingeführte Variable "*RecordIDs*" (keine Ahnung, wer beschlossen hat, da Sternchen drum zu machen). Die enthält alle in einem Bericht anzuzeigenden Datensätze, wenn man den JasperReport über ein Druckformat aufruft. (Man kann im Druckformat einen Prozess/Report mit einem JasperReport eintragen. Dann wird das Druckformat im Grunde komplett ignoriert und stattdessen JasperReports aufgerufen.)

Die Abfrage im JasperReport kann man jetzt so gestalten, das der Bericht sowohl über den Druck-Button (als über RECORD_ID) als auch über den Berichts-Button (also über *RecordIDs*) die Auswahl der auszudruckenden Daten erhält. Das kann dann so aussehen:
select
bp.c_bpartner_id, $P{*RecordIDs*} as records
FROM C_BPartner bp
where bp.C_BPartner_ID IN (SELECT jsonb_array_elements_text($P{*RecordIDs*}::jsonb)::int)
OR bp.C_BPartner_ID = $P{RECORD_ID}
[[Category: Entwicklerdokumentation]]
[[Category: Anwenderhandbuch]]
[[Category: Ausgaben (drucken)]]
[[Category: Jasper Report]]
[[Category: Berichte]]

Finanzbericht

2021-02-04T19:43:24Z

TBayen: /* Definition von Spalten (Berichtsspaltensatz) */

== Was ist ein Finanzbericht? ==

Ein Finanzbericht ist ein druckbarer Bericht, der eine Zusammenfassung (nicht nur) von Finanzdaten enthält. Es kann sich um eine Kontenübersicht, eine Saldenliste, eine Bilanz oder eine Gewinn- und Verlustrechnung handeln. Alle diese Anwendungsfälle werden durch den Generator für Finanzberichte abgehandelt.

Finanzberichte (Fenster [[Finanzbericht (Fenster ID-216)]], Seitenkategorie [[:Category:Finanzberichte]]) werden benutzt, um periodengerechte Werte auszugeben oder nebeneinanderzustellen. Diese erlauben es, in einem ersten Schritt Saldierungen von Konten, Mengen, und dergleichen vorzunehmen und so z.B. Jahres-, Quartals-, Monats-, und Vorjahreswerte nebeneinanderzustellen. Klassische Beispiele sind die [[Bilanz]], die [[Gewinn- und Verlustrechnung]] aber auch viele Arten von Umsatz- und Kostenanalysen, die Gruppen von Kunden, Verkaufsmitarbeitern, Produkten, etc. gegenüberstellen.

Der Finanzbericht unterscheidet sich vom normalen Bericht (siehe [[Statistik und Berichte]]) dadurch, das keine gewöhnlichen Tabellendaten ausgegeben werden sondern sowohl die Spalten als auch die Zeilen des Berichts einzeln definiert und durch Formeln festgelegt werden können (und müssen).

Sind diese Periodenwerte entsprechend berechnet, bedienen sich die Finanzberichte für Ausgabe und Layout auch dem bekannten internen Berichtsgenerator.

Als Informatiker gesprochen gesagt dienen Finanzberichte als eine Möglichkeit, eine Art [http://de.wikipedia.org/wiki/Kreuztabelle Kreuztabellen] (ähnleich einer [http://de.wikipedia.org/wiki/Pivot-Tabelle Pivot-Tabelle]) zu berechnen. In einem ersten Schritt wird diese Kreuztabelle berechnet. Im zweiten Schritt wird diese dann über den normalen Berichtsgenerator ausgegeben (siehe also dort zur Definition von Druckformaten, Layout, etc. etc.).

Für einen Finanzbericht muss man als erstes die Zeilen und die Spalten definieren, die man ausgeben will. Die entsprechenden Fenster sind [[Berichtspositionssatz (Fenster ID-218)]] und [[Berichtsspaltensatz (Fenster ID-217)]].

== Wie funktioniert das? ==

Um das genauer zu erklären hole ich etwas aus: Ein Finanzbericht besteht aus Zeilen und Spalten. Die Spalten werden über einen sogenannten Berichtsspaltensatz (siehe [[Berichtsspaltensatz (Fenster ID-217)]]) definiert. Das ist ein Satz von Spaltendefinitionen, die z.B. bedeuten, das wir eine Jahressumme, eine Periodensumme, eine Vorjahressumme, etc. im Bericht haben wollen. Die Zeilen des Finanzreports werden über einen Reportpositionssatz definiert. Dort steht drin, welche Zeilen ("Report-Positionen") unser Bericht haben soll und aus welchen Konten er berechnet werden soll. Da steht also sowas wie "Die Zeile soll heissen 'technische Anlagen und Maschinen' und soll die Konten 0400-0599 zusammenfassen." Um nun einen Finanzbericht für die Bilanz zu erzeugen, muss man also zuerst im [[Berichtspositionssatz (Fenster ID-218)]] einen neuen Satz anlegen. Diesen kann man dann im Programm per Hand oder direkt aus der CSV-Datei füllen.

Darüber hinaus kann man noch einen [[Datenwürfel]] definieren (Das erhöht bei sehr grossen Datenmengen die Performanz, weil es die Daten verdichtet). Ist der Import abgeschlossen, kann man im Fenster [[Finanzbericht (Fenster ID-216)]] den fertigen Report aus einer Spaltensatz, einem Positionssatz und einem Report zusammenstellen. Dazu kann man nach der Anzeige des Reports noch das Druckformat anpassen wie üblich.

== Definition von Zeilen ([[Berichtspositionssatz (Fenster ID-218)|Berichtspositionssatz]]) ==

Die Zeilendaten benutzen als Basis eine der [[Buchführungsdimensionen]], die in der Tabelle der [[Buchführungsdaten Details (Fenster ID-162)|Buchführungsdaten]] benutzt werden. Der zur Erklärung einfachste Fall sind Konten. Hier benutzt der Bericht bestimmte Konten, die bekanntlich im [[Buchführungsschema (Fenster ID-125)|Buchführungsschema]], d.h. im [[Kontenplan]] angegeben werden. Wer der klassischen Installationsanleitung folgt, wird zu Beginn der Installationsanleitung eine [[Bilanz]] und eine [[Gewinn- und Verlustrechnung]] aus seinem Kontenplan generieren. Man kann aber ebenso auch eigene Berichte definieren.

Ist die "Positionsart" des Zeileneintrags "'''Segmentwert'''", so wird der Inhalt des angegebenen Kontos ausgegeben. Ist das angegebene Konto ein Summenkonto, so wird hier die Summe aller Unterkonten als eine Zeile betrachtet (bei der Erzeugung des Berichts im Fenster "Finanzbericht" kann man auswählen, ob die verwendeten Konten auch nochmal einzeln aufgeführt werden sollen).

Die Positionsart "'''Berechnung'''" bietet die Möglichkeit, die Werte anderer Zeilen zu addieren oder zu subtrahieren etc.

Wer eine '''Kommentarzeile''' oder eine '''Überschrift''' erzeugen möchte, kann eine Zeile mit der Art "Berechnung" erzeugen, ohne eine echte Formel anzugeben. Man sollte dazu den Operator auf Addieren setzen und die beiden Operanden-Felder freilassen. ''(Lässt man den Operator frei, gibt das pro Zeile eine "Störungsmeldung", die im entsprechenden Fenster zu sehen ist und im Swing-Client zu einem unangenehmen "Beep" führt.)'' Man kannn der aktuellen iDempiere-Version auch komplett freie Zeilen erzeugen mit der Positionsart "Blank Line" (siehe Tips & Tricks).

=== Import eines Finanzberichtes ===

Man kann einen Satz von Berichts-Positionen auch aus einer CSV-Datei importieren. Insbesondere ist das interessant, weil man diese Definition direkt in der Datei mit dem Kontenplan abhandeln kann. Hierzu steht etwas mehr auf der Setie zur [[Einrichtung der Buchhaltung]].

=== andere Berichtsquellen als Konten ===

Im Register "Berichtsquelle" kann jedoch auch etwas anderes als ein Konto ausgewählt werden. So kann man also anstatt einer Kontenübersicht seine Kunden in einem Baum von Kundengruppen organisieren und dann eine Übersicht über die Umsätze seiner Kundengruppen erzeugen. Grundsätzlich sollte jede dieser Hierarchien es ermöglichen, einen entsprechenden Baum zu definieren.

Für fortgeschrittene Problemstellungen ist es auch möglich, für eine Dimension (z.B. für "Kunden") einen zweiten [[Baum (Fenster ID-163)|Baum]] zu definieren. Jeder Kunde kann dann je nach Berichtsanforderung in jedem Baum woanders einsortiert sein (z.B. ein Baum nach Kundengruppen, ein Baum nach Außendienst und ein Baum nach Bundesländern). Bei der Erzeugung des Berichts (im Fenster "Finanzbericht") wird man unter anderem nach einer [[Berichtshierarchie (Fenster ID-360)|Berichtshierarchie]] gefragt. Eine solche kann man anlegen, um die zu verwendenden Bäume mit unserem Bericht zu verknüpfen.

=== Tips und Tricks ===

Wer beim Druck des Finanzberichts mit der Einstellung "Quellen auflisten" einen Kontennachweis der ausgegebenen Zeilen aktiviert, wird in vielen Berichten viel zu viele Daten bekommen. Das Problem ist, das man in hierarchischen Berichten (z.B. der Bilanz) für jede Obersumme alle Konten auflistet und dann für jede Zwischensumme nochmal. Je nach Hierarchieebenen kann so jedes Konto X-mal auf dem Bericht stehen und dieser wird dadurch völlig unbrauchbar. In diesem Fall darf man nicht verzweifeln, sondern kann mit etwas liebevoller Arbeit dafür sorgen, das wirklich nur die Zeilen, von denen man einen Kontennachweis erwartet (das sind die "Blätter" der Baumhierarchie) auf "Segmentwert" gesetzt werden. Die anderen Zeilen werden dann per Formel aus den ersteren erzeugt.

Falls das nicht in einem Schritt geht (die Addition erlaubt immer nur zwei Summanden-Zeilen), muss man eben eine zusätzliche Zeile für ein Zwischenergebnis einfügen. Diese kann man dann mit dem Feld "gedruckt" so einstellen, das sie im Ausdruck nicht erscheint (sie wird aber wohl intern für die Berechnung genutzt).

Wer eine Positionszeile als "Blank line" konfiguriert, kann das Problem bekommen, das zwar in Summenspalten die Zeile ebenfalls frei ist, das aber in Prozentspalten eine "0,00" steht (ich halte das für einen Bug. Man kann das beheben, indem man nach Erzeugung des Berichts in das Druckformat geht und i, Formatelement der entsprechenden Spalte in der Anzeigelogik sowas einträgt wie "@Col_1@!0" (Den Namen der Spalte sieht man im Feld "Spalte"). Dann ist die Freizeile im Ausdruck wirklich frei.

== Definition von Spalten ([[Berichtsspaltensatz (Fenster ID-217)|Berichtsspaltensatz]]) ==

In den Spalten werden periodenbezogene Werte der Buchungszeilen zusammengeführt. Hier gibt es interessante (und ehrlich gesagt leicht verwirrende) Einstellungsmöglichkeiten.

=== Art des Betrags ===

Grundlegend wichtig ist die Spalte "Art des Betrags". Am einfachsten zu verstehen sind hier die Einstellungen '''"Soll"''' und '''"Haben"'''. Diese zählen entsprechend nur Konten zusammen, die auf der einen oder der anderen Seite stehen. Hiermit ist es möglich, diese in zwei Spalten auszugeben, wie das in kaufmännischen Berichten oft gewünscht ist.

Auch einfach ist die Einstellung '''"gebuchtes Vorzeichen"'''. Hier werden Soll-Buchungen als "+" und Haben-Buchungen als "-" betrachtet und das Ergebnis ausgegeben.

Nun ergibt sich aber z.B. in einer [[Gewinn- und Verlustrechnung]], das auf diese Art das Ergebnis "umgedreht" ist, d.h. ein Gewinn steht dort als Minus-Wert. Da das nicht so schön ist, gibt es die Einstellung '''"Saldo (erwartetes Vorzeichen)"'''. Diese dreht aber nun das Vorzeichen nicht einfach überall in dieser Spalte um sondern sie erlaubt, das Vorzeichen für jedes einzelne Konto auf die "richtige" Seite zu drehen. Das erlaubt, das im gleichen Bericht (z.B. [[Bilanz]]) manche Werte umgedreht werden (Passivbuchungen) und manche nicht (Aktivbuchungen), so das im Ergebnis die Aktiva und Passiva beide positiv sind (was ja auch der kaufmännischen Logik entspricht).

Um das zu erreichen, ist es allerdings immens wichtig, das im Kontenplan bei jedem Konto angegeben ist, was das "erwartete" Vorzeichen ist. Dort kann man die Kontenart und das Kontovorzeichen angeben. Die Grundregel hierzu ist, das alle Unterkonten eines Summenkontos die gleiche Kontenart haben müssen. Ist das nicht so, werden Soll und Haben wild durcheinanderaddiert und nichts stimmt mehr.

Außerdem gibt es die Möglichkeit, bei einzelnen (oder natürlich auch allen) Zeilen das Vorzeichen einfach umzudrehen. Dazu setzt man in der Spalte das Flag "Show Opposite Sign" UND in der Positionszeile das Flag "Show Opposite Sign". Nur, wenn beides in einem Tabellenfeld sich kreuzt, wird das Vorzeichen umgedreht. Wer das bei allen Positionssätzen anhakt, kann so natürlich auch eine ganze Spalte umdrehen, deren Ausrichtung ihm nicht gefällt (z.B. in einer GuV, die sonst einen negativen Gewinn auswirft). Siehe auch: https://wiki.idempiere.org/en/NF8.2_Reverse_Sign_In_Financial_Report_Cell

=== Spaltenart ===

Die Spaltenart kann drei Werte haben:

* '''Buchungsart''' - wird ausgewertet, wenn in der Berichtsposition nicht festgelegt.
* '''Segmentwert''' - Bei der endgültigen Erzeugung des Berichts (im Fenster Finanzbericht) muss man eine Periode angeben. Deren Gesamtwert wird dann verwendet
* '''relative Periode''' - Es wird nicht die angegebene Periode verwendet (Periodenart auf "Periode"), sondern z.B. die davor, dahinter, 12 Monate davor oder aber auch das ganze Jahr (Periodenart auf "Jahr") bzw. das Jahr davor. Hiermit sind Vergleiche zwischen verschiedenen Perioden denkbar ("dieses - letztes Jahr", "dieser Monat - ganzes Jahr" etc.). Dies wird nicht ausgewertet, wenn in der Berichtsposition bereits festgelegt wurde, welche Periodenart betrachtet werden soll.
* '''relative Periode bis''' - Es werden mehrere Perioden bis zu dieser Periode verwendet, vorausgesetzt 'relative Periode' wurde gesetzt.
* '''Berechnung''' - Die Spalte wird von anderen Spalten berechnet. Zum einen kann man hier auch über den Trick, Spalten nicht zu drucken, Ergebnisse über mehrere Rechenschritte zusammenfassen, zum anderen interessant ist hier auch, eine Spalte als '''Prozentsatz einer bestimmten Zeile''' auszugeben. So kann man in einer Kostenaufstellung (z.B. auch der [[Gewinn- und Verlustrechnung]]) die Kosten in Prozent vom gesamten Verkaufsumsatz angeben.

== weitere Hilfe und Dokumentation ==

Ein sehr schönes (englisches) Tutorial zum Thema ist [[adempiere:Financial_Report_Writer]]. Ein anderes Tutorial (das mir nicht so gut gefällt, aber etwas tiefere Informationen hat) gibt es [[http://wtcindia.wordpress.com/2011/12/07/financial-reporting-in-adempiere/ von Walking Tree]].

[[Category: Entwicklerdokumentation]]
[[Category: Anwenderhandbuch]]
[[Category: Ausgaben (drucken)]]
[[Category: Berichte]]
[[Category: Finanzberichte]]
[[Category: Buchführung]]

Finanzbericht

2021-02-04T19:33:29Z

TBayen: Freizeilen einfügen

== Was ist ein Finanzbericht? ==

Ein Finanzbericht ist ein druckbarer Bericht, der eine Zusammenfassung (nicht nur) von Finanzdaten enthält. Es kann sich um eine Kontenübersicht, eine Saldenliste, eine Bilanz oder eine Gewinn- und Verlustrechnung handeln. Alle diese Anwendungsfälle werden durch den Generator für Finanzberichte abgehandelt.

Finanzberichte (Fenster [[Finanzbericht (Fenster ID-216)]], Seitenkategorie [[:Category:Finanzberichte]]) werden benutzt, um periodengerechte Werte auszugeben oder nebeneinanderzustellen. Diese erlauben es, in einem ersten Schritt Saldierungen von Konten, Mengen, und dergleichen vorzunehmen und so z.B. Jahres-, Quartals-, Monats-, und Vorjahreswerte nebeneinanderzustellen. Klassische Beispiele sind die [[Bilanz]], die [[Gewinn- und Verlustrechnung]] aber auch viele Arten von Umsatz- und Kostenanalysen, die Gruppen von Kunden, Verkaufsmitarbeitern, Produkten, etc. gegenüberstellen.

Der Finanzbericht unterscheidet sich vom normalen Bericht (siehe [[Statistik und Berichte]]) dadurch, das keine gewöhnlichen Tabellendaten ausgegeben werden sondern sowohl die Spalten als auch die Zeilen des Berichts einzeln definiert und durch Formeln festgelegt werden können (und müssen).

Sind diese Periodenwerte entsprechend berechnet, bedienen sich die Finanzberichte für Ausgabe und Layout auch dem bekannten internen Berichtsgenerator.

Als Informatiker gesprochen gesagt dienen Finanzberichte als eine Möglichkeit, eine Art [http://de.wikipedia.org/wiki/Kreuztabelle Kreuztabellen] (ähnleich einer [http://de.wikipedia.org/wiki/Pivot-Tabelle Pivot-Tabelle]) zu berechnen. In einem ersten Schritt wird diese Kreuztabelle berechnet. Im zweiten Schritt wird diese dann über den normalen Berichtsgenerator ausgegeben (siehe also dort zur Definition von Druckformaten, Layout, etc. etc.).

Für einen Finanzbericht muss man als erstes die Zeilen und die Spalten definieren, die man ausgeben will. Die entsprechenden Fenster sind [[Berichtspositionssatz (Fenster ID-218)]] und [[Berichtsspaltensatz (Fenster ID-217)]].

== Wie funktioniert das? ==

Um das genauer zu erklären hole ich etwas aus: Ein Finanzbericht besteht aus Zeilen und Spalten. Die Spalten werden über einen sogenannten Berichtsspaltensatz (siehe [[Berichtsspaltensatz (Fenster ID-217)]]) definiert. Das ist ein Satz von Spaltendefinitionen, die z.B. bedeuten, das wir eine Jahressumme, eine Periodensumme, eine Vorjahressumme, etc. im Bericht haben wollen. Die Zeilen des Finanzreports werden über einen Reportpositionssatz definiert. Dort steht drin, welche Zeilen ("Report-Positionen") unser Bericht haben soll und aus welchen Konten er berechnet werden soll. Da steht also sowas wie "Die Zeile soll heissen 'technische Anlagen und Maschinen' und soll die Konten 0400-0599 zusammenfassen." Um nun einen Finanzbericht für die Bilanz zu erzeugen, muss man also zuerst im [[Berichtspositionssatz (Fenster ID-218)]] einen neuen Satz anlegen. Diesen kann man dann im Programm per Hand oder direkt aus der CSV-Datei füllen.

Darüber hinaus kann man noch einen [[Datenwürfel]] definieren (Das erhöht bei sehr grossen Datenmengen die Performanz, weil es die Daten verdichtet). Ist der Import abgeschlossen, kann man im Fenster [[Finanzbericht (Fenster ID-216)]] den fertigen Report aus einer Spaltensatz, einem Positionssatz und einem Report zusammenstellen. Dazu kann man nach der Anzeige des Reports noch das Druckformat anpassen wie üblich.

== Definition von Zeilen ([[Berichtspositionssatz (Fenster ID-218)|Berichtspositionssatz]]) ==

Die Zeilendaten benutzen als Basis eine der [[Buchführungsdimensionen]], die in der Tabelle der [[Buchführungsdaten Details (Fenster ID-162)|Buchführungsdaten]] benutzt werden. Der zur Erklärung einfachste Fall sind Konten. Hier benutzt der Bericht bestimmte Konten, die bekanntlich im [[Buchführungsschema (Fenster ID-125)|Buchführungsschema]], d.h. im [[Kontenplan]] angegeben werden. Wer der klassischen Installationsanleitung folgt, wird zu Beginn der Installationsanleitung eine [[Bilanz]] und eine [[Gewinn- und Verlustrechnung]] aus seinem Kontenplan generieren. Man kann aber ebenso auch eigene Berichte definieren.

Ist die "Positionsart" des Zeileneintrags "'''Segmentwert'''", so wird der Inhalt des angegebenen Kontos ausgegeben. Ist das angegebene Konto ein Summenkonto, so wird hier die Summe aller Unterkonten als eine Zeile betrachtet (bei der Erzeugung des Berichts im Fenster "Finanzbericht" kann man auswählen, ob die verwendeten Konten auch nochmal einzeln aufgeführt werden sollen).

Die Positionsart "'''Berechnung'''" bietet die Möglichkeit, die Werte anderer Zeilen zu addieren oder zu subtrahieren etc.

Wer eine '''Kommentarzeile''' oder eine '''Überschrift''' erzeugen möchte, kann eine Zeile mit der Art "Berechnung" erzeugen, ohne eine echte Formel anzugeben. Man sollte dazu den Operator auf Addieren setzen und die beiden Operanden-Felder freilassen. ''(Lässt man den Operator frei, gibt das pro Zeile eine "Störungsmeldung", die im entsprechenden Fenster zu sehen ist und im Swing-Client zu einem unangenehmen "Beep" führt.)'' Man kannn der aktuellen iDempiere-Version auch komplett freie Zeilen erzeugen mit der Positionsart "Blank Line" (siehe Tips & Tricks).

=== Import eines Finanzberichtes ===

Man kann einen Satz von Berichts-Positionen auch aus einer CSV-Datei importieren. Insbesondere ist das interessant, weil man diese Definition direkt in der Datei mit dem Kontenplan abhandeln kann. Hierzu steht etwas mehr auf der Setie zur [[Einrichtung der Buchhaltung]].

=== andere Berichtsquellen als Konten ===

Im Register "Berichtsquelle" kann jedoch auch etwas anderes als ein Konto ausgewählt werden. So kann man also anstatt einer Kontenübersicht seine Kunden in einem Baum von Kundengruppen organisieren und dann eine Übersicht über die Umsätze seiner Kundengruppen erzeugen. Grundsätzlich sollte jede dieser Hierarchien es ermöglichen, einen entsprechenden Baum zu definieren.

Für fortgeschrittene Problemstellungen ist es auch möglich, für eine Dimension (z.B. für "Kunden") einen zweiten [[Baum (Fenster ID-163)|Baum]] zu definieren. Jeder Kunde kann dann je nach Berichtsanforderung in jedem Baum woanders einsortiert sein (z.B. ein Baum nach Kundengruppen, ein Baum nach Außendienst und ein Baum nach Bundesländern). Bei der Erzeugung des Berichts (im Fenster "Finanzbericht") wird man unter anderem nach einer [[Berichtshierarchie (Fenster ID-360)|Berichtshierarchie]] gefragt. Eine solche kann man anlegen, um die zu verwendenden Bäume mit unserem Bericht zu verknüpfen.

=== Tips und Tricks ===

Wer beim Druck des Finanzberichts mit der Einstellung "Quellen auflisten" einen Kontennachweis der ausgegebenen Zeilen aktiviert, wird in vielen Berichten viel zu viele Daten bekommen. Das Problem ist, das man in hierarchischen Berichten (z.B. der Bilanz) für jede Obersumme alle Konten auflistet und dann für jede Zwischensumme nochmal. Je nach Hierarchieebenen kann so jedes Konto X-mal auf dem Bericht stehen und dieser wird dadurch völlig unbrauchbar. In diesem Fall darf man nicht verzweifeln, sondern kann mit etwas liebevoller Arbeit dafür sorgen, das wirklich nur die Zeilen, von denen man einen Kontennachweis erwartet (das sind die "Blätter" der Baumhierarchie) auf "Segmentwert" gesetzt werden. Die anderen Zeilen werden dann per Formel aus den ersteren erzeugt.

Falls das nicht in einem Schritt geht (die Addition erlaubt immer nur zwei Summanden-Zeilen), muss man eben eine zusätzliche Zeile für ein Zwischenergebnis einfügen. Diese kann man dann mit dem Feld "gedruckt" so einstellen, das sie im Ausdruck nicht erscheint (sie wird aber wohl intern für die Berechnung genutzt).

Wer eine Positionszeile als "Blank line" konfiguriert, kann das Problem bekommen, das zwar in Summenspalten die Zeile ebenfalls frei ist, das aber in Prozentspalten eine "0,00" steht (ich halte das für einen Bug. Man kann das beheben, indem man nach Erzeugung des Berichts in das Druckformat geht und i, Formatelement der entsprechenden Spalte in der Anzeigelogik sowas einträgt wie "@Col_1@!0" (Den Namen der Spalte sieht man im Feld "Spalte"). Dann ist die Freizeile im Ausdruck wirklich frei.

== Definition von Spalten ([[Berichtsspaltensatz (Fenster ID-217)|Berichtsspaltensatz]]) ==

In den Spalten werden periodenbezogene Werte der Buchungszeilen zusammengeführt. Hier gibt es interessante (und ehrlich gesagt leicht verwirrende) Einstellungsmöglichkeiten.

=== Art des Betrags ===

Grundlegend wichtig ist die Spalte "Art des Betrags". Am einfachsten zu verstehen sind hier die Einstellungen '''"Soll"''' und '''"Haben"'''. Diese zählen entsprechend nur Konten zusammen, die auf der einen oder der anderen Seite stehen. Hiermit ist es möglich, diese in zwei Spalten auszugeben, wie das in kaufmännischen Berichten oft gewünscht ist.

Auch einfach ist die Einstellung '''"gebuchtes Vorzeichen"'''. Hier werden Soll-Buchungen als "+" und Haben-Buchungen als "-" betrachtet und das Ergebnis ausgegeben.

Nun ergibt sich aber z.B. in einer [[Gewinn- und Verlustrechnung]], das auf diese Art das Ergebnis "umgedreht" ist, d.h. ein Gewinn steht dort als Minus-Wert. Da das nicht so schön ist, gibt es die Einstellung '''"Saldo (erwartetes Vorzeichen)"'''. Diese dreht aber nun das Vorzeichen nicht einfach überall in dieser Spalte um sondern sie erlaubt, das Vorzeichen für jedes einzelne Konto auf die "richtige" Seite zu drehen. Das erlaubt, das im gleichen Bericht (z.B. [[Bilanz]]) manche Werte umgedreht werden (Passivbuchungen) und manche nicht (Aktivbuchungen), so das im Ergebnis die Aktiva und Passiva beide positiv sind (was ja auch der kaufmännischen Logik entspricht).

Um das zu erreichen, ist es allerdings immens wichtig, das im Kontenplan bei jedem Konto angegeben ist, was das "erwartete" Vorzeichen ist. Dort kann man die Kontenart und das Kontovorzeichen angeben. Die Grundregel hierzu ist, das alle Unterkonten eines Summenkontos die gleiche Kontenart haben müssen. Ist das nicht so, werden Soll und Haben wild durcheinanderaddiert und nichts stimmt mehr.

=== Spaltenart ===

Die Spaltenart kann drei Werte haben:

* '''Buchungsart''' - wird ausgewertet, wenn in der Berichtsposition nicht festgelegt.
* '''Segmentwert''' - Bei der endgültigen Erzeugung des Berichts (im Fenster Finanzbericht) muss man eine Periode angeben. Deren Gesamtwert wird dann verwendet
* '''relative Periode''' - Es wird nicht die angegebene Periode verwendet (Periodenart auf "Periode"), sondern z.B. die davor, dahinter, 12 Monate davor oder aber auch das ganze Jahr (Periodenart auf "Jahr") bzw. das Jahr davor. Hiermit sind Vergleiche zwischen verschiedenen Perioden denkbar ("dieses - letztes Jahr", "dieser Monat - ganzes Jahr" etc.). Dies wird nicht ausgewertet, wenn in der Berichtsposition bereits festgelegt wurde, welche Periodenart betrachtet werden soll.
* '''relative Periode bis''' - Es werden mehrere Perioden bis zu dieser Periode verwendet, vorausgesetzt 'relative Periode' wurde gesetzt.
* '''Berechnung''' - Die Spalte wird von anderen Spalten berechnet. Zum einen kann man hier auch über den Trick, Spalten nicht zu drucken, Ergebnisse über mehrere Rechenschritte zusammenfassen, zum anderen interessant ist hier auch, eine Spalte als '''Prozentsatz einer bestimmten Zeile''' auszugeben. So kann man in einer Kostenaufstellung (z.B. auch der [[Gewinn- und Verlustrechnung]]) die Kosten in Prozent vom gesamten Verkaufsumsatz angeben.

== weitere Hilfe und Dokumentation ==

Ein sehr schönes (englisches) Tutorial zum Thema ist [[adempiere:Financial_Report_Writer]]. Ein anderes Tutorial (das mir nicht so gut gefällt, aber etwas tiefere Informationen hat) gibt es [[http://wtcindia.wordpress.com/2011/12/07/financial-reporting-in-adempiere/ von Walking Tree]].

[[Category: Entwicklerdokumentation]]
[[Category: Anwenderhandbuch]]
[[Category: Ausgaben (drucken)]]
[[Category: Berichte]]
[[Category: Finanzberichte]]
[[Category: Buchführung]]

Finanzbericht

2021-02-04T19:20:44Z

TBayen: /* Wie funktioniert das? */

== Was ist ein Finanzbericht? ==

Ein Finanzbericht ist ein druckbarer Bericht, der eine Zusammenfassung (nicht nur) von Finanzdaten enthält. Es kann sich um eine Kontenübersicht, eine Saldenliste, eine Bilanz oder eine Gewinn- und Verlustrechnung handeln. Alle diese Anwendungsfälle werden durch den Generator für Finanzberichte abgehandelt.

Finanzberichte (Fenster [[Finanzbericht (Fenster ID-216)]], Seitenkategorie [[:Category:Finanzberichte]]) werden benutzt, um periodengerechte Werte auszugeben oder nebeneinanderzustellen. Diese erlauben es, in einem ersten Schritt Saldierungen von Konten, Mengen, und dergleichen vorzunehmen und so z.B. Jahres-, Quartals-, Monats-, und Vorjahreswerte nebeneinanderzustellen. Klassische Beispiele sind die [[Bilanz]], die [[Gewinn- und Verlustrechnung]] aber auch viele Arten von Umsatz- und Kostenanalysen, die Gruppen von Kunden, Verkaufsmitarbeitern, Produkten, etc. gegenüberstellen.

Der Finanzbericht unterscheidet sich vom normalen Bericht (siehe [[Statistik und Berichte]]) dadurch, das keine gewöhnlichen Tabellendaten ausgegeben werden sondern sowohl die Spalten als auch die Zeilen des Berichts einzeln definiert und durch Formeln festgelegt werden können (und müssen).

Sind diese Periodenwerte entsprechend berechnet, bedienen sich die Finanzberichte für Ausgabe und Layout auch dem bekannten internen Berichtsgenerator.

Als Informatiker gesprochen gesagt dienen Finanzberichte als eine Möglichkeit, eine Art [http://de.wikipedia.org/wiki/Kreuztabelle Kreuztabellen] (ähnleich einer [http://de.wikipedia.org/wiki/Pivot-Tabelle Pivot-Tabelle]) zu berechnen. In einem ersten Schritt wird diese Kreuztabelle berechnet. Im zweiten Schritt wird diese dann über den normalen Berichtsgenerator ausgegeben (siehe also dort zur Definition von Druckformaten, Layout, etc. etc.).

Für einen Finanzbericht muss man als erstes die Zeilen und die Spalten definieren, die man ausgeben will. Die entsprechenden Fenster sind [[Berichtspositionssatz (Fenster ID-218)]] und [[Berichtsspaltensatz (Fenster ID-217)]].

== Wie funktioniert das? ==

Um das genauer zu erklären hole ich etwas aus: Ein Finanzbericht besteht aus Zeilen und Spalten. Die Spalten werden über einen sogenannten Berichtsspaltensatz (siehe [[Berichtsspaltensatz (Fenster ID-217)]]) definiert. Das ist ein Satz von Spaltendefinitionen, die z.B. bedeuten, das wir eine Jahressumme, eine Periodensumme, eine Vorjahressumme, etc. im Bericht haben wollen. Die Zeilen des Finanzreports werden über einen Reportpositionssatz definiert. Dort steht drin, welche Zeilen ("Report-Positionen") unser Bericht haben soll und aus welchen Konten er berechnet werden soll. Da steht also sowas wie "Die Zeile soll heissen 'technische Anlagen und Maschinen' und soll die Konten 0400-0599 zusammenfassen." Um nun einen Finanzbericht für die Bilanz zu erzeugen, muss man also zuerst im [[Berichtspositionssatz (Fenster ID-218)]] einen neuen Satz anlegen. Diesen kann man dann im Programm per Hand oder direkt aus der CSV-Datei füllen.

Darüber hinaus kann man noch einen [[Datenwürfel]] definieren (Das erhöht bei sehr grossen Datenmengen die Performanz, weil es die Daten verdichtet). Ist der Import abgeschlossen, kann man im Fenster [[Finanzbericht (Fenster ID-216)]] den fertigen Report aus einer Spaltensatz, einem Positionssatz und einem Report zusammenstellen. Dazu kann man nach der Anzeige des Reports noch das Druckformat anpassen wie üblich.

== Definition von Zeilen ([[Berichtspositionssatz (Fenster ID-218)|Berichtspositionssatz]]) ==

Die Zeilendaten benutzen als Basis eine der [[Buchführungsdimensionen]], die in der Tabelle der [[Buchführungsdaten Details (Fenster ID-162)|Buchführungsdaten]] benutzt werden. Der zur Erklärung einfachste Fall sind Konten. Hier benutzt der Bericht bestimmte Konten, die bekanntlich im [[Buchführungsschema (Fenster ID-125)|Buchführungsschema]], d.h. im [[Kontenplan]] angegeben werden. Wer der klassischen Installationsanleitung folgt, wird zu Beginn der Installationsanleitung eine [[Bilanz]] und eine [[Gewinn- und Verlustrechnung]] aus seinem Kontenplan generieren. Man kann aber ebenso auch eigene Berichte definieren.

Ist die "Positionsart" des Zeileneintrags "'''Segmentwert'''", so wird der Inhalt des angegebenen Kontos ausgegeben. Ist das angegebene Konto ein Summenkonto, so wird hier die Summe aller Unterkonten als eine Zeile betrachtet (bei der Erzeugung des Berichts im Fenster "Finanzbericht" kann man auswählen, ob die verwendeten Konten auch nochmal einzeln aufgeführt werden sollen).

Die Positionsart "'''Berechnung'''" bietet die Möglichkeit, die Werte anderer Zeilen zu addieren oder zu subtrahieren etc.

Wer eine '''Kommentarzeile''' oder eine '''Überschrift''' erzeugen möchte, kann eine Zeile mit der Art "Berechnung" erzeugen, ohne eine echte Formel anzugeben. Man sollte dazu den Operator auf Addieren setzen und die beiden Operanden-Felder freilassen. ''(Lässt man den Operator frei, gibt das pro Zeile eine "Störungsmeldung", die im entsprechenden Fenster zu sehen ist und im Swing-Client zu einem unangenehmen "Beep" führt.)''

=== Import eines Finanzberichtes ===

Man kann einen Satz von Berichts-Positionen auch aus einer CSV-Datei importieren. Insbesondere ist das interessant, weil man diese Definition direkt in der Datei mit dem Kontenplan abhandeln kann. Hierzu steht etwas mehr auf der Setie zur [[Einrichtung der Buchhaltung]].

=== andere Berichtsquellen als Konten ===

Im Register "Berichtsquelle" kann jedoch auch etwas anderes als ein Konto ausgewählt werden. So kann man also anstatt einer Kontenübersicht seine Kunden in einem Baum von Kundengruppen organisieren und dann eine Übersicht über die Umsätze seiner Kundengruppen erzeugen. Grundsätzlich sollte jede dieser Hierarchien es ermöglichen, einen entsprechenden Baum zu definieren.

Für fortgeschrittene Problemstellungen ist es auch möglich, für eine Dimension (z.B. für "Kunden") einen zweiten [[Baum (Fenster ID-163)|Baum]] zu definieren. Jeder Kunde kann dann je nach Berichtsanforderung in jedem Baum woanders einsortiert sein (z.B. ein Baum nach Kundengruppen, ein Baum nach Außendienst und ein Baum nach Bundesländern). Bei der Erzeugung des Berichts (im Fenster "Finanzbericht") wird man unter anderem nach einer [[Berichtshierarchie (Fenster ID-360)|Berichtshierarchie]] gefragt. Eine solche kann man anlegen, um die zu verwendenden Bäume mit unserem Bericht zu verknüpfen.

=== Tips und Tricks ===

Wer beim Druck des Finanzberichts mit der Einstellung "Quellen auflisten" einen Kontennachweis der ausgegebenen Zeilen aktiviert, wird in vielen Berichten viel zu viele Daten bekommen. Das Problem ist, das man in hierarchischen Berichten (z.B. der Bilanz) für jede Obersumme alle Konten auflistet und dann für jede Zwischensumme nochmal. Je nach Hierarchieebenen kann so jedes Konto X-mal auf dem Bericht stehen und dieser wird dadurch völlig unbrauchbar. In diesem Fall darf man nicht verzweifeln, sondern kann mit etwas liebevoller Arbeit dafür sorgen, das wirklich nur die Zeilen, von denen man einen Kontennachweis erwartet (das sind die "Blätter" der Baumhierarchie) auf "Segmentwert" gesetzt werden. Die anderen Zeilen werden dann per Formel aus den ersteren erzeugt.

Falls das nicht in einem Schritt geht (die Addition erlaubt immer nur zwei Summanden-Zeilen), muss man eben eine zusätzliche Zeile für ein Zwischenergebnis einfügen. Diese kann man dann mit dem Feld "gedruckt" so einstellen, das sie im Ausdruck nicht erscheint (sie wird aber wohl intern für die Berechnung genutzt).

== Definition von Spalten ([[Berichtsspaltensatz (Fenster ID-217)|Berichtsspaltensatz]]) ==

In den Spalten werden periodenbezogene Werte der Buchungszeilen zusammengeführt. Hier gibt es interessante (und ehrlich gesagt leicht verwirrende) Einstellungsmöglichkeiten.

=== Art des Betrags ===

Grundlegend wichtig ist die Spalte "Art des Betrags". Am einfachsten zu verstehen sind hier die Einstellungen '''"Soll"''' und '''"Haben"'''. Diese zählen entsprechend nur Konten zusammen, die auf der einen oder der anderen Seite stehen. Hiermit ist es möglich, diese in zwei Spalten auszugeben, wie das in kaufmännischen Berichten oft gewünscht ist.

Auch einfach ist die Einstellung '''"gebuchtes Vorzeichen"'''. Hier werden Soll-Buchungen als "+" und Haben-Buchungen als "-" betrachtet und das Ergebnis ausgegeben.

Nun ergibt sich aber z.B. in einer [[Gewinn- und Verlustrechnung]], das auf diese Art das Ergebnis "umgedreht" ist, d.h. ein Gewinn steht dort als Minus-Wert. Da das nicht so schön ist, gibt es die Einstellung '''"Saldo (erwartetes Vorzeichen)"'''. Diese dreht aber nun das Vorzeichen nicht einfach überall in dieser Spalte um sondern sie erlaubt, das Vorzeichen für jedes einzelne Konto auf die "richtige" Seite zu drehen. Das erlaubt, das im gleichen Bericht (z.B. [[Bilanz]]) manche Werte umgedreht werden (Passivbuchungen) und manche nicht (Aktivbuchungen), so das im Ergebnis die Aktiva und Passiva beide positiv sind (was ja auch der kaufmännischen Logik entspricht).

Um das zu erreichen, ist es allerdings immens wichtig, das im Kontenplan bei jedem Konto angegeben ist, was das "erwartete" Vorzeichen ist. Dort kann man die Kontenart und das Kontovorzeichen angeben. Die Grundregel hierzu ist, das alle Unterkonten eines Summenkontos die gleiche Kontenart haben müssen. Ist das nicht so, werden Soll und Haben wild durcheinanderaddiert und nichts stimmt mehr.

=== Spaltenart ===

Die Spaltenart kann drei Werte haben:

* '''Buchungsart''' - wird ausgewertet, wenn in der Berichtsposition nicht festgelegt.
* '''Segmentwert''' - Bei der endgültigen Erzeugung des Berichts (im Fenster Finanzbericht) muss man eine Periode angeben. Deren Gesamtwert wird dann verwendet
* '''relative Periode''' - Es wird nicht die angegebene Periode verwendet (Periodenart auf "Periode"), sondern z.B. die davor, dahinter, 12 Monate davor oder aber auch das ganze Jahr (Periodenart auf "Jahr") bzw. das Jahr davor. Hiermit sind Vergleiche zwischen verschiedenen Perioden denkbar ("dieses - letztes Jahr", "dieser Monat - ganzes Jahr" etc.). Dies wird nicht ausgewertet, wenn in der Berichtsposition bereits festgelegt wurde, welche Periodenart betrachtet werden soll.
* '''relative Periode bis''' - Es werden mehrere Perioden bis zu dieser Periode verwendet, vorausgesetzt 'relative Periode' wurde gesetzt.
* '''Berechnung''' - Die Spalte wird von anderen Spalten berechnet. Zum einen kann man hier auch über den Trick, Spalten nicht zu drucken, Ergebnisse über mehrere Rechenschritte zusammenfassen, zum anderen interessant ist hier auch, eine Spalte als '''Prozentsatz einer bestimmten Zeile''' auszugeben. So kann man in einer Kostenaufstellung (z.B. auch der [[Gewinn- und Verlustrechnung]]) die Kosten in Prozent vom gesamten Verkaufsumsatz angeben.

== weitere Hilfe und Dokumentation ==

Ein sehr schönes (englisches) Tutorial zum Thema ist [[adempiere:Financial_Report_Writer]]. Ein anderes Tutorial (das mir nicht so gut gefällt, aber etwas tiefere Informationen hat) gibt es [[http://wtcindia.wordpress.com/2011/12/07/financial-reporting-in-adempiere/ von Walking Tree]].

[[Category: Entwicklerdokumentation]]
[[Category: Anwenderhandbuch]]
[[Category: Ausgaben (drucken)]]
[[Category: Berichte]]
[[Category: Finanzberichte]]
[[Category: Buchführung]]

LdapTelefonverzeichnis

2020-11-20T11:31:44Z

TBayen:

= LDAP Telefonverzeichnis =

== Unsere Aufgabenstellung ==

In unserem Unternehmen benutzen wir eine auf Asterisk basierende Telefonanlage mit VoIP-Telefonen von Snom. Wir haben über verschiedene Wege nachgedacht, die Anlage mit iDempiere zu verknüpfen.

In unserem Fall ist es so, das wir relativ viele Anrufe von bereits bekannten Kunden mit Bestellungen bekommen. Das Ziel sollte sein, das wir Kunden schnell und ohne viel Aufwand erkennen, wenn sie anrufen und der richtigen Kundennummer zuordnen.

Zuerst hatten wir die Idee, irgendwie automatisch eine Bestellung zu öffnen, wenn ein Anruf angenommen wird. Allerdings gibt es sehr viele Anrufe, die sich nicht direkt mit einer neuen Bestellung beschäftigen. Das zuzuordnen bzw. dafür eine GUI zu erstellen, erschien und wieder recht unübersichtlich. Wir sind dann darauf gekommen, das es eigentlich reicht, wenn wir den Namen des Kunden, seine Firma sowie die Kundennummer angezeigt bekommen.

== Die Lösung ==

iDempiere wird zu einem LDAP-Server

Ich habe einen LDAP-Server aufgesetzt, der seine Verzeichnisdaten direkt aus der iDempiere-Datenbank holt. Die Snom-Telefone können nun so eingestellt werden, das sie bei jedem Anruf direkt in das Verzeichnis schauen und dann im Display den Namen und die Kundennummer anzeigen wie gewünscht.

Ein LDAP-Server ist ein Verzeichnisdienst. Dieser kann alle möglichen Arten von strukturierten Daten verwalten, arbeitet allerdings mit grundsätzlich ziemlich flexiblen Datenstrukturen, die nicht so leicht als relationale Daten abzuspeichern sind. In der Praxis werden LDAP-Server vor allem benutzt, um Benutzer in komplexeren IT-Umgebungen zu verwalten. Oft dienen sie aber auch der Verwaltung von Kontaktdaten. In diesem Sinne gibt es eine LDAP-Konfiguration in den Snom-Telefonen, die auf solche Kontaktdaten zugreifen kann.

=== vorher: ===

[[File:Snom385AnrufOhneLDAP.png]]

=== nachher: ===

[[File:Snom385AnrufMitDAP.png]]

(Der Text scrollt übrigens durch, deshalb ist der Name hier vorne und hinten "abgeschnitten").

== technische Umsetzung ==

Ich habe auf einer eigenen virtuellen Maschine (muss nicht zwingend sein) einen OpenLDAP-Server aufgesetzt. Dieser verfügt über ein Backend namens slapd-sql, das es erlaubt, eingehende Verzeichnis-Anfragen für den LDAP-Server umzuschreiben und an die PostgreSQL-Datenbank zu senden. Das Ergebnis wird dann als LDAP-Antwort an den Client (das Telefon) zurückgegeben.

Leider scheint es nicht sehr viele Anwender von slapd-sql zu geben. Allerdings habe ich es hinbekommen, die Anfragen so zu gestalten, wie ich möchte. Insbesondere habe ich die verschiedenen Namen (Kontakt und Geschäftspartner) und die Kundennummer ohne Probleme kombinieren können.

== Dokumentation ==

Die exakte Dokumentation, was ich wie gemacht habe, habe ich als PDF geschrieben:

[[Media:IT LDAP Telefonbuch.pdf]]

== Besonderheiten ==

* Die Schnittstelle vonm slapd-sql erlaubt es grundsätzlich auch, schreibend auf die LDAP-Daten zuzugreifen. Das habe ich bei meiner Umsetzung nicht erlaubt. Die Pflege der Daten findet ausschließlich in iDempiere statt. Bei anderen Anwendungen des LDAP-Servers ist es denkbar, das ebenfalls zu implementieren (z.B. Änderung von Kontaktdaten in Thunderbird). Ob das wünschenswert ist, muss jeder selber wissen.

* Mit ein wenig Herumprobieren gelang es mir auch, Bilder anzuzeigen. Wichtig ist u.a., das diese richtigen Format vorliegen (http://wiki.snom.com/Category:HowTo:Caller_Picture).

* Die Filter-Engine von OpenLDAP hat Probleme, bestimmte Datentypen zu erlauben, die illegale Zeichen enthalten. Deshalb formen meine SQL-Queries diese jeweils um. Das betrifft z.B. "/" in Telefonnummern und "," in Namen. (Keine Ahnung, ob diese Restriktion wirklich vom Datentyp abhängig ist oder ggf. für alle Felder gilt.)

LdapTelefonverzeichnis

2020-11-20T11:27:15Z

TBayen:

= LDAP Telefonverzeichnis =

== Unsere Aufgabenstellung ==

In unserem Unternehmen benutzen wir eine auf Asterisk basierende Telefonanlage mit VoIP-Telefonen von Snom. Wir haben über verschiedene Wege nachgedacht, die Anlage mit iDempiere zu verknüpfen.

In unserem Fall ist es so, das wir relativ viele Anrufe von bereits bekannten Kunden mit Bestellungen bekommen. Das Ziel sollte sein, das wir Kunden schnell und ohne viel Aufwand erkennen, wenn sie anrufen und der richtigen Kundennummer zuordnen.

Zuerst hatten wir die Idee, irgendwie automatisch eine Bestellung zu öffnen, wenn ein Anruf angenommen wird. Allerdings gibt es sehr viele Anrufe, die sich nicht direkt mit einer neuen Bestellung beschäftigen. Das zuzuordnen bzw. dafür eine GUI zu erstellen, erschien und wieder recht unübersichtlich. Wir sind dann darauf gekommen, das es eigentlich reicht, wenn wir den Namen des Kunden, seine Firma sowie die Kundennummer angezeigt bekommen.

== Die Lösung ==

iDempiere wird zu einem LDAP-Server

Ich habe einen LDAP-Server aufgesetzt, der seine Verzeichnisdaten direkt aus der iDempiere-Datenbank holt. Die Snom-Telefone können nun so eingestellt werden, das sie bei jedem Anruf direkt in das Verzeichnis schauen und dann im Display den Namen und die Kundennummer anzeigen wie gewünscht.

Ein LDAP-Server ist ein Verzeichnisdienst. Dieser kann alle möglichen Arten von strukturierten Daten verwalten, arbeitet allerdings mit grundsätzlich ziemlich flexiblen Datenstrukturen, die nicht so leicht als relationale Daten abzuspeichern sind. In der Praxis werden LDAP-Server vor allem benutzt, um Benutzer in komplexeren IT-Umgebungen zu verwalten. Oft dienen sie aber auch der Verwaltung von Kontaktdaten. In diesem Sinne gibt es eine LDAP-Konfiguration in den Snom-Telefonen, die auf solche Kontaktdaten zugreifen kann.

=== vorher ===

[[File:Snom385AnrufOhneLDAP.png]]

=== nachher ===

[[File:Snom385AnrufMitDAP.png]]

(Der Text scrollt übrigens durch, deshalb ist der Name hier vorne und hinten "abgeschnitten").

== technische Umsetzung ==

Ich habe auf einer eigenen virtuellen Maschine (muss nicht zwingend sein) einen OpenLDAP-Server aufgesetzt. Dieser verfügt über ein Backend namens slapd-sql, das es erlaubt, eingehende Verzeichnis-Anfragen für den LDAP-Server umzuschreiben und an die PostgreSQL-Datenbank zu senden. Das Ergebnis wird dann als LDAP-Antwort an den Client (das Telefon) zurückgegeben.

Leider scheint es nicht sehr viele Anwender von slapd-sql zu geben. Allerdings habe ich es hinbekommen, die Anfragen so zu gestalten, wie ich möchte. Insbesondere habe ich die verschiedenen Namen (Kontakt und Geschäftspartner) und die Kundennummer ohne Probleme kombinieren können.

== Dokumentation ==

Die exakte Dokumentation, was ich wie gemacht habe, habe ich als PDF geschrieben:

[[File:IT_LDAP_Telefonbuch.png]]

== Besonderheiten ==

* Die Schnittstelle vonm slapd-sql erlaubt es grundsätzlich auch, schreibend auf die LDAP-Daten zuzugreifen. Das habe ich bei meiner Umsetzung nicht erlaubt. Die Pflege der Daten findet ausschließlich in iDempiere statt. Bei anderen Anwendungen des LDAP-Servers ist es denkbar, das ebenfalls zu implementieren (z.B. Änderung von Kontaktdaten in Thunderbird). Ob das wünschenswert ist, muss jeder selber wissen.

* Mit ein wenig Herumprobieren gelang es mir auch, Bilder anzuzeigen. Wichtig ist u.a., das diese richtigen Format vorliegen (http://wiki.snom.com/Category:HowTo:Caller_Picture).

* Die Filter-Engine von OpenLDAP hat Probleme, bestimmte Datentypen zu erlauben, die illegale Zeichen enthalten. Deshalb formen meine SQL-Queries diese jeweils um. Das betrifft z.B. "/" in Telefonnummern und "," in Namen. (Keine Ahnung, ob diese Restriktion wirklich vom Datentyp abhängig ist oder ggf. für alle Felder gilt.)

LdapTelefonverzeichnis

2020-11-20T11:26:07Z

TBayen:

= LDAP Telefonverzeichnis =

== Unsere Aufgabenstellung ==

In unserem Unternehmen benutzen wir eine auf Asterisk basierende Telefonanlage mit VoIP-Telefonen von Snom. Wir haben über verschiedene Wege nachgedacht, die Anlage mit iDempiere zu verknüpfen.

In unserem Fall ist es so, das wir relativ viele Anrufe von bereits bekannten Kunden mit Bestellungen bekommen. Das Ziel sollte sein, das wir Kunden schnell und ohne viel Aufwand erkennen, wenn sie anrufen und der richtigen Kundennummer zuordnen.

Zuerst hatten wir die Idee, irgendwie automatisch eine Bestellung zu öffnen, wenn ein Anruf angenommen wird. Allerdings gibt es sehr viele Anrufe, die sich nicht direkt mit einer neuen Bestellung beschäftigen. Das zuzuordnen bzw. dafür eine GUI zu erstellen, erschien und wieder recht unübersichtlich. Wir sind dann darauf gekommen, das es eigentlich reicht, wenn wir den Namen des Kunden, seine Firma sowie die Kundennummer angezeigt bekommen.

== Die Lösung ==

iDempiere wird zu einem LDAP-Server

Ich habe einen LDAP-Server aufgesetzt, der seine Verzeichnisdaten direkt aus der iDempiere-Datenbank holt. Die Snom-Telefone können nun so eingestellt werden, das sie bei jedem Anruf direkt in das Verzeichnis schauen und dann im Display den Namen und die Kundennummer anzeigen wie gewünscht.

Ein LDAP-Server ist ein Verzeichnisdienst. Dieser kann alle möglichen Arten von strukturierten Daten verwalten, arbeitet allerdings mit grundsätzlich ziemlich flexiblen Datenstrukturen, die nicht so leicht als relationale Daten abzuspeichern sind. In der Praxis werden LDAP-Server vor allem benutzt, um Benutzer in komplexeren IT-Umgebungen zu verwalten. Oft dienen sie aber auch der Verwaltung von Kontaktdaten. In diesem Sinne gibt es eine LDAP-Konfiguration in den Snom-Telefonen, die auf solche Kontaktdaten zugreifen kann.

=== vorher ===

[[File:Snom385AnrufOhneLDAP.png]]

=== nachher ===

[[File:Snom385AnrufMitLDAP.png]]

(Der Text scrollt übrigens durch, deshalb ist der Name hier vorne und hinten "abgeschnitten").

== technische Umsetzung ==

Ich habe auf einer eigenen virtuellen Maschine (muss nicht zwingend sein) einen OpenLDAP-Server aufgesetzt. Dieser verfügt über ein Backend namens slapd-sql, das es erlaubt, eingehende Verzeichnis-Anfragen für den LDAP-Server umzuschreiben und an die PostgreSQL-Datenbank zu senden. Das Ergebnis wird dann als LDAP-Antwort an den Client (das Telefon) zurückgegeben.

Leider scheint es nicht sehr viele Anwender von slapd-sql zu geben. Allerdings habe ich es hinbekommen, die Anfragen so zu gestalten, wie ich möchte. Insbesondere habe ich die verschiedenen Namen (Kontakt und Geschäftspartner) und die Kundennummer ohne Probleme kombinieren können.

== Dokumentation ==

Die exakte Dokumentation, was ich wie gemacht habe, habe ich als PDF geschrieben:

[[File:IT_LDAP_Telefonbuch.png]]

== Besonderheiten ==

* Die Schnittstelle vonm slapd-sql erlaubt es grundsätzlich auch, schreibend auf die LDAP-Daten zuzugreifen. Das habe ich bei meiner Umsetzung nicht erlaubt. Die Pflege der Daten findet ausschließlich in iDempiere statt. Bei anderen Anwendungen des LDAP-Servers ist es denkbar, das ebenfalls zu implementieren (z.B. Änderung von Kontaktdaten in Thunderbird). Ob das wünschenswert ist, muss jeder selber wissen.

* Mit ein wenig Herumprobieren gelang es mir auch, Bilder anzuzeigen. Wichtig ist u.a., das diese richtigen Format vorliegen (http://wiki.snom.com/Category:HowTo:Caller_Picture).

* Die Filter-Engine von OpenLDAP hat Probleme, bestimmte Datentypen zu erlauben, die illegale Zeichen enthalten. Deshalb formen meine SQL-Queries diese jeweils um. Das betrifft z.B. "/" in Telefonnummern und "," in Namen. (Keine Ahnung, ob diese Restriktion wirklich vom Datentyp abhängig ist oder ggf. für alle Felder gilt.)

Datei:IT LDAP Telefonbuch.pdf

2020-11-20T11:22:16Z

TBayen: Genaue Dokumentation für die Wikiseite LDAPTelefonbuch

== Beschreibung ==
Genaue Dokumentation für die Wikiseite LDAPTelefonbuch

Datei:Snom385AnrufMitDAP.png

2020-11-20T10:57:53Z

TBayen: Screenshot from Thomas Bayen's Snom Phone

== Beschreibung ==
Screenshot from Thomas Bayen's Snom Phone

Datei:Snom385AnrufOhneLDAP.png

2020-11-20T10:57:21Z

TBayen: Screenshot from Thomas Bayen's Snom Phone

== Beschreibung ==
Screenshot from Thomas Bayen's Snom Phone

LdapTelefonverzeichnis

2020-11-20T10:51:19Z

TBayen: Vorstellung meiner OpenLDAP-Anbindung

Benutzer:TBayen

2020-11-20T10:14:15Z

TBayen: neuer Link zur Seite über mein LDAP Telefonverzeichnis

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
** [[Inventur]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
** [[Tiny iDempiere]]
* Dokumentation
** [[Anwenderhandbuch mit DocBook erstellen]]
** [[Anwenderhandbuch]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
** [[Mehrwährungsfähigkeit]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
* Verbindung zu anderer Software
** [[direktes Schreiben in die Datenbank]]
** [[WebServices]]
** [[LdapTelefonverzeichnis]]
* [[Vereinsverwaltung]]

Anwenderhandbuch

2016-12-08T16:04:36Z

TBayen: Installation for newbies

= Anwenderhandbuch =

To prepare some thoughts about a better documentation of iDempiere I started this page to think about scope and content of such a document. This page may be written in german and/or english.

= index =

* ...
* ...
* ...

= features =

Multi-Language approach (english and german for the beginning)

= technology =

Possible platforms
* OpenOffice Writer
* DocBook
* HTML

= suggestions =

== Installation ==

We can try documenting every way of installing iDempiere. If we do that we will have an outdated book using a unique version of PostgreSQL, Windows, Browser and whatever. And we do not really solve the problems that people have today. Perhaps we find a way to install iDempiere in an not-outdating, newbie-proof way. Some ideas are:
* Easy cloud installation on amazon standard server
* allow a test client for new users for free on demo.idempiere.org (that will cost us money)
* creating a virtual machine that can be used with VirtualBox or whatever on the user's own computer

Anwenderhandbuch

2016-12-08T15:42:45Z

TBayen: Some ideas to show what it is about

Anwenderhandbuch

2016-12-08T15:36:42Z

TBayen: First start of this page

= Anwenderhandbuch =

To prepare some thoughts about a better documentation of iDempiere I started this page to think about scope and content of such a document.

Benutzer:TBayen

2016-12-08T15:34:45Z

TBayen: Links hinzugefügt

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
** [[Inventur]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
** [[Tiny iDempiere]]
* Dokumentation
** [[Anwenderhandbuch mit DocBook erstellen]]
** [[Anwenderhandbuch]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
** [[Mehrwährungsfähigkeit]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

Mehrwährungsfähigkeit

2016-02-11T16:51:40Z

TBayen: Die Seite wurde neu angelegt: „Um die Installation so einfach wie möglich zu halten, habe ich eine Installation zu Beginn erst einmal nur in einer Sprache und mit einer Währung (dem Euro) …“

Um die Installation so einfach wie möglich zu halten, habe ich eine Installation zu Beginn erst einmal nur in einer Sprache und mit einer Währung (dem Euro) eingerichtet. Nach einiger Zeit kam dann allerdings der erste Kunde, der seine Preise in US-Dollar verhandeln wollte. Natürlich beherrscht unser ERP-System dies ohne Probleme.

== Vorbemerkung zur Systemkonfiguration ==

Einige Dinge sollten im Systemmandanten richtiggestellt werden. Zuerst gehen wir in das Fenster "Währung" und rufen dort den Datensatz "USD" auf. Unten im ersten TAb stehen Exchange Rates. Früher war da mal eine voreingestellt; seit einigen Versionen ist dieser Datensatz dort gelöscht, was auch sinnvoll ist. Falls dort also ein Eintrag des Systemmandanten steht, diesen bitte entfernen.

Im Fenster Währung für den Euro "EUR" ist als Symbol "E" eingetragen und nicht "€". Das sollte man verbessern. Das hilft dem Bericht, das richtige Währungssymbol anzuzeigen.

== Einrichtung ==

Folgende Dinge müssen einmal ordentlich konfiguriert werden, um die Mehrwährungsfähigkeit zu aktivieren:

=== Preisliste ===

* Eine Preisliste in Dollar muss angelegt werden. Diese bekommt z.B. den Namen "USD Preisliste". Diese wiederum erhält eine Preislistenversion.

* Im Fenster Währung schlägt man die Währung USD auf und geht in das erste Tab "Exchange Rate". Dort trägt man einen Umrechnungskurs ein. Als Start- und Enddatum empfehle ich das heutige Datum, da es sich ja zumeist um einen aktuell ermittelten Tageskurs handelt. Wer möchte und der Stabilität des Kurses vertraut, kann hier aber auch einen Zeitraum von z.B. einer Woche oder gar einem Monat angeben.

=== Artikel und Geschäftspartner ===

Da wir bis hierhin nur Multicurrency und nicht Multilanguage benutzen wollen, bietet es sich u.U. an, für englische Kunden eigene Artikel anzulegen, die dann englische Bezeichnungen haben. Das muss allerdings nicht zwingend sein. Man kann auch Artikel mit international einheitlichen Bezeichnungen vermarkten.

* Dieser Artikel erhält nun einen Preis in der neuen Preislisten-Version. Grundsätzlich ist es möglich, die USD-Preisliste ausgehend von der Euro-Preisliste mit einer Umrechnung zu kopieren. In unserem Fall wurden die PReise mit dem US-Kunden sowieso neu verhandelt, so das dort sowieso ein komplett eigener Preis eingegeben wurde. Außerdem ergab sich für uns später der Vorteil (oder Nachteil - wie man es sieht), das nur die Artikel für diesen Kunden eingegeben werden können, die auch einen Preis in USD haben.

* Neuer Geschäftspartner. Wie immer Name und Adresse eingeben. Dann wähle ich die vorher eingerichtete Preisliste aus. Das war es dann schon.

== Rechnung schreiben ==

Sobald ich eine Rechnung für den neuen Geschäftspartner schreibe, wird diese in USD berechnet. Das war es eigentlich schon.

== zusätzliche Übersetzung in die Sprache des Kunden ==

Darüber hinaus kann man überlegen, ob man die Sprache des Geschäftspartners für die Rechnung auf englisch stellt. Auch ohne, das man das komplette Programm auf mehrsprachigkeit umstellt, ergibt sich hierdurch die Möglichkeit, das Druckformular an sich zu übersetzen. Im Falle eines Jasper-Formulars ist das natürlich dort entsprechend vorzusehen.

Um Artikel und andere Daten in eine andere Sprache zu übersetzen, muss der entsprechende Datensatz mehrsprachig eingerichtet sein. Das sprengt hier erst einmal die Beschreibung. Es sei vor allem darauf hingewiesen, das man sich hierdurch eigentlich zwingt, für jeden Artikel Übersetzungen zu pflegen.

Benutzer:TBayen

2016-02-09T13:23:16Z

TBayen:

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
** [[Inventur]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
** [[Tiny iDempiere]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
** [[Mehrwährungsfähigkeit]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

Hauptseite

2015-08-03T08:53:32Z

TBayen: iDempiere Welt Konferenz 2015

== iDempiere Weltkonferenz 2015 in Krefeld ==

Am 2./3. September 2015 findet in Krefeld die nächste Konferenz zu iDempiere statt. Ihr seid alle herzlich eingeladen. Bei Rückfragen bitte beim Organisationsteam oder [[Benutzer:TBayen]] melden.

* http://wiki.idempiere.org/de/Weltkonferenz_2015
* http://wiki.idempiere.org/en/IDempiere_World_Conference_2015

=='''Herzlich Willkommen bei iDempiere!'''==
'''Willkommen auf der deutschen Startseite des iDempiere-Projektes'''

Es freut uns Ihnen iDempiere vorstellen zu dürfen. Bei iDempiere handelt es sich um ein ausgereiftes [http://de.wikipedia.org/wiki/Enterprise_Resource_Planning (ERP) Unternehmensressourcenplanungs] und [http://de.wikipedia.org/wiki/Customer-Relationship-Management (CRM) Kundenbeziehungsmanagement] System mit einer Vielzahl von Funktionen.<br>.
iDempiere ist unter der GPL v2 Lizenz verfügbar. Weitere Informationen zu diesem Lizenzmodell stehen Ihnen auf [http://www.gnu.org/licenses/old-licenses/gpl-2.0.de.html der englischen Website] und auch als [http://www.gnu.de/documents/gpl-2.0.de.html deutsche Übersetzung] zur Verfügung.<br> Entwickelt und gepflegt wird iDempiere weltweit von erfahrenen Spezialisten auf verschieden Gebieten, Helfern jeder Art und Endanwendern. Daher steht Ihnen dieses Wiki in [http://wiki.idempiere.org/wiki/Main_Page diversen Sprachen zur Verfügung]. Die deutschsprachige Community organisiert sich über die Seite [[Team Germany]], hat eine eigene deutschsprachige [https://groups.google.com/forum/#!forum/idempiere-de Mailingliste] und organisiert hin und wieder auch iDempiere-[[Treffen in Deutschland]].<br>

Sie können iDemperie gerne [http://demo.idempiere.com/ unverbindlich und ohne jegliche Installation per Webstart] mit einigen Musterdaten testen.<br><br>
Wenn Ihnen iDempiere gefällt steht Ihnen nach dem [http://sourceforge.net/projects/idempiere/files/ '''Download'''] [[Image:Icon_Save24.png]] und der [[:Category:Installation|'''Installation''']] ein uneingeschränkt nutzbares und lizenzkostenfreies Warenwirtschaftssystem inkl. [http://hg.idempiere.com/ Sourcecode] zur Verfügung.<br>

Bei Bedarf stehen Ihnen außer der Gemeinschaft auch diverse deutschsprachige Beratungs-Unternehmen in Deutschland, Österreich und der Schweiz hilfreich zur Seite.<br>

In diesem Wiki werden Ihnen diverse Informationen in deutscher Sprache zu den verschiedensten Themengebieten zur Verfügung gestellt. Sie können dieses Wiki gerne erkunden indem Sie die Suchfunktion verwenden oder einfach [[:Special:AllPages|alle Seiten aufrufen]]. Auf dieser Seite können Sie eine Vorauswahl treffen.<br><br>
'''Um Ihnen eine bessere Übersicht zu gewähren ist das Wiki in Bestimmte Bereiche aufgeteilt:'''<br>

{|
|-
| [[:Category:Anwenderhandbuch|Anwenderhandbuch]]
| Im Anwenderhandbuch wird die grundsätzliche Einrichtung und diverse Handhabungen von iDempiere für Anwender in verständlicher Sprache mit Bildschirmausdrucken erklärt. Etwas weiter unten befindet sich eine [[Hauptseite#Anwenderhandbuch|strukturierte Übersicht über das Anwenderhandbuch]]
|-
|
|-
|
|-
| [[:Category:Entwicklerdokumentation|Entwicklerdokumentation]]
| In der Entwicklerdokumentation befinden sich technische Beschreibungen zum WIKI, der Überseztung und auch zur Programmierung.
|
|-
|
|-
|
|-
| [[:Category:Referenzhandbuch|Referenzhandbuch]]
| In iDempiere gibt es ca. 450 Prozessfenster, Workflows, Formulare und Bildschirmmasken, teilweise mit mehreren Karteireitern. Die Fenster in iDempiere haben Hilfstexten und Beschreibungen zu den einzelnen Karteireitern und Feldern, die wir Ihnen auch hier im WIKi zur Verfügung stellen.
|
|-
|
|-
|
|-
| [[:Category:Inhaltsverzeichnis|Inhaltsverzeichnis]]
| Da dieses WIKI bereits sehr umfangreich ist sind mehrere Inhaltsverzeichnisse angelegt.
|-
|}

==[[:Category:Anwenderhandbuch|Anwenderhandbuch]]==

{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Installation|'''Installation''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_mProcess.png|50px]]
| valign="top" |

[[:Category:Installation|'''Installation :''']]

* [[Howto-iDempiere-VM| in einer VM]]
* [[Installation Linux]] (Debian, Ubuntu usw.)
* [[Installation Windows]]
* Installation Mac
* [[Installation auf einem Server]]
* [[Installation der Entwicklungsumgebung]] (Eclipse)
* [[Datenbankeinrichtung für Entwickler|Datenbankeinrichtung für Entwickler]]

'''Sprachunterstützung :'''
* [[Deutsche Sprache installieren|Deutsche Sprache installieren]]
* [[Installierte Sprache löschen|Installierte Sprache löschen]]

|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Grundlagen|'''iDempiere Grundlagen''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Ok24.png|50px]]
| valign="top" |

[[:Category:Grundlagen|'''Grundlagen :''']]
*[[Allgemeine Handhabung von iDempiere|'''Allgemeine Handhabung von iDempiere''']]
**[[Clienten auswählen|Swing / Web UI - Clienten auswählen]]
**[[Login Hilfe|Login Hilfe]]
***[[Login Help|Login Help (Anmeldebildschirm)]]
**[[Startseite - Willkommensseite|Startseite - Willkommensseite]]
***[[IDempiere Informationsfenster|IDempiere Informationsfenster]]
**[[Toolbar|Toolbar]]
*.....
*[[Referenzhandbuch|Menübaum des Admin]]
*[[Referenzhandbuch-System|Menübaum bei System-Anmeldung]]

|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Systemadministration|'''Systemadministration''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Preference24.png|50px]]
| valign="top" |

[[:Category:Systemadministration|'''Systemadministration''']]

* [[:Category:Systemeinstellungen|Systemeinstellungen]]
* [[Ersteinrichtung Mandant|Ersteinrichtung eines neuen Mandanten]]
* [[Deutschen Mandanten einrichten|Deutschen Mandanten einrichten]]
* [[:Category:Mandant|Diverse Mandanten Seiten]]
* [[:Category:Organisation|Organisation einrichten]]
* [[Benutzerverwaltung]]
* [[Application Dictionary]]
<br><br><br>
[[Organisationsstuktur inkl. Flussdiagramm|'''Organisationsstruktur inkl. Flussdiagramm''']]
<br><br><br>
[[Musterfirma einrichten und verwenden|'''Musterfirma einrichten und verwenden''']]
<br><br><br>

|}</div>
|}

{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Geschäftspartner|'''Geschäftspartner''' ]]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_BPartner24.png|50px]]
| valign="top" |

[[:Category:Geschäftspartner|'''Geschäftspartner...''' ]]

* [[:Category:Geschäftspartner Stammdaten|Geschäftspartner Stammdaten]]
* [[Benutzerverwaltung‎|Benutzerverwaltung‎]]
* [[Benutzerpasswort als Admin ändern|Benutzerpasswort als Admin ändern]]
* [[Benutzerpasswort als Mitarbeiter ändern|Benutzerpasswort als Mitarbeiter ändern]]
|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Materialwirtschaft|'''Materialwirtschaft''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Product24.png|50px]]
| valign="top" |

[[:Category:Materialwirtschaft-Stammdaten|'''Materialwirtschaft-Stammdaten:''']]

* [[:Category:Artikelstammdaten|Artikelstammdaten]]
** [[:Category:Preislisten‏‎|Preislisten‏‎]]
* [[:Category:Lagerstammdaten|Lagerstammdaten]]

[[:Category:Bestandsbewegungen|'''Bestandsbewegungen:''']]
* [[:Category:Bestandsbewegungen|Warenbewegung]]
* [[:Category:Inventur|Inventur]]

'''Analysen:'''
* Lagerdetails
|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Beschaffung|'''Beschaffung''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Info24.png|50px]]
| valign="top" |

[[:Category:Beschaffung|'''Beschaffung:''']]

* [[:Category:Beschaffung-Ausschreibung|Ausschreibung]]
* [[:Category:Bestellung|Bestellung]]
* [[:Category:Wareneingang|Wareneingang]]
* Wareneingangsbestätigung
* Rechnung (Lieferant)
|}</div>
|}

{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Vertrieb|'''Vertrieb''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Payment24.png|50px]]
| valign="top" |

[[:Category:Vertrieb|'''Vertrieb...''' ]]

* [[:Category:Marketingkampagne|Marketingkampagne]]
* [[:Category:Stammdaten-Vertrieb|Stammdaten "Marketing und Vertrieb"]]
* [[:Category:Anfrage-Vertrieb|Anfragen]]
* [[:Category:Auftrag-Vertrieb|Aufträge]]
* [[:Category:Lieferungen|Lieferungen]]
* [[:Category:Verkaufsrechnung|Verkaufsrechnungen]]
* [[:Category:Rücksendungen‏‎|Rücksendungen‏‎]]
* [[:Category:Aufwand-Vertrieb|Aufwand]]
* [[:Category:Projekte-Vertrieb|Projekte]]
* [[:Category:Versand|Versand]]
* [[Statistik und Berichte]]
|}
</div>
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">'''Produktionsmanagement'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Prod.png|50px]]
| valign="top" |

'''Verwaltung Konstruktion'''

* [[Stücklistenverwaltung_(Fenster_ID-53128)|Stücklistenverwaltung]]
* Ressourcenfertigung
* Fertigungsworkflow erstellen

'''Planungsmanagement'''

* Produktplanung
* Prognosenverwaltung
* Materialbedarfsplanung
* Kapazitätsplanung
* Einsatzplanung Distribution

[[:Category:Produktion|'''Verwaltung Produktion''' ]]

'''Verwaltung Distribution'''

[[:Category:Qualitätsmanagement|'''Qualitätsmanagement''' ]]

'''Verwaltung Standardkostenrechnung'''
|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#D0E2EE; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Finanzbuchhaltung|'''Buchhaltung''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em 0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Calculator24.png|50px]]
| valign="top" |

'''[[Einrichtung der Buchhaltung|Einrichtung]]'''

* [[:Category:Stammdaten-Finanzbuchhaltung|Stammdaten]]
* [[:Category:Konten|Konten]]
* [[Kontenplan]]
* [[Buchführungsdimensionen]]
* [[Standardkonten]]
* [[:Category:Währung|Währung]]
* [[:Category:Steuerverwaltung|Steuerverwaltung]]
* [[:Category:Bank und Kassenbuch|Bank und Kassenbuch]]

[[:Category:Sachanlagen|'''Anlagevermögen''']]

*[[:Category:Abschreibung|Abschreibung]]

[[:Category:Buchführung|'''Buchführung''']]

*[[:Category:Geschäftsvorfall|Geschäftsvorfälle]]
* Einstellungen Buchführung
* [[:Category:Offene Posten|Offene Posten]]
* [[:Category:Zahlungen|Zahlungen]]
* [[Statistik und Berichte]]
* [[:Category:Finanzberichte|Finanzberichte]]
* [[:Category:Leistungsmessung|Leistungsmessung]]
* [[:Category:Kostenrechnung|Kostenrechnung]]

[[:Category:Personal|'''Personal''']]

[[:Category:Stammdaten-Personal|Stammdaten-Personal]]

|}</div>

|}

==[[:Category:Entwicklerdokumentation|Entwicklerdokumentation]]==

{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#ECE5CA; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Wiki|'''WIKI''']] </div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Wikiicon.jpg|50px]]
| valign="top" |

[[:Category:Wiki|'''Wiki Grundlagen''']]

* Aufbau / Struktur des WIKI's
* [[Verhaltensregeln_im_Wiki|Verhaltensregeln im Wiki]]
* [[Konventionen_für_dieses_Wiki|Konventionen für dieses Wiki]]
* [[Kategorien_einrichten|Kategorien einrichten]]
* [[Vorlagen_verwenden |Vorlagen verwenden]]
* [http://meta.wikimedia.org/w/index.php?title=Help:Contents/de&uselang=de Hilfe bzw. Konfiguration des MediaWiki]
* [http://www.mediawiki.org/wiki/Help:Searching/de Suchfunktion im Wiki verwenden]
* [http://www.mediawiki.org/wiki/Help:Formatting/de Seite für Formatierungen bei Mediawiki]
* [[WIKI Historie, Entwicklung und Statistik]]

[[:Category:DocBook|'''DocBook''']]
* [[Anwenderhandbuch mit DocBook erstellen]]
|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#ECE5CA; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Übersetzung|'''Übersetzung''']]</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Translate24.png|50px]]
| valign="top" |

|rowspan="1"|[[:Category:Übersetzung|'''Übersetzung von iDempiere in weitere Sprachen''']]

* [[Team Germany]] - Team für die deutsche Anpassung
* [[Übersetzung in iDempiere anpassen|Übersetzung in iDempiere anpassen]]
* [[Übersetzungsverbesserungen melden|Übersetzungsverbesserungen melden]]
* [[Glossar|Glossar für wichtige Begriffe]]

|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#ECE5CA; border-bottom:1px solid #aaaaaa; text-align: center;">'''Programmierung'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Preference24.png|50px]]
| valign="top" |

* [[Installation der Entwicklungsumgebung]]
* [[Entwicklung eigener Module]]
* [[Anleitung zur Migration von Modulen]] ([[http://sourceforge.net/projects/red1/files/ADempiere%20PDFs/iDempiereMigrationGuide2.pdf/download|Redhuan D. Oon]] auf dt. übersetzt)
* '''Programmierung von iDempiere'''
* .....
* [[Darstellung der Datenbankstruktur]]
* [http://www.adempiere.com/technical/340/schemaspy/ApplicationDictionary/index.html Eine veraltete aber sehr gute Darstellung: SchemaSpy Analysis of orclqss.ADEMPIERE340]

|}</div>
|}

== Kommunikation ==

{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#01DF01; border-bottom:1px solid #aaaaaa; text-align: center;">[[:Category:Wiki|'''Kommunikation''']] </div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Chat24.jpg|50px]]
| valign="top" |

'''Kommunikation'''

* [https://groups.google.com/forum/?fromgroups#!forum/idempiere-de Google-Group idempiere-de (Deutsch)] Hier kann über die deutsche Übersetzung des Programms, deutsche Anpassungen der Warenwirtschaft und der Finanzbuchhaltung sowie alle anderen Themen rund um iDempiere und ADempiere gesprochen werden.
* [https://groups.google.com/forum/?fromgroups#!forum/idempiere Google-Group iDempiere (GB)] This googlegroup is for developers and users to improve iDempiere ERP.
* [http://www.twitter.com/idempiere iDempiere auf Twitter (GB)]
* [http://www.globalqss.com/wiki/index.php/IDempiere/Full_Meeting_Minutes Protokolle der wöchentlichen Meetings]
* FreeNode - idempiere
* [http://sourceforge.net/projects/red1/?source=directory Red1 SourceForge]
* [http://jenkins.idempiere.com/ Jenkins]

|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#01DF01; border-bottom:1px solid #aaaaaa; text-align: center;">'''Kontakt-Links'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Online24.png|50px]]
| valign="top" |

|rowspan="1"|'''Kontakt-Links'''

* [http://www.idempiere.org/ Haupt-Startseite] (engl.)]
* [http://hg.idempiere.com/ Sourcecode Download]
* [http://jira.idempiere.com/ JIRA Ticketsystem]
* [http://jenkins.idempiere.com/ Jenkins kontinuierliche Auslieferung und Build Server]
* [http://www.globalqss.com/wiki/index.php/IDempiere Carlos Ruiz]
* [http://kenai.com/projects/hengsin Low Heng Sin]
* [http://www.red1.org/ Redhuan D. Oon]

|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#01DF01; border-bottom:1px solid #aaaaaa; text-align: center;">'''Hilfestellungen'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Help24.png|50px]]
| valign="top" |

* [http://red1.org/adempiere/viewtopic.php?f=29&t=1713|Wie migriere ich Module] - Auspacken, Plugin erschaffen, Verpacken, Migrieren, herkömmliche Modulskripte.
* [P2 sample site|http://sourceforge.net/projects/red1/files/p2/] für externe Plugins im iDempiere Marktplatz!
* [https://bitbucket.org/tbayen Bitbucket Projekte (engl.)] [[User:TBayen]]
* [http://www.frei-bier.org/wiki/Hauptseite frei Bier (englisch und teilweise deutsch)] [[User:TBayen]]
* [[FAQ]]

|}</div>
|}

==Funktionsumfang / Unterstützte Plattformen / Systemvorraussetzungen==

{| style="border:0; margin: 0;" width="100%" cellspacing="10"
| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#01DF01; border-bottom:1px solid #aaaaaa; text-align: center;">'''Funktionen von iDempiere'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Chat24.jpg|50px]]
| valign="top" |

[http://de.wikipedia.org/wiki/Enterprise_Resource_Planning (ERP) Unternehmensressourcenplanung]<br>
Durch iDempiere werden die Ressourcen (Kapital, Betriebsmittel oder Personal) möglichst effizient im betrieblichen Ablauf eingesetzt und die Steuerung der Geschäftsprozesse optimiert.<br><br>
[http://de.wikipedia.org/wiki/Customer-Relationship-Management (CRM) Kundenbeziehungsmanagement bzw. Kundenpflege]<br>
Bei einem CRM (Customer-Relationship-Management) handelt es sich um die Dokumentation und Verwaltung von Kundenbeziehungen. CRM ist ein wichtiger Baustein für ein gutes Beziehungsmarketing. Hierbei werden alle Kundendaten und Transaktionen in einer zentralen Datenbank gespeichert. <br><br>

'''Funktionen von iDempiere'''<br>
* Mandantenfähig
* Mehrsprachig (jeder Benutzer kann sogar seine eigene Sprache wählen)
* Mehrere Währungen
* Kontenrahmen/[[Kontenplan]] auswählbar und erweiterbar
* Umfangreiche Lagerverwaltungsmöglichkeiten inklusive Lagertransfer und Lagerplätzen
* Alle Geschäftspartner (Kunden, Lieferanten, Mitarbeiter) werden in einer Tabelle gespeichert.
* Alle Datensätze könne auf externe Datenquellen verweisen
* ohne großen Aufwand anpassungsfähig

Die vielen weiteren Punkte können hier aus Platzgründen nicht aufgeführt werden. Hierzu wird auf das Referenzhandbuch und weiteren Beschreibungen verweisen.

|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#01DF01; border-bottom:1px solid #aaaaaa; text-align: center;">'''Unterstützte Plattformen'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Windows Linux Mac.png|50px]]
| valign="top" |

|rowspan="1"|'''Unterstützte Plattformen'''

* Linux
* Windows
* Mac
* Start über Smartphone ist vorhanden und wird aktuell weiter entwickelt

|}
</div>

| valign="top" style="padding:0; border:1px solid #aaaaaa; margin-bottom:5px;" |
<div style="font-size: 105%; padding:0.4em; background-color:#01DF01; border-bottom:1px solid #aaaaaa; text-align: center;">'''Systemvoraussetzungen'''</div>
<div style="background:#ffffff; padding:0.2em 0.4em;">
{| style="border: 0; margin: 0;" cellpadding="3"
| valign="top" | [[Image:Icon_Preference24.png|50px]]
| valign="top" |

* [http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html Java 1.6]
* [http://www.postgresql.org/ PostgreSQL Datenbank (GB)] [http://www.postgresql.de/ deutsche Seite von PostgreSQL]
* oder die [http://www.oracle.com/us/products/database/overview/index.html?origref=http://www.idempiere.org/ Oracle Datenbank] [http://www.oracle.com/de/index.html deutschsprachige Oracle Seite]

|}</div>
|}[[Image:Lager_NortheastIndiana.png|500px|thumb|right|Beispiel für ein großes Lager]]

==iDempiere testen==

Es gibt grundsätzlich zwei verschiedene Wege um iDempiere zu testen.

'''Der erste und leichteste Weg''' iDempiere zu testen ist der [http://demo.idempiere.com Webstart]. Hier können Sie iDempiere ohne jegliches Risiko und Installationsaufwand testen. Es ist bereits eine Testfirma mit diversen Testdaten angelegt. In dieser Testfirma „GardenWorld“ können Sie diverse Eingaben tätigen, Listenausgaben starten und Auswertungen abrufen.

Zur Anmeldung verwenden Sie bitte:

'''EMail: admin @ gardenworld.com (inklusive Leerzeichen!)'''

'''Passwort: GardenAdmin'''

'''EMail: superuser @ idempiere.com ODER system @ idempiere.com (inklusive Leerzeichen!) '''

'''Passwort: System'''

'''Der zweite Weg''' ist iDempiere auf Ihrem Rechner zu installieren. Bei jeder Installation von iDempiere wird zusätzlich die Beispielfirma „GardenWorld“ installiert. Auch bei der installierten Version können Sie beliebige Änderungen und Tests durchführen.

==Literatur==

|''[http://books.google.de/books?id=I80Yl-VbjGsC&printsec=frontcover&dq=isbn+adempiere&hl=de&sa=X&ei=KeQiU5D1DIGNtAbas4G4CQ&ved=0CE0Q6AEwAA#v=onepage&q=isbn%20adempiere&f=false ADempiere 3.4]''
|''[http://books.google.de/books?id=qd0sSThez_kC&printsec=frontcover&dq=isbn+adempiere&hl=de&sa=X&ei=KeQiU5D1DIGNtAbas4G4CQ&ved=0CFUQ6AEwAQ#v=onepage&q=isbn%20adempiere&f=false ADempiere Cookbook 3.6]''
|''[http://books.google.de/books?id=OIH-ZwEACAAJ&dq=isbn+adempiere&hl=de&sa=X&ei=KeQiU5D1DIGNtAbas4G4CQ&ved=0CF0Q6AEwAg ADempiere kompakt]''

[[Image:ADempiere_3_4_ERP_Solutions.png|400px]]
[[Image:ADempiere_3_6_Cookbook.png|400px]]
[[Image:ADempiere_kompakt.png|400px]]

[[Image:PearsonBookCover.jpg|400px]]

[[en:Main Page]]
[[es:Página_principal]]
[[de:Hauptseite]]
[[fr:Accueil]]
[[pt:Página_principal]]
[[da:Forside]]
[[el:Αρχική_σελίδα]]
[[nl:Hoofdpagina]]
[[pl:Strona główna]]
[[ru:главная страница]]
[[bg:Начална_страница]]
[[hu:Kezdőlap]]
[[sr:Главна_страна]]
[[sv:Huvudsida]]
[[tr:Ana_sayfa]]
[[ms:Laman_Utama]]
[[zh:首页]]
[[ja:メインページ]]
[[th:หน้าหลัก]]
[[id:Halaman_Utama]]
[[ar:الصفحة_الرئيسية]]
[[it:Pagina_principale]]
[[ro:Pagina_principală]]

[[Category:Inhaltsverzeichnis]]

Inventur

2015-06-25T09:29:35Z

TBayen:

= Inventur =

Eine Inventur ist einerseits bei der Ersteinrichtung des Programmes für einen bestehenden Betrieb und andererseits in bestimmten Abständen (je nach Gesetzeslage mindestens jährlich) zum Abgleich der Programmdaten mit dem realen Lagerbestand nötig.

== Inventur über Wareneingangsbeleg ==

Es gibt verschiedene Wege, eine Erstinventur zu machen. Einerseits kann man einen Geschäftspartner "Eröffnungsbilanz" anlegen und mit diesem einen Wareneingangsbeleg erstellen. Diese Lösung ist einfach und pragmatisch. Sie verfälscht aber sowohl die Buchungen (wenn man die Buchhaltung benutzt) als auch die Lieferanten-Statistiken. Denn schließlich erzeugt man einen Wareneingang, wo eigentlich - zumindest in dieser Periode - keiner war.

== Inventur über Inventurbeleg ==

Andererseits gibt es das Dokumenten-Fenster "physische Inventur". Dort erzeugt man einen Beleg mit ganz vielen Inventurzeilen.

Allerdings ist das nicht ganz so einfach wie gedacht, weil man zuerst die Kosten der Artikel feststellen muss. Das Problem ist, das das Programm für die Inventurbuchungen einen Wert für die angegebenen Artikel festlegen muss. Hierzu wird normalerweise ein Kostensatz automatisch errechnet. Im Allgemeinen geschieht das auf Grund der zurückliegenden Eingangsrechnungen. Da wir ja aber solche noch nicht haben, müssen wir diese Kostensätze einmal vorbelegen. Das kann man mit dem Prozeß "Standardkosten aktualisieren" machen. Dieser aktualisiert die Kostensätze für alle Artikel, die im Lager geführt werden (kann in den Artikelstammdaten angegeben werden). Man wählt dort bei "Standardkosten festlegen" aus, das man die Kosten mit "Preisliste (Limit)" initialisiert werden und wählt unten eine Preisliste aus. Gibt man hier seine Einkaufspreisliste an, so werden die Kostensätze nun entsprechend initialisiert Es ergibt sich ein Beleg (im Fenster "Cost Adjustment"), der keine Buchungen in die Buchhaltung erzeugt, sondern nur die Kostensätze bei den Artikeln aktualisiert. Das kann man im Stammdatenfenster der Artikel im Register "Kosten" im Feld "gegenwärtiger Kostenpreis" sehen.

Um nun eine Inventur zu machen, kann man im Fenster "physische Inventur" einen neuen Beleg anlegen. Mit dem Button "Zählliste für Inventur anlegen" kann man dann die Liste bereits vorausfüllen, man kann sie aber auch manuell (oder per CSV-Import) füllen. Dabei muss man jedoch darauf achten, das man wirklich nur Artikel angibt, die im Lager geführt werden (wie in den Artikelstammdaten angegeben). Ansonsten steht man nachher mit einem nicht verbuchbaren Beleg da: "Buchungsfehler (No costs for blablabla) - Doc_Inventory...".

= Links =

* [[https://groups.google.com/forum/#!topic/idempiere/3Np1C63CV_8 First setup of inventory items]]
* [[:en:NF1.0_Inventory_Documents]]
* [[https://groups.google.com/forum/#!topic/idempiere/s4O82rGxJbk Inventory Document can not be posted]]

Inventur

2015-06-25T08:27:50Z

TBayen:

Inventur

2015-06-25T08:19:47Z

TBayen: Die Seite wurde neu angelegt: „= Inventur = Eine Inventur ist einerseits bei der Ersteinrichtung des Programmes für einen bestehenden Betrieb und andererseits in bestimmten Abständen (je …“

= Inventur =

Eine Inventur ist einerseits bei der Ersteinrichtung des Programmes für einen bestehenden Betrieb und andererseits in bestimmten Abständen (je nach Gesetzeslage mindestens jährlich) zum Abgleich der Programmdaten mit dem realen Lagerbestand nötig.

== Inventur über Wareneingangsbeleg ==

Es gibt verschiedene Wege, eine Erstinventur zu machen. Einerseits kann man einen Geschäftspartner "Eröffnungsbilanz" anlegen und mit diesem einen Wareneingangsbeleg erstellen. Diese Lösung ist einfach und pragmatisch. Sie verfälscht aber sowohl die Buchungen (wenn man die Buchhaltung benutzt) als auch die Lieferanten-Statistiken. Denn schließlich erzeugt man einen Wareneingang, wo eigentlich - zumindest in dieser Periode - keiner war.

== Inventur über Inventurbeleg ==

Andererseits gibt es das Dokumenten-Fenster "physische Inventur". Dort erzeugt man einen Beleg mit ganz vielen Inventurzeilen.

Allerdings ist das nicht ganz so einfach wie gedacht, weil man zuerst die Kosten der Artikel feststellen muss. Das Problem ist, das das Programm für die Inventurbuchungen einen Wert für die angegebenen Artikel festlegen muss. Hierzu wird normalerweise ein Kostensatz automatisch errechnet. Im Allgemeinen geschieht das auf Grund der zurückliegenden Eingangsrechnungen. Da wir ja aber solche noch nicht haben, müssen wir diese Kostensätze einmal vorbelegen. Das kann man mit dem Prozeß "Standardkosten aktualisieren" machen. Dieser aktualisiert die Kostensätze für alle Artikel, die im Lager geführt werden (kann in den Artikelstammdaten angegeben werden). Man wählt dort bei "Standardkosten festlegen" aus, das man die Kosten mit "Preisliste (Limit)" initialisiert werden und wählt unten eine Preisliste aus. Gibt man hier seine Einkaufspreisliste an, so werden die Kostensätze nun entsprechend initialisiert Es ergibt sich ein Beleg (im Fenster "Cost Adjustment"), der keine Buchungen in die Buchhaltung erzeugt, sondern nur die Kostensätze bei den Artikeln aktualisiert. Das kann man im Stammdatenfenster der Artikel im Register "Kosten" im Feld "gegenwärtiger Kostenpreis" sehen.

Um nun eine Inventur zu machen, kann man im Fenster "physische Inventur" einen neuen Beleg anlegen. Mit dem Button "Zählliste für Inventur anlegen" kann man dann die Liste bereits vorausfüllen, man kann sie aber auch manuell (oder per CSV-Import) füllen. Dabei muss man jedoch darauf achten, das man wirklich nur Artikel angibt, die im Lager geführt werden (wie in den Artikelstammdaten angegeben). Ansonsten steht man nachher mit einem nicht verbuchbaren Beleg da.

Siehe auch [[https://groups.google.com/forum/#!topic/idempiere/3Np1C63CV_8|First setup of inventory items]]

= Links =

* [[https://groups.google.com/forum/#!topic/idempiere/3Np1C63CV_8 First setup of inventory items]]
* [[:en:NF1.0_Inventory_Documents]]

Benutzer:TBayen

2015-06-25T08:07:46Z

TBayen:

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
** [[Inventur]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
** [[Tiny iDempiere]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

JasperReports

2015-03-28T10:40:32Z

TBayen: /* Fonts */

[http://jasperforge.org/projects/jasperreports Jasperreports] ist ein Reportgenerator, dessen Möglichkeiten weit über die der in Adempiere eingebauten Report-Fähigkeiten hinausgehen. Es ist gut in ADempiere integriert.

== Links zum Thema ==

Die folgenden Links verweisen auf Anleitungen, die eine gute Einführung von ADempiere und Jasperreports anbieten.

* [http://www.adempiere.com/ADempiere/Compiere_JasperReports_Integration_HowTo ADempiere/Compiere_JasperReports_Integration_HowTo] - ursprüngliches Dokument, das die Einbindung beschreibt
* [http://www.adempiere.com/Workshop:Integration_von_JasperReports_in_ADempiere Workshop:Integration_von_JasperReports_in_ADempiere] - informativer Workshop von nwessel auf deutsch
* http://adempiere.metas.de/mediawiki/index.php/Neuen_Bericht_anlegen#Einrichten_eines_Jasper_Berichts_in_ADempiere - kurzgehaltene Eindeutschung von Metas

== Wie legt man los? ==

Zuerst sollte man ein aktuelles "iReport" herunterladen. Ohne grosse Anmeldung geht das von https://sourceforge.net/projects/ireport/ aus. Unter http://jasperforge.org/projects/ireport findet sich die eigentliche Projektseite mit einigen Hinweisen. Ansonsten empfehle ich auch das Buch "iReport Ultimate Guide", was man da (nach einer Registrierung) kostenlos herunterladen kann.

Grobe Gliederung der ersten Schritte:

* Ggf. Konfiguration eines Benutzers, der auf das benutzte Datenbank-Schema zugreifen kann ohne dieses immer angeben zu müssen. Dazu u.U. setzen der PostreSQL-Variable search_path fest im Benutzerprofil (per PgAdmin3)
* Anlegen einer Datenquelle in iReport, d.h. Datenbank-Zugangsparameter
* Anlegen eines neuen Reports entweder über Templates oder eines leeren Blattes.
* Anlegen eines Parameters "RECORD_ID" zur Übergabe einer Datensatznummer von iDempiere nach JasperReports (Der Name dieses Parameters ist von iDempiere vorgegeben)
** Man kann iReport so einstellen, das bei jedem Test (in iReport, also ausserhalb von iDempiere) diese Nummer von Hand eingegeben werden muss (etwas lästig) und/oder das ein Default-Wert verwendet wird. Hier kann man einen vorhandenen Datensatz für Tests fest verdrahten. Dazu den Parameter anklicken und in die Einstellungen zu diesem Element schauen.
* Eingeben eines Datenbank-Queries
** Dabei $P{RECORD_ID} als Platzhalter verwenden. (Der Query-Generator hilft übrigens durch Drag-and-Drop dabei, wenn man einen Parameter-Namen vergessen hat.)
** Im Query definiert man Felder, die aus dem Select in eine Art lokale Variablen ("Felder") geladen werden.
** Diese Felder kann man links im Dokumentenbaum aufklappen und dann in den Bericht ziehen. Der einzelne Datensatz kommt in den "Detail"-Bereich, die Überschriften z.B. in den "Page Header".

== Subreports ==

Für den Zugriff auf Subreports, Bilder und sonstige Resourcen sollte man die Beschreibung unter [[JasperReportsClassic]] oder [[JasperReportsFreiBier]] lesen. Einer der Vorteile des FreiBier-Plugins ist, das es hierbei viel flexibler ist und somit eine Modularisierung des Reports erlaubt.

== Übergabe von Parametern ==

Ein JasperReport wird in iDempiere über das Application-Dictionary in der Tabelle "Bericht & Prozeß" eingerichtet. Einen solchen Prozeß kann man dann in das Menü einhängen oder mit einem Button verknüpfen. Man kann hier auch Parameter angeben. Wird das getan, öffnet sich vor dem Start des eigentlichen Berichts ein kleines Eingabefenster, in dem man Parameter eingeben kann. Dabei sind die üblichen Möglichkeiten von ADempiere, um Datentypen zu definieren, vorhanden. Das bedeutet, man kann also Texte oder Zahlen eingeben aber auch Datensätze aus einer Combobox oder mit Hilfe eines Suchfensters auswählen. Der Name des Parameters kann dort konfiguriert werden. Diesen Namen kann man dann in iReport als Parameter konfigurieren. Im Fall eines ausgewählten Datensatzes wird dann z.B. die ID dieses Satzes als Integer-Wert (bzw. BigDecimal im neuen Plugin) übergeben. Wird ein Report über das Druck-Icon der Toolbar aufgerufen, so wird automatisch der Parameter '''RECORD_ID''' mit der ID des momentanen Datensatzes gefüllt.

== Vorbereiten von *.jasper-Dateien mit unterschiedlichen JasperReports-Versionen ==

Das Erzeugen von Subreports in Jasperreports ist nicht ganz trivial, aber vielfach erklärt. Hierzu benutzt man iReport. Leider gibt es bei der Zusammenarbeit mit ADempiere noch einige weitere Hürden. Einen normalen Report kann man als *.jrxml-Datei im Filesystem oder im Classpath ablegen. Diese Datei wird dann von iDempiere automatisch in eine *.jasper-Datei kompiliert. Diese stellt dann den eigentlichen Report dar, der sodann Daten aus der Datenbank zieht und ein Ausgabedokument (zumeist ein PDF) erzeugt. Subreports werden nun allerdings durch einen String deklariert, der den Dateinamen des Subreports enthält. An dieser Stelle erwartet JasperReports (zumindest nach meiner Erfahrung) auf jeden Fall den Namen einer *.jasper-Datei. Also muss man diese vorübersetzen.

An sich ist das nicht schlimm, weil iReport das sowieso für uns macht. Dabei trat bei mir allerdings ein Problem auf: das letzte echte ADempiere (Version 3.6.1) enthält jasperreports-3.7.3.jar, iDempiere 2.0 enthält JasperReports 5.2, während mein aktuell heruntergeladenes iReport bereits die Version 5.5 hat. Dadurch ergab sich nun leider nach der Installation der Datei in ADempiere eine Exception, weil irgendwelche Abhängigkeiten nicht aufgelöst werden konnten.

Um das zu beheben muss man also sicherstellen, das der in iReport erzeugte Report erstens grundsätzlich von den verwendeten Funktionen her kompatibel mit der Version im Programmcode ist (3.7.3 bzw. 5.2) ist und zweitens muss man die *.jasper-Datei mit einer entsprechenden Version übersetzen. Ersteres geht, indem wir in iReport in den Einstellungen (Menü Extras->Optionen) im Register "General" im Unterregister "Compatibility" einstellen, das wir *.jrxml-Dateien der Version 5.2 erstellen wollen.

Zweiteres geht entweder mit einem Ant-Skript (siehe [[JasperReportsClassic]]) oder indem man die übersetzte Datei aus dem Cache fischt (siehe [[JasperReportsFreiBier]]).

== Images in Reporten ==

Es gibt relativ wenige Erklärungen im Netz zum Thema, wie man ein Bild in einen Report integriert. All diese Anleitungen erklären zuerst einmal, wie man statische Bilder in einen Report einfügt, um z.B. das Logo der eigenen Firma oben an den Rand jeder Seite oder auf ein Deckblatt zu drucken. Das ist aber natürlich nur der halbe Spaß! Ich möchte gerne Bilder aus der Datenbank in meinen Report übernehmen. Also z.B. ein Kunden-Stammblatt, auf dem das Logo des Kunden steht oder eine Preisliste mit Abbildungen meiner Produkte.

Hierzu benötigt man zuerst einmal das Image als Daten. In iDempiere (und überhaupt) gibt es verschiedene Systeme, wie Images abgespeichert werden. Die Logos der Geschäftspartner werden dabei standardmäßig im (meiner Meinung nach) sinnvollsten Format abgespeichert: Als Strom von Binärdaten, die in der Datenbank in einer eigenen Tabelle gespeichert werden. Warum ist das sinnvoll: Bilder sind genauso wie alle anderen Daten Teil der Summe aller Geschäftsdaten und gehören damit in die Datenbank (und nicht ins Filesystem, ins Internet oder sonstwohin). Speichert man sie in den normalen Datensatz (z.B. die Tabelle C_BPartner), so wird dieser allerdings extrem aufgebläht und somit verlangsamt sich der Zugriff auf Geschäftspartner sehr stark. Daher werden solche Bilder in iDempiere in die Tabelle '''AD_Image''' gespeichert. Wer möchte, kann diese Tabelle dann sogar auf eine eigene Festplatte auslagern, um so weder Performance noch Speicherplatz der eigentlichen Datenbank zu stören.

Nun gibt es folgende Fälle:

* '''statisches Bild''': Ein solches Bild hat eine feste URL als String. Für diese Bilder kann man in iReport einstellen, das diese gecachet werden. Das bedeutet einerseits, das ein Logo, das auf jeder Seite gedruckt werden soll, bei der Erstellung des Berichts nur einmal geladen wird. Andererseits bedeutet es, das ebendieses Logo auch in einem am Ende erzeugten PDF nur einmal enthalten ist (diese Datei also relativ klein ist).
* '''dynamische geladenes Bild''': Ein solches Bild kommt aus einer Datenquelle, die sich jederzeit ändern kann. Der hier interessanteste Fall ist, das es aus der iDempiere-Datenbank geladen werden kann. Ein solches Bild wird dann als Datenstrom (Java-Objekt vom Typ InputStream) in den Report eingelesen und kann nicht gecachet werden.
* '''statisches Bild aus dynamischer Quelle''': Das Plugin [[JasperReportsFreiBier]] erlaubt noch eine weitere Variante: Ein Bild hat einen String-Namen (was für JasperReports und iReport bedeutet, das es gecachet werden kann) wie z.B. "AD_Image:1000123.png", wird aber trotzdem dynamisch aus der Datenbank geladen. Die Übertragung vom Namen in eine Datenbankabfrage übernimmt dabei eine Implementation des "FileResolver" Interface namens ReportFileResolverImage.

Nun zur Erklärung des dynamisch geladenen Bildes. Dieser Fall ist aus Sicht des Berichtes der komplizierteste:

Man muss die Daten as AD_Image, (die mit Absicht aus der Haupt-Tabelle herausgehalten werden), mit dieser mit einlesen. Das geht wie üblich mit so etwas wie:

<pre>
SELECT *
FROM C_BPartner
LEFT JOIN AD_Image ON(C_BPartner.logo_ID = AD_Image.AD_Image_ID)
WHERE
C_BPartner.C_BPartner_ID=$P{RECORD_ID}
</pre>

Ein derartiger Query-String wird in iReport als Haupt-Query eingegeben. Dann kann man ein ganz normales Image-Element aus dem Panel nehmen und in seinen Report ziehen. In den Eigenschaften dieses Images kann man nun die "Expression Class" einstellen. Falls man doch seine Bilder im Filesystem gespeichert hat (und eine URL in der Datenbank), kann man hier '''String''' angeben. Hat man die Bilder als Binärdaten z.B. aus AD_Image geholt, nimmt man am besten '''java.io.InputStream'''. Als Image Expression nimmt man in ersterem Fall einfach die entsprechende Feldvariable. Für Binärdaten nimmt man den folgenden String:

new java.io.ByteArrayInputStream((byte[])$F{binarydata})

Dieser Ausdruck ist im Grunde das ganze Geheimnis. Damit läuft es dann auch schon - Viel Spaß! :-)

=== Problem mit Images aus InputStreams und PostgreSQL 9.x ===

Bis heute (Januar 2014) wird bei iReport ein PostgreSQL-Treiber 8.x mitgeliefert. Leider hat sich in den Grundeinstellungen von PostgreSQL [http://stackoverflow.com/questions/4828266/what-has-changed-between-postgres-jdbc-8-4-and-9-regarding-bytearrays etwas geändert] zwischen 8.x und 9.x bzgl. des ''bytea_output''-Wertes etwas geändert. Es gibt auch [http://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=2&ved=0CC8QFjAB&url=http%3A%2F%2Fcommunity.jaspersoft.com%2Fquestions%2F816757%2Flicense-issue-server-failure&ei=SHjhUq6AAcjMsgbww4DQDA&usg=AFQjCNHjMzioZGkWdCaRVs2PGASQGpTmnQ&bvm=bv.59930103,d.Yms&cad=rja eine Beschreibung aus JasperReports-Sicht] hierzu. Um das Problem zu beheben kann man entweder diese Einstellung ändern (als Voreinstellung im Datenbank-User oder bei jedem Query) oder (besser) einen aktuellen JDBC-Treiber als JAR-File herunterladen und in den iReport-Optionen in der Registerkarte "Classpath" einbinden. Danach ging es bei mir problemlos.

== Parameter in Reporten ==

ADempiere übergibt verschiedene Parameter an JasperReports. Diese muss man nicht benutzen, kann es aber, indem man sie in iReport als Parameter definiert. Dabei muss man einfach einen Parameter des angegebenen Namens (Gross- und Kleinschreibung beachten) anlegen. Um seine Reporte auch in iReport sinnvoll testen zu können, sollte man dann noch einen intelligenten Default-Wert angeben, der einem beim Test halbwegs sinnvolle Daten in die Ausgabe zaubert. Natürlich kann es von Fall zu Fall auch sinnvoll sein, einen Default-Wert im SQL-Code, der diese Parameter benutzt, z.B. mit COALESCE(...) zu erzeugen.

Da sich die konkrete Ausgestaltung der automatisch übergebenen Parameter und deren Benennung von Parametern bei den beiden alternativen Plugins unterscheidet, bitte ich auch hier, unter [[JasperReportsClassic]] bzw. [[JasperReportsFreiBier]] nachzusehen.

== iReport-Tips ==

ADempiere hatte früher Probleme mit '''Groovy als Skriptsprache''' (aufgrund von Versionsdifferenzen). Einerseits erleichtert Groovy das Leben ganz allgemein und andererseits laufen Reporte in ADempiere eher, wenn man Java verwendet. Mit iDempiere habe ich es ehrlich gesagt noch nicht probiert (könnte aber besser klappen, weil genau derartige Probleme durch [[OSGi]] gelöst werden sollten). Um die Skriptsprache umzustellen kann man in iReports in "Extras/Optionen" auf der Registerkarte "General", Unterkarte "Report Defaults" die Language umstellen. Diese Einstellung gilt dann für alle neuen Reporte. Die eigentliche Einstellung nimmt man im Objektbaum des Reports auf der allerobersten Ebene vor. Dort gibt es eine Einstellung "Language". Eigentlich hätte ich erwartet, das man diese Einstellung auch noch je Ausgabefeld einstellen kann, was aber scheinbar nicht geht.

== Fonts ==

Das Benutzen von eigenen Zeichensätzen wird in den Dokus immer so beschrieben, als ob es mit besonderen Fallstricken versehen wäre. Daher dokumentiere ich hier vorsichtshalber, was mir zu dem Thema so begegnet ist:

* http://jasperforge.org/uploads/publish/jasperreportswebsite/trunk/sample.reference/fonts/index.html - offizielles Fonts-Beispiel von der JasperReports-Seite
* http://www.alexander-merz.com/print_43.html - Artikel von 2006 zum Thema (sind das die Basics?)
* http://grysz.com/2010/06/01/use-custom-fonts-in-jasperreports-pdf-exporter/ - neuerer Artikel zum Thema
* http://mdahlman.wordpress.com/2010/05/28/jaspersoft-v3-7-font-extensions/ - beschreibt das neue Font-Handling ab Version 3.7, bezieht sich aber leider explizit auf den (kostenpflichtigen) Ultimate Guide
* http://www.faqs.org/docs/Linux-mini/TT-Debian.html - Recht altes HOWTO über TrueType und Debian
* http://wiki.debian.org/Fonts - aktuelle Seite über Debian und Fonts
* http://fonts.debian.net/ - Abbildungen von allen Fonts in Debian
* http://dejavu-fonts.org - gut ausgearbeitete Fontfamilie für alle Gelegenheiten

Welcher Font in einem Report wirklich benutzt wird, ist immer eine lange Geschichte. Eigentlich ist nur der Dejavu-Font in iReport selber enthalten. Dazu gibt es noch einige Fontbezeichnungen, die je nach Umgebung auf einen möglichst passenden Systemfont abgebildet werden. Diese sind "Monospaced", "Serif" und "SansSerif". Wenn ich versuche, einen Font einzustellen (z.B. bei den Eigenschaften eines Textfeldes), so stehen diese "ordentlich konfigurierten" Fonts ganz oben (über dem Strich). Darunter stehen dann noch die im aktuellen Betriebssystem installierten Fonts. Diese sollte man normalerweise nicht benutzen. Sie haben erstens den Nachteil (je nach Anwendungsfall), das sie nicht plattformübergreifend zur Verfügung stehen und zweitens, das sie nicht in PDF-Dokumenten verwendet werden.

Der moderne Weg, um Fonts in einem Report zu benutzen, ist, diese in eine sogenannte Font Extension zu packen. Das ist ein JAR-File, das den Font beschreibt. Dieses JAR-File kommt dann in den Classpath z.B. von iReport (geschieht ganz automatisch, wenn man einen Font richtig installiert). Man kann Fonts ausgehend von ganz normalen TTF-Dateien in den Einstellungen von iReport hinzufügen. Dort kann man dann aus einem solchen hinzugefügten Font auch eine Font Extension (sprich: ein JAR-File) machen. Dieses kann man dann ganz normal seiner Applikation beifügen. Für ADempiere/FreiBier heisst das z.B., das ich diese Datei nach packages/freibier/lib kopiere (es gibt verschiedene Wege, JARs zu ADempiere hinzuzufügen, Packages sind einer davon). In iDempiere habe ich das bisher noch nicht gemacht.

Früher konnte man wohl für die PDF-Ausgabe einen eigenen Font angeben, das scheint aber nicht mehr empfohlen zu werden. In den alten Zeiten war es wohl nicht so einfach (oder nicht möglich) einen eigenen Font in ein PDF zu integrieren. Außerdem finde ich es extrem blöde, wenn der normale, im Viewer angezeigte Report anders aussieht als dein PDF-Report. Zu überlegen ist allerdings, ob man den Font in das PDF-Dokument einbettet oder nicht. Ersteres garantiert immer eine ordentliche Anzeige auf allen Zielrechnern (und ist eigentlich der übliche Weg), zweiteres sorgt für kleinere PDF-Dateien und ist vielleicht platzsparender, wenn man im Unternehmenseinsatz sehr viele Dokumente erzeugt und diese dann auch archivieren will (in einem kleinen Test mit einem einseitigen Dokuemnt hatte ich 2,5KB für das blanke PDF und 7,1KB für das mit integrierem Font, allerdings wurden wohl nur die verwendeten ca. 10 Buchstaben eingebettet, der praktische Unterschied könnte also durchaus im Bereich von einigen -zig KB liegen).

In einem Beispiel hatte ich den Standard-Font "SansSerif" ausgesucht, damit ein PDF generiert und dieses dann auf einem recht einfach installierten Linux-System (einem LTSP Thin Client) in einem Chrome-Browser angesehen. Die Ausgabe war unschön verschoben. Dieselbe Datei konnte aber z.B. auf einem Android Gerät korrekt wiedergegeben werden. Soweit ich das Problem nachverfolgt habe, benutzt JasperReports in diesem Fall bei der Erzeugung des PDF den Adobe-Standardfont Helvetica, der dort nicht installiert war (ich bin da aber nicht ganz sicher, es kann auch ein anderer Fontname sein, der benutzt wird). Auf jeden Fall half es, das Debian-Paket "fonts-liberation" auf dem Thin Client zu installieren.

=== Styles ===

Seit einiger Zeit gibt es in iReport sogenannte Styles. Damit kann man einen Schriftstil (inklusive Font) einmalig vorgeben und braucht ihn dann nicht für jedes Feld neu festzulegen. Vor allem kann man aber den Stil auch an einer Stelle global ändern.

=== Fragen, die bleiben: ===

* Die speziellen Angaben für PDF-Fonts sind in meinem iReport vorhanden, aber durchgestrichen - was bedeutet das?
* Ich sollte mal versuchen, einen ganz fremden TTF-Font zu integrieren und das dann dokumentieren, um das obige alles beweisen zu können

Auf der Seite [http://www.adempiere.com/Using_Jasper_Report_Form_in_place_of_Standard_Forms Using Jasper Report Form in place of Standard Forms] ist (ziemlich unten) auch ein ausführlicher Teil zur Arbeit mit einem eigenen Font.

== verwandte Links ==

* http://dynamicreports.sourceforge.net/ - interessante Erweiterung von JasperReports, um Reporte dynamisch per Java-Code zu erzeugen
* https://sourceforge.net/projects/jrdesigner/ - Seite zu einem ColumnDesigner mit wenig Informationen. Vielleicht handelt es sich um die gleiche Funktion, die unter http://www.jaspersoft.com/de/column-manager-0 verkauft wird. Dort steht, das man damit parametergesteuert Spalten ein- und ausblenden kann.

[[Category: Entwicklerdokumentation]]
[[Category: Anwenderhandbuch]]
[[Category: Ausgaben (drucken)]]
[[Category: Jasper Report]]
[[Category: Berichte]]

Steuersätze einrichten

2014-12-02T16:25:53Z

TBayen:

= Einrichtung der Umsatzsteuer =

Um Steuersätze einzurichten, müssen Steuerkategorien und Steuersätze eingerichtet werden. Außerdem muss man [[Geschäftspartner]] und [[Artikel]] richtig konfigurieren. Als letztes können noch Einstellungen im Buchführungs-Schema nötig sein. Es gibt hierfür einen vorbereiteten Workflow unter

Leistungsanalyse → Einstellungen Buchführung → Einrichtung Steuern

Da Steuersätze vom Gesetzgeber immer mal wieder gerne geändert werden – das grundsätzliche System der zu besteuernden Produkte und Personen aber nicht so oft -, sind diese beiden Dinge getrennt einzustellen.

== Steuerkategorien ==

Steuerkategorien sind Kategorien, in die alle Waren und Dienstleistungen eingeteilt werden. In Deutschland haben die meisten Produkte den normalen Steuersatz (z.Zt. 19%). Für bestimmte Produkte wie Lebensmittel gibt es einen ermäßigten Steuersatz (7%). Dazu gibt es noch einige Produkte, die von der Umsatzsteuer ganz befreit sind (z.B. Lotterielose, Wohnungsmieten). Also legen wir im Fenster [[Steuerkategorie (Fenster ID-138)|Steuerkategorien]] folgende Kategorien an:

* normale Umsatzsteuer
* ermäßigte Umsatsteuer
* umsatzsteuerbefreit

Es ist sinnvoll, darauf zu achten, das diese Steuerkategorien mit der Organisation „*“ angelegt werden, damit man sie in allen Organisationen des Mandanten nutzen kann. Wer wirklich nur eine Organisation hat, kann das aber auch ignorieren. Die bereits vorhandene Kategorie „Standard“ kann man deaktivieren (oder vielleicht sogar löschen).

== Steuersätze ==

Das System der Steuersätze in iDempiere ist recht komplex, da es auch vielfältige Steuersysteme der Welt abbilden kann. Für Deutschland sollte man mindestens drei Steuersätze anlegen.
Zuerst erstellt man im Fenster [[Steuersatz (Fenster ID-137)|Steuersatz]] einen neuen Steuersatz und gibt ihm den Namen „Umsatzsteuer 19%“. Mit der Steuerkategorie wählt man sodann aus, für welche Produkte er gilt (in unserem Fall also die soeben angelegte Kategorie „normale Umsatzsteuer“. Dahinter gibt man das Datum an (die aktuellen Sätze von 19% und 7% gelten seit dem 1.1.2007 bzw dem 1.7.1983), ab dem der Steuersatz gilt. Sobald die Politik das nächste Mal beschließt, den Satz zu erhöhen, tragen wir lediglich einen neuen Steuersatz mit dem entsprechenden Datum ein und alles läuft richtig.

''Besondere Felder:''

Das Feld '''Umsatzsteuer''' (im englischen „Sales Tax“) darf nicht angewählt werden. Hier ist die deutsche Übersetzung entgleist. Wird dieses Feld angewählt, handelt es sich um eine Steuer, die auf den gesamten Verkauf und nicht nur auf den Mehrwert genommen wird (also genau keine Umsatzsteuer). Es wird also keine Vorsteuer abgezogen. In Deutschland ist dieses Verfahren seit 1968 nicht mehr üblich. Eventuell können mit Hilfe dieses Systems in Deutschland Verbrauchsteuern (Biersteuer, Stromsteuer, Tabaksteuer) berechnet werden.

Die '''Auftrags-/Bestellart''' bleibt auf „beide“ und die '''Parentsteuer''' bleibt leer. Das '''Land''' setzt man am besten auf „Deutschland“ und das '''Ziel''' auch auf „Deutschland“. Über diese Felder ist es z.B. möglich, einen besonderen Steuersatz allgemein für Auslandsumsätze oder für bestimmte Länder zu setzen.

Der wichtigste Wert ist natürlich der eigentliche '''Steuersatz''' („Tax Rate“, in manchen Übersetzungen blöderweise '''„Wechselkurs“''' genannt).

Nachdem man auf diese Art den ersten Steuersatz angelegt hat, sollte es ein leichtes sein, noch einen für den ermäßigten Satz und einen mit dem Satz 0,0 anzulegen. Auch hier ist es sinnvoll, darauf zu achten, das alle Steuersätze mit der Organisation „*“ angelegt werden. Außerdem kann man auch hier den vorab vorhandenen Steuersatz „Standard“ deaktivieren (oder vielleicht sogar löschen).

In diesem Fenster ist es dann auch möglich, Steuersätze für Auslandsumsätze anzulegen, indem man das entsprechende Zielland anlegt. Lässt man das Zielland frei, sollte das dann alle restlichen Länder betreffen. Ich habe keine persönliche Erfahrung damit gesammelt, denke aber, das sollte selbsterklärend sein.

=== weitere Tabs ===

In dem Tab „Steuernummer“ (schlecht übersetzt „Tax ZIP“) kann die Steuer abhängig von der Postleitzahl gesetzt werden, was in Deutschland nicht nötig ist.

Interessant ist aber das Tab „Buchführung“, in dem man einstellen kann, auf welche Konten die Steuer gebucht wird. Die vorgegebenen Werte sind aus dem Buchführungs-Schema übernommen (Diese wurden bei der Anlage des Mandanten als Default-Konten aus der CSV-Datei mit dem Kontenplan übernommen). Da man in Deutschland für die Umsatzsteuererklärung diese Posten getrennt angeben muss, kann es sinnvoll sein, hier unterschiedliche Konten für die Steuerarten anzugeben.

= Probleme mit iDempiere im deutschen/europäischen Steuersystem =

* Ich habe Hinweise darauf gesehen, das für Waren und Dienstleistungen unterschiedliche Steuerregelungen gelten. Das möchte ich noch mit meinem Steuerberater abklären. Falls es nötig ist, mehrere steuerbefreite Tatbestände auf der Rechnung getrennt aufzuführen, geht dass nicht, solange in Tax.java alle steuerbefreiten Geschäftspartner über einen "Tax"-Datensatz geschoren werden (die Formel, wie der gefunden wird, ist sowieso etwas zweifelhaft, was Organisationen anbetrifft, aber das ist ein anderes Thema).
* steuerbefreite Lieferungen in die EU und in ein Drittland sind nicht nur unterschiedlich in der USt-VA zu deklarieren, sondern müssen auch unterschiedlich auf der Rechnung bezeichnet werden (Stichwort "Steuerschuldnerschaft des Leistungsempfängers" und "Nicht im Inland steuerbare Leistung"). Das ist mit iDempiere nur mit Tricksen möglich (mein Plan ist ein SQL-Feld in C_Invoice_Header_V).
* In dem Zusammenhang sollte man über die Tatsache nachdenken, das das Programm, wenn ein Geschäftspartner als "steuerbefreit" angegeben ist, gar keine Steuerzeile in der Rechnung (im Tab Steuer) anlegt. Falls wir also verschiedene Fälle von Steuerbefreiung haben und später z.B. in der USt-VA deklarieren wollen, finden wir die vielleicht nicht mehr. (Entweder uns fällt ein anderer Weg ein, eine Steuererklärung zu fabrizieren oder wir brauchen eine Zeile dafür).
* In dem Zusammenhang frage ich mich außerdem, was der Haken beim Steuersatz "benötigt ein Steuerbefreiungszertifikat" bewirkt).

Folgende Formel eingefügt in C_Invoice_Header_V ist mein Versuch, den zweiten Punkt zu lösen. Das ist ausdrücklich nur ein Denkanstoss und eine bessere Lösung sollte auf jeden Fall noch überdacht werden.

CASE
WHEN BP_IsTaxExempt = 'N' THEN ''
WHEN C_Invoice_Header_vt.C_Country_ID = 101 THEN ''
WHEN C_Invoice_Header_vt.C_Country_ID IN
/* european union in alphabetical order */
(103,142,167,101,176,181,102,192,212,214,163,226,232,233,241,105,108,280,281,285,313,301,302,106,166,206,333,165)
THEN 'Steuerschuldnerschaft des Leistungsempfängers'
ELSE 'Nicht im Inland steuerbare Leistung'
END

= Weitere Links =

* http://www.adempiere.com/Umsatzsteuer Artikel im ADempiere Wiki - nicht wirklich gut, aber das beste, was wir zur Zeit haben :-(
* http://www.finanzamt.bayern.de/Informationen/Formulare/Weitere_Themen_A_bis_Z/Umsatzsteuer-Voranmeldung/ - Formular für USt-Voranmeldung und Erklärungen hierzu zum Download
* http://www.gesetze-im-internet.de/ustg_1980/index.html - Umsatzsteuergesetz
* http://ec.europa.eu/taxation_customs/resources/documents/taxation/vat/how_vat_works/rates/vat_rates_de.pdf - Sehr umfangreiche Informationen über fast alle Steuersätze in der EU

Anwenderhandbuch mit DocBook erstellen

2014-11-24T20:47:38Z

TBayen:

== Warum DocBook für das iDempiere Anwenderhandbuch verwendet wird ==

DocBook eignet sich besonders zur Erstellung von Büchern, Artikeln und Dokumentationen im technischen Umfeld (Hardware oder Software).

[http://de.wikipedia.org/wiki/DocBook Weitere Infos zu DocBook]

== Eingesetzte Version ==

Zur Zeit wird 5.0 eingesetzt. Die Diskussion läuft jedoch noch. Im Gespräch ist auch eine ältere Version einzusetzen, da dort mehr Entwicklungswerkzeuge (z.B.: Serna) zur Verfügung stehen.
Sobal eine eindeutige Entscheidung getroffen wurde wird diese hier veröffentlicht.

== Vorbereitung und Hinweis zum Einsatz von DocBook ==

DocBook wird als DEB Paket unter Linux installiert

Innerhalb der DocBook Datei wird auf die "XSL Stylesheets" verwiesen<br>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN" "http://docbook.org/xml/5.0/dtd/docbook.dtd">
Diese werden immer aktuell aus dem Internet, ohne Änderungen, verwendet.<br>
Somit wird sichergestellt, dass die erstellte Dokumentation weltweit ein einheitliches Aussehen erhält.

Der Artikel (oder das Buch) wird in einen Texteditor erstellt.<br>
In der Konsole wird der Artikel oder das Buch in HTML Dateien übersetzt. Hierzu wird z.B. folgender Befehl verwendet:
xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/chunk.xsl Startseite.xml
Der genaue Befehl hängt natürlich von Ihrer Installation und Ihrem Arbeitsverzeichnis ab. Dies ist nur ein Beispiel.

Um Include-Direktiven zu benutzen, nimmt man folgenden Befehl (mit der Option "--xinclude"):

xsltproc --xinclude /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/html/chunk.xsl iDempiere-Buch.xml

== Eingesetzte Editoren und Hilfsmittel um einen DocBook Artikel zu erstellen ==

Es kann grundsätzlich jeder Texteditor eingesetzt werden.
DocBook Funktionen werden z.B. von Emacs unterstützt.

=== XML Copy Editor ===

Thomas Thießen setzt den "XML Copy Editor" ein.<br>
Kleiner Tipp:<br>
* Datei
* Neu
* DocBook 5.0 book (*xml) oder DocBook 5.0 article (*xml) auswählen

Anschließend steht der Befehlssatz von DocBook 5.0 zur Verfügung

== Kapitelstruktur ==

Die Kapitelstruktur sollte von allen Autoren einheitlich verwendet werden.<br>
Hier folgen die ersten "Grundgedanken"

=== Konkrete Anwendung ===

<book xml:lang="de" xml:id="userguid-anwenderhandbuch"> // <book> Das gesamte Buch (ink. ID)
<title>iDempiere Anwenderhandbuch</title> // <title> Titel des Buches
<article xml:id="userguide-allgemeines-zu-idempiere-article"> // <article> Artikel (Grobes Kapitel)
<title>Allgemeines zu iDempiere</title> // <title> Titel des Kapitels
</article>

<article> // <article> Artikel (Grobes Kapitel)
<sect1 xml:id="userguide-startseite"> // <sect1> ein wesentliches Unterkapitel (Eigene Seite, Indexeintrag wird erzeugt, große Überschrift)
<title>Startseite - Willkommensseite</title>
<sect2 xml:id="userguide-einleitung"> // <sect2> Ein kleiners Unterkapitel (Keine eigene Seite, kein Indexeintrag, mittelgroße Überschrift)
<title>Einleitung</title>
</sect2>
<sect2 xml:id="userguide-bereiche-der-startseite">
<title>Bereiche der Startseite</title>
<sect3 xml:id="userguide-menueleiste-idempiere-logo"> // <sect3> Ein Absatz (Keine eigene Seite, kein Indexeintrag, mittelgroße Überschrift)
<title>Menüleiste: iDemperie Logo</title>
</sect3>
<sect3 xml:id="userguide-menueleiste-hinzufuegen-loeschen-knopf">
<title>Menüleiste: hinzufügen / löschen Knopf</title>
</sect3>
</sect2>
</sect1>
</article>
</book>

=== Gedankensammlung zur Kapitelstruktur ===

<book xml:lang="de" xml:id="userguid-idempiere"> // book ist der "Name des Buches"
<chapter xml:id="userguide-installation"> // chapter ist das grobe "oberste Kapitel" z.B. "Vorwort", "Installation", "Anwenderhandbuch", "Anhänge", usw.... (chapter kann jedoch KEINE article enthalten)
</chapter>
<chapter xml:id="userguide-anwenderhanduch">
<section xml:id="userguide-allgemeine-einführung"> // section ist ein wesentliches Kapitel, innerhalb des "obersten Kapitels"
</section>
</chapter>
<chapter xml:id="userguide-inhaltsverzeichnis">
</chapter>
</book>

* Ein <book> kann <chapter> oder <article> enthalten
* Ein <chapter> kann KEINE <article>
* Ein <chapter> kann <section> enthalten
* Eine <section> kann weitere <section> enthalten.

* <sect1> bildet immer eine große Überschrift als "Kapitel"
* <sect1> wird immer auf einer neuen Seite begonnen
* <sect1> erhält immer einen Indexeintrag

== Speicherort für Bilder ==

* Zur Zeit werden die Bilder auf dem lokalen Laufwerk gespeichert. Hierfür muss ein öffentlicher Org geschaffen werden.
* Dateinamen und Verzeichnisbenennungen müssen festgelegt werden

== Eingesetzte Befehle ==

=== Gliederung ===
<book xml:lang="de" xml:id="userguid-anwenderhandbuch">
<article xml:id="userguide-grundlagen">
<sect1 xml:id="userguide-startseite">
<sect2 xml:id="userguide-einleitung">
<sect3 xml:id="userguide-menueleiste-idempiere-logo">
<title>Einleitung</title>
<para>Eigentlicher Textbereich</para>
<imageobject><imagedata fileref="bilder/Startseite.png"/></imageobject>

=== Listen ===
<orderedlist>
<listitem>Menüleiste</listitem>
</orderedlist>

<itemizedlist mark='opencircle'>
<listitem override='bullet'>Informationen über Ihre aktuell installierte iDempier Installation</listitem>
</itemizedlist>

=== Infos zu Lizenz und Autor ===
<info>
<legalnotice>
<para>Der Inhalt ist verfügbar unter der Lizenz GNU-Lizenz für freie Dokumentation 1.3 oder höher.</para>
</legalnotice>
<author>
<personname>
<firstname>Thomas</firstname>
<surname>Thießen</surname>
</personname>
</author>
<author>
<publisher>
<publishername>Thomas Thießen </publishername>
<address>Hülser Str. 113</address>
<address>DE-47803 Krefeld</address>
<address>email TTHatARCORdotDE</address>
</publisher>
<edition>01.11.2014 iDempiere Version 2.0 </edition>
</info>

<appendix>
<title>Lizenzbedingungen</title>
<para>Lizenzbedingungen für dieses Buch</para>
</appendix>

=== Widmung ===
<dedication>
<title>Widmung am Anfang des Buches</title>
<para>Eigentliche Widmung</para>
</dedication>

[[Category:Wiki]]
[[Category:DocBook]]

Treffen in Deutschland

2014-09-11T15:15:21Z

TBayen: /* iDempiere Workshop Burg Bischofstein */

= Treffen in Deutschland =

Auf dieser Seite können in loser Folge Treffen vereinbart, organisiert und beschrieben werden. Eine offene und frühzeitige Kommunikation soll mehr Leute dazu anregen, dazuzukommen. Wer auf dem laufenden bleiben möchte, sollte der deutschsprachigen [https://groups.google.com/forum/#!forum/idempiere-de Mailingliste] beitreten.

== 3./4. August 2014 iDempiere Workshop Burg Bischofstein ==

Am 3./4. August 2014 fand in Hatzenport auf der Burg Bischofstein eine Entwickler-Schulung mit Workshop statt.

Siehe [[:en:IDempiere_Workshop_2014]]

== 7. März 2014: iDempiere Deutschland Konferenz ==

Am 7.3.2014 trifft sich die deutschsprachige iDempiere-Community in '''Bonn'''. Um Anmeldung bei [[User:TBayen]] oder auf der Mailingliste wird gebeten. Thema ist u.a. der Stand der SEPA-Umsetzung.

Siehe https://groups.google.com/forum/#!topic/idempiere-de/2QBhw49ftOM

=== Vorträge===
Auf Wunsch der Community sind die von der [http://www.evenos-consulting.de evenos Consulting GmbH] gehaltenen Vorträge nun hier zu finden:
* [http://de.slideshare.net/xxtesaxx/prsentation-webservices Webservices]
* [http://de.slideshare.net/xxtesaxx/prsentation-plug-in-development Plug-In Development]
* [http://de.slideshare.net/adrilleros/idempiere-mobile Mobile Apps]
* [http://de.slideshare.net/adrilleros/idempiere-reproting Office Reporting]

Hier findet sich der Vortrag von Marco Westermann (interSales AG aus Köln)
* [http://de.slideshare.net/MarWestermann/erp-anbindung-an-fremdsysteme-32219620 Anbindung von Fremdsystemen an ein ERP-System]

== [[Weltkonferenz 2013 Mai|iDempiere Welt Konferenz im Mai 2013 in Deutschland.]] ==

Die [[Weltkonferenz 2013 Mai|'''iDempiere Welt Konferenz im Mai 2013 in Deutschland.''']] wird von Redhuan D'Oon (red1) und Thomas Bayen geplant. Näheres auf folgenden Konferenz-Seiten:

* Vorgesehen sind folgende Workshops und Schulungen:
** [[Weltkonferenz 2013 Mai - Administrator Training|6-10 Mai, 5 Tage Administrator Training]]
** [[Weltkonferenz 2013 Mai - Entwicklerschulung|13-15 Mai, 20-21 Mai, 5 Tage Entwicklerschulung]]
** [[Weltkonferenz 2013 Mai - Konferenzthemen|16-17 Mai, 2 Tage Konferenzthemen]]

== 31. Januar 2013: Treffen des Übersetzungsteams ==

Siehe auch das [[Protokoll Treffen 2013-01-31]].

Am Donnerstag, den '''31.01.2013''' trifft sich in '''Krefeld''' (Bei [[User:TBayen|Thomas Bayen]]) eine kleine Gruppe, um sich kennenzulernen und über die Übersetzung sowie Anpassungen an den deutschen Sprachraum zu sprechen. Das Treffen soll tagsüber stattfinden. Der genaue Beginn kann mit Thomas abgesprochen werden. Es wurde in [https://groups.google.com/forum/#!topic/idempiere-de/-vlnIUC76lQ diesem Thread] auf der Mailingliste vereinbart.

Adresse:

Jakob Bayen KG
Getränke-Fachgroßhandlung
Bleichpfad 27
47799 Krefeld
Tel. 02151/658090
https://maps.google.com/maps?q=krefeld+bleichpfad+27

Vom Hauptbahnhof Krefeld ist es ca. 1km - ich kann Euch bei Vorankündigung gerne abholen lassen.

Die Agenda steht jetzt ebenfalls im [[Protokoll Treffen 2013-01-31]].

[[Category:Konferenzen|D]]
[[Category:Konferenzen 2014|D]]
[[Category:Konferenzen 2013|D]]

Treffen in Deutschland

2014-09-11T15:15:02Z

TBayen: /* iDempiere workshop Burg Bischofstein */

= Treffen in Deutschland =

Auf dieser Seite können in loser Folge Treffen vereinbart, organisiert und beschrieben werden. Eine offene und frühzeitige Kommunikation soll mehr Leute dazu anregen, dazuzukommen. Wer auf dem laufenden bleiben möchte, sollte der deutschsprachigen [https://groups.google.com/forum/#!forum/idempiere-de Mailingliste] beitreten.

== iDempiere Workshop Burg Bischofstein ==

Am 3./4. August 2014 fand in Hatzenport auf der Burg Bischofstein eine Entwickler-Schulung mit Workshop statt.

Siehe [[:en:IDempiere_Workshop_2014]]

== 7. März 2014: iDempiere Deutschland Konferenz ==

Am 7.3.2014 trifft sich die deutschsprachige iDempiere-Community in '''Bonn'''. Um Anmeldung bei [[User:TBayen]] oder auf der Mailingliste wird gebeten. Thema ist u.a. der Stand der SEPA-Umsetzung.

Siehe https://groups.google.com/forum/#!topic/idempiere-de/2QBhw49ftOM

=== Vorträge===
Auf Wunsch der Community sind die von der [http://www.evenos-consulting.de evenos Consulting GmbH] gehaltenen Vorträge nun hier zu finden:
* [http://de.slideshare.net/xxtesaxx/prsentation-webservices Webservices]
* [http://de.slideshare.net/xxtesaxx/prsentation-plug-in-development Plug-In Development]
* [http://de.slideshare.net/adrilleros/idempiere-mobile Mobile Apps]
* [http://de.slideshare.net/adrilleros/idempiere-reproting Office Reporting]

Hier findet sich der Vortrag von Marco Westermann (interSales AG aus Köln)
* [http://de.slideshare.net/MarWestermann/erp-anbindung-an-fremdsysteme-32219620 Anbindung von Fremdsystemen an ein ERP-System]

== [[Weltkonferenz 2013 Mai|iDempiere Welt Konferenz im Mai 2013 in Deutschland.]] ==

Die [[Weltkonferenz 2013 Mai|'''iDempiere Welt Konferenz im Mai 2013 in Deutschland.''']] wird von Redhuan D'Oon (red1) und Thomas Bayen geplant. Näheres auf folgenden Konferenz-Seiten:

* Vorgesehen sind folgende Workshops und Schulungen:
** [[Weltkonferenz 2013 Mai - Administrator Training|6-10 Mai, 5 Tage Administrator Training]]
** [[Weltkonferenz 2013 Mai - Entwicklerschulung|13-15 Mai, 20-21 Mai, 5 Tage Entwicklerschulung]]
** [[Weltkonferenz 2013 Mai - Konferenzthemen|16-17 Mai, 2 Tage Konferenzthemen]]

== 31. Januar 2013: Treffen des Übersetzungsteams ==

Siehe auch das [[Protokoll Treffen 2013-01-31]].

Am Donnerstag, den '''31.01.2013''' trifft sich in '''Krefeld''' (Bei [[User:TBayen|Thomas Bayen]]) eine kleine Gruppe, um sich kennenzulernen und über die Übersetzung sowie Anpassungen an den deutschen Sprachraum zu sprechen. Das Treffen soll tagsüber stattfinden. Der genaue Beginn kann mit Thomas abgesprochen werden. Es wurde in [https://groups.google.com/forum/#!topic/idempiere-de/-vlnIUC76lQ diesem Thread] auf der Mailingliste vereinbart.

Adresse:

Jakob Bayen KG
Getränke-Fachgroßhandlung
Bleichpfad 27
47799 Krefeld
Tel. 02151/658090
https://maps.google.com/maps?q=krefeld+bleichpfad+27

Vom Hauptbahnhof Krefeld ist es ca. 1km - ich kann Euch bei Vorankündigung gerne abholen lassen.

Die Agenda steht jetzt ebenfalls im [[Protokoll Treffen 2013-01-31]].

[[Category:Konferenzen|D]]
[[Category:Konferenzen 2014|D]]
[[Category:Konferenzen 2013|D]]

Treffen in Deutschland

2014-09-11T12:53:10Z

TBayen:

= Treffen in Deutschland =

Auf dieser Seite können in loser Folge Treffen vereinbart, organisiert und beschrieben werden. Eine offene und frühzeitige Kommunikation soll mehr Leute dazu anregen, dazuzukommen. Wer auf dem laufenden bleiben möchte, sollte der deutschsprachigen [https://groups.google.com/forum/#!forum/idempiere-de Mailingliste] beitreten.

== iDempiere workshop Burg Bischofstein ==

Am 3./4. August 2014 fand in Hatzenport auf der Burg Bischofstein eine Entwickler-Schulung mit Workshop statt.

Siehe [[:en:IDempiere_Workshop_2014]]

== 7. März 2014: iDempiere Deutschland Konferenz ==

Am 7.3.2014 trifft sich die deutschsprachige iDempiere-Community in '''Bonn'''. Um Anmeldung bei [[User:TBayen]] oder auf der Mailingliste wird gebeten. Thema ist u.a. der Stand der SEPA-Umsetzung.

Siehe https://groups.google.com/forum/#!topic/idempiere-de/2QBhw49ftOM

=== Vorträge===
Auf Wunsch der Community sind die von der [http://www.evenos-consulting.de evenos Consulting GmbH] gehaltenen Vorträge nun hier zu finden:
* [http://de.slideshare.net/xxtesaxx/prsentation-webservices Webservices]
* [http://de.slideshare.net/xxtesaxx/prsentation-plug-in-development Plug-In Development]
* [http://de.slideshare.net/adrilleros/idempiere-mobile Mobile Apps]
* [http://de.slideshare.net/adrilleros/idempiere-reproting Office Reporting]

Hier findet sich der Vortrag von Marco Westermann (interSales AG aus Köln)
* [http://de.slideshare.net/MarWestermann/erp-anbindung-an-fremdsysteme-32219620 Anbindung von Fremdsystemen an ein ERP-System]

== [[Weltkonferenz 2013 Mai|iDempiere Welt Konferenz im Mai 2013 in Deutschland.]] ==

Die [[Weltkonferenz 2013 Mai|'''iDempiere Welt Konferenz im Mai 2013 in Deutschland.''']] wird von Redhuan D'Oon (red1) und Thomas Bayen geplant. Näheres auf folgenden Konferenz-Seiten:

* Vorgesehen sind folgende Workshops und Schulungen:
** [[Weltkonferenz 2013 Mai - Administrator Training|6-10 Mai, 5 Tage Administrator Training]]
** [[Weltkonferenz 2013 Mai - Entwicklerschulung|13-15 Mai, 20-21 Mai, 5 Tage Entwicklerschulung]]
** [[Weltkonferenz 2013 Mai - Konferenzthemen|16-17 Mai, 2 Tage Konferenzthemen]]

== 31. Januar 2013: Treffen des Übersetzungsteams ==

Siehe auch das [[Protokoll Treffen 2013-01-31]].

Am Donnerstag, den '''31.01.2013''' trifft sich in '''Krefeld''' (Bei [[User:TBayen|Thomas Bayen]]) eine kleine Gruppe, um sich kennenzulernen und über die Übersetzung sowie Anpassungen an den deutschen Sprachraum zu sprechen. Das Treffen soll tagsüber stattfinden. Der genaue Beginn kann mit Thomas abgesprochen werden. Es wurde in [https://groups.google.com/forum/#!topic/idempiere-de/-vlnIUC76lQ diesem Thread] auf der Mailingliste vereinbart.

Adresse:

Jakob Bayen KG
Getränke-Fachgroßhandlung
Bleichpfad 27
47799 Krefeld
Tel. 02151/658090
https://maps.google.com/maps?q=krefeld+bleichpfad+27

Vom Hauptbahnhof Krefeld ist es ca. 1km - ich kann Euch bei Vorankündigung gerne abholen lassen.

Die Agenda steht jetzt ebenfalls im [[Protokoll Treffen 2013-01-31]].

[[Category:Konferenzen|D]]
[[Category:Konferenzen 2014|D]]
[[Category:Konferenzen 2013|D]]

Benutzer:TBayen

2014-08-12T15:41:33Z

TBayen:

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
** [[Tiny iDempiere]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

EMail einrichten

2014-08-10T14:12:38Z

TBayen: Debugging-Einstellungen benutzen

Es ist ganz einfach möglich, aus iDempiere heraus EMails zu versenden.

== Einrichtung ==

Um Mails zu versenden, muss iDempiere Zugriff auf einen SMTP Mailserver erhalten. Hierzu gibt es verschiedene Anleitungen wie die folgenden (weshalb ich das jetzt im Detail hier nicht wiederhole):

* http://www.adempiere.com/EMail
* http://www.adempiere.metas.de/mediawiki/index.php/E-Mail_Versand_einrichten

In einer Beispiel-Implementierung habe ich auf einem Server zuerst das '''postfix''' Debian-Paket eingerichtet. In der Debconf-Einrichtung konnte man postfix als Internet-Server einrichten, was ganz schnell gibt und sofort funktionierte. Ich persönlich installiere dazu immer noch das Paket '''mailutils''', so das man dann z.B. von der Konsole aus Mails mit dem Kommando "mail" versenden kann (zum Testen). Ein solcher Server sollte übrigens noch per Firewall von außen her blockiert werden, damit nicht Gott und die Welt seine Spam über unseren Server einliefert.

Die Einstellungen in iDempiere kann man bei der Programmeinrichtung angeben. Man kann sie aber auch problemlos später als Mandanten-Administrator im Fenster "Mandant" angeben. Bei einem postfix auf dem selben Rechner gibt man als Servernamen "localhost", als Port 25 und keine Authentifizierung und Verschlüsselung an. Außerdem gibt man eine Default-Mailadresse an und kann dann auch schon mit dem Test-Button die erste Mail versenden.

== Möglichkeiten ==

* Über den Feedback-Button (oben rechts) kann ein Benutzer eine Mail z.B. an den Support senden. In der Voreinstellung ist dieser Mail direkt ein Protokoll mit dem Systemstatus und ein Screenshot beigefügt. Das ist insbesondere für das Melden von Benutzer-Problemen sehr hilfreich.
* Man kann selbstverständlich auch Jasper-Berichte ganz einfach per Mail als PDF-Anhang versenden. Eigentlich ist das fast selbsterklärend, aber [http://www.adempiere.metas.de/mediawiki/index.php/Belege_per_Email_versenden hier] ist es auch nochmal beschrieben.

== Debugging ==

In obengenanntem Link im Metas-Wiki steht, das es eine Möglichkeit gibt, alle Mails nicht an die Empfänger zu versenden, sondern an eine einzige zentrale Mailadresse. Das kann dem Debugging dienen, kann aber auch einen Check der Ausgangspost erlauben, bevor die Mails dann endgültig weitergeleitet werden. Die dortige Beschreibung funktioniert allerdings nicht. Also habe ich in die Hände gespuckt und das als [https://idempiere.atlassian.net/browse/IDEMPIERE-2104 IDEMPIERE-2104] implementiert. Um das zu benutzen, geht man folgendermassen vor:

* Zuerst mal sollte man sehen, das das Mailsystem normal läuft. (wenn das nicht geht, ist die zusätzliche Umleitung vielleicht auch nicht das richtige Werkzeug, um einen Fehler zu finden.) Also erst einmal einen Bericht ausgeben und dann per Mail versenden (man kann übrigens im String-Feld unterhalb des Benutzer-Suchfeldes eine Adresse eingeben, ohne das diese vorher dem Programm bekannt sein muss).
* Als nächstes öffnet man als Admin des Mandanten das Fenster '''Systemkonfigurator'''. Dort trägt man als ersten Test den folgenden neuen Schlüssel ein:
: '''MAIL_SEND_BCC_TO_ADDRESS''' : "Configured Value" -> 'meinemailadresse@meinserver.de'
* Nun testet man diese Funktion. Es sollte eine Kopie von jeder ausgehenden Mail per BCC an die angegebene Adresse geschickt werden. Die angegebene Adresse sollte nicht per Umleitung/weiterleitung wieder auf die selbe Adresse gehen, die man sonst auch zum Testen nimmt (mein schlauer Mailserver hatte erkannt, das das zwei gleiche Mails sind und eine direkt weggeworfen). ''(Im übrigen gibt es wohl allgemein Mailserver mit Problemen, BCC-Adressen auszuliefern, wenn die gleiche Mail gleichzeitig innerhalb derselben Domain ordentlich ausgeliefert wird. Wenn derartige Probleme auftreten, liegt's am Mailserver, nicht in iDempiere. Ich empfehle, bei Problemen erstmal eine GMX-Adresse einzurichten, um das auszuschliessen.)''
* Als nächstes aktiviert man die nächste Einstellung im Systemkonfigurator:
* '''MAIL_DONT_SEND_TO_ADDRESS''' : "Configured Value" -> 'Y'
* Nun testet man das Ergebnis: Es werden alle Mails nur noch an den Administrator (die BCC-Adresse) geschickt und nicht mehr an die eigentlichen Adressaten.
* Wenn alles glatt läuft, kann man im Thunderbird/Icedove die erhaltene Mail mit "Ctrl-E" öffnen und direkt versenden, um sie dem ursprünglichen Empfänger zukommen zu lassen. Auf diese Art kann man, wenn man iDempiere nicht so richtig traut, eine Art Torwächter haben, der alle Mails nochmal checkt und dann manuell rausschickt.
: ''(leider geht das z.Zt. noch nicht perfekt, siehe Kommentare https://idempiere.atlassian.net/browse/IDEMPIERE-2104 und https://idempiere.atlassian.net/browse/IDEMPIERE-2132)''

Benutzer:TBayen

2014-08-08T11:35:11Z

TBayen: Änderung 4113 von TBayen (Diskussion) rückgängig gemacht.

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

Benutzer:TBayen

2014-08-08T11:18:13Z

TBayen:

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]], [[EMail debuggen]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

Vereinsverwaltung/Einführung

2014-06-10T20:49:21Z

TBayen: Link zum PDF

Dies ist eine Kurzanleitung für die [[Vereinsverwaltung]]. Die ausführliche und bebilderte Version ist erhältlich unter https://vv.efg-krefeld.de/Vereinsverwaltung-Anleitung.pdf

= Installation =

Der Server ist von [[User:TBayen]] so installiert worden, wie auf der Seite [[Vereinsverwaltung/Konfiguration]] beschrieben ist. Er ist auf einem Cloud-Server installiert und wird per Web-Browser bedient. Wer eine eigene Version installieren oder installiert bekommen möchte, kann mich gerne ansprechen. :-)

Das Programm läuft als Webanwendung. Da es die zk-Bibliothek benutzt (die starken Gebrauch von Javascript macht), empfehle ich die Installation eines aktuellen Browsers. Beste Ergebnisse gibt ein aktueller Google Chrome. Ein aktueller Firefox sollte aber auch gehen, fühlt sich aber (z.Zt.) etwas langsamer an.

= Start und Login =

== Starten des Browsers ==

Dann geht man auf die angegebene URL, um die Applikation zu starten. Es zeigt sich das Login-Fenster.

== Login-Fenster ==

TODO Screenshot

Den Benutzername habe ich bei der Installation mit vergeben. Da nach diesem Namen in der Mitgliederliste auch alphabetisch gesucht werden kann, beginnt er mit dem Nachnamen, hat also die Form "Schmitz-Backes, Michael" (genauso mit Gross- und Kleinschreibung und Komma, ohne Anführungszeichen). Das Passwort lasse ich Euch ggf. auf einem separaten Weg zukommen (auch dabei ist Gross- und Kleinschreibung wichtig). Die Sprache stellst Du am besten auf deutsch. Beim ersten Mal sollte man "Rolle wählen" und "Angaben merken" auswählen. Letzteres führt dazu, das Du auf diesem Browser beim nächsten Mal nichts mehr eingeben musst, sondern direkt "ok" drücken kannst.

== Login Seite 2: Rollen-Auswahl ==

TODO Screenshot

Ersteres führt (nach OK) zu einem weiteren Eingabefenster. Dort kann man seine Rolle auswählen:

* '''Vorstandsmitglied''': Die Rolle "Vorstandsmitglied" dient dem Zugriff auf alle Daten, aber nur lesend. Normale Vorstandmitglieder sollten mit dieser Rolle arbeiten, was verhindert, das man was kaputtmachen kann.
* '''Datenpfleger''': Wer was kaputt- oder ganzmachen möchte (also nach unserer Beschlussfassung nur eine Person), kann sich als "Datenpfleger" anmelden. Die anderen Einstellungen in diesem Fenster könnt ihr ignorieren.

Ich habe das so eingerichtet, das rein technisch jeder beide Rollen annehmen kann, wenn er möchte, was es im Notfall einfacher macht, die Aufgaben anders zu verteilen. Natürlich geht das dann von ein bisschen Selbstdisziplin bei den anderen aus. ;-)

= Hauptfenster und Menü =

TODO Screenshot

Nach einem weiteren OK öffnet sich das Hauptfenster. Das wichtigste ist oben der '''"Menü"'''-Knopf. Es gibt dort einen Eintrag "Mitglieder". Darauf klickt man, woraufhin das Eingabefenster für Mitglieder aufgerufen wird. Man kann den Menüpunkt übrigens auch nach links in die '''Favoriten''' ziehen (was ich bei Michael schonmal gemacht habe) und dann dort mit einem Klick das Eingabefenster öffnen.

Außerdem gibt es einen Menüpunkt, um sein '''Passwort zu ändern'''. Das sollte man am besten zu Anfang einmal machen. Bitte kein Passwort eingeben, das anderweitig fürs Online-Banking verwendet wird, da man der Sicherheit eines Cloud-Servers immer nur bedingt trauen sollte.

= Eingabefenster für Mitglieder =

== Suchdialog ==

TODO Screenshot

Als allererstes öffnet sich der Suchdialog. Dort kann man z.B. nach der Nummer oder einem Namen suchen. Die Nummern sind immer vierstellig, also "0001", um eindeutiger suchen zu können. Wer mit Joker suchen möchte, nimmt dafür "%" als Joker. Also findet man z.B. mit "%drea%" alle Andreasse und Andreaen. Man kann aber auch einfach gar nichts eingeben, dann findet man alle Datensätze (also alle Mitglieder und Ex-Mitglieder).

== Eingabefenster ==

=== Navigation durch die Datensätze ===

TODO Screenshot

Nach einem "OK" (grüner Haken) ruft man die Liste der Suchergebnisse auf. Oben rechts im Fensterchen steht sowas wie [1/26] (bei Suche nach Andreassen) oder [1/1164] (bei Suche nach allen Datensätzen).

Wer später was anderes suchen möchte, kann in der Toolbar auf die Lupe klicken und erhält wieder den Suchdialog wie am Anfang.

In der Toolbar findet sich ein Knopf, der wie eine Tabelle mit einem einzelnen roten Feld aussieht. Damit schaltet man zwischen der Tabellen- und der Formularansicht um. Einfach mal ausprobieren und hin- und herschalten, dann versteht Ihr das schon.

TODO Screenshot

In der Listenansicht sieht man immer eine (scrollbare) Liste mit einer Seite von 25 Datensätzen. Am unteren Rand des Listenbereichs (unten links) ist ein Feld, in dem man die angezeigte Seite auswählen kann. Mit den dort befindlichen Pfeilknöpfen kann man auch seitenweise durch die Daten blättern (also immer 25 weiter). Oben rechts (da, wo [1/1164] steht) kann man auch immer einen einzelnen Datensatz weiternavigieren. Das kann in der Formularansicht ganz gut sein, um mehrere Datensätze durchzugehen.

=== Register mit Unterlisten ===

Am unteren Rand gibt es einen Bereich mit drei Registerkarten "Kontakte", "Adresse", "Bankdaten". Diese Registerkarten sind für "Unterlisten" des eigentlichen Mitgliederdatensatzes. Also sind alle Datenfelder, die nur genau einmal vorkommen, oben im Haupt-Datensatzbereich und diese drei Dinge, die mehrfach vorkommen können, stehen in diesen Registern in einer Art Unterlisten.

Hat man dort einen Datensatz ausgewählt, kann man mit dem Editier-Icon links daneben den Editor so umschalten, das der ausgewählte Datensatz der Unterliste oben im Haupt-Arbeitsbereich erscheint.

TODO Screenshot

Man kann den dann dort bearbeiten. Um wieder zurückzukommen, klickt man entweder in der Breadcrumb-Zeile oberhalb des Datensatzes auf den Link, der mit "Business Partner" beschrieben ist (Sorry! - ist noch nicht richtig "übersetzt" - das bedeutet "Mitglied"). Alternativ kann man auch in der oberen Toolbar auf den "blauen Pfeil nach oben" klicken. Der bring einen ebenfalls wieder eine Untertabellen-Ebene hoch.

=== Daten editieren, neu, löschen ===

TODO Screenshot

Hat man Daten geändert, werden die im allgemeinen gespeichert, wenn man weiternavigiert. Um sicherzugehen, sollte man ggf. das Speicher-Icon oben in der Toolbar drücken, das erscheint, sobald man ein Datenfeld geändert (und dann verlassen) hat.

Neue Datensätze erzeugt man mit dem Neu-Knopf (dritter von links in der Toolbar). Bitte nicht kopieren (rechts daneben), sondern besser immer neu drücken.

Neue Unter-Datensätze erzeugt man Mit dem Neu-Knopf (erster von links) im Kopf des Unter-Registers.

Grundsätzlich kann man mit dem Lösch-Icon (kleine Mülltonne) einen Datensatz löschen. Aber bitte keine Lösch-Orgien!!! Löschen sollte man aber nur, wenn ein Datensatz nur versehentlich angelegt wurde etc.. Ansonsten ist es dafür immer besser, den Datensatz zu '''dekativieren''' (also das Häkchen bei "Aktiv" wegzumachen). Der Datensatz verschwindet somit aus allen Listen (auf jeden Fall aus den gedruckten, je nach Einstellung auch komplett aus dem normalen Editorfenster), ist aber im Zweifelsfall noch da, um auf historische Daten weiterhin zuzugreifen (vielleicht wollen wir zum 50. Vereinsjubiläum ja die ausgetretenen Mitglieder nochmal anschreiben oder haben später nochmal Rückfragen, wann wer wie und warum ausgetreten ist oder so...?!?)

= nächste Schritte =

So, das sollte als Einführung bis hierhin reichen, um Daten zu pflegen. Bei Fragen oder Entdeckungen bitte melden. Wir sollten diese Anleitung hier weiterentwickeln, damit sie dann auch für andere Benutzer hilfreich ist. Das hier ist ein Wiki, kann also gerne von jedem geändert werden! Bei Rückfragen werde ich umgehend antworten. -- [[User:TBayen]]

Steuersätze einrichten

2014-05-29T15:25:55Z

TBayen: /* Probleme mit iDempiere im deutschen/europäischen Steuersystem */

Steuersätze einrichten

2014-05-29T12:49:45Z

TBayen: Lösungsansatz für ein Problem mit der Deklaration von Auslandsumsätzen auf der Rechnung

= Einrichtung der Umsatzsteuer =

Um Steuersätze einzurichten, müssen Steuerkategorien und Steuersätze eingerichtet werden. Außerdem muss man [[Geschäftspartner]] und [[Artikel]] richtig konfigurieren. Als letztes können noch Einstellungen im Buchführungs-Schema nötig sein. Es gibt hierfür einen vorbereiteten Workflow unter

Leistungsanalyse → Einstellungen Buchführung → Einrichtung Steuern

Da Steuersätze vom Gesetzgeber immer mal wieder gerne geändert werden – das grundsätzliche System der zu besteuernden Produkte und Personen aber nicht so oft -, sind diese beiden Dinge getrennt einzustellen.

== Steuerkategorien ==

Steuerkategorien sind Kategorien, in die alle Waren und Dienstleistungen eingeteilt werden. In Deutschland haben die meisten Produkte den normalen Steuersatz (z.Zt. 19%). Für bestimmte Produkte wie Lebensmittel gibt es einen ermäßigten Steuersatz (7%). Dazu gibt es noch einige Produkte, die von der Umsatzsteuer ganz befreit sind (z.B. Lotterielose, Wohnungsmieten). Also legen wir im Fenster [[Steuerkategorie (Fenster ID-138)|Steuerkategorien]] folgende Kategorien an:

* normale Umsatzsteuer
* ermäßigte Umsatsteuer
* umsatzsteuerbefreit

Es ist sinnvoll, darauf zu achten, das diese Steuerkategorien mit der Organisation „*“ angelegt werden, damit man sie in allen Organisationen des Mandanten nutzen kann. Wer wirklich nur eine Organisation hat, kann das aber auch ignorieren. Die bereits vorhandene Kategorie „Standard“ kann man deaktivieren (oder vielleicht sogar löschen).

== Steuersätze ==

Das System der Steuersätze in iDempiere ist recht komplex, da es auch vielfältige Steuersysteme der Welt abbilden kann. Für Deutschland sollte man mindestens drei Steuersätze anlegen.
Zuerst erstellt man im Fenster [[Steuersatz (Fenster ID-137)|Steuersatz]] einen neuen Steuersatz und gibt ihm den Namen „Umsatzsteuer 19%“. Mit der Steuerkategorie wählt man sodann aus, für welche Produkte er gilt (in unserem Fall also die soeben angelegte Kategorie „normale Umsatzsteuer“. Dahinter gibt man das Datum an (die aktuellen Sätze von 19% und 7% gelten seit dem 1.1.2007 bzw dem 1.7.1983), ab dem der Steuersatz gilt. Sobald die Politik das nächste Mal beschließt, den Satz zu erhöhen, tragen wir lediglich einen neuen Steuersatz mit dem entsprechenden Datum ein und alles läuft richtig.

''Besondere Felder:''

Das Feld '''Umsatzsteuer''' (im englischen „Sales Tax“) darf nicht angewählt werden. Hier ist die deutsche Übersetzung entgleist. Wird dieses Feld angewählt, handelt es sich um eine Steuer, die auf den gesamten Verkauf und nicht nur auf den Mehrwert genommen wird (also genau keine Umsatzsteuer). Es wird also keine Vorsteuer abgezogen. In Deutschland ist dieses Verfahren seit 1968 nicht mehr üblich. Eventuell können mit Hilfe dieses Systems in Deutschland Verbrauchsteuern (Biersteuer, Stromsteuer, Tabaksteuer) berechnet werden.

Die '''Auftrags-/Bestellart''' bleibt auf „beide“ und die '''Parentsteuer''' bleibt leer. Das '''Land''' setzt man am besten auf „Deutschland“ und das '''Ziel''' auch auf „Deutschland“. Über diese Felder ist es z.B. möglich, einen besonderen Steuersatz allgemein für Auslandsumsätze oder für bestimmte Länder zu setzen.

Der wichtigste Wert ist natürlich der eigentliche '''Steuersatz''' („Tax Rate“, in manchen Übersetzungen blöderweise '''„Wechselkurs“''' genannt).

Nachdem man auf diese Art den ersten Steuersatz angelegt hat, sollte es ein leichtes sein, noch einen für den ermäßigten Satz und einen mit dem Satz 0,0 anzulegen. Auch hier ist es sinnvoll, darauf zu achten, das alle Steuersätze mit der Organisation „*“ angelegt werden. Außerdem kann man auch hier den vorab vorhandenen Steuersatz „Standard“ deaktivieren (oder vielleicht sogar löschen).

In diesem Fenster ist es dann auch möglich, Steuersätze für Auslandsumsätze anzulegen, indem man das entsprechende Zielland anlegt. Lässt man das Zielland frei, sollte das dann alle restlichen Länder betreffen. Ich habe keine persönliche Erfahrung damit gesammelt, denke aber, das sollte selbsterklärend sein.

=== weitere Tabs ===

In dem Tab „Steuernummer“ (schlecht übersetzt „Tax ZIP“) kann die Steuer abhängig von der Postleitzahl gesetzt werden, was in Deutschland nicht nötig ist.

Interessant ist aber das Tab „Buchführung“, in dem man einstellen kann, auf welche Konten die Steuer gebucht wird. Die vorgegebenen Werte sind aus dem Buchführungs-Schema übernommen (Diese wurden bei der Anlage des Mandanten als Default-Konten aus der CSV-Datei mit dem Kontenplan übernommen). Da man in Deutschland für die Umsatzsteuererklärung diese Posten getrennt angeben muss, kann es sinnvoll sein, hier unterschiedliche Konten für die Steuerarten anzugeben.

= Probleme mit iDempiere im deutschen/europäischen Steuersystem =

* Ich habe Hinweise darauf gesehen, das für Waren und Dienstleistungen unterschiedliche Steuerregelungen gelten. Das möchte ich noch mit meinem Steuerberater abklären. Falls es nötig ist, mehrere steuerbefreite Tatbestände auf der Rechnung getrennt aufzuführen, geht dass nicht, solange in Tax.java alle steuerbefreiten Geschäftspartner über einen "Tax"-Datensatz geschoren werden (die Formel, wie der gefunden wird, ist sowieso etwas zweifelhaft, was Organisationen anbetrifft, aber das ist ein anderes Thema).
* steuerbefreite Lieferungen in die EU und in ein Drittland sind nicht nur unterschiedlich in der USt-VA zu deklarieren, sondern müssen auch unterschiedlich auf der Rechnung bezeichnet werden (Stichwort "Steuerschuldnerschaft des Leistungsempfängers" und "Nicht im Inland steuerbare Leistung"). Das ist mit iDempiere nur mit Tricksen möglich (mein Plan ist ein SQL-Feld in C_Invoice_Header_V).
* In dem Zusammenhang sollte man über die Tatsache nachdenken, das das Programm, wenn ein Geschäftspartner als "steuerbefreit" angegeben ist, gar keine Steuerzeile in der Rechnung (im Tab Steuer) anlegt. Falls wir also verschiedene Fälle von Steuerbefreiung haben und später z.B. in der USt-VA deklarieren wollen, finden wir die vielleicht nicht mehr. (Entweder uns fällt ein anderer Weg ein, eine Steuererklärung zu fabrizieren oder wir brauchen eine Zeile dafür).
* In dem Zusammenhang frage ich mich außerdem, was der Haken beim Steuersatz "benötigt ein Steuerbefreiungszertifikat" bewirkt).

Folgende Formel eingefügt in C_Invoice_LineTax_V ist mein Versuch, den zweiten Punkt zu lösen. Das ist ausdrücklich nur ein Denkanstoss und eine bessere Lösung sollte auf jeden Fall noch überdacht werden.

CASE
WHEN IsTaxExempt 'N' THEN ''
WHEN TO_Country_ID = 101 THEN ''
WHEN TO_Country_ID IN
/* european union in alphabetical order */
(103,142,167,101,176,181,102,192,212,214,163,226,232,233,241,105,108,280,281,285,313,301,302,106,166,206,333,165)
THEN 'Steuerschuldnerschaft des Leistungsempfängers'
ELSE
'Nicht im Inland steuerbare Leistung'
END AS tax_recipientmessage

= Weitere Links =

* http://www.adempiere.com/Umsatzsteuer Artikel im ADempiere Wiki - nicht wirklich gut, aber das beste, was wir zur Zeit haben :-(
* http://www.finanzamt.bayern.de/Informationen/Formulare/Weitere_Themen_A_bis_Z/Umsatzsteuer-Voranmeldung/ - Formular für USt-Voranmeldung und Erklärungen hierzu zum Download
* http://www.gesetze-im-internet.de/ustg_1980/index.html - Umsatzsteuergesetz

Steuersätze einrichten

2014-05-29T11:21:31Z

TBayen: /* Probleme mit iDempiere im deutschen/europäischen Steuersystem */

= Einrichtung der Umsatzsteuer =

Um Steuersätze einzurichten, müssen Steuerkategorien und Steuersätze eingerichtet werden. Außerdem muss man [[Geschäftspartner]] und [[Artikel]] richtig konfigurieren. Als letztes können noch Einstellungen im Buchführungs-Schema nötig sein. Es gibt hierfür einen vorbereiteten Workflow unter

Leistungsanalyse → Einstellungen Buchführung → Einrichtung Steuern

Da Steuersätze vom Gesetzgeber immer mal wieder gerne geändert werden – das grundsätzliche System der zu besteuernden Produkte und Personen aber nicht so oft -, sind diese beiden Dinge getrennt einzustellen.

== Steuerkategorien ==

Steuerkategorien sind Kategorien, in die alle Waren und Dienstleistungen eingeteilt werden. In Deutschland haben die meisten Produkte den normalen Steuersatz (z.Zt. 19%). Für bestimmte Produkte wie Lebensmittel gibt es einen ermäßigten Steuersatz (7%). Dazu gibt es noch einige Produkte, die von der Umsatzsteuer ganz befreit sind (z.B. Lotterielose, Wohnungsmieten). Also legen wir im Fenster [[Steuerkategorie (Fenster ID-138)|Steuerkategorien]] folgende Kategorien an:

* normale Umsatzsteuer
* ermäßigte Umsatsteuer
* umsatzsteuerbefreit

Es ist sinnvoll, darauf zu achten, das diese Steuerkategorien mit der Organisation „*“ angelegt werden, damit man sie in allen Organisationen des Mandanten nutzen kann. Wer wirklich nur eine Organisation hat, kann das aber auch ignorieren. Die bereits vorhandene Kategorie „Standard“ kann man deaktivieren (oder vielleicht sogar löschen).

== Steuersätze ==

Das System der Steuersätze in iDempiere ist recht komplex, da es auch vielfältige Steuersysteme der Welt abbilden kann. Für Deutschland sollte man mindestens drei Steuersätze anlegen.
Zuerst erstellt man im Fenster [[Steuersatz (Fenster ID-137)|Steuersatz]] einen neuen Steuersatz und gibt ihm den Namen „Umsatzsteuer 19%“. Mit der Steuerkategorie wählt man sodann aus, für welche Produkte er gilt (in unserem Fall also die soeben angelegte Kategorie „normale Umsatzsteuer“. Dahinter gibt man das Datum an (die aktuellen Sätze von 19% und 7% gelten seit dem 1.1.2007 bzw dem 1.7.1983), ab dem der Steuersatz gilt. Sobald die Politik das nächste Mal beschließt, den Satz zu erhöhen, tragen wir lediglich einen neuen Steuersatz mit dem entsprechenden Datum ein und alles läuft richtig.

''Besondere Felder:''

Das Feld '''Umsatzsteuer''' (im englischen „Sales Tax“) darf nicht angewählt werden. Hier ist die deutsche Übersetzung entgleist. Wird dieses Feld angewählt, handelt es sich um eine Steuer, die auf den gesamten Verkauf und nicht nur auf den Mehrwert genommen wird (also genau keine Umsatzsteuer). Es wird also keine Vorsteuer abgezogen. In Deutschland ist dieses Verfahren seit 1968 nicht mehr üblich. Eventuell können mit Hilfe dieses Systems in Deutschland Verbrauchsteuern (Biersteuer, Stromsteuer, Tabaksteuer) berechnet werden.

Die '''Auftrags-/Bestellart''' bleibt auf „beide“ und die '''Parentsteuer''' bleibt leer. Das '''Land''' setzt man am besten auf „Deutschland“ und das '''Ziel''' auch auf „Deutschland“. Über diese Felder ist es z.B. möglich, einen besonderen Steuersatz allgemein für Auslandsumsätze oder für bestimmte Länder zu setzen.

Der wichtigste Wert ist natürlich der eigentliche '''Steuersatz''' („Tax Rate“, in manchen Übersetzungen blöderweise '''„Wechselkurs“''' genannt).

Nachdem man auf diese Art den ersten Steuersatz angelegt hat, sollte es ein leichtes sein, noch einen für den ermäßigten Satz und einen mit dem Satz 0,0 anzulegen. Auch hier ist es sinnvoll, darauf zu achten, das alle Steuersätze mit der Organisation „*“ angelegt werden. Außerdem kann man auch hier den vorab vorhandenen Steuersatz „Standard“ deaktivieren (oder vielleicht sogar löschen).

In diesem Fenster ist es dann auch möglich, Steuersätze für Auslandsumsätze anzulegen, indem man das entsprechende Zielland anlegt. Lässt man das Zielland frei, sollte das dann alle restlichen Länder betreffen. Ich habe keine persönliche Erfahrung damit gesammelt, denke aber, das sollte selbsterklärend sein.

=== weitere Tabs ===

In dem Tab „Steuernummer“ (schlecht übersetzt „Tax ZIP“) kann die Steuer abhängig von der Postleitzahl gesetzt werden, was in Deutschland nicht nötig ist.

Interessant ist aber das Tab „Buchführung“, in dem man einstellen kann, auf welche Konten die Steuer gebucht wird. Die vorgegebenen Werte sind aus dem Buchführungs-Schema übernommen (Diese wurden bei der Anlage des Mandanten als Default-Konten aus der CSV-Datei mit dem Kontenplan übernommen). Da man in Deutschland für die Umsatzsteuererklärung diese Posten getrennt angeben muss, kann es sinnvoll sein, hier unterschiedliche Konten für die Steuerarten anzugeben.

= Probleme mit iDempiere im deutschen/europäischen Steuersystem =

* Ich habe Hinweise darauf gesehen, das für Waren und Dienstleistungen unterschiedliche Steuerregelungen gelten. Das möchte ich noch mit meinem Steuerberater abklären. Falls es nötig ist, mehrere steuerbefreite Tatbestände auf der Rechnung getrennt aufzuführen, geht dass nicht, solange in Tax.java alle steuerbefreiten Geschäftspartner über einen "Tax"-Datensatz geschoren werden (die Formel, wie der gefunden wird, ist sowieso etwas zweifelhaft, was Organisationen anbetrifft, aber das ist ein anderes Thema).
* steuerbefreite Lieferungen in die EU und in ein Drittland sind nicht nur unterschiedlich in der USt-VA zu deklarieren, sondern müssen auch unterschiedlich auf der Rechnung bezeichnet werden (Stichwort "Steuerschuldnerschaft des Leistungsempfängers" und "Nicht im Inland steuerbare Leistung"). Das ist mit iDempiere nur mit Tricksen möglich (mein Plan ist ein SQL-Feld in C_Invoice_Header_V).
* In dem Zusammenhang sollte man über die Tatsache nachdenken, das das Programm, wenn ein Geschäftspartner als "steuerbefreit" angegeben ist, gar keine Steuerzeile in der Rechnung (im Tab Steuer) anlegt. Falls wir also verschiedene Fälle von Steuerbefreiung haben und später z.B. in der USt-VA deklarieren wollen, finden wir die vielleicht nicht mehr. (Entweder uns fällt ein anderer Weg ein, eine Steuererklärung zu fabrizieren oder wir brauchen eine Zeile dafür).
* In dem Zusammenhang frage ich mich außerdem, was der Haken beim Steuersatz "benötigt ein Steuerbefreiungszertifikat" bewirkt).

= Weitere Links =

* http://www.adempiere.com/Umsatzsteuer Artikel im ADempiere Wiki - nicht wirklich gut, aber das beste, was wir zur Zeit haben :-(
* http://www.finanzamt.bayern.de/Informationen/Formulare/Weitere_Themen_A_bis_Z/Umsatzsteuer-Voranmeldung/ - Formular für USt-Voranmeldung und Erklärungen hierzu zum Download
* http://www.gesetze-im-internet.de/ustg_1980/index.html - Umsatzsteuergesetz

Steuersätze einrichten

2014-05-29T11:18:54Z

TBayen: /* Probleme mit iDempiere im deutschen/europäischen Steuersystem */

= Einrichtung der Umsatzsteuer =

Um Steuersätze einzurichten, müssen Steuerkategorien und Steuersätze eingerichtet werden. Außerdem muss man [[Geschäftspartner]] und [[Artikel]] richtig konfigurieren. Als letztes können noch Einstellungen im Buchführungs-Schema nötig sein. Es gibt hierfür einen vorbereiteten Workflow unter

Leistungsanalyse → Einstellungen Buchführung → Einrichtung Steuern

Da Steuersätze vom Gesetzgeber immer mal wieder gerne geändert werden – das grundsätzliche System der zu besteuernden Produkte und Personen aber nicht so oft -, sind diese beiden Dinge getrennt einzustellen.

== Steuerkategorien ==

Steuerkategorien sind Kategorien, in die alle Waren und Dienstleistungen eingeteilt werden. In Deutschland haben die meisten Produkte den normalen Steuersatz (z.Zt. 19%). Für bestimmte Produkte wie Lebensmittel gibt es einen ermäßigten Steuersatz (7%). Dazu gibt es noch einige Produkte, die von der Umsatzsteuer ganz befreit sind (z.B. Lotterielose, Wohnungsmieten). Also legen wir im Fenster [[Steuerkategorie (Fenster ID-138)|Steuerkategorien]] folgende Kategorien an:

* normale Umsatzsteuer
* ermäßigte Umsatsteuer
* umsatzsteuerbefreit

Es ist sinnvoll, darauf zu achten, das diese Steuerkategorien mit der Organisation „*“ angelegt werden, damit man sie in allen Organisationen des Mandanten nutzen kann. Wer wirklich nur eine Organisation hat, kann das aber auch ignorieren. Die bereits vorhandene Kategorie „Standard“ kann man deaktivieren (oder vielleicht sogar löschen).

== Steuersätze ==

Das System der Steuersätze in iDempiere ist recht komplex, da es auch vielfältige Steuersysteme der Welt abbilden kann. Für Deutschland sollte man mindestens drei Steuersätze anlegen.
Zuerst erstellt man im Fenster [[Steuersatz (Fenster ID-137)|Steuersatz]] einen neuen Steuersatz und gibt ihm den Namen „Umsatzsteuer 19%“. Mit der Steuerkategorie wählt man sodann aus, für welche Produkte er gilt (in unserem Fall also die soeben angelegte Kategorie „normale Umsatzsteuer“. Dahinter gibt man das Datum an (die aktuellen Sätze von 19% und 7% gelten seit dem 1.1.2007 bzw dem 1.7.1983), ab dem der Steuersatz gilt. Sobald die Politik das nächste Mal beschließt, den Satz zu erhöhen, tragen wir lediglich einen neuen Steuersatz mit dem entsprechenden Datum ein und alles läuft richtig.

''Besondere Felder:''

Das Feld '''Umsatzsteuer''' (im englischen „Sales Tax“) darf nicht angewählt werden. Hier ist die deutsche Übersetzung entgleist. Wird dieses Feld angewählt, handelt es sich um eine Steuer, die auf den gesamten Verkauf und nicht nur auf den Mehrwert genommen wird (also genau keine Umsatzsteuer). Es wird also keine Vorsteuer abgezogen. In Deutschland ist dieses Verfahren seit 1968 nicht mehr üblich. Eventuell können mit Hilfe dieses Systems in Deutschland Verbrauchsteuern (Biersteuer, Stromsteuer, Tabaksteuer) berechnet werden.

Die '''Auftrags-/Bestellart''' bleibt auf „beide“ und die '''Parentsteuer''' bleibt leer. Das '''Land''' setzt man am besten auf „Deutschland“ und das '''Ziel''' auch auf „Deutschland“. Über diese Felder ist es z.B. möglich, einen besonderen Steuersatz allgemein für Auslandsumsätze oder für bestimmte Länder zu setzen.

Der wichtigste Wert ist natürlich der eigentliche '''Steuersatz''' („Tax Rate“, in manchen Übersetzungen blöderweise '''„Wechselkurs“''' genannt).

Nachdem man auf diese Art den ersten Steuersatz angelegt hat, sollte es ein leichtes sein, noch einen für den ermäßigten Satz und einen mit dem Satz 0,0 anzulegen. Auch hier ist es sinnvoll, darauf zu achten, das alle Steuersätze mit der Organisation „*“ angelegt werden. Außerdem kann man auch hier den vorab vorhandenen Steuersatz „Standard“ deaktivieren (oder vielleicht sogar löschen).

In diesem Fenster ist es dann auch möglich, Steuersätze für Auslandsumsätze anzulegen, indem man das entsprechende Zielland anlegt. Lässt man das Zielland frei, sollte das dann alle restlichen Länder betreffen. Ich habe keine persönliche Erfahrung damit gesammelt, denke aber, das sollte selbsterklärend sein.

=== weitere Tabs ===

In dem Tab „Steuernummer“ (schlecht übersetzt „Tax ZIP“) kann die Steuer abhängig von der Postleitzahl gesetzt werden, was in Deutschland nicht nötig ist.

Interessant ist aber das Tab „Buchführung“, in dem man einstellen kann, auf welche Konten die Steuer gebucht wird. Die vorgegebenen Werte sind aus dem Buchführungs-Schema übernommen (Diese wurden bei der Anlage des Mandanten als Default-Konten aus der CSV-Datei mit dem Kontenplan übernommen). Da man in Deutschland für die Umsatzsteuererklärung diese Posten getrennt angeben muss, kann es sinnvoll sein, hier unterschiedliche Konten für die Steuerarten anzugeben.

= Probleme mit iDempiere im deutschen/europäischen Steuersystem =

* Ich habe Hinweise darauf gesehen, das für Waren und Dienstleistungen unterschiedliche Steuerregelungen gelten. Das möchte ich noch mit meinem Steuerberater abklären. Falls es nötig ist, mehrere steuerbefreite Tatbestände auf der Rechnung getrennt aufzuführen, geht dass nicht, solange in Tax.java alle steuerbefreiten Geschäftspartner über einen "Tax"-Datensatz geschoren werden (die Formel, wie der gefunden wird, ist sowieso etwas zweifelhaft, was Organisationen anbetrifft, aber das ist ein anderes Thema).
* steuerbefreite Lieferungen in die EU und in ein Drittland sind nicht nur unterschiedlich in der USt-VA zu deklarieren, sondern müssen auch unterschiedlich auf der Rechnung bezeichnet werden (Stichwort "Steuerschuldnerschaft des Leistungsempfängers" und "Nicht im Inland steuerbare Leistung"). Das ist mit iDempiere nur mit Tricksen möglich (mein Plan ist ein SQL-Feld in C_Invoice_Header_V).
* In dem Zusammenhang sollte man über die Tatsache nachdenken, das das Programm, wenn ein Geschäftspartner als "steuerbefreit" angegeben ist, gar keine Steuerzeile in der Rechnung (im Tab Steuer) anlegt. Falls wir als verschiedene Fälle von Steuerbefreiung haben und später z.B. in der USt-VA deklarieren wollen, finden wir die vielleicht nicht mehr. (Entweder uns fällt ein anderer Weg ein, eine Steuererklärung zu fabrizieren oder wir brauchen eine Zeile dafür).
* In dem Zusammenhang frage ich mich außerdem, was der Haken beim Steuersatz "benötigt ein Steuerbefreiungszertifikat" bewirkt).

= Weitere Links =

* http://www.adempiere.com/Umsatzsteuer Artikel im ADempiere Wiki - nicht wirklich gut, aber das beste, was wir zur Zeit haben :-(
* http://www.finanzamt.bayern.de/Informationen/Formulare/Weitere_Themen_A_bis_Z/Umsatzsteuer-Voranmeldung/ - Formular für USt-Voranmeldung und Erklärungen hierzu zum Download
* http://www.gesetze-im-internet.de/ustg_1980/index.html - Umsatzsteuergesetz

Steuersätze einrichten

2014-05-29T11:01:55Z

TBayen: Probleme mit dem Steuersystem

= Einrichtung der Umsatzsteuer =

Um Steuersätze einzurichten, müssen Steuerkategorien und Steuersätze eingerichtet werden. Außerdem muss man [[Geschäftspartner]] und [[Artikel]] richtig konfigurieren. Als letztes können noch Einstellungen im Buchführungs-Schema nötig sein. Es gibt hierfür einen vorbereiteten Workflow unter

Leistungsanalyse → Einstellungen Buchführung → Einrichtung Steuern

Da Steuersätze vom Gesetzgeber immer mal wieder gerne geändert werden – das grundsätzliche System der zu besteuernden Produkte und Personen aber nicht so oft -, sind diese beiden Dinge getrennt einzustellen.

== Steuerkategorien ==

Steuerkategorien sind Kategorien, in die alle Waren und Dienstleistungen eingeteilt werden. In Deutschland haben die meisten Produkte den normalen Steuersatz (z.Zt. 19%). Für bestimmte Produkte wie Lebensmittel gibt es einen ermäßigten Steuersatz (7%). Dazu gibt es noch einige Produkte, die von der Umsatzsteuer ganz befreit sind (z.B. Lotterielose, Wohnungsmieten). Also legen wir im Fenster [[Steuerkategorie (Fenster ID-138)|Steuerkategorien]] folgende Kategorien an:

* normale Umsatzsteuer
* ermäßigte Umsatsteuer
* umsatzsteuerbefreit

Es ist sinnvoll, darauf zu achten, das diese Steuerkategorien mit der Organisation „*“ angelegt werden, damit man sie in allen Organisationen des Mandanten nutzen kann. Wer wirklich nur eine Organisation hat, kann das aber auch ignorieren. Die bereits vorhandene Kategorie „Standard“ kann man deaktivieren (oder vielleicht sogar löschen).

== Steuersätze ==

Das System der Steuersätze in iDempiere ist recht komplex, da es auch vielfältige Steuersysteme der Welt abbilden kann. Für Deutschland sollte man mindestens drei Steuersätze anlegen.
Zuerst erstellt man im Fenster [[Steuersatz (Fenster ID-137)|Steuersatz]] einen neuen Steuersatz und gibt ihm den Namen „Umsatzsteuer 19%“. Mit der Steuerkategorie wählt man sodann aus, für welche Produkte er gilt (in unserem Fall also die soeben angelegte Kategorie „normale Umsatzsteuer“. Dahinter gibt man das Datum an (die aktuellen Sätze von 19% und 7% gelten seit dem 1.1.2007 bzw dem 1.7.1983), ab dem der Steuersatz gilt. Sobald die Politik das nächste Mal beschließt, den Satz zu erhöhen, tragen wir lediglich einen neuen Steuersatz mit dem entsprechenden Datum ein und alles läuft richtig.

''Besondere Felder:''

Das Feld '''Umsatzsteuer''' (im englischen „Sales Tax“) darf nicht angewählt werden. Hier ist die deutsche Übersetzung entgleist. Wird dieses Feld angewählt, handelt es sich um eine Steuer, die auf den gesamten Verkauf und nicht nur auf den Mehrwert genommen wird (also genau keine Umsatzsteuer). Es wird also keine Vorsteuer abgezogen. In Deutschland ist dieses Verfahren seit 1968 nicht mehr üblich. Eventuell können mit Hilfe dieses Systems in Deutschland Verbrauchsteuern (Biersteuer, Stromsteuer, Tabaksteuer) berechnet werden.

Die '''Auftrags-/Bestellart''' bleibt auf „beide“ und die '''Parentsteuer''' bleibt leer. Das '''Land''' setzt man am besten auf „Deutschland“ und das '''Ziel''' auch auf „Deutschland“. Über diese Felder ist es z.B. möglich, einen besonderen Steuersatz allgemein für Auslandsumsätze oder für bestimmte Länder zu setzen.

Der wichtigste Wert ist natürlich der eigentliche '''Steuersatz''' („Tax Rate“, in manchen Übersetzungen blöderweise '''„Wechselkurs“''' genannt).

Nachdem man auf diese Art den ersten Steuersatz angelegt hat, sollte es ein leichtes sein, noch einen für den ermäßigten Satz und einen mit dem Satz 0,0 anzulegen. Auch hier ist es sinnvoll, darauf zu achten, das alle Steuersätze mit der Organisation „*“ angelegt werden. Außerdem kann man auch hier den vorab vorhandenen Steuersatz „Standard“ deaktivieren (oder vielleicht sogar löschen).

In diesem Fenster ist es dann auch möglich, Steuersätze für Auslandsumsätze anzulegen, indem man das entsprechende Zielland anlegt. Lässt man das Zielland frei, sollte das dann alle restlichen Länder betreffen. Ich habe keine persönliche Erfahrung damit gesammelt, denke aber, das sollte selbsterklärend sein.

=== weitere Tabs ===

In dem Tab „Steuernummer“ (schlecht übersetzt „Tax ZIP“) kann die Steuer abhängig von der Postleitzahl gesetzt werden, was in Deutschland nicht nötig ist.

Interessant ist aber das Tab „Buchführung“, in dem man einstellen kann, auf welche Konten die Steuer gebucht wird. Die vorgegebenen Werte sind aus dem Buchführungs-Schema übernommen (Diese wurden bei der Anlage des Mandanten als Default-Konten aus der CSV-Datei mit dem Kontenplan übernommen). Da man in Deutschland für die Umsatzsteuererklärung diese Posten getrennt angeben muss, kann es sinnvoll sein, hier unterschiedliche Konten für die Steuerarten anzugeben.

= Probleme mit iDempiere im deutschen/europäischen Steuersystem =

* Ich habe Hinweise darauf gesehen, das für Waren und Dienstleistungen unterschiedliche Steuerregelungen gelten. Das möchte ich noch mit meinem Steuerberater abklären. Falls es nötig ist, mehrere steuerbefreite Tatbestände auf der Rechnung getrennt aufzuführen, geht dass nicht, solange in Tax.java alle steuerbefreiten Geschäftspartner über einen "Tax"-Datensatz geschoren werden (die Formel, wie der gefunden wird, ist sowieso etwas zweifelhaft, was Organisationen anbetrifft, aber das ist ein anderes Thema).
* steuerbefreite Lieferungen in die EU und in ein Drittland sind nicht nur unterschiedlich in der USt-VA zu deklarieren, sondern müssen auch unterschiedlich auf der Rechnung bezeichnet werden (Stichwort "Steuerschuldnerschaft des Leistungsempfängers" und "Nicht im Inland steuerbare Leistung"). Das ist mit iDempiere nur mit Tricksen möglich (mein Plan ist ein SQL-Feld in C_Invoice_LineTax_V).

= Weitere Links =

* http://www.adempiere.com/Umsatzsteuer Artikel im ADempiere Wiki - nicht wirklich gut, aber das beste, was wir zur Zeit haben :-(
* http://www.finanzamt.bayern.de/Informationen/Formulare/Weitere_Themen_A_bis_Z/Umsatzsteuer-Voranmeldung/ - Formular für USt-Voranmeldung und Erklärungen hierzu zum Download
* http://www.gesetze-im-internet.de/ustg_1980/index.html - Umsatzsteuergesetz

Steuersätze einrichten

2014-05-28T20:22:38Z

TBayen: /* Weitere Links */

Steuersätze einrichten

2014-05-28T17:28:23Z

TBayen: Links zur USt-Voranmeldung

EMail einrichten

2014-05-23T14:12:45Z

TBayen: Mails versenden

EMail einrichten

2014-05-23T14:11:07Z

TBayen: Die Seite wurde neu angelegt: „Es ist ganz einfach möglich, aus iDempiere heraus EMails zu versenden. == Einrichtung == Um Mails zu versenden, muss iDempiere Zugriff auf einen SMTP Mailse…“

Benutzer:TBayen

2014-05-23T13:59:26Z

TBayen:

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
** [[EMail einrichten]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

Kontenplan

2014-05-21T22:31:43Z

TBayen: Ich habe neue Standardkontenpläne SKR-04 und SKR-07 erstellt

== Welchen Kontenrahmen nehmen wir? ==

Zur [[Einrichtung der Buchhaltung]] ist es wichtig, das man einen [[http://de.wikipedia.org/wiki/Kontenplan Kontenplan]] eingerichtet hat. Dieser Kontenplan sollte sich normalerweise an einem der gängigen [[http://de.wikipedia.org/wiki/Kontenrahmen Kontenrahmen]] orientieren. Letztlich basiert der Kontenplan auf einer Entscheidung jedes einzelnen Unternehmens, was man denn nun an Konten benötigt. Eine Rücksprache mit dem Steuerberater sowie ggf. ein Blick in die bisherige Buchhaltung können da helfen. Natürlich ist eine Umstellung auf '''iDempiere''' immer auch eine gute Gelegenheit, alte Zöpfe abzuschneiden und von vorne mit einem ordentlich aufgeräumten Kontenplan zu beginnen.

Prinzipiell kann sich jeder die Aufteilung, Sortierung und Benennung seiner Konten selbst aussuchen. Seitdem die Fugger im Jahre 1511 die erste Bilanz aufstellten hat es da viele verschiedene Systeme gegeben. Mit der Einführung gesetzlicher Bestimungen sowie der Idee, Konten durch Kontonummern gleichzeitig zu sortieren und zu gliedern hat sich allerdings immer mehr ein einheitliches System von Kontenrahmen durchgesetzt. So gibt es von der [[http://www.datev.de/portal/ShowPage.do?pid=dpi&nid=302 DATEV]] (der größten Genossenschaft deutscher Steuerberater) sogenannte Standard-Kontenrahmen. Diese "SKR" sind für verschiedene Bedürfnisse und Branchen angepasst und haben jeweils eine Nummer. Für die allgemeine Verwendung am bekanntesten sind der SKR-03 (bei dem die Konten nach dem Prozeßgliederungsprinzip sortiert sind) und der SKR-04 (nach dem Abschlußgliederungsprinzip).

Ein Kontenrahmen dient letztlich nicht nur dazu, einzelne Konten zu haben, sondern hilft auch, diese Konten entsprechend bestimmter Vorgaben zusammenzufassen und daraus einen verkürzten Bericht zu erstellen. Solche Berichte sind z.B. die in Deutschland vorgeschriebene [[http://de.wikipedia.org/wiki/Bilanz#Deutschland:_Bilanzgliederung_nach_.C2.A7.C2.A0266.C2.A0HGB Bilanz]] und die [[http://de.wikipedia.org/wiki/Gewinn-_und_Verlustrechnung#nach_HGB Gewinn- und Verlustrechnung]] (GuV).

Entsprechende Vorschriften zur Gliederung dieser Berichte finden sich im [[http://de.wikipedia.org/wiki/Handelsgesetzbuch HGB]] ([[http://www.gesetze-im-internet.de/hgb/__266.html Bilanz]] und [[http://www.gesetze-im-internet.de/hgb/__275.html GuV]]). Diese handelsrechtliche Sicht wird durch die steuerrechtliche Sicht der E-Bilanz und deren [[http://www.esteuer.de/ Taxonomie]] ergänzt. Aber natürlich würden wir uns hier nicht auf dem Feld der Bürokratie befinden, wenn es nicht auch andere Vorschriften und Regelungen gäbe. So kann nicht nur eine Handelsbilanz anders aussehen als eine Steuerbilanz - firmenintern mag man es vielleicht wieder anders aufgeteilt. Manche Firmen (z.B. Tochterfirmen angelsächsischer Konzerne oder solche, die an die weltweiten Finanzmärkte wollen) bilanzieren auch in Deutschland nach [[http://de.wikipedia.org/wiki/United_States_Generally_Accepted_Accounting_Principles US-GAAP]] usw. Auch die laut HGB vorgeschriebene Gewinn- und Verlustrechnung gibt es im [[http://de.wikipedia.org/wiki/Gewinn-_und_Verlustrechnung#Gesamt-_oder_Umsatzkostenverfahren Gesamt- und im Umsatzkostenverfahren]]. ''Zum Glück ist iDempiere in der Lage, mehrere Gliederungsbäume parallel zu verwalten.''

Sollten Sie nicht bereits eine Festlegung aus Ihrem bisherigen Betrieb oder von Ihrem Steuerberater haben, so empfehle ich, den [[http://www.datev.de/portal/ShowPage.do?pid=dpi&nid=84700 SKR-04]] als Basis zu nehmen. Er entspricht mit dem Abschlußgliederungsprinzip am ehesten dem, was man im modernen Buchführungs-Unterricht lernt. Außerdem entspricht er den Vorgaben der [[http://de.wikipedia.org/wiki/Bilanzrechtsmodernisierungsgesetz Bilanzrechtsmodernisierungsgesetz]] und weitgehend auch der [[http://www.esteuer.de/ Kerntaxonomie]] der [http://de.wikipedia.org/wiki/Elektronische_Bilanz E-Bilanz].

= deutscher Kontenplan =

Welche Konten man sich aus diesem Standard-Kontenrahmen nun herauszieht, muss man für sich selber wissen. Wichtig ist, das man die [[Standardkonten]] von iDempiere alle belegt. Ich habe einen Beispiel-Kontenrahmen erzeugt, in dem alle wichtigen Konten des SKR-04 sowie alle Standard-Konten von iDempiere enthalten sind. Ihr findet ihn hier:

https://bitbucket.org/tbayen/translations/src/tip/data/AccountingDE/

Dort befindet sich auch ein Kontenplan ohne Kontonummern (mit symbolischen Namen), der einerseits benutzt werden kann, um einen Kontenplan ohne jede Festlegung auf einen bestimmten Kontenrahmen zu haben (alles, was iDempiere automatisch bucht, ist damit voll funktionsfähig). Andererseits kann diese Datei auch als Basis für die Entwicklung eines ganz eigenen Plans dienen.

== Österreich ==

Für Österreich gilt der sogenannte österreichische Einheitskontenrahmen, von dem es bei der DATEV den daran angelehnten [[http://www.datev.de/portal/ShowPage.do?pid=dpi&nid=84706 SKR-07]] gibt. Ich habe - angestiftet durch ein kleines Sponsoring der Firma Echotech - einen Kontenplan mit den grundlegenden Konten hierfür erstellt, der sofort in iDempiere importiert werden kann.

https://bitbucket.org/tbayen/translations/src/tip/data/AccountingAT/

== CSV-Datei für Kontenplan erstellen ==

Im iDempiere Server-Installationspaket gibt es ein Verzeichnis "data/import", in dem verschiedene Beispiel-Kontenpläne enthalten sind. Dort finden sich auch Beispiele basierend auf SKR-03 und SKR-04. Man sollte diese jedoch nicht kritiklos installieren. Sie sind etwas älter und nicht ganz fehlerfrei. Sie sollten ernsthaft versuchen, sich diese Datei selber zu erarbeiten (auch wenn das viel Arbeit ist). Eine Datei, die auf der Grundlage meiner eigenen Buchhaltung erzeugt wurde, findet sich als weiteres Beispiel [https://bitbucket.org/tbayen/smallprojects/src/tip/iDempiereAccounting hier] und ein von mir erstellter SKR-04, der als allgemeine Basis dienen kann, findet sich [https://bitbucket.org/tbayen/translations/src/tip/data/AccountingDE/ hier] . Nur durch die Beschäftigung mit diesen erhalten Sie ein für Ihre Bedürfnisse ausgearbeitetes System.

Eine alternative Basis wäre vielleicht, wenn es eine entsprechende Datei mit einem wirklich kompletten SKR-04 nach aktuellem Stand gäbe. Man könnte dann vielleicht die Konten löschen oder deaktivieren, die man nicht braucht. Wer Interesse hat, an so etwas mitzuarbeiten, möge sich gerne melden. Meine "SKR04minimal"-Atei wäre eine gute Grundlage hierfür.

Zum Format der Datei steht einiges auf [[adempiere:Chart_of_Accounts]].

Eine Excel-Datei mit einem SKR-04 von 2009 (nicht im iDempiere-Format, aber vielleicht dennoch hilfreich) habe ich [[http://www.msdynamics.de/viewtopic.php?t=7134&p=71780 in diesem Forum]] gefunden.

Es gibt übrigens zwei Herangehensweisen. Die klassische ist die, die in den Beispieldateien benutzt wurde. Ich selber empfehle eine etwas andere: In der Datei stehen sowohl "richtige" Konten, auf die gebucht werden kann sowie Summenkonten, die nur der Gliederung dienen. Letztere unterscheiden sich durch ein "Yes" in der Spalte "<nowiki>[Account_Summary]</nowiki>". Klassisch schreibt man jeweils ein Summenkonto und dann die Konten, die darunter aufsummiert werden. Es ergibt sich in der Datei dann eine schöne übersichtliche und hierarchisch sortierte Lsite von Konten und Unterkonten. Leider ist das nur sehr unkomfortabel einzugeben. Ich empfehle daher, zuerst oben die Gliederung komplett anzulegen und darunter dann alle Konten aufzuführen. Man kann oben jederzeit kontrollieren, ob man alle wichtigen Gliederungspunkte hat. Man kann sogar die Gliederung ganz einfach aus z.B. meiner Beispieldatei kopieren. Diese enthält die Bilanz nach HGB §266 und die GuV nach §275 im Gesamtkostenverfahren. Wer also die gesetzlichen Vorschriften einhalten will, ist insoweit schon fertig. Dann schreibt man alle seine Konten darunter. Womöglich hat man bereits eine Liste aus dem vorherigen Programm oder sich eine mit Hilfe des Steuerberaters erarbeitet. Auf jeden Fall ist es einfacher, das runterzutippen als jede Zeile in die vorhandene Gliederung extra einfügen zu müssen. Am Ende - und das ist vielleicht der Nachteil - muss man dann die Zuordnungen der Konten zur Gliederung sorgfältig eintragen.

=== Standardkonten ===

Im Kontenplan müssen diverse [[Standardkonten]] definiert sein. Das sind die Konten, die von iDempiere bei verschiedenen Gelegenheiten automatisch gewählt und bebucht werden. Wer hier nicht sofort alles versteht, braucht keine Angst zu haben. Es muss jedoch jedes der Standardkonten angegeben sein.

== importieren ==

Die Datei wird über den Menüpunkt

Systemadministration -> Daten -> Datenimport -> Import Ladeprogramm

eingeladen. Danach kann man die Daten in

Systemadministration -> Daten -> Datenimport -> Import Konto

betrachten und prüfen. Dort kann man sie dann auch endgültig einlesen. Unter

Leistungsanalyse -> Einstellungen Buchführung -> Kontenplan

kann man sie dann betrachten. Das sollte man so lange wiederholen, bis dort im zweiten Tab ein Baum erscheint, der so aussieht, wie man sich das vorgestellt hat. ''(Da das beim ersten Mal garantiert nicht fehlerfrei funktioniert, empfehle ich übrigens dringend, diese Experimente zuerst auf einer eigenen Datenbank zu machen, die man später wieder komplett löschen kann. Es kann nämlich nötig sein, so lange neue Mandanten anzulegen, bis einem das Ergebnis gefällt. Und diese Mandanten später wieder zu löschen ist mühseliger als einfach die ganze Datenbank wegzuwerfen.)''

[[Category: Entwicklerdokumentation]]
[[Category: Anwenderhandbuch]]
[[Category: Konten]]
[[Category: Stammdaten-Finanzbuchhaltung]]

== Beiträge ==

Steuersätze einrichten

2014-05-21T12:37:33Z

TBayen: Anlegen von Steuerkategorie und Steuersatz

Benutzer:TBayen

2014-05-21T12:28:04Z

TBayen: neue Seite zu Steuersätzen

{{raw:idempiere:Userboxtop}}
{{raw:idempiere:User real name|Thomas Bayen}}
{{raw:idempiere:User de}}
{{raw:idempiere:User en}}
{{raw:idempiere:Userboxbottom}}

Hallo!

Mein Name ist Thomas Bayen. Ich bin der Administrator dieses Wikis und Mitglied des [[Team Germany]] und begrüße alle User hier.

Man kann mich erreichen unter:

tbayen -at- bayen.de

= Arbeitsbereiche in diesem Wiki =

* Material- und Warenwirtschaft
** [[Maßeinheiten]]
* Artikel zu bestimmten Geschäftsvorfällen
** [[Darlehensverwaltung]]
** [[Zahlungsverkehr]], [[Zahlungsauswahl]]
* Berichte
** [[Statistik und Berichte]]
** [[Berichte mit Unterbericht]], [[komplexe Berichte]]
** [[Neues View für Berichte anlegen]], [[Berichtsansicht]]
** [[Finanzbericht]] ([[Bilanz]])
* Buchführung
** [[Buchführungsdimensionen]]
** [[Standardkonten]]
** [[Kontenplan]]
* Zahlungsverkehr
** [[Bankschnittstelle]]
** [[Zahlungssammler]]
* Einrichtung
** [[Banken einrichten]]
** [[Einrichtung der Buchhaltung]]
** [[Krefelder iDempiere Mini Installation]]
** [[Steuersätze einrichten]]
* deutsche Lokalisierung
** [[Treffen in Deutschland]], [[Team Germany]]
** [[Deutsche Sprache installieren]], [[Verbessertes Übersetzungssystem]], [[Glossar]]
* Programmieren
** [[Eclipse Projekt für ein eigenes Modul]], [[Entwicklung eigener Module]]
** [[Mercurial Bayen Best Practice]]
** [[Datenbankeinrichtung für Entwickler]]
** [[Installation der Entwicklungsumgebung]], [[Migrations-Skripte ausführen]]
** [[2pack]]
** [[GenerateModel]]
** [[ModelValidator]]
** [[direktes Schreiben in die Datenbank]]
** [[:en:Buckminster]]
** [[Gedanken über Dokumente]]
** [[WebServices]]
* [[Vereinsverwaltung]]

Vereinsverwaltung

2014-05-16T07:12:17Z

TBayen:

Man kann sehr einfach auf Basis des Warenwirtschaftssystems iDempiere eine Vereinsverwaltung aufsetzen. Leider ist es sehr schwer, eine ordentliche Software in diesem Bereich zu finden, die Mehrbenutzerfähig und Open Source ist. Die einzige vernünftige Alternative, die ich gefunden habe, ist [http://www.jverein.de JVerein]. Da kam ich auf die Idee, das man durch eine simple Anpassung der Konfiguration iDempiere hierfür nutzen kann.

== Implementierung von Thomas Bayen ==

Die Mitglieder können mit allen Ihren Eigenschaften als Geschäftspartner verwaltet werden und ein zusätzliches Datenbank-View kann eine Mitgliederliste als CSV-Datei ausgeben, um sie auch anderweitig verwerten oder auswerten zu können.

Ich habe eine solche Mitgliederverwaltung für den [http://www.efg-krefeld.de Ehemaligenverein des Fichte-Gymnasiums] (EFG) aufgesetzt. -- [[User:TBayen]]

Der Server steht in der Cloud, was einiger Vorsichtsmaßnahmen seitens der Server-Konfiguration bedar.

Auf der Seite [[Vereinsverwaltung/Konfiguration]] habe ich dokumentiert, wie ich das Programm konfiguriert habe.

Auf der Seite [[Vereinsverwaltung/Einführung]] gibt es eine schnelle Bedienungsanleitung für Vorstandsmitglieder.

== Zukunftspläne ==

* Bisher werden noch keine Mitgliedsbeiträge verwaltet bzw. eingezogen.
* Die Verwaltung von offenen Posten ist äußerst rudimentär.
* Es gibt noch keine gedruckte Mitgliederliste, die auf DIN A4 passt

Vereinsverwaltung/Einführung

2014-05-16T07:05:56Z

TBayen: Einführung in die Vereinsverwaltung

Dies ist eine Kurzanleitung für die [[Vereinsverwaltung]].

= Installation =

Der Server ist von [[User:TBayen]] so installiert worden, wie auf der Seite [[Vereinsverwaltung/Konfiguration]] beschrieben ist. Er ist auf einem Cloud-Server installiert und wird per Web-Browser bedient. Wer eine eigene Version installieren oder installiert bekommen möchte, kann mich gerne ansprechen. :-)

Das Programm läuft als Webanwendung. Da es die zk-Bibliothek benutzt (die starken Gebrauch von Javascript macht), empfehle ich die Installation eines aktuellen Browsers. Beste Ergebnisse gibt ein aktueller Google Chrome. Ein aktueller Firefox sollte aber auch gehen, fühlt sich aber (z.Zt.) etwas langsamer an.

= Start und Login =

== Starten des Browsers ==

Dann geht man auf die angegebene URL, um die Applikation zu starten. Es zeigt sich das Login-Fenster.

== Login-Fenster ==

TODO Screenshot

Den Benutzername habe ich bei der Installation mit vergeben. Da nach diesem Namen in der Mitgliederliste auch alphabetisch gesucht werden kann, beginnt er mit dem Nachnamen, hat also die Form "Schmitz-Backes, Michael" (genauso mit Gross- und Kleinschreibung und Komma, ohne Anführungszeichen). Das Passwort lasse ich Euch ggf. auf einem separaten Weg zukommen (auch dabei ist Gross- und Kleinschreibung wichtig). Die Sprache stellst Du am besten auf deutsch. Beim ersten Mal sollte man "Rolle wählen" und "Angaben merken" auswählen. Letzteres führt dazu, das Du auf diesem Browser beim nächsten Mal nichts mehr eingeben musst, sondern direkt "ok" drücken kannst.

== Login Seite 2: Rollen-Auswahl ==

TODO Screenshot

Ersteres führt (nach OK) zu einem weiteren Eingabefenster. Dort kann man seine Rolle auswählen:

* '''Vorstandsmitglied''': Die Rolle "Vorstandsmitglied" dient dem Zugriff auf alle Daten, aber nur lesend. Normale Vorstandmitglieder sollten mit dieser Rolle arbeiten, was verhindert, das man was kaputtmachen kann.
* '''Datenpfleger''': Wer was kaputt- oder ganzmachen möchte (also nach unserer Beschlussfassung nur eine Person), kann sich als "Datenpfleger" anmelden. Die anderen Einstellungen in diesem Fenster könnt ihr ignorieren.

Ich habe das so eingerichtet, das rein technisch jeder beide Rollen annehmen kann, wenn er möchte, was es im Notfall einfacher macht, die Aufgaben anders zu verteilen. Natürlich geht das dann von ein bisschen Selbstdisziplin bei den anderen aus. ;-)

= Hauptfenster und Menü =

TODO Screenshot

Nach einem weiteren OK öffnet sich das Hauptfenster. Das wichtigste ist oben der '''"Menü"'''-Knopf. Es gibt dort einen Eintrag "Mitglieder". Darauf klickt man, woraufhin das Eingabefenster für Mitglieder aufgerufen wird. Man kann den Menüpunkt übrigens auch nach links in die '''Favoriten''' ziehen (was ich bei Michael schonmal gemacht habe) und dann dort mit einem Klick das Eingabefenster öffnen.

Außerdem gibt es einen Menüpunkt, um sein '''Passwort zu ändern'''. Das sollte man am besten zu Anfang einmal machen. Bitte kein Passwort eingeben, das anderweitig fürs Online-Banking verwendet wird, da man der Sicherheit eines Cloud-Servers immer nur bedingt trauen sollte.

= Eingabefenster für Mitglieder =

== Suchdialog ==

TODO Screenshot

Als allererstes öffnet sich der Suchdialog. Dort kann man z.B. nach der Nummer oder einem Namen suchen. Die Nummern sind immer vierstellig, also "0001", um eindeutiger suchen zu können. Wer mit Joker suchen möchte, nimmt dafür "%" als Joker. Also findet man z.B. mit "%drea%" alle Andreasse und Andreaen. Man kann aber auch einfach gar nichts eingeben, dann findet man alle Datensätze (also alle Mitglieder und Ex-Mitglieder).

== Eingabefenster ==

=== Navigation durch die Datensätze ===

TODO Screenshot

Nach einem "OK" (grüner Haken) ruft man die Liste der Suchergebnisse auf. Oben rechts im Fensterchen steht sowas wie [1/26] (bei Suche nach Andreassen) oder [1/1164] (bei Suche nach allen Datensätzen).

Wer später was anderes suchen möchte, kann in der Toolbar auf die Lupe klicken und erhält wieder den Suchdialog wie am Anfang.

In der Toolbar findet sich ein Knopf, der wie eine Tabelle mit einem einzelnen roten Feld aussieht. Damit schaltet man zwischen der Tabellen- und der Formularansicht um. Einfach mal ausprobieren und hin- und herschalten, dann versteht Ihr das schon.

TODO Screenshot

In der Listenansicht sieht man immer eine (scrollbare) Liste mit einer Seite von 25 Datensätzen. Am unteren Rand des Listenbereichs (unten links) ist ein Feld, in dem man die angezeigte Seite auswählen kann. Mit den dort befindlichen Pfeilknöpfen kann man auch seitenweise durch die Daten blättern (also immer 25 weiter). Oben rechts (da, wo [1/1164] steht) kann man auch immer einen einzelnen Datensatz weiternavigieren. Das kann in der Formularansicht ganz gut sein, um mehrere Datensätze durchzugehen.

=== Register mit Unterlisten ===

Am unteren Rand gibt es einen Bereich mit drei Registerkarten "Kontakte", "Adresse", "Bankdaten". Diese Registerkarten sind für "Unterlisten" des eigentlichen Mitgliederdatensatzes. Also sind alle Datenfelder, die nur genau einmal vorkommen, oben im Haupt-Datensatzbereich und diese drei Dinge, die mehrfach vorkommen können, stehen in diesen Registern in einer Art Unterlisten.

Hat man dort einen Datensatz ausgewählt, kann man mit dem Editier-Icon links daneben den Editor so umschalten, das der ausgewählte Datensatz der Unterliste oben im Haupt-Arbeitsbereich erscheint.

TODO Screenshot

Man kann den dann dort bearbeiten. Um wieder zurückzukommen, klickt man entweder in der Breadcrumb-Zeile oberhalb des Datensatzes auf den Link, der mit "Business Partner" beschrieben ist (Sorry! - ist noch nicht richtig "übersetzt" - das bedeutet "Mitglied"). Alternativ kann man auch in der oberen Toolbar auf den "blauen Pfeil nach oben" klicken. Der bring einen ebenfalls wieder eine Untertabellen-Ebene hoch.

=== Daten editieren, neu, löschen ===

TODO Screenshot

Hat man Daten geändert, werden die im allgemeinen gespeichert, wenn man weiternavigiert. Um sicherzugehen, sollte man ggf. das Speicher-Icon oben in der Toolbar drücken, das erscheint, sobald man ein Datenfeld geändert (und dann verlassen) hat.

Neue Datensätze erzeugt man mit dem Neu-Knopf (dritter von links in der Toolbar). Bitte nicht kopieren (rechts daneben), sondern besser immer neu drücken.

Neue Unter-Datensätze erzeugt man Mit dem Neu-Knopf (erster von links) im Kopf des Unter-Registers.

Grundsätzlich kann man mit dem Lösch-Icon (kleine Mülltonne) einen Datensatz löschen. Aber bitte keine Lösch-Orgien!!! Löschen sollte man aber nur, wenn ein Datensatz nur versehentlich angelegt wurde etc.. Ansonsten ist es dafür immer besser, den Datensatz zu '''dekativieren''' (also das Häkchen bei "Aktiv" wegzumachen). Der Datensatz verschwindet somit aus allen Listen (auf jeden Fall aus den gedruckten, je nach Einstellung auch komplett aus dem normalen Editorfenster), ist aber im Zweifelsfall noch da, um auf historische Daten weiterhin zuzugreifen (vielleicht wollen wir zum 50. Vereinsjubiläum ja die ausgetretenen Mitglieder nochmal anschreiben oder haben später nochmal Rückfragen, wann wer wie und warum ausgetreten ist oder so...?!?)

= nächste Schritte =

So, das sollte als Einführung bis hierhin reichen, um Daten zu pflegen. Bei Fragen oder Entdeckungen bitte melden. Wir sollten diese Anleitung hier weiterentwickeln, damit sie dann auch für andere Benutzer hilfreich ist. Das hier ist ein Wiki, kann also gerne von jedem geändert werden! Bei Rückfragen werde ich umgehend antworten. -- [[User:TBayen]]

Vereinsverwaltung

2014-05-16T06:33:24Z

TBayen: Ich habe eine VEreinsverwaltung implementiert

Man kann sehr einfach auf Basis des Warenwirtschaftssystems iDempiere eine Vereinsverwaltung aufsetzen. Leider ist es sehr schwer, eine ordentliche Software in diesem Bereich zu finden, die Mehrbenutzerfähig und Open Source ist. Die einzige vernünftige Alternative, die ich gefunden habe, ist [[http://www.jverein.de JVerein]]. Da kam ich auf die Idee, das man durch eine simple Anpassung der Konfiguration iDempiere hierfür nutzen kann.

== Implementierung von Thomas Bayen ==

Die Mitglieder können mit allen Ihren Eigenschaften als Geschäftspartner verwaltet werden und ein zusätzliches Datenbank-View kann eine Mitgliederliste als CSV-Datei ausgeben, um sie auch anderweitig verwerten oder auswerten zu können.

Ich habe eine solche Mitgliederverwaltung für den [http://www.efg-krefeld.de Ehemaligenverein des Fichte-Gymnasiums] (EFG) aufgesetzt. -- [[User:TBayen]]

Der Server steht in der Cloud, was einiger Vorsichtsmaßnahmen seitens der Server-Konfiguration bedar.

Auf der Seite [[Vereinsverwaltung/Konfiguration]] habe ich dokumentiert, wie ich das Programm konfiguriert habe.

Auf der Seite [[Vereinsverwaltung/Einführung]] gibt es eine schnelle Bedienungsanleitung für Vorstandsmitglieder.

== Zukunftspläne ==

* Bisher werden noch keine Mitgliedsbeiträge verwaltet bzw. eingezogen.
* Die Verwaltung von offenen Posten ist äußerst rudimentär.
* Es gibt noch keine gedruckte Mitgliederliste, die auf DIN A4 passt