Difference between revisions of "Report"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(53)
(Undo revision 48377 by Thomas Thießen (Talk) - German translation overwrite english version)
 
Line 5: Line 5:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
  
Die Report-Funktion bietet eine Möglichkeit einfache Berichte über angezeigte Daten zu erzeugen.  
+
The Report function provides a way to generate simple reports based on the data being viewed.
  
 
+
== Access ==
 
+
 
+
==Zugang==
+
 
{|
 
{|
 
|Icon:
 
|Icon:
Line 16: Line 13:
 
|-
 
|-
 
|Menu:
 
|Menu:
|{{MenuRef|Datei|Bericht}}
+
|{{MenuRef|File|Report}}
 
|-
 
|-
|Kurztaste:  
+
|Short Cut:  
 
|<nowiki><F11></nowiki>
 
|<nowiki><F11></nowiki>
 
|}
 
|}
 +
== Restrictions ==
  
 +
To enable reports, the user's role must have '''Can Report''' checked in the {{WindowRef|Role}}.
  
 +
To [[Export]] the reports, the user's role must have '''Can Export''' checked in the {{WindowRef|Role}}.
  
 +
The Report function is only available when viewing a data window.
  
==Beschränkungen==
+
== Description ==
  
Damit die Reports freigegeben werden muß in der {{WindowRef|Role}}. die Spalte '''Can Report''' markiert sein.
+
The Report function will display reports on the current records and table. The format of the report is determined by [[Print Formats]], several of which can be defined for any table.
Für den [[Export]] von Berichten muss in  the der {{WindowRef|Role}} das Feld '''Can Export''' markiert sein.
+
Die Report-Funktion ist nur in einem Dateneingabefenster verfügbar.
+
  
 +
It is possible to modify the report formats and add others so that there is a choice of what you want to see when you click the report button.  For more information on the possibilities, see [[Print Formats]].
  
 +
It is also possible to override the internal report mechanism and create the reports with Jasper Reports.  See [[ADempiere/Compiere_JasperReports_Integration_HowTo|Jasper Reports Integration]] for more information.
  
 +
When the report menu or icon ([[Image:Report24.png]]) is selected or clicked, ADempiere will check to see if there are any predefined reports.
  
==Beschreibung==
+
If there are no pre-defined reports, ADempiere will create one using the name of the tableThis default print format will use a standard header and will display all available fields in a flat format, one line per row. This will often result in a report that is many pages wide - not very useful, but its a start.
 
+
Die Report-Funktion zeigt Berichte über die aktuell angezeigten Datensätze und Tabellen.
+
 
+
Das Format des Berichts wird von [[Print Formats]] festgelegt. Für jede Tabelle können mehrere Berichte definiert werden.
+
 
+
Es ist möglich das Format des Berichtes zu ändern und weitere Berichte neu zu erstellen.
+
 
+
Es ist auch möglich den internen Bericht mit Jasper Reports zu erstellen. Hierzu wird der interne Bericht außer Kraft gesetzt und der neue Bericht mit Jasper Reports erstellt.
+
 
+
Um einen Bericht mit Jasper Reports zu erzeugen folgen Sie am besten de mWiki: [[ADempiere/Compiere_JasperReports_Integration_HowTo|Jasper Reports Integration]] für weitere Informationen.
+
 
+
 
+
Wenn im Menü oder über die Schaltfläche "Bericht" ([[Image:Report24.png]]) das Symbol ausgewählt oder angeklickt wird, prüft ADempiere ob es irgendwelche vordefinierten Berichte gibt. Wenn es keine vordefinierten Berichte gibt erstellt ADempiere einen neuen Bericht mit dem Namen der Tabelle. Dieses Standard-Druckformat wird mit einem Standard-Kopf und allen verfügbaren Feldern in einem Listenformat erzeug. Es wird jeweils eine Zeile pro Datenzeile angezeigt. Dies wird oft ein Bericht mit viele Seiten. Es ist nicht sehr nützlich, aber es ist ein Anfang.
+
 
+
 
+
Wenn nur ein Bericht definiert ist wird dieser sofort angezeigt. Wenn es mehr als einen Bericht gibt wird, wie unten dargestellt, ein kleines Popup-Fenster mit einer Liste aller definierten Berichte angezeigt. Ein Klick auf eines der Elemente in der Liste öffnet den ausgewählten Bericht.
+
  
 +
If only one report is defined, it will be displayed immediately.  If there are more than one, a small pop-up dialog will appear next to the Report icon in the tool bar, as shown below, with a list of all the defined reports.  Clicking on one of the items in the list will open the selected report.
 
{{Space}}
 
{{Space}}
 
[[Image:Report_Popup.png|center]]
 
[[Image:Report_Popup.png|center]]
 
{{Space}}
 
{{Space}}
 +
ADempiere will determine if the report is a Jasper Report or a standard report and will display the report accordingly.  For more on Jasper Reports, see the Jasper Report documentation.  The rest of this article refers to the standard report.
  
ADempiere erkennt ob der Bericht ein Jasper-Bericht oder ein Standard-Bericht ist und zeigt Ihn entsprechend an. Weitere Informationen über Jasper Reports finden Sie in der Jasper Report-Dokumentation. Der Rest dieses Artikels bezieht sich auf den Standard-Bericht.
+
== The Report Viewer ==
 
+
 
+
 
+
 
+
==Die Reportanzeige==
+
  
Die Reportanzeige erscheint wie unten dargestellt.
+
The Report Viewer appears as shown below.
 
{{Space}}
 
{{Space}}
[[Image:ReportExample.png]]
+
[[Image:ReportExample.png|center]]
[[Image:TTH_GeschäftspartnerBericht_360LTS.png]]
+
 
{{Space}}
 
{{Space}}
 +
The Viewer has the following main components:
 +
* a title bar
 +
* a main menu (File, View, Go, ...)
 +
* a tool bar with several controls
 +
* the report window
 +
* a status bar at the bottom and
 +
* a page count
  
Die Ansicht verfügt über die folgenden Hauptkomponenten:
+
The title bar and main menu are pretty standard with the following additions:
* Titelleiste
+
* Ein Hauptmenü (Datei, Ansicht, Gehe, ...)
+
* Eine Symbolleiste mit mehreren Steuerungen
+
* Der Bericht im Fenster
+
* Eine Statusleiste am unteren Rand und
+
* Eine Seitenanzahl
+
  
 +
* File
 +
** Customize Report
 +
** Translate
 +
** Lookup Record
 +
* Go
 +
** First Page
 +
** Previous Page
 +
** Next Page
 +
** Last Page
  
Die Titelleiste und Hauptmenü entsprechen mit folgenden Ergänzungen etwa dem Standard :
+
The tool bar contains the following controls:
 
+
* Previous Page
* Datei
+
* Go To Page
** Bericht anpassen
+
* Next Page
** Übersetzen
+
** Eintrag suchen
+
* Gehe
+
** Erste Seite
+
** Vorherige Seite
+
** Nächste Seite
+
** Letzte Seite
+
 
+
 
+
Die Symbolleiste enthält die folgenden Steuerelemente:
+
* Vorherige Seite
+
* Gehe zu Seite
+
* Nächste Seite
+
 
* Zoom
 
* Zoom
* Drill (durch Tabelle)
+
* Drill (by table)
* Print-Formate
+
* Print Formats
*Zusammenfassung Kontrollkästchen
+
* Summary check box
* Bericht anpassen
+
* Customize Report
* Eintrag suchen
+
* Lookup Record
* Drucken
+
* Print
* Seite einrichten
+
* Page Setup
* E-Mail senden
+
* Send mail
* Archivierte Belege und Dokumente
+
* Archive documents
 
* Export
 
* Export
* Verlassen Sie das Fenster
+
* Exit the Window
  
 +
We will look at a few of these in detail.
  
Einige dieser Punkte im Detail:
+
=== Drilling Up, Down and Across ===
  
 +
The Report Viewer provides the ability to drill down into details, across to related reports and up to more general information.
  
 +
Each _ID field in the report will appear as a link to the default report for the associated table.  Double-clicking the link will open that report.
  
===Weitere Details und allgemeine Informationen===
+
The '''Drill Control''' is a combo box style control with a list of tables that use the main key field of the report being viewed.  For example, if viewing the Business Partner report, the key field will be C_BPartner_ID.  The Drill Control will contain a list of all tables that include C_BPartner_ID as a column.
  
Die Reportansicht bietet die Möglichkeit per Drilldown mehr Details und allgemeine Informationen zu erhalten.
+
Selecting any entry in the Drill control will enable the drill. Then, double clicking on any record in the current report will open the report based on that record. You can click anywhere in the record.
Jedes _ID Feld im Bericht wird als Link auf die Standard-Bericht zu der zugehörigen Tabelle angezeigt. Ein Doppelklick auf den Link öffnet diesen Bericht.
+
Das '''Drill Control''' ist eine Combo-Box mit einer Liste von Tabellen. Hier werden die wichtigsten Schlüsselfeld des Berichtes angezeigt. Wenn Sie sich zum Beispiel den Bericht Business Partner ansehen wird das Schlüsselfeld C_BPartner_ID angezeigt. Das Drill Down Control enthält eine Liste aller Tabellen in denen das Feld C_BPartner_ID vorkommt.
+
  
Wenn ein Eintrag selektiert wird kann dieser durch eine Doppelklick den Report öffnen.
+
As an example, open the {{WindowRef|ProductCategory|Product Category}} and click on the Report icon ([[Image:Report24.png]]).  When the report opens, use the [[Lookup]] control (see below) to find all records.  Then, select ''Product'' in the Drill control and double click on any row in the Product Category report.  Another Report Viewer will open showing the Product report listing all products in the Product Category you clicked on.
  
Zum Beispiel können Sie die {{MenuRef|Menü|Materialwirtschaft|Einstellungen Materialwirtschaft|Produktkategorie}}  Englisch: {{WindowRef|ProductCategory|Product Category}} öffnen und im Report auf das Icon ([[Image:Report24.png]]) klicken . Wenn der Report öffnet können Sie die [[Lookup]] Steuerung (siehe unten) verwenden um alle Datensätze anzuzeigen.
+
Click on the link to the Unit of Measure (UOM) for any product on the list. A report based on the C_UOM table with the selected C_UOM_ID will appear.  Use the Drill control to find all products that use that UOM by selecting ''Product'' in the Drill control and then double clicking anywhere on the record in the UOM report.
  
{{Space}}
+
Try this: find an invoice that has a particular product on one or more of it's invoice lines.
[[Image:TTH_MenueProduktkategorie_360LTS.png]]
+
{{Note|The database is built on one-to-many relationships.  The Drill moves along these relationships.  This makes it difficult to find ALL invoices that order a particular product but easy to find one invoice that does.}}
[[Image:TTH_ProduktkategorieFenster_360LTS.png]]
+
{{Space}}
+
Dann wählen Sie ''Produkt'' in der Kombobox und doppelklicken auf eine Zeile in dem Bericht der Produktkategorie. Eine weitere Reportansicht öffnet sich, zeigt das Produkt und enthält alle Produkte der Produktkategorie auf die geklickt wurde.
+
  
{{Space}}
+
=== Print Format ===
[[Image:TTH_ProduktkategorieBerichtSeitenansicht_1_360LTS.png]]
+
[[Image:TTH_ProduktkategorieEintragSuchen_360LTS.png]]
+
[[Image:TTH_ProduktkategorieBerichtSeitenansicht_2_360LTS.png]]
+
[[Image:TTH_ProduktkategorieBerichtSeitenansicht_3_360LTS.png]]
+
[[Image:TTH_ProduktkategorieProduktBerichtSeitenansicht_360LTS.png]]
+
{{Space}}
+
  
Ein Klick mit der rechten Maustaste auf einem Produkt zeigt ein PopUp Menü mit dem Eintrag "Produkt". Wenn der Eintrag Produkt im PopUp Menü aktiviert wird erscheint die Artikelmaske.
+
The '''Print Format''' combo box displays the current Print Format being displayed. If additional Print Formats are defined for the same table, they will also be listed here. Selecting one of them will close the current report and display the selected one. See [[Print Formats]] for more information on creating additional Print Formats.
 +
{{Note|Defining multiple Print Formats for a table is a great way to display information with less clutter.  Set up reports around relevant groupings.}}
  
 +
=== Summary ===
  
{{Space}}
+
The '''Summary''' check box will collapse the report to its main groupings, showing only columns that are set to "group by" or have one of the "Calculate" functions selected in the {{TabRef|PrintFormat|FormatItem|Format Item}} of the {{WindowRef|PrintFormat|Print Format}}.
UNGEPRÜFTER ABSATZ
+
=== Customizing the Report ===
 
+
Klicken Sie auf den Link der Maßeinheit (UOM) um alle Produkt dieser Maßeinheit anzuzeigen. Basis dieses Berichtes is die Tabelle C_UOM Tabelle und bezeiht sich auf die C_UOM_ID. Wähen Sie Produkte in der Kombobox aus, werden alle Produkte mit der ausgewählten UOM angezeigt.
+
 
+
UNGEPRÜFTER ABSATZ
+
{{Space}}
+
 
+
 
+
{{Note|Die Datenbank verwendet die eine zu viele (one-to-many) Beziehungstabelle.  Die Auswahl bewegt sich entlang dieser Beziehungen. Es ist schwierig alle Rechnungen, die ein bestimmtes Produkt berechnet haben anzuzeigen. Es ist jedoch einfach eine Rechnung zu finden}} Die'''Druckformat''' Combobox zeigt die aktuelle Druckformatean.
+
 
+
 
+
 
+
 
+
===Berichtsauswahl===
+
 
+
Die Combobox '''Berichtsauswahl''' zeigt den aktuellen Bericht an. Wenn zusätzliche Berichte für die gleiche Tabelle definiert sind werden diese hier aufgelistet und können durch die entsprechende Auswahl aktiviert werden.
+
 
+
 
+
 
+
 
+
===Zusammenfassung===
+
 
+
Das Kontrollkästchen '''Zusammenfassung'''  fasst die wichtigsten Gruppierungen in dem Bericht zusammen und zeigt nur die Spalten das Kennzeichen "Gruppe" gesetzt haben oder eine "Berechnen"-Funktionen ausweisen. Siehe auch: {{TabRef|PrintFormat|FormatItem|Format Item}} im Fenster {{WindowRef|PrintFormat|Print Format}}.
+
 
+
 
+
 
+
 
+
===Benutzerdefinierte Berichte ===
+
 
+
Ein Klick auf das '''Bericht anpassen''' Symbol ([[Image:Icon_Preference24.png]]) oder die Auswahl {{MenuRef|File|Customize Report}} öffnet das {{WindowRef|PrintFormat|Print Format}} bzw. das
+
 
+
[[Image:TTH_DruckFormatDruckFormatFenster_360LTS.png]]
+
 
+
Fenster. Hier kann das Format des Berichts geändert werden, die Anzahl und Platzierung der Felder gesteuert, die Sortierreihenfolgen eingestellt werden usw... usw....
+
 
+
 
+
 
+
 
+
===Suche Datensatz===
+
 
+
Wenn ein Bericht startet wird nur der aktuell im Fenster ausgewählte Datensatz angezeigt. Über die '''Suchfunktion''' ([[Image:Icon_Find24.png]]) Kann die Datensatzauswahl verändert werden. Auch die Anzeige aller Datenstze ist möglich. Die '''Suchfunktion''' hat die gleiche Funktionsweise wie die Suchfunktion in Fenstern. Siehe auch [[Such-Tool]] für weitere Informationen.
+
 
+
  
 +
Clicking on the '''Customize Report''' icon ([[Image:Icon_Preference24.png]]) or selecting {{MenuRef|File|Customize Report}} will open the {{WindowRef|PrintFormat|Print Format}}.  Here the format of the report can be modified, the number and placement of the fields controlled, sort orders set and so on.  For more information on how to customize the reports, see [[Print Formats]].
  
 +
=== Lookup Record ===
  
===Seite einrichten===
+
When the report opens initially, only the current record selected in the window is shown.  The '''Lookup Record''' function ([[Image:Icon_Find24.png]]) can be used to find all or specific records.  The '''Lookup Record''' function works in the same way as it does in the windows.  See [[Lookup]] for more information.
  
Ein Klick auf das '''Seite einrichten''' Symbol ([[Image:Icon_PageSetup24.png]]) öffnet den unten abgebildeten Dialog. Darin kann die Papier Quelle, Papier Größe, Seitenränder und Seitenausrichtung verändert werden.
+
=== Page Setup ===
  
Der Dialog bezieht die Informationen vom Drucker. So spiegeln die Seitenränder die bedruckbare Fläche wieder. Wenn Sie die Einstellungen andern und auf OK klicken wird das Format in der Ansicht geändert.
+
Clicking the '''Page Setup''' icon ([[Image:Icon_PageSetup24.png]]) will open a small dialog similar to the one below where the page source, size, margins and orientation can be changed. The dialog draws it's information from the printer so the margins may initially reflect the printable area, rather than what was set in the Print Format.  Changing the settings and clicking OK will change the format in the viewer.
 
{{Space}}
 
{{Space}}
[[Image:PageSetup.png]] [[Image:TTH_SeiteEinrichtenFenter_360LTS.png]]
+
[[Image:PageSetup.png|center|300px]]
 
{{Space}}
 
{{Space}}
 +
=== Send Mail ===
  
 +
Clicking the Send Mail icon ([[Image:Icon_SendMail24.png]]) will convert the report to PDF format and attach it to a draft e-mail dialog.  You can then send the e-mail to whomever you like.  See the [[EMail]] page for more information.
  
 +
=== Archive Documents ===
  
 +
Clicking the '''Archive Reports''' icon ([[Image:Icon_Archive24.png]]) will save a copy of the report in the archive for the table and record that was selected with the Viewer was first opened. More specifically, the report will be archived under the table and record used to open the report.  If you use the drill to move from, say, Business Partners to Invoice, and then archive the Invoice report, it will be archived under the Business Partner used to open the report.  For more information see the [[Archive]] page.
  
===Mail senden===
+
=== Export ===
  
Wenn Sie auf das E-Mail senden Icon ([[Image:Icon_SendMail24.png]]) drücken wird der Bericht in das PDF-Format konvertieren und als Entwurf an den E-Mail-Dialog angehangen. Siehe auch [[EMail-Hilfe_(Support)]] oder [[EMail]] für weitere Informationen.
+
Clicking the '''Export''' button ([[Image:Icon_Export24.png]]) will open a save dialog where you can save the report to disk as an XLS file. The saved file will then be opened in the appropriate software. See [[Export]] for more information.
  
 +
== For Developers ==
  
 
+
The software that controls this dialog is found in
 
+
===Als Dokument archivieren===
+
 
+
Durch einen Klick auf das '''Archivierte Belege und Berichte''' Symbol ([[Image:Icon_Archive24.png]]) wird für die Tabelle und Datensätze eine Kopie des Berichts in das Archiv gespeichert. Werden erstmalig Belege oder Berichte archivert erscheint ein Dateiauswahldialog. Genauer gesagt, wird der Bericht unter der Tabelle und dem Datensatz archiviert. Weitere Informationen gibt es im WIKI unter [[Archivierte_Dokumente]] bzw. [[Archive]].
+
 
+
 
+
 
+
 
+
===Export===
+
 
+
Ein Klick auf das '''Export'''- Icon  ([[Image:Icon_Export24.png]]) öffnet das Dialogfeld zum Speichern mit dem Sie den Bericht als XLS-Datei auf der Festplatte speichern können. Siehe [[Exportieren]] bzw.
+
[[Export]] für weitere Informationen.
+
 
+
 
+
 
+
 
+
==Für Entwicker==
+
 
+
Die Software befindet sich in:
+
  
 
* base/src
 
* base/src
Line 236: Line 156:
 
** org.compiere.print.SwingViewerProvider.java
 
** org.compiere.print.SwingViewerProvider.java
 
** org.compiere.print.Viewer.java
 
** org.compiere.print.Viewer.java
 
 
 
 
==Original Seite==
 
 
[[http://www.adempiere.com/Report Report]]
 

Latest revision as of 18:27, 29 January 2012

Table of Contents{{#if: Functionality| | Functionality }}{{#if: | | [[{{{3}}}]] }}{{#if: | | [[{{{4}}}]] }}{{#if: | | [[{{{5}}}]] }} | Report{{#if: Request| | Request }} ⇒

The Report function provides a way to generate simple reports based on the data being viewed.

Access

Icon: Report24.png
Menu: →Report }}{{#if: | → }}{{#if: | → }}
Short Cut: <F11>

Restrictions

To enable reports, the user's role must have Can Report checked in the {{#if: |{{{2}}}|Role }} Window.

To Export the reports, the user's role must have Can Export checked in the {{#if: |{{{2}}}|Role }} Window.

The Report function is only available when viewing a data window.

Description

The Report function will display reports on the current records and table. The format of the report is determined by Print Formats, several of which can be defined for any table.

It is possible to modify the report formats and add others so that there is a choice of what you want to see when you click the report button. For more information on the possibilities, see Print Formats.

It is also possible to override the internal report mechanism and create the reports with Jasper Reports. See Jasper Reports Integration for more information.

When the report menu or icon (Report24.png) is selected or clicked, ADempiere will check to see if there are any predefined reports.

If there are no pre-defined reports, ADempiere will create one using the name of the table. This default print format will use a standard header and will display all available fields in a flat format, one line per row. This will often result in a report that is many pages wide - not very useful, but its a start.

If only one report is defined, it will be displayed immediately. If there are more than one, a small pop-up dialog will appear next to the Report icon in the tool bar, as shown below, with a list of all the defined reports. Clicking on one of the items in the list will open the selected report.

 

Report Popup.png

 

ADempiere will determine if the report is a Jasper Report or a standard report and will display the report accordingly. For more on Jasper Reports, see the Jasper Report documentation. The rest of this article refers to the standard report.

The Report Viewer

The Report Viewer appears as shown below.

 

ReportExample.png

 

The Viewer has the following main components:

  • a title bar
  • a main menu (File, View, Go, ...)
  • a tool bar with several controls
  • the report window
  • a status bar at the bottom and
  • a page count

The title bar and main menu are pretty standard with the following additions:

  • File
    • Customize Report
    • Translate
    • Lookup Record
  • Go
    • First Page
    • Previous Page
    • Next Page
    • Last Page

The tool bar contains the following controls:

  • Previous Page
  • Go To Page
  • Next Page
  • Zoom
  • Drill (by table)
  • Print Formats
  • Summary check box
  • Customize Report
  • Lookup Record
  • Print
  • Page Setup
  • Send mail
  • Archive documents
  • Export
  • Exit the Window

We will look at a few of these in detail.

Drilling Up, Down and Across

The Report Viewer provides the ability to drill down into details, across to related reports and up to more general information.

Each _ID field in the report will appear as a link to the default report for the associated table. Double-clicking the link will open that report.

The Drill Control is a combo box style control with a list of tables that use the main key field of the report being viewed. For example, if viewing the Business Partner report, the key field will be C_BPartner_ID. The Drill Control will contain a list of all tables that include C_BPartner_ID as a column.

Selecting any entry in the Drill control will enable the drill. Then, double clicking on any record in the current report will open the report based on that record. You can click anywhere in the record.

As an example, open the {{#if: Product Category|Product Category|ProductCategory }} Window and click on the Report icon (Report24.png). When the report opens, use the Lookup control (see below) to find all records. Then, select Product in the Drill control and double click on any row in the Product Category report. Another Report Viewer will open showing the Product report listing all products in the Product Category you clicked on.

Click on the link to the Unit of Measure (UOM) for any product on the list. A report based on the C_UOM table with the selected C_UOM_ID will appear. Use the Drill control to find all products that use that UOM by selecting Product in the Drill control and then double clicking anywhere on the record in the UOM report.

Try this: find an invoice that has a particular product on one or more of it's invoice lines.

Note.gif Note:

The database is built on one-to-many relationships. The Drill moves along these relationships. This makes it difficult to find ALL invoices that order a particular product but easy to find one invoice that does.

Print Format

The Print Format combo box displays the current Print Format being displayed. If additional Print Formats are defined for the same table, they will also be listed here. Selecting one of them will close the current report and display the selected one. See Print Formats for more information on creating additional Print Formats.

Note.gif Note:

Defining multiple Print Formats for a table is a great way to display information with less clutter. Set up reports around relevant groupings.

Summary

The Summary check box will collapse the report to its main groupings, showing only columns that are set to "group by" or have one of the "Calculate" functions selected in the {{#if: Format Item|Format Item|FormatItem }} Tab of the {{#if: Print Format|Print Format|PrintFormat }} Window.

Customizing the Report

Clicking on the Customize Report icon (Icon Preference24.png) or selecting File{{#if: Customize Report | →Customize Report }}{{#if: | → }}{{#if: | → }} will open the {{#if: Print Format|Print Format|PrintFormat }} Window. Here the format of the report can be modified, the number and placement of the fields controlled, sort orders set and so on. For more information on how to customize the reports, see Print Formats.

Lookup Record

When the report opens initially, only the current record selected in the window is shown. The Lookup Record function (Icon Find24.png) can be used to find all or specific records. The Lookup Record function works in the same way as it does in the windows. See Lookup for more information.

Page Setup

Clicking the Page Setup icon (Icon PageSetup24.png) will open a small dialog similar to the one below where the page source, size, margins and orientation can be changed. The dialog draws it's information from the printer so the margins may initially reflect the printable area, rather than what was set in the Print Format. Changing the settings and clicking OK will change the format in the viewer.

 

PageSetup.png

 

Send Mail

Clicking the Send Mail icon (Icon SendMail24.png) will convert the report to PDF format and attach it to a draft e-mail dialog. You can then send the e-mail to whomever you like. See the EMail page for more information.

Archive Documents

Clicking the Archive Reports icon (Icon Archive24.png) will save a copy of the report in the archive for the table and record that was selected with the Viewer was first opened. More specifically, the report will be archived under the table and record used to open the report. If you use the drill to move from, say, Business Partners to Invoice, and then archive the Invoice report, it will be archived under the Business Partner used to open the report. For more information see the Archive page.

Export

Clicking the Export button (Icon Export24.png) will open a save dialog where you can save the report to disk as an XLS file. The saved file will then be opened in the appropriate software. See Export for more information.

For Developers

The software that controls this dialog is found in

  • base/src
    • org.compiere.print.ReportEngine.java
  • client/src
    • org.compiere.apps.APanel.java
    • org.compiere.print.AReport.java
    • org.compiere.print.CPaper.java
    • org.compiere.print.LayoutEngine.java
    • org.compiere.print.ReportCtl.java
    • org.compiere.print.ReportViewerProvider.java
    • org.compiere.print.SwingViewerProvider.java
    • org.compiere.print.Viewer.java