Wiki-Quellcode von Reports

Zuletzt geändert von Jannis Klein am 2024/03/19 18:00
Zeige letzte Bearbeiter
1 {{aagon.priorisierung}}
2 40
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
7 Das Report Center dient dazu, Daten Ihrer mit ACMP verwalteten Rechner optisch aufzubereiten. Dies kann z.B. für Vorträge oder interne Nachweise sehr hilfreich sein. Mit dem Report Center lassen sich komplette Berichte inkl. Auflistungen und Diagrammen erstellen.
8
9 {{aagon.warnungsbox}}
10 Seit ACMP 5.1 wurden die DisplayFields überarbeitet. Dies hat zur Folge, dass Sie bei einem Update von einer früheren ACMP Version die folgenden mitgelieferten Reports anpassen: Hardwarekarte, stillgelegte Rechner, Hardwarekarte, RAM. ​​​​​Löschen Sie hierzu das bestehende Feld und fügen es neu hinzu! Beachten Sie, dass Sie auch Ihre eigenen Reports anpassen, sofern Sie das Display Field Arbeitsspeicher Slot verfügbar verwendet haben!
11 {{/aagon.warnungsbox}}
12
13 Der Aufbau des Report Center ähnelt dem der Abfrageverwaltung. Auch hier sind die schon vorhandenen Reports in Gruppen eingeteilt, wobei die Gruppe Hardware standardmäßig integriert ist. Die übrigen Gruppen sind an die entsprechende Solution gebunden und werden Ihnen nur bei gültigen Lizenzen angezeigt.
14
15 {{figure}}
16 (% style="text-align:center" %)
17 [[image:13a_64_ClientManagement_Reports_1180.png||alt="63_ClientManagement_Reports_1180.png"]]
18
19 {{figureCaption}}
20 Übersicht über Ihre Reports
21 {{/figureCaption}}
22 {{/figure}}
23
24 = Geplante Reports =
25
26 Geplante Reports helfen Ihnen dabei in regelmäßigen Zyklen Reports zu versenden. Wählen Sie zum Verwalten von geplanten Reports zunächst in der Navigation Reports aus und klicken dann auf den Reiter Geplante Reports.
27
28 {{figure}}
29 (% style="text-align:center" %)
30 [[image:13c_64_ClientManagement_Reports_1180.png||alt="63_ClientManagement_GeplanteReports_1180.png"]]
31
32 {{figureCaption}}
33 Übersicht der geplanten Reports
34 {{/figureCaption}}
35 {{/figure}}
36
37
38 Über der hierarchischen Ansicht der geplanten Reports befindet sich die Suche, mit der Sie, bei steigender Anzahl an geplanten Reports, direkt den richtigen finden können. Darunter werden Ihnen die geplanten Reports angezeigt.
39
40 == Geplanten Report hinzufügen ==
41
42 Zum Hinzufügen klicken Sie zunächst auf einen vorhandenen Ordner oder erstellen einen neuen. Klicken Sie nun in der Ribbonleiste auf Geplanten Report hinzufügen. Es öffnet sich ein Wizard, der Sie durch die Erstellung des neuen geplanten Reports führt.
43
44 (% style="text-align:center" %)
45 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_7d469f72.png||alt="Neuen geplante Reports hinzufügen" height="414" width="652"]]
46 Neuen geplanten Report hinzufügen
47
48 Sofern der Zielordner nicht richtig ist, können Sie diesen korrigieren. Hierbei stehen Ihnen nur bereits vorhandenen Ordner zur Verfügung. Geben Sie einen Namen an und wählen aus, auf Grundlage welchem Reports der geplante Report erstellt werden soll. Anschließend legen Sie fest, ob der Report auch versendet werden soll, wenn dieser keine Daten liefert.
49
50 Sie legen fest, in welchem Format der Report gesendet werden soll (als HTML-E-Mail oder als PDF-Anhang) und geben an, ob der Report Job aktiviert werden soll. Wenn Ihre Angaben richtig sind, klicken Sie auf Weiter, um zum nächsten Konfigurationsschritt zu gelangen.
51
52 {{aagon.infobox}}
53 Bei den geplanten Reports werden eine Vielzahl verschiedener Formate unterstützt (HTML, PDF, XML, XLSX, DOCX, PPTX, ODS, ODT, RTF, TXT, CSV).
54 {{/aagon.infobox}}
55
56 (% style="text-align:center" %)
57 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_35b91239.png||alt="E-Mail konfigurieren" height="418" width="659"]]
58 E-Mail konfigurieren
59
60 Auf dieser Seite konfigurieren Sie die zu versendende E-Mail. Tragen Sie zunächst einen Empfänger bzw. eine Empfängergruppe ein. Hierfür stehen Ihnen die Felder An, CC und BCC zur Verfügung. Bei allen drei Feldern können Sie auf auf [[Benutzer>>doc:||anchor="GlobaleNutzerkonten"]] und [[Gruppen>>doc:ACMP.63.ACMP-Solutions.System.Benutzerverwaltung.WebHome||anchor="HGruppenverwalten"]] zugreifen, die Sie bereits in ACMP angelegt haben oder tragen manuell die richtige E-Mail-Adresse ein. Anschließend geben Sie den Betreff an. Hier wird per Default der Name des zu Grunde liegenden Reports sowie ein Zeitstempel eingetragen. Alle Werte können Sie individuell an Ihre Bedürfnisse und Anforderungen anpassen.
61
62 Abschließend schreiben Sie, sofern notwendig, den eigentlichen E-Mail-Text in das entsprechende Feld und klicken auf Weiter um die Startbedingung anzugeben. Hierbei haben Sie die folgenden Möglichkeiten:
63
64 |Bestimmte Zeit|Geben Sie eine feste Uhrzeit an
65 |Startintervall|Geben Sie das Intervall in Minuten, Stunden oder Tagen an
66 |Tag der Woche|Geben Sie den bzw. die Wochentage zusammen mit einer "bestimmten Zeit" oder einem "Startintervall" an
67 |Tag des Monats|Geben Sie den bzw. die Tage des Monats zusammen mit einer "bestimmten Zeit" oder einem "Startintervall" an
68
69 = Erweiterter Report =
70
71 Neben bereits bestehenden Abfragen, haben Sie die Möglichkeit direkt eine neue Abfrage zu erstellen. Zudem bietet der Reportbuilder weitere grafische Aufbereitungsmöglichkeiten. So stehen Ihnen unter anderem verschiedene Diagrammtypen zur Verfügung. Das folgende Beispiel soll ein solches Szenario darstellen. Dabei wird ein neuer Report erstellt, welcher alle Clients mit deren Laufwerken inklusive Kapazitätsangabe auflistet. Die neue Abfrage wird so erstellt, dass im Report automatisch eine Unterabfrage erstellt wird. Anschließend wird ein Diagramm erstellt, um die Ergebnisse besser darstellen zu können.
72
73 == Erweiterte Abfrage erstellen ==
74
75 Um einen neuen Report zu erstellen, markieren Sie im Report Center einen Ordner, in welchem der Bericht erstellt werden soll. Anschließend klicken Sie auf das Icon Report hinzufügen in der Schnellwahlleiste. Es öffnet sich der Dialog zur Reporterstellung. Geben Sie Laufwerke als Titel an. Die Beschreibung lautet Auflistung aller Laufwerke der Clients.
76
77 Wählen Sie in den nächsten Schritten als Abfragetyp Neue Abfrage sowie die Abfragebasis Clients. Als Abfragefelder geben Sie zusätzlich die Felder Drive Label, Drive Free Space und Drive Capacity an. Diese Felder finden Sie unter der Kategorie Operating System -> Logical Drives. Klicken Sie auf das Kästchen Sortieren neben dem Feld Computer Name um alle Clients alphabetisch auflisten zu lassen.
78
79 Als Filter wählen Sie das Feld Computer Domain in der Kategorie Client -> Workstation aus. Ziehen Sie es auf den ODER-Filter. Geben Sie als Operator IN an und markieren Sie die Option bei Ausführung angeben. Dadurch werden Sie immer vor dem Ausführen des Berichts nach der Domain gefragt, deren Clients aufgelistet werden sollen.
80
81 Da die Abfrage über mindestens zwei Datenbanktabellen läuft, muss angegeben werden, nach welchen Daten eine Sortierung stattfindet. Geben Sie hier Clients an. Die anschließenden Angaben zur Sicherheit können Sie überspringen. Der Report wird nun im Editor geöffnet. Dazu werden Sie zu einer Eingabe der Domain aufgefordert, wonach die Daten aus der Datenbank gesammelt werden, mit deren Hilfe der Report generiert wird.
82
83 Der folgende Screenshot zeigt den erstellten Report im Designer. Dabei sind zunächst die einfachen Bereiche wie Report Titel, Hauptkopf, Hauptdaten und Seitenfuß zu finden. Da zu einem Client aber mehrere Laufwerke gehören können, gibt es weiterhin die Bereiche Detailkopf, Detaildaten und Detailfuß. Wie der Name dieser Bereiche schon sagt, werden hier Details aufgelistet. In diesem Fall die Laufwerke.
84
85 (% style="text-align:center" %)
86 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_49916695.png||alt="8.6.4.1 - Übersicht" height="421" width="478"]]
87
88
89 Wie im Abschnitt [[Arbeiten mit dem Reportbuilder>>doc:ACMP.63.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.
90
91 == Diagramme ==
92
93 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.
94
95 Es öffnet sich der Diagramm-Editor in einem neuen Fenster. Hier konfigurieren Sie das Diagramm.
96
97 (% style="text-align:center" %)
98 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_cfaab069.png||alt="Diagramm konfigurieren" height="391" width="495"]]
99
100 Wenn Sie bisher keine Diagrammserie erstellt haben, klicken Sie auf Serien hinzufügen ().
101
102 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.
103
104 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:
105
106 |(% style="width:524px" %)[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_8a61fe57.png||alt="8.6.4.2 - Diagram 1" height="258" style="float:right" width="276"]]|(% style="width:552px" %)[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_08c464bf.png||alt="8.6.4.2 - Diagram 2" height="258" width="276"]]
107
108 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.
109
110 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.
111
112 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:
113
114 * Der Report Titel wird nach oben hin in der Höhe vergrößert, um einen bestimmten Abstand zum oberen Rand der Seite einzuhalten.
115 * 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.
116 * Das Rechteckobjekt im Hauptkopf wird fett und kursiv gesetzt.
117 * 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.
118 * 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.
119 * Zwischen den Rechteckobjekten des Detaildaten-Bereichs werden senkrechte Linien eingezogen, um eine optische Trennung der einzelnen Datensätze zu erstellen.
120 * Der Seitenfuß wird nach unten hin etwas in der Höhe vergrößert, um einen Abstand zum unteren Rand der Seite einzuhalten.
121
122 Wie der Report im Designer nach diesen Anpassungen aussieht, zeigt der folgende Screenshot:
123
124 (% style="text-align:center" %)
125 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_4c98300c.png||alt="8.6.4.2 - Diagram 3" height="488" width="554"]]
126
127 Der Report könnte anschließend wie folgt aussehen:
128
129 (% style="text-align:center" %)
130 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_0d77700a.png||alt="8.6.4.2 - Diagram 4" height="299" width="560"]]
131
132 === Diagrammverwendung bei gruppierten Daten ===
133
134 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.
135
136 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.
137
138 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".
139
140 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.
141
142 (% style="text-align:center" %)
143 [[image:https://manual.aagon.com/acmp/de/61/reports_groupdatadiagram_1.png||alt="Reports_GroupdataDiagram_1" height="306" width="597"]]
144 Erstellen von Gruppenkopf und Gruppenfuß
145
146 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.
147
148
149 (% style="text-align:center" %)
150 [[image:https://manual.aagon.com/acmp/de/61/reports_groupdatadiagram_2.png||alt="Reports_GroupdataDiagram_2" height="370" width="417"]]
151 Diagramm einfügen
152
153 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:
154
155 * Anzahl: Enthält die Anzahl der Clients eines Betriebssystem
156 * Anzahl Gesamt: Enthält die Gesamtanzahl an Clients
157 * X_Chart: Enthält die Liste mit verschiedenen Betriebssystemen
158 * Y_Chart: Enthält die Liste mit der Anzahl der Clients der verschiedenen Betriebssystemen
159
160 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;").
161
162 Abschließend können die Daten in der ReportSummary dem Diagramm zugeordnet werden.
163
164 ====== Quellcode ======
165
166 ~/~/Variablen definieren
167
168 var           
169 Anzahl : int;
170 Anzahl_Gesamt : int;
171 X_Chart,Y_Chart : String;
172
173
174 ~/~/Ausgangswerte festlegen  
175 procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);
176 begin
177 Anzahl_Gesamt := 0;
178 X_Chart := ''; 
179 Y_Chart := ''; 
180 end;
181
182
183 ~/~/Zähler wieder auf 0 setzen   
184 procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
185 begin
186 Anzahl := 0;                          
187 end;
188
189
190 ~/~/Clients zählen     
191 procedure MasterData1OnBeforePrint(Sender: TfrxComponent);
192 begin
193 Anzahl := 1 + Anzahl;
194 Anzahl_Gesamt := 1 + Anzahl_Gesamt;         
195 end;
196
197
198 ~/~/Zur Liste der Clients und der Menge hinzufügen
199 procedure GroupFooter1OnBeforePrint(Sender: TfrxComponent);
200 begin
201 X_Chart := X_Chart + Memo4.Value + ';' ;
202 Y_Chart := Y_Chart + IntToStr(Anzahl) + ';' ;         
203 end;
204 \\~/~/Daten an das Diagramm übergeben 
205 procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
206 begin
207 Chart2.SeriesData[0].XSource := X_Chart;
208 Chart2.SeriesData[0].YSource := Y_Chart; 
209 end;
210 \\begin
211 \\end.
212
213 {{aagon.infobox}}
214 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"
215 {{/aagon.infobox}}
216
217 (% style="color:inherit; font-family:inherit; font-size:16px" %)Beispieldiagramm:
218
219 (% style="text-align:center" %)
220 [[image:https://manual.aagon.com/acmp/de/61/reports_groupdatadiagram_3_zoom75.png||alt="Reports_GroupdataDiagram_3" height="469" width="376"]]

Navigation

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community