Wiki source code of Das Log

Last modified by Sabrina V. on 2024/10/14 05:41
Show last authors
1 {{aagon.priorisierung}}
2 80
3 {{/aagon.priorisierung}}
4
5 {{aagon.floatingbox/}}
6
7 Im Log-Bereich des Client Command Editors kann der Verlauf der Client Command Ausführung verfolgt und kontrolliert werden. Die Kontrolle ist vor allem dann sinnvoll, wenn der Ablauf eines neu erstellten Client Commands getestet oder ein nicht erfolgreich ausgeführtes Client Command im Hinblick auf den Fehler überprüft werden soll.
8
9 Das Log ist unterteilt in das Ablauflog und die Variablenüberwachung.
10
11 {{figure}}
12 [[image:CC Editor_Log.PNG||data-xwiki-image-style-alignment="center"]]
13
14 {{figureCaption}}
15 Log-Bereich
16 {{/figureCaption}}
17 {{/figure}}
18
19 = Ablauflog =
20
21 Im ersten Teil des Logs, dem Ablauflog, wird bei dem geladenen Client Command jeder ausgeführte Befehl in der Reihenfolge aufgelistet, in der es ausgeführt wurde. Die Log-Struktur ähnelt somit dem Skript im Skript-Bereich.
22
23 Das Ablauflog erscheint in diesem Bereich dann, wenn Sie in der Toolbar im Skript-Bereich auf  [[image:image-20240215163304-1.png||height="22" width="22"]] (Play) klicken.
24
25 {{aagon.infobox}}
26 Das Ablauflog zeigt die von der der ACMP Console durchgeführten Ausführung im Editor, sowohl vom Console Skript als auch Client Skript. Es ist nicht möglich, sich das Log einer Ausführung von einem einzelnen Client anzuschauen.
27 {{/aagon.infobox}}
28
29 Jeder ausgeführte Befehl innerhalb des Client Commands enthält weitere, untergeordnete Befehle. Sie umfassen genaue Angaben zur Ausführung, wie z.B. eingesetzte Variablen und Werte oder genaue Fehlerbeschreibungen, falls der Befehl nicht erfolgreich ausgeführt werden konnte.
30
31 {{figure}}
32 [[image:Angaben zur Ausführung.png||data-xwiki-image-style-alignment="center"]]
33
34 {{figureCaption}}
35 Ausgeführter Befehl mit untergeordneten Befehlen
36 {{/figureCaption}}
37 {{/figure}}
38
39 (% class="wikigeneratedid" %)
40 Des Weiteren können die Zeilen des ausgeführten Befehls im eigentlichen Skript, das Datum, Start- und Endzeit, die Laufzeit und das Ergebnis (erfolgreich oder nicht erfolgreich ausgeführt) des jeweiligen Befehls nachvollzogen werden.
41
42 = Variablenüberwachung =
43
44 Innerhalb der Variablenüberwachung besteht die Möglichkeit, die Werte von den verwendeten Variablen während der Ausführung zu überwachen, um z.B. Fehler dort zu finden.
45
46 Es ist nicht möglich sich dort das Log einer Ausführung von einem Client anzuschauen. Einige Commands können sich demnach auch unterschiedlich verhalten weil z.B. keine erhöhten Rechte zur Verfügung stehen.
47
48 Sie fügen eine Variable zur Überwachung hinzu, indem Sie im Bereich der Variablenüberwachung über einen Rechtklick die Option //Variable hinzufügen// wählen. Es öffnet sich ein Popup mit allen Variablen.
49
50 {{figure}}
51 [[image:Variablenüberwachung.png||data-xwiki-image-style-alignment="center"]]
52
53 {{figureCaption}}
54 Variablenüberwachung
55 {{/figureCaption}}
56 {{/figure}}
57
58 Wählen Sie die zu überwachende Variable aus und klicken Sie auf den //OK//.
59
60 Während des Durchlaufs des Skripts, werden hier neben dem Variablennamen und dem Typ auch der aktuelle Wert sowie die beiden vorherigen Werte angezeigt. Somit kann eine Variable genau verfolgt und Fehler gefunden werden.
61
62 Um eine Variable von der Überwachung wieder auszuschließen, wählen Sie per Rechtsklick auf der zu entfernenden Variable die Option //Variable entfernen//.
63
64 = **Log-Dateien verwalten** =
65
66 Damit jegliche Log-Dateien überhaupt gespeichert werden, können Sie bei jedem Client Command individuell einstellen, ob für dieses Client Command eine Log-Datei erstellt werden soll.
67
68 Diese Einstellung kann in den [[Client Command Log-Optionen>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HOptionen"]] über Projekt > //Eigenschaften > Client Command spezifisch > Optionen > Client Command Log-Optionen// getätigt werden.
69
70 == **Log-Dateien einsehen** ==
71
72 Um die gespeicherten Log-Dateien einzusehen, haben Sie innerhalb der ACMP Console zwei verschiedene Möglichkeiten.
73
74 **Option 1:**
75
76 Klicken Sie in der Phase //Ausführen// auf das gewünschte Client Command und klicken Sie im unteren Bereich auf //Details anzeigen//.
77
78 {{figure}}
79 [[image:Log Details einsehen_klein.png||data-xwiki-image-style-alignment="center"]]
80
81 {{figureCaption}}
82 Möglichkeit 1, um Log-Details einzusehen
83 {{/figureCaption}}
84 {{/figure}}
85
86 Es öffnet sich folgende Zusammenfassung für das Client Command:
87
88 {{figure}}
89 [[image:Log Details einsehen_2.png||data-xwiki-image-style-alignment="center"]]
90
91 {{figureCaption}}
92 Zusammenfassung des Logs
93 {{/figureCaption}}
94 {{/figure}}
95
96 Klicken Sie dann auf das Icon //Log ansehen//, um den Client Command Log Viewer zu öffnen.
97
98 {{figure}}
99 [[image:Client Command Log Viewer.png||data-xwiki-image-style-alignment="center"]]
100
101 {{figureCaption}}
102 Client Command Log Viewer
103 {{/figureCaption}}
104 {{/figure}}
105
106 **Option 2:**
107
108 Öffnen Sie die Client Details eines Clients und wählen Sie //Logs// //unter Client Commands// aus.
109
110 Nun klicken Sie auf das Icon //Log ansehen//, um den Client Command Log Viewer zu öffnen.
111
112 {{figure}}
113 [[image:Client Command Logs.png||data-xwiki-image-style-alignment="center"]]
114
115 {{figureCaption}}
116 Möglichkeit 2, um Logs einzusehen
117 {{/figureCaption}}
118 {{/figure}}
119
120 == **Log-Dateien exportieren** ==
121
122 Es besteht zusätzlich die Möglichkeit, Log-Dateien zu exportieren. Für den Export haben Sie zwei Optionen:
123
124 **Option 1:**
125
126 Öffnen Sie die Client Details eines Clients, markieren Sie das gewünschte, zu exportierende Log und klicken Sie auf [[image:image-20240215165152-2.png]]//Log als Datei speichern//.
127
128 Wählen Sie dann den Speicherort aus und vergeben Sie einen Namen.
129
130 Sie erhalten eine .alf-Datei, die Sie mit dem Client Command Log Viewer einsehen können. Dieser wird, zusammen mit der ACMP Console installiert und befindet sich im Bin-Verzeichnis (z.B.: C:\Program Files (x86)\Aagon\ACMP Console\Bin\ClientCommandLogViewer.exe).
131
132 Öffnen Sie den Client Command Log Viewer und fügen Sie die .alf-Datei über //Datei > Logdatei öffnen //hinzu oder ziehen Sie die Datei per Drag-and-Drop in den Client Command Log Viewer.
133
134 **Option 2:**
135
136 Rufen Sie über einen Rechtsklick das Kontextmenü des Client Command Log Viewers auf. Wählen Sie den Speicherort aus und vergeben Sie einen Namen.
137
138 Sie erhalten eine .alf-Datei, die Sie mit dem Client Command Log Viewer einsehen können. Dieser wird, zusammen mit der ACMP Console installiert und befindet sich im Bin-Verzeichnis (z.B.: C:\Program Files (x86)\Aagon\ACMP Console\Bin\ClientCommandLogViewer.exe).
139
140 Öffnen Sie den Client Command Log Viewer und fügen Sie die .alf-Datei über //Datei > Logdatei öffnen //hinzu oder ziehen Sie die Datei per Drag-and-Drop in den Client Command Log Viewer.
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community