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: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: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>>doc:||anchor="HGeplanteReports"]] 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>>doc:]] 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 (z.B. HTML, PDF, XML, XLSX, DOCX, PPTX, ODS, ODT, TXT, CSV oder RTF).
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
72 erstellt, um die Ergebnisse besser darstellen zu können.
73
74 == Erweiterte Abfrage erstellen ==
75
76 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.
77
78 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.
79
80 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.
81
82 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.
83
84 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.
85
86 (% style="text-align:center" %)
87 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_49916695.png||alt="8.6.4.1 - Übersicht" height="421" width="478"]]
88
89
90 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.
91
92 == Diagramme ==
93
94 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.
95
96 Es öffnet sich der Diagramm-Editor in einem neuen Fenster. Hier konfigurieren Sie das Diagramm.
97
98 (% style="text-align:center" %)
99 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_cfaab069.png||alt="Diagramm konfigurieren" height="391" width="495"]]
100
101 Wenn Sie bisher keine Diagrammserie erstellt haben, klicken Sie auf Serien hinzufügen ().
102
103 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.
104
105 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:
106
107 |(% 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"]]
108
109 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.
110
111 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.
112
113 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:
114
115 * Der Report Titel wird nach oben hin in der Höhe vergrößert, um einen bestimmten Abstand zum oberen Rand der Seite einzuhalten.
116 * 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.
117 * Das Rechteckobjekt im Hauptkopf wird fett und kursiv gesetzt.
118 * 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.
119 * 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.
120 * Zwischen den Rechteckobjekten des Detaildaten-Bereichs werden senkrechte Linien eingezogen, um eine optische Trennung der einzelnen Datensätze zu erstellen.
121 * Der Seitenfuß wird nach unten hin etwas in der Höhe vergrößert, um einen Abstand zum unteren Rand der Seite einzuhalten.
122
123 Wie der Report im Designer nach diesen Anpassungen aussieht, zeigt der folgende Screenshot:
124
125 (% style="text-align:center" %)
126 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_4c98300c.png||alt="8.6.4.2 - Diagram 3" height="488" width="554"]]
127
128 Der Report könnte anschließend wie folgt aussehen:
129
130 (% style="text-align:center" %)
131 [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_0d77700a.png||alt="8.6.4.2 - Diagram 4" height="299" width="560"]]
132
133 === Diagrammverwendung bei gruppierten Daten ===
134
135 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.
136
137 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.
138
139 Erstellen Sie zunächst einen neuen Report (siehe [[Report hinzufügen>>doc:ACMP.63.ACMP-Solutions.Client-Management.Reports.Reports verwalten.WebHome]]). 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".
140
141 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.
142
143 (% style="text-align:center" %)
144 [[image:https://manual.aagon.com/acmp/de/61/reports_groupdatadiagram_1.png||alt="Reports_GroupdataDiagram_1" height="306" width="597"]]
145 Erstellen von Gruppenkopf und Gruppenfuß
146
147 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.
148
149
150 (% style="text-align:center" %)
151 [[image:https://manual.aagon.com/acmp/de/61/reports_groupdatadiagram_2.png||alt="Reports_GroupdataDiagram_2" height="370" width="417"]]
152 Diagramm einfügen
153
154 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:
155
156 * Anzahl: Enthält die Anzahl der Clients eines Betriebssystem
157 * Anzahl Gesamt: Enthält die Gesamtanzahl an Clients
158 * X_Chart: Enthält die Liste mit verschiedenen Betriebssystemen
159 * Y_Chart: Enthält die Liste mit der Anzahl der Clients der verschiedenen Betriebssystemen
160
161 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;").
162
163 Abschließend können die Daten in der ReportSummary dem Diagramm zugeordnet werden.
164
165 ====== Quellcode ======
166
167 ~/~/Variablen definieren
168
169 var           
170 Anzahl : int;
171 Anzahl_Gesamt : int;
172 X_Chart,Y_Chart : String;
173
174
175 ~/~/Ausgangswerte festlegen  
176 procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);
177 begin
178 Anzahl_Gesamt := 0;
179 X_Chart := ''; 
180 Y_Chart := ''; 
181 end;
182
183
184 ~/~/Zähler wieder auf 0 setzen   
185 procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
186 begin
187 Anzahl := 0;                          
188 end;
189
190
191 ~/~/Clients zählen     
192 procedure MasterData1OnBeforePrint(Sender: TfrxComponent);
193 begin
194 Anzahl := 1 + Anzahl;
195 Anzahl_Gesamt := 1 + Anzahl_Gesamt;         
196 end;
197
198
199 ~/~/Zur Liste der Clients und der Menge hinzufügen
200 procedure GroupFooter1OnBeforePrint(Sender: TfrxComponent);
201 begin
202 X_Chart := X_Chart + Memo4.Value + ';' ;
203 Y_Chart := Y_Chart + IntToStr(Anzahl) + ';' ;         
204 end;
205 \\~/~/Daten an das Diagramm übergeben 
206 procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
207 begin
208 Chart2.SeriesData[0].XSource := X_Chart;
209 Chart2.SeriesData[0].YSource := Y_Chart; 
210 end;
211 \\begin
212 \\end.
213
214 {{aagon.infobox}}
215 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"
216 {{/aagon.infobox}}
217
218 (% style="color:inherit; font-family:inherit; font-size:16px" %)Beispieldiagramm:
219
220 (% style="text-align:center" %)
221 [[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