Changes for page Reports

Last modified by Steffi F on 2026/07/24 08:37

From version 2.1

edited by Steffi F
on 2026/07/24 08:37

Change comment: There is no comment for this version

To version 1.1

edited by Steffi F
on 2026/07/24 06:52

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -74,127 +74,132 @@
  The following screenshot shows the created report in the Designer. First, you’ll see the basic sections such as Report Title, Main Header, Main Data, and Footer. However, since a Client can have multiple drives, there are also sections for Detail Header, Detail Data, and Detail Footer. As the names of these sections suggest, details are listed here—in this case, the drives.
--[[Generated Report>>image:XWiki.Images.WebHome@hmfile_hash_49916695.png||alt="Erstellter Report" data-xwiki-image-style-alignment="center" height="421" width="478"]]
++[[Erstellter Report>>image:XWiki.Images.WebHome@hmfile_hash_49916695.png||alt="Erstellter Report" data-xwiki-image-style-alignment="center" height="421" width="478"]]
--As described in the section [[Working with the Report Builder>>doc:.Reportbuilder .Mit dem Reportbuilder arbeiten.WebHome]], you can also count group elements here and create a page header and footer. For example, the existing page footer could be expanded to include the current date. In addition, each Client and its drives could be displayed on a separate page.
++Wie im Abschnitt [[Arbeiten mit dem Reportbuilder>>doc:ACMP.610.ACMP-Solutions.Client-Management.Reports.Reportbuilder .Mit dem Reportbuilder arbeiten.WebHome]] können auch hier Gruppenelemente gezählt und ein Seitenkopf sowie –fuß erstellt werden. Der vorhandene Seitenfuß könnte so z.B. noch um das aktuelle Datum ergänzt werden. Zusätzlich ließe sich jeder Client mit seinen Laufwerken auf einer eigenen Seite darstellen.
--== Diagram ==
++== Diagramme ==
--To make the entire report more visually appealing, a chart is a good option. The goal is to create a chart that shows the free disk space on each client’s individual drives in relation to one another. To do this, use the chart tool. Now click in the report preview at the location where you want the chart to be inserted.
--The chart editor opens in a new window. Here, you can configure the chart.
++Um den ganzen Report optisch besser aufbereiten zu können, bietet sich zum Beispiel ein Diagramm an. Es soll dazu ein Diagramm erstellt werden, welches den freien Speicherplatz der einzelnen Laufwerke eines jeden Clients im Verhältnis zueinander darstellt. Dazu wird das Diagramm-Werkzeug verwendet. Klicken Sie nun in der Reportvorschau an die Stelle, wo später das Diagramm eingefügt werden soll.
++Es öffnet sich der Diagramm-Editor in einem neuen Fenster. Hier konfigurieren Sie das Diagramm.
++
  [[image:XWiki.Images.WebHome@hmfile_hash_cfaab069.png||alt="Diagramm konfigurieren" data-xwiki-image-style-alignment="center" height="391" width="495"]]
--If you haven't created a chart series yet, click Add Series ().
--The dialog box contains three tabs: Type, Data, and Labels. Under Type, you can set the chart type and some display settings. The Data section is used to specify report elements that contain the data to be displayed. Finally, under Labels, you can specify how the chart data should be labeled.
--On the Type tab, select the pie chart. This displays the data in relation to one another. You can leave the options as they are. On the Data tab, specify the report elements that contain the relevant data. The captions of the individual drives serve as the legend. To do this, enter the internal name of the rectangle object labeled [vLogical Drives->Drive Label]. In this case, it is Memo7. Follow the same procedure to specify the values. Here, enter the internal name of the element labeled [vLogical Drives->Drive Free Space]. This element contains the amount of free space on a drive and is named Memo8 here. All other settings can be left as they are for now. The following screenshots show the settings in the dialog:
++Wenn Sie bisher keine Diagrammserie erstellt haben, klicken Sie auf Serien hinzufügen ().
++Der Dialog bietet die drei Tabs Art, Daten und Markierungen. Unter Art können der Diagrammtyp sowie einige Anzeigeoptionen eingestellt werden. Der Bereich Daten dient der Angabe von Report-Elementen, welche die darzustellenden Daten beinhalten. Zuletzt kann unter Markierungen angegeben werden, wie die Daten des Diagramms beschriftet werden sollen.
++
++Wählen Sie im Tab Art das Kreisdiagramm aus. Dadurch werden die Daten im Verhältnis zueinander dargestellt. Die Optionen können so belassen werden. Im Tab Daten geben Sie nun die Report-Elemente an, welche die entsprechenden Daten enthalten. Als Legende dient die Bezeichnung der einzelnen Laufwerke. Dazu geben Sie den internen Namen des Rechteckobjektes mit der Aufschrift [vLogical Drives->Drive Label] an. In diesem Fall lautet er Memo7. Für die Angabe der Werte wird ebenso verfahren. Geben Sie hier den internen Namen des Elements mit der Aufschrift [vLogical Drives->Drive Free Space] an. Dieses Element beinhaltet die Angabe des freien Speicherplatzes eines Laufwerks und lautet hier Memo8. Alle anderen Angaben können vorerst so belassen werden. Die folgenden Screenshots zeigen die Angaben im Dialog:
++
  |(% style="width:524px" %)[[image:XWiki.Images.WebHome@hmfile_hash_8a61fe57.png||alt="8.6.4.2 - Diagram 1" data-xwiki-image-style-alignment="end" height="258" width="276"]]|(% style="width:552px" %)[[image:XWiki.Images.WebHome@hmfile_hash_08c464bf.png||alt="8.6.4.2 - Diagram 2" height="258" width="276"]]
--To find the internal name of an element, select it and open the Object Inspector. Among other things, the Object Inspector displays the element’s name. The name appears in the top drop-down list.
++Um den internen Namen eines Elements herauszufinden, markieren Sie dieses und rufen den Objekt Inspector auf. Dieser zeigt unter anderem den Namen des Elements an. Der Name wird in der oberen DropDown-Liste angezeigt.
--It is important to note that, when creating charts, only data that is directly related to one another can be used for legends and values. If, in this example, the computer name (Memo3) were entered as the legend, the chart could not be created because the data (free space) directly pertains to the individual drives, whereas the client (computer name) is only indirectly related.
++Wichtig bei Diagrammen ist, dass für Legenden und Werte nur Daten genutzt werden können, die unmittelbar miteinander zusammen hängen. Würde in diesem Beispiel der Computer Name (Memo3) als Legende eingetragen, könnte das Diagramm nicht erstellt werden, da die Daten (der freie Speicherplatz) die einzelnen Laufwerke direkt betreffen, den Client (Computer Name) jedoch nur indirekt.
--To ensure the chart is displayed properly, resize the chart element using the handle points. To do this, you must also increase the height of the detail footer. Additionally, continuing customization is made to improve the report’s appearance:
++Damit das Diagramm auch ordentlich angezeigt wird, vergrößern Sie das Diagramm-Element über die Rahmenpunkte. Dazu muss ebenso der Detailfuß in der Höhe vergrößert werden. Zusätzlich werden noch weitere Anpassungen vorgenommen, um den Bericht besser wirken zu lassen:
--* The report title is moved upward to maintain a specific distance from the top margin of the page.
--* A page header is inserted, which is also moved slightly upward. This creates a space between the report title and the first list. Similarly, a space is created between the top margin and the content on subsequent pages.
--* The rectangle object in the main header is formatted as bold and italic.
--* The main data section is advanced downward to create space between it and the actual data. The rectangle object within it is formatted as bold.
--* The detail header is slightly extended downward so that a horizontal line can be inserted. The Insert Line tool is used for this.
--* Vertical lines are drawn between the rectangle objects in the “Detail Data” section to create a visual separation between the individual datasets.
--* The page footer is slightly extended downward to maintain a margin from the bottom edge of the page.
++* Der Report Titel wird nach oben hin in der Höhe vergrößert, um einen bestimmten Abstand zum oberen Rand der Seite einzuhalten.
++* Es wird ein Seitenkopf eingefügt, welcher ebenfalls etwas in der Höhe vergrößert wird. Dadurch wird ein Abstand zwischen dem Report Titel und der ersten Auflistung eingehalten. Ebenso wird auf den Folgeseiten ein Abstand zum oberen Seitenrand erzeugt.
++* Das Rechteckobjekt im Hauptkopf wird fett und kursiv gesetzt.
++* Der Bereich Hauptdaten wird nach unten hin in der Höhe erweitert um einen Abstand zu den eigentlichen Daten zu haben. Das enthaltene Rechteckobjekt wird fett gesetzt.
++* Der Detailkopf wird in der Höhe nach unten hin leicht vergrößert, sodass eine waagerechte Linie eingezogen werden kann. Dazu wird das Linie einfügen-Werkzeug genutzt.
++* Zwischen den Rechteckobjekten des Detaildaten-Bereichs werden senkrechte Linien eingezogen, um eine optische Trennung der einzelnen Datensätze zu erstellen.
++* Der Seitenfuß wird nach unten hin etwas in der Höhe vergrößert, um einen Abstand zum unteren Rand der Seite einzuhalten.
--The following screenshot shows what the report looks like in the Designer after these customizations:
++Wie der Report im Designer nach diesen Anpassungen aussieht, zeigt der folgende Screenshot:
  [[image:XWiki.Images.WebHome@hmfile_hash_4c98300c.png||alt="8.6.4.2 - Diagram 3" data-xwiki-image-style-alignment="center" height="488" width="554"]]
--The report could then look like this:
++Der Report könnte anschließend wie folgt aussehen:
  [[image:XWiki.Images.WebHome@hmfile_hash_0d77700a.png||alt="8.6.4.2 - Diagram 4" data-xwiki-image-style-alignment="center" height="299" width="560"]]
--=== Using Charts with Grouped Data ===
++=== Diagrammverwendung bei gruppierten Daten ===
--If you want to use charts in a report based on nested datasets, you must prepare the data manually. The following example illustrates this process.
++Falls Sie in einem Report, der auf verschachtelten Datensätze aufbaut, Diagramme verwenden möchten, so müssen Sie die Daten manuell aufbereiten. Dies soll am folgenden Beispiel exemplarisch dargestellt werden.
--The report should list all operating systems. For each operating system, a separate list should also be created showing all Clients running that operating system. At the end of the report, the distribution of operating systems should be graphically represented in a pie chart. However, before this can be done, the number of Clients for each operating system must be calculated manually.
++Der Report soll eine Auflistung aller Betriebssysteme enthalten. Zu jedem Betriebssystem soll zudem eine eigene Liste mit allen Clients, auf denen das entsprechende Betriebssystem läuft, erstellt werden. Am Ende des Reports soll die Verteilung der Betriebssysteme in einem Tortendiagramm grafisch dargestellt werden. Bevor dies jedoch geschehen kann, muss die Anzahl der Clients eines Betriebssystem manuell berechnet werden.
--First, create a new report. If the desired Query already exists, you can select it. Otherwise, you can create your own Query for the report. The example used here requires only the “OS Name” and “Computer Name” information.
++Erstellen Sie zunächst einen neuen Report. Falls bereits die gewünschte Abfrage besteht, so kann diese ausgewählt werden. Andernfalls können Sie eine eigene Abfrage für den Report erstellen. Das hier verwendete Beispiel benötigt lediglich die Informationen "OS Name" und "Computer Name".
--Next, add a group header and group footer to your report. Enter the operating system name in the group header and create a corresponding field for the number of Clients in the group footer. The associated variable will be created later. If desired, you can also add additional information, such as the date.
++Fügen Sie anschließend einen Gruppenkopf und Gruppenfuß ihrem Report hinzu. Hinterlegen Sie den Betriebssystemnamen im Gruppenkopf und erstellen Sie ein entsprechendes Feld für die Anzahl der Clients im Gruppenfuß. Die dazugehörige Variable wird hinterher erstellt. Fall gewünscht, können Sie auch noch zusätzliche Informationen, wie z.B. das Datum, hinzufügen.
  (% style="text-align:center" %)
  [[image:XWiki.Images.WebHome@reports_groupdatadiagram_1.png||alt="Reports_GroupdataDiagram_1" height="306" width="597"]]
--Creating Group Headers and Group Footers
++Erstellen von Gruppenkopf und Gruppenfuß
--For the chart, you can use the “Report Summary” ribbon. This is only for logical organization and is not required. Then insert the chart. Be sure to select “Fixed Data” as the data source. If necessary, you can also customize the chart further.
++Für das Diagramm können Sie das Band "Reportzusammenfassung" verwenden. Dies dient nur der logischen Strukturierung und ist nicht notwendig. Fügen Sie anschließend das Diagramm ein. Achten Sie hierbei darauf, als Datenquelle "Fixe Daten" anzugeben. Bei Bedarf können Sie auch weitere optische anpassen vornehmen.
  (% style="text-align:center" %)
  [[image:XWiki.Images.WebHome@reports_groupdatadiagram_2.png||alt="Reports_GroupdataDiagram_2" height="370" width="417"]]
--Insert a chart
++Diagramm einfügen
--Now switch to the Code tab of the Report Editor. Here, you must first define the required variables. A total of 4 different variables are needed:
++Wechseln Sie nun in den Code-Tab des Reporteditors. Hier müssen zunächst die benötigten Variablen definiert werden. Insgesamt werden 4 verschiedene Variablen benötigt:
--* Count: Contains the number of Clients for a given operating system
--* Total Count: Contains the total number of Clients
--* X_Chart: Contains the list of different operating systems
--* Y_Chart: Contains the list of the number of Clients for the different operating systems
++* Anzahl: Enthält die Anzahl der Clients eines Betriebssystem
++* Anzahl Gesamt: Enthält die Gesamtanzahl an Clients
++* X_Chart: Enthält die Liste mit verschiedenen Betriebssystemen
++* Y_Chart: Enthält die Liste mit der Anzahl der Clients der verschiedenen Betriebssystemen
--The required source code for the individual sections of the report can now be inserted into the corresponding OnBeforePrint procedures of the individual bands. First, the variables must be assigned initial values. This is done in the ReportTitle or in the GroupHeader. Be sure to set the “Number” variable in the GroupHeader to 0. This allows the correct number of Clients for each operating system to be calculated. You can then increment both the “Anzahl” and ‘Anzahl_Gesamt’ variables by one in the MasterData. In the GroupFooter, the data can now be consolidated into a list. The data is stored as a string and separated by a “;” (example: “Windows 7;Windows XP;”).
++Der benötigte Quellcode für die einzelnen Bereiche des Reports kann nun in die entsprechenden OnBeforePrint-Prozeduren der einzelnen Bänder eingefügt werden. Zunächst einmal müssen die Variablen mit Ausgangswerten belegt werden. Dies geschieht im ReportTitle bzw. im GroupHeader. Achten Sie darauf, die Variable Anzahl im GroupHeader auf den Wert 0 zu setzen. Auf diese Weise kann die korrekte Anzahl der Clients eines Betriebssystems berechnet werden. Anschließend können Sie im MasterData die Anzahl, sowie die Anzahl_Gesamt jeweils um Eins erhöhen. Im GroupFooter können nun die Daten zu einer Liste zusammengeführt werden. Die Daten werden als String gespeichert und durch ein ";" getrennt (Beispiel: "Windows 7;Windows XP;").
--Finally, the data can be assigned to the chart in the ReportSummary.
++Abschließend können die Daten in der ReportSummary dem Diagramm zugeordnet werden.
--====== Source code ======
++====== Quellcode ======
--~/~/Define variables
++~/~/Variablen definieren
--var
--Count : int;
--Total_Count : int;
--X_Chart, Y_Chart : String;
++var
++Anzahl : int;
++Anzahl_Gesamt : int;
++X_Chart,Y_Chart : String;
++
--~/~/Set initial values
--procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);
++~/~/Ausgangswerte festlegen
++procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);
  begin
--Total_Count := 0;
--X_Chart := ‘’;
--Y_Chart := ‘’;
++Anzahl_Gesamt := 0;
++X_Chart := '';
++Y_Chart := '';
  end;
++
--~/~/Reset the counter to 0
--procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
++~/~/Zähler wieder auf 0 setzen
++procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
  begin
--Number := 0;
++Anzahl := 0;
  end;
++
--~/~/Count Clients
--procedure MasterData1OnBeforePrint(Sender: TfrxComponent);
++~/~/Clients zählen
++procedure MasterData1OnBeforePrint(Sender: TfrxComponent);
  begin
--  Number := 1 + Number;
--  Total_Number := 1 + Total_Number;
++  Anzahl := 1 + Anzahl;
++  Anzahl_Gesamt := 1 + Anzahl_Gesamt;
  end;
++
--~/~/Add to the list of Clients and the quantity
--procedure GroupFooter1OnBeforePrint(Sender: TfrxComponent);
++~/~/Zur Liste der Clients und der Menge hinzufügen
++procedure GroupFooter1OnBeforePrint(Sender: TfrxComponent);
  begin
--  X_Chart := X_Chart + Memo4.Value + ‘;’ ;
--  Y_Chart := Y_Chart + IntToStr(Count) + ‘;’ ;
++  X_Chart := X_Chart + Memo4.Value + ';' ;
++  Y_Chart := Y_Chart + IntToStr(Anzahl) + ';' ;
  end;
--
--~/~/Pass data to the chart
--procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
++\\~/~/Daten an das Diagramm übergeben
++procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
  begin
--  Chart2.SeriesData[0].XSource := X_Chart;
--  Chart2.SeriesData[0].YSource := Y_Chart;
++  Chart2.SeriesData[0].XSource := X_Chart;
++  Chart2.SeriesData[0].YSource := Y_Chart;
  end;
++\\begin
++\\end.
--begin
--
--end.
--
  {{aagon.infobox}}
--If a chart displays incorrectly, this is often due to insufficient display space. In this case, try hiding any captions you don't need, for example, under Pie -> Marks -> Visible = “False”. It may also be helpful to change the position of the legend under Chart -> Alignment = ‘laBottom’ or “laTop”
++Kommt es bei einem Diagramm zu Darstellungsfehlern, so ist dies oft auf eine nicht ausreichende Anzeigefläche zurückzuführen. Versuchen Sie in diesem Fall nicht benötigte Beschriftungen auszublenden, z.B. unter Pie -> Marks -> Visible = "False". Zudem kann es hilfreich sein die Position der Legende zu ändern, unter Diagramm -> Alignment = "laBottom" oder "laTop"
  {{/aagon.infobox}}
--Example:
++(% style="color:inherit; font-family:inherit; font-size:16px" %)Beispieldiagramm:
++
  [[image:XWiki.Images.WebHome@reports_groupdatadiagram_3_zoom75.png||alt="Reports_GroupdataDiagram_3" data-xwiki-image-style-alignment="center" height="469" width="376"]]