Changes for page Reports

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.SF
	1	+XWiki.SV

Content

...	...	@@ -1,9 +1,9 @@
1	1	{{aagon.floatingbox/}}
2	2
3		-The Report Center is designed to visually present data from the machines you manage with ACMP. This can be very helpful, for example, for presentations or internal reports. With the Report Center, you can create complete reports, including lists and charts.
	3	+The Report Center is designed to visually present data from the machines you manage with acmp. This can be very helpful, for example, for presentations or internal reports. With the Report Center, you can create complete reports, including lists and charts.
4	4
5	5	{{aagon.warnungsbox}}
6		-Starting with ACMP 5.1, the Display Fields have been modified. As a result, when updating from an earlier version of ACMP, you will need to customize the following included reports: Hardware Card, Decommissioned Machines, Hardware Card, RAM. To do this, delete the existing field and add it again! Please note that you will also need to customize your own reports if you have been using the “RAM Slot Available” Display Field!
	6	+Starting with acmp 5.1, the Display Fields have been modified. As a result, when updating from an earlier version of acmp, you will need to customize the following included reports: Hardware Card, Decommissioned Machines, Hardware Card, RAM. To do this, delete the existing field and add it again! Please note that you will also need to customize your own reports if you have been using the “RAM Slot Available” Display Field!
7	7	{{/aagon.warnungsbox}}
8	8
9	9	The structure of the Report Center is similar to that of Query Management. Here, too, the existing reports are organized into groups, with the “Hardware” group integrated by default. The remaining groups are linked to the corresponding solution and are displayed only if you have valid licenses.
...	...	@@ -45,7 +45,7 @@
45	45
46	46	[[Set Up Email>>image:XWiki.Images.WebHome@hmfile_hash_35b91239.png||alt="E-Mail konfigurieren" data-xwiki-image-style-alignment="center" height="418" width="659"]]
47	47
48		-On this page, you can configure the email to be sent. First, enter a recipient or a recipient group. The “To,” “CC,” and “BCC” fields are available for this purpose. For all three fields, you can access [[users>>url:https://www.deepl.com/de/translator#GlobaleNutzerkonten]] and [[groups>>url:https://www.deepl.com/bin/view/ACMP/610/ACMP-Solutions/System/Benutzerverwaltung/#HGruppenverwalten]] that you have already created in ACMP, or you can manually enter the correct email address. Next, enter the subject line. By default, the name of the underlying report and a timestamp are entered here. You can customize all values to suit your needs and requirements.
	48	+On this page, you can configure the email to be sent. First, enter a recipient or a recipient group. The “To,” “CC,” and “BCC” fields are available for this purpose. For all three fields, you can access [[users>>url:https://www.deepl.com/de/translator#GlobaleNutzerkonten]] and [[groups>>url:https://www.deepl.com/bin/view/ACMP/610/ACMP-Solutions/System/Benutzerverwaltung/#HGruppenverwalten]] that you have already created in acmp, or you can manually enter the correct email address. Next, enter the subject line. By default, the name of the underlying report and a timestamp are entered here. You can customize all values to suit your needs and requirements.
49	49
50	50	Finally, if necessary, enter the actual email text in the corresponding field and click Next to specify the start condition. You have the following options:
51	51
...	...	@@ -74,132 +74,127 @@
74	74
75	75	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.
76	76
77		-[[Erstellter Report>>image:XWiki.Images.WebHome@hmfile_hash_49916695.png||alt="Erstellter Report" data-xwiki-image-style-alignment="center" height="421" width="478"]]
	77	+[[Generated Report>>image:XWiki.Images.WebHome@hmfile_hash_49916695.png||alt="Erstellter Report" data-xwiki-image-style-alignment="center" height="421" width="478"]]
78	78
79		-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.
	79	+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.
80	80
81		-== Diagramme ==
	81	+== Diagram ==
82	82
83		-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.
	83	+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.
	84	+The chart editor opens in a new window. Here, you can configure the chart.
84	84
85		-Es öffnet sich der Diagramm-Editor in einem neuen Fenster. Hier konfigurieren Sie das Diagramm.
86		-
87	87	[[image:XWiki.Images.WebHome@hmfile_hash_cfaab069.png||alt="Diagramm konfigurieren" data-xwiki-image-style-alignment="center" height="391" width="495"]]
88	88
89		-Wenn Sie bisher keine Diagrammserie erstellt haben, klicken Sie auf Serien hinzufügen ().
	88	+If you haven't created a chart series yet, click Add Series ().
	89	+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.
	90	+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:
90	90
91		-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.
92		-
93		-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:
94		-
95	95	|(% 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"]]
96	96
97		-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.
	94	+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.
98	98
99		-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.
	96	+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.
100	100
101		-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:
	98	+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:
102	102
103		-* Der Report Titel wird nach oben hin in der Höhe vergrößert, um einen bestimmten Abstand zum oberen Rand der Seite einzuhalten.
104		-* 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.
105		-* Das Rechteckobjekt im Hauptkopf wird fett und kursiv gesetzt.
106		-* 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.
107		-* 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.
108		-* Zwischen den Rechteckobjekten des Detaildaten-Bereichs werden senkrechte Linien eingezogen, um eine optische Trennung der einzelnen Datensätze zu erstellen.
109		-* Der Seitenfuß wird nach unten hin etwas in der Höhe vergrößert, um einen Abstand zum unteren Rand der Seite einzuhalten.
	100	+* The report title is moved upward to maintain a specific distance from the top margin of the page.
	101	+* 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.
	102	+* The rectangle object in the main header is formatted as bold and italic.
	103	+* 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.
	104	+* The detail header is slightly extended downward so that a horizontal line can be inserted. The Insert Line tool is used for this.
	105	+* Vertical lines are drawn between the rectangle objects in the “Detail Data” section to create a visual separation between the individual datasets.
	106	+* The page footer is slightly extended downward to maintain a margin from the bottom edge of the page.
110	110
111		-Wie der Report im Designer nach diesen Anpassungen aussieht, zeigt der folgende Screenshot:
	108	+The following screenshot shows what the report looks like in the Designer after these customizations:
112	112
113	113	[[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"]]
114	114
115		-Der Report könnte anschließend wie folgt aussehen:
	112	+The report could then look like this:
116	116
117	117	[[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"]]
118	118
119		-=== Diagrammverwendung bei gruppierten Daten ===
	116	+=== Using Charts with Grouped Data ===
120	120
121		-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.
	118	+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.
122	122
123		-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.
	120	+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.
124	124
125		-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".
	122	+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.
126	126
127		-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.
	124	+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.
128	128
129	129	(% style="text-align:center" %)
130	130	[[image:XWiki.Images.WebHome@reports_groupdatadiagram_1.png||alt="Reports_GroupdataDiagram_1" height="306" width="597"]]
131		-Erstellen von Gruppenkopf und Gruppenfuß
	128	+Creating Group Headers and Group Footers
132	132
133		-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.
	130	+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.
134	134
135	135	(% style="text-align:center" %)
136	136	[[image:XWiki.Images.WebHome@reports_groupdatadiagram_2.png||alt="Reports_GroupdataDiagram_2" height="370" width="417"]]
137		-Diagramm einfügen
	134	+Insert a chart
138	138
139		-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:
	136	+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:
140	140
141		-* Anzahl: Enthält die Anzahl der Clients eines Betriebssystem
142		-* Anzahl Gesamt: Enthält die Gesamtanzahl an Clients
143		-* X_Chart: Enthält die Liste mit verschiedenen Betriebssystemen
144		-* Y_Chart: Enthält die Liste mit der Anzahl der Clients der verschiedenen Betriebssystemen
	138	+* Count: Contains the number of Clients for a given operating system
	139	+* Total Count: Contains the total number of Clients
	140	+* X_Chart: Contains the list of different operating systems
	141	+* Y_Chart: Contains the list of the number of Clients for the different operating systems
145	145
146		-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;").
	143	+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;”).
147	147
148		-Abschließend können die Daten in der ReportSummary dem Diagramm zugeordnet werden.
	145	+Finally, the data can be assigned to the chart in the ReportSummary.
149	149
150		-====== Quellcode ======
	147	+====== Source code ======
151	151
152		-~/~/Variablen definieren
	149	+~/~/Define variables
153	153
154		-var
155		-Anzahl : int;
156		-Anzahl_Gesamt : int;
157		-X_Chart,Y_Chart : String;
158		-
	151	+var
	152	+Count : int;
	153	+Total_Count : int;
	154	+X_Chart, Y_Chart : String;
159	159
160		-~/~/Ausgangswerte festlegen
161		-procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);
	156	+~/~/Set initial values
	157	+procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);
162	162	begin
163		-Anzahl_Gesamt := 0;
164		-X_Chart := '';
165		-Y_Chart := '';
	159	+Total_Count := 0;
	160	+X_Chart := ‘’;
	161	+Y_Chart := ‘’;
166	166	end;
167		-
168	168
169		-~/~/Zähler wieder auf 0 setzen
170		-procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
	164	+~/~/Reset the counter to 0
	165	+procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
171	171	begin
172		-Anzahl := 0;
	167	+Number := 0;
173	173	end;
174		-
175	175
176		-~/~/Clients zählen
177		-procedure MasterData1OnBeforePrint(Sender: TfrxComponent);
	170	+~/~/Count Clients
	171	+procedure MasterData1OnBeforePrint(Sender: TfrxComponent);
178	178	begin
179		- Anzahl := 1 + Anzahl;
180		- Anzahl_Gesamt := 1 + Anzahl_Gesamt;
	173	+ Number := 1 + Number;
	174	+ Total_Number := 1 + Total_Number;
181	181	end;
182		-
183	183
184		-~/~/Zur Liste der Clients und der Menge hinzufügen
185		-procedure GroupFooter1OnBeforePrint(Sender: TfrxComponent);
	177	+~/~/Add to the list of Clients and the quantity
	178	+procedure GroupFooter1OnBeforePrint(Sender: TfrxComponent);
186	186	begin
187		- X_Chart := X_Chart + Memo4.Value + ';' ;
188		- Y_Chart := Y_Chart + IntToStr(Anzahl) + ';' ;
	180	+ X_Chart := X_Chart + Memo4.Value + ‘;’ ;
	181	+ Y_Chart := Y_Chart + IntToStr(Count) + ‘;’ ;
189	189	end;
190		-\\~/~/Daten an das Diagramm übergeben
191		-procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
	183	+
	184	+~/~/Pass data to the chart
	185	+procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
192	192	begin
193		- Chart2.SeriesData[0].XSource := X_Chart;
194		- Chart2.SeriesData[0].YSource := Y_Chart;
	187	+ Chart2.SeriesData[0].XSource := X_Chart;
	188	+ Chart2.SeriesData[0].YSource := Y_Chart;
195	195	end;
196		-\\begin
197		-\\end.
198	198
	191	+begin
	192	+
	193	+end.
	194	+
199	199	{{aagon.infobox}}
200		-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"
	196	+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”
201	201	{{/aagon.infobox}}
202	202
203		-(% style="color:inherit; font-family:inherit; font-size:16px" %)Beispieldiagramm:
204		-
	199	+Example:
205	205	[[image:XWiki.Images.WebHome@reports_groupdatadiagram_3_zoom75.png||alt="Reports_GroupdataDiagram_3" data-xwiki-image-style-alignment="center" height="469" width="376"]]