Benutzerhandbuch

Funktionsweise File Analyzer

Aktualisiert am

Erfahren Sie in diesem Artikel,

  • welche Funktionen in der PPD Tools Collection im Hauptmenü für den File Analyzer zur Verfügung stehen und
  • wie und für was diese angewandt werden können.

1. Einführung

In diesem Artikel wird näher auf den File Analyzer eingegangen, mit welchem Logfiles und andere Textfiles geöffnet werden können und der Inhalt nach bestimmten Kriterien gefiltert werden kann. Durch die Filterung wird von einem File nur mehr das angezeigt, was relevant ist. Dadurch sollen Files insgesamt lesbarer und übersichtlicher werden.

Abbildung 1: Das Hauptmenü der PPD Tool Collection mit dem File Analyzer

Öffnen Sie den File Analyzer über die dazugehörige Schaltfläche [1]. Die Benutzeroberfläche (siehe Abbildung 2) öffnet sich mit den nachfolgend beschriebenen Optionen:

  • File [8] – Alle Funktionen welche das File betreffen. Diese werden in Punkt 2. im Detail beschrieben.
  • Edit [9] – Alle Funktionen welche den Edit betreffen. Diese werden in Punkt 3. im Detail beschrieben.
  • Tools [10] – Alle Funktionen welche die Tools betreffen. Diese werden in Punkt 4. im Detail beschrieben.
  • Tabs [11], [2] – Alle Funktionen welche die Tabs betreffen. Diese werden in Punkt 5. im Detail beschrieben.
  • Help [12] – Links zur Hilfe für die PPD Tools Collection.
  • Path Feld mit + und - Schaltfläche [3] – Hierbei handelt es sich um den Basispfad für das geladene File. Das heißt, alle Files dieses Basispfads können in dem File Feld ausgewählt und geladen werden. Nach einer Neuinstallation werden in Logfile Tabs die lokalen Workflow Log Ordner von PMS bzw. Zunicomm ausgewählt. Beim File Analyzer bleibt das Feld leer, bis ein File geladen wurde. Mit dem »+«-Button kann ein Pfad abgespeichert werden und ist beim nächsten Start wieder auswählbar. Der »-«-Button entfernt den ausgewählten Eintrag wieder aus der Liste. Wird der Production Job Analyzer verwendet, dann werden in der Path Liste auch Pfade aufscheinen die mit »CustomerLog« beginnen. Diese zeigen auf die Logfiles des exportierten Jobs. Achtung: Wenn ein CustomerLog Eintrag ausgewählt ist und anschließend die »-«-Schaltfläche aktiviert wird, wird auch der exportierte Production Job gelöscht!
  • File Feld, (Re) Load Button, »<>« Buttons und Fast View Checkbox [13] – Im File Feld werden alle Files des Basispfads (Path Feld) aufgelistet. Wird ein Eintrag ausgewählt, dann wird das File geladen. Mit den Buttons »<« und »>« kann das vorige bzw. das nächste Logfile in der Liste geladen werden. Bei großen Logfiles wird das Anzeigen von diesen ziemlich mühsam. Deshalb gibt es die Option »Fast View«. Hier wird immer nur ein Teil des Logfiles geladen und bei Bedarf nachgeladen.
    • Vorteil: Flottes Laden, die Zeilennummern werden sofort angezeigt.
    • Nachteil: Das File hat die Berechtigung readonly und kann nicht geändert werden. »Alles markieren« kann nicht ausgeführt werden.
  • LineCount [6] – Anzahl der Zeilen des Files und Dateigröße. Diese werden beim Laden errechnet, Änderungen im File Textfeld werden nicht berücksichtigt.
  • »F« (Find) Schaltfläche und Suchpanel [14] – Damit wird das Panel zum Suchen, Ersetzen und Markieren geöffnet. Dieses Panel bezieht sich auf das zuletzt verwendete Textfeld (File oder Filter). Das verwendete Feld wird beim Label »Textbox« angezeigt. Ein Klick auf die jeweils andere Box aktiviert diese im Suchpanel. Mit »Highlight« können die Zeichen im Feld »Search« im Textfeld des File bzw. Filters hervorgehoben werden. »UnHighlight« setzt die Zeichen des Feldes »Search« wieder auf schwarz. Der Button neben »Search« und »Replace« kopiert den Wert von »Search« nach »Replace«.
  • »J« Schaltfläche [17] – Die »J« Schaltfläche verhält sich wie ein manuelles »Auto Jump to Line« und funktioniert in beide Richtungen (File zu Filter und zurück)
  • Analyze! [4] – Startet die Filter Funktion. Das Ergebnis wird im Textfeld Filter angezeigt.
  • Include Lines, Exclude Lines, »+« und »-« Button [15] – In diesem Bereich werden die Filter gesetzt.
    • »Include Lines with String«: Alle Zeichenfolgen welche hier definiert sind, werden beim Filtern angezeigt.
    • »Exclude Lines with string«: das Ergebnis kann verkleinert werden, wenn sich das Filterergebnis noch zu umfangreich bzw. unübersichtlich gestaltet.

Die Filter können mit folgenden Operatoren verknüpft werden:

  • »|« = Oder
  • »&« = Und
  • Mit der »+« Schaltfläche können einzelne Filter gespeichert und mit »-« wieder vom Speicher gelöscht werden.

Nachfolgend befinden sich zwei Beispiele zur Veranschaulichung dieser Funktionen.

  1. Include Lines with String: DecodeURLEncodedParts | verification | documents

Das File wird nach den Zeichenfolgen »DecodeURLEncodedParts«, »verification«, »documents« durchsucht. Im Filter werden die Zeilen vom File angezeigt in dem eines oder mehrere diese Zeichenfolgen vorhanden sind.

  1. Include Lines with String: DecodeURLEncodedParts & verification  | documents - Exclude Lines with String: processing

Es werden alle Zeilen des Files angezeigt, in welchen in einer Zeile »DecodeURLEncodedParts« und »verification«  oder »documents« vorkommt, außer diejenigen bei denen »processing« vorkommt.

  • Checkboxen Highlight, Auto Jump, Group Filter Result [5] – Wenn »Highlight File« aktiviert ist, werden die Filter Zeichenfolgen im Textfeld File nach Aufruf von "Analyze!" farblich hervorgehoben. Bei Aktivierung von »Auto Jump to Line«, springt der Cursor im Logfile auf die im Filter ausgewählte Zeile. Bei Aktivierung von »Group Filter Result«, werden nicht zusammenhängende Zeilen mit einem Separator getrennt.
  • Filter Checkboxen [7] – Die Filtercheckboxen sind im Prinzip Suchzeichenfolgen, die mit einem Klick aktiviert werden können. Diese sind mit dem Operator »Oder« verknüpft.  Beispiel: Bei Aktivierung der Checkbox »Preflight« und »Render« werden alle Zeilen vom Log die einen Preflight oder Render Aufruf beinhalten im Filterergebnis angezeigt.
  • Checkbox Show Request Ends if possible (nur ZuniComm Tab): Damit wird der Processing Request Start und das Ende in der Filterbox angezeigt. Wurde ein Request zwar gestartet aber nicht beendet wird dies auch angezeigt. Dieses Verhalten kommt vor allem bei ZuniComm Abstürzen vor. Durch die Checkbox kann leichter festgestellt werden, durch welchen Job ZuniComm abstürzt.
  • From Hour / To Hour [16] – Damit lässt sich das Filterergebnis auf die eingestellte Zeitspanne reduzieren.
  • Buttons »P« und »Z« [18] – Damit wird das Finden von Aufrufen und Fehlern über Logfiles hinweg vereinfacht. Dies ist nur möglich, wenn das PMS und das ZuniComm Log vom gleichen Datum und Zeitraum sind. Somit können Aufrufe von PMS oder ZuniComm im jeweilig anderen Logfile gefunden werden.
    • Button »Z«: Das ZuniComm Logfile wird nach dem Zeitstempel der aktuellen PMS Filterzeile gefiltert.
    • Button »P« (ZuniComm Tab): Das PMS Logfile wird nach dem Zeitstempel der aktuellen ZuniComm Filterzeile gefiltert.

Abbildung 2: Die Menüpunkte des File Analyzer

2. File

Nachfolgend eine Auflistung der verschiedenen Funktionen des Menüpunkts File:

Open [19]: Befehl zum Öffnen von Dateien.

Reload [20]: Befehl zum neu Laden von geöffneten Dateien.

Save [21]: Getätigte Änderungen in der Datei (Feld File) können damit gespeichert werden.

Save as [22]:  Getätigte Änderungen in der Datei (Feld File) können damit in einer neuen Datei gespeichert werden.

Open Folder in Explorer [23]: Befehl um den Ordner vom Feld "Pfad" zu öffnen.

Open in External Editor [24]: Befehl um Datei (Feld File) im Standard Editor zu öffnen.

Copy File to Clipboard [25]: Befehl um eine Datei in die Zwischenablage speichern,

Restart PPDTC as Admin [26]: PPDTC wird mit dieser Funktion als Admin neu gestartet. Bei vielen Installationen muss jedes Mal wenn eine administrative Berechtigung benötigt wird, dass Passwort eingegeben werden, was lästig sein kann. Da mit PPDTC fast alle für den Service erforderlichen Aufgaben erledigt werden können, entfällt die Passworteingabe größtenteils wenn ppdtc als Administrator gestartet wurde.

Quit [27]: Befehl um das Fenster zu schießen.

Abbildung 3: Der File Reiter der PPD Tools Collection mit dem Befehl Restart PPDTC as Admin

3. Edit

  • Find (STRG + F/F3) / REplace (F4) / Highlight (STRG + H) [28]: Das Suchpanel wird geöffnet wie durch Klick auf F [13] auf Abbildung 1.
  • Jump to Line in File [29]: Stellt die »J« Schaltfläche da, welche wie ein manuelles »Auto Jump to Line« funktioniert und in beide Richtungen angewandt werden kann (File <-> Filter).
  • Jump to Line in Filter [30]: Stellt die »J« Schaltfläche da, welche wie ein manuelles "Auto Jump to Line" funktioniert und in beide Richtungen angewandt werden kann (File <-> Filter).
  • Jump to Line Number [31]: Springt zur einzugebenden Zeilennummer im Feld File.
  • Replace Lines in File (F5) [32]: Hiermit kann das Filter Textfeld editiert werden. Um die Änderungen im File Textfeld zu übernehmen muss die Taste F5 gedrückt werden. Dabei wird entweder die Zeile (Filter Textfeld), in welcher sich der Cursor befindet, oder die im Filter Textfeld markierten Zeilen im File Textfeld, ausgetauscht. Dies soll selektive Änderungen in z.B. json oder xml Files beschleunigen und vereinfachen. Die Funktion kann verwendet werden, wenn einfaches Suchen und Ersetzten nicht ausreicht. Anwendungsbeispiel: File Laden > File nach den zu ändernden Keys / Values (zu ändernde Werte) und Schlüsselwörtern (Kriterien ob ein Key / Value geändert werden soll oder nicht) filtern > im Filter Textfeld die gewünschten Keys ändern (anhand der Schlüsselwörter kann entschieden werden ob ein Key / Value geändert wird oder nicht)

Abbildung 4: Der Menüpunkt Edit des File Analyzer

4. Tools

Dieser Menüpunkt ist in neun Funktionsgruppen unterteilt die nachfolgend beschrieben werden.

Abbildung : Der Tools Reiter der PPD Tools Collection

Analyze

Über Analyze [33] können ZuniComm Requests vom PMS Log ausgewertet werden. Im Wesentlichen handelt es sich hierbei um einen Texteditor mit besonderen Filter-, Markierungs- und Validierungsfunktionen. Mit den Logfile Analyzer (PMS und ZuniComm) können Logfiles geladen und nach Kriterien gefiltert werden. Mit den gefilterten Daten sollten Fehler schneller und leichter identifiziert werden können. Des weiteren sind noch nützliche Tools für den Service enthalten.

Tail File

Rufen Sie Tail File [34] auf um somit Änderungen in einem LogFile zu verfolgen und zu filtern.

Validate

Der Einstellungsbereich Validate [35] besitzt fünf Validierungsmöglichkeiten.

  • XML / KFPX / LIC – Prüfung ob das File valide ist (der Inhalt wird nicht geprüft). Das Ergebnis wird im Feld Filter angezeigt.
  • JSON – Prüfung ob das File valide ist (der Inhalt wird nicht geprüft). Das Ergebnis wird im Feld Filter angezeigt.
  • Json Tool – Tool zum bearbeiten und analysieren von JSON Files
  • Check TAU JDF References – Hier wird festgestellt ob alle Files welche in einem TAU JDF referenziert sind, auch wirklich vorhanden sind. Besonders hilfreich bei großen VDP Jobs
  • CSV Formatter – Geladene CSV Files werden im Feld File formatiert dargestellt. Der CSV Delimiter wird im Feld "CSV Delimiter:" gesetzt. Hilfreich auch bei der Auswertung von RHO Datenfiles (DP*.txt)

Find Files with String

Mit diesem Tool [36] kann nach Files gesucht werden, welche einen definierten String beinhalten. Das macht vor allem dann Sinn, wenn ein Logfile gesucht wird, in dem ein bestimmter Job verarbeitet wurde.

Open PMS / ZuniComm Log with Time Filter (P / Z)

Mit dieser Funktion [37] kann über die Schaltflächen »P« »Z« ein Time Filter gesetzt werden. Diese Funktion ist ident zur Beschreibung Nummer [18].

Local Workflow Services

In diesem Einstellungsbereich werden zwei Optionen [38] angeboten:

  1. DW Services Manager Sämtliche Services vom Workflow können hier gestartet und gestoppt werden. Des weiteren können hier die diversen Frontends der Services geöffnet werden. Zum Debuggen ist es hier möglich einen Service in der Konsole zu starten.
  2. Local Workflow Services: Zusätzlich zum DW Services Manager können die Services auch direkt aus dem Menü gestoppt und gestartet werden:
  • PMS – Start, Stop, Restart
  • ZuniComm – Start, Stop, Restart
  • SMC – Start, Stop, Restart
  • PostGres – Start, Stop, Restart

Abbildung 5: Der Tools Dialog mit den Optionen welche in Local Workflow Services enthalten sind

Open local Config Files and Special

Nachfolgend wird ein kurzer Überblick über die wichtigsten Funktionen dieses Einstellungsbereichs [39] aufgelistet.

  • PMS Config – Dient dazu um die application.properties von PMS zu öffnen.
  • ZuniComm Config – Dient dazu um die ZuniCommConfig.txt von ZuniComm zu öffnen.
  • Special – Open DW-Install Log, View DB-Deployment (reset DB Deployment Error), View DB-ZuniComm Log

Abbildung 6: Der Tools Reiter der PPD Tools Collection

Open

In diesem Einstellungsbereich [36] werden folgende Optionen angeboten.

  • Open Swagger – Der Swagger wird im Browser geöffnet
  • Open Workflow – Der Workflow wird im Browser geöffnet
  • Open ZuniComm Frontend – ZuniComm wird im Browser geöffnet
  • Open SMC Frontend – Die Service Management Console wird im Browser geöffnet

Ping Workstation

Durch diese Funktion [37] werden die eingegebene Workstation / IP gepingt. (die IP kann im geöffneten Fenster überschrieben werden)

5. Tabs

Pro Tab kann jeweils ein File geöffnet werden. Mit dem »+« der Tableiste kann ein neuer Tab geöffnet werden. Dabei wird ein neuer Tab mit dem Typ des gerade aktiven Tabs erstellt. Über das Menü Tabs können ebenfalls neue Tabs geöffnet werden. Mit einem Doppelklick (oder mittlere Maustaste) auf einen Tab wird dieser geschlossen.

Gehen Sie folgendermaßen vor, um ein File für den jeweiligen Tab zu öffnen:

  1. Ziehen Sie das File mit der Maus in das (Log)File Textfeld  oder öffnen eine Datei mit „File -> Open File“ oder klicken sie auf den Button (Re)Load File (Ein Datei öffnen Dialog erscheint, wenn das File Feld leer ist).
  2. Falls sich eine Datai laufend verändert (zB Logfiles) drücken Sie die Schaltfläche (Re)Load File. Ändert sich ein File, dann wird der Button "Orange".
  3. Wird eine Datei im File Feld gewählt, dann wird die Datei automatisch geladen.

Tab Typen:

  • Add ZuniComm Analyzer Tab [41] – Damit können ZuniComm Logfiles analysiert werden.
  • Add PMS Analyzer Tab [42] – Damit können PMS Logfiles analysiert werden.
  • Add File Analyzer Tab [43] – Damit können Logfiles und andere Textfiles geöffnet und der Inhalt nach bestimmten Kriterien gefiltert werden. Durch die Filterung sollte nur mehr das von einem File angezeigt werden, was wirklich relevant ist. Dadurch sollte die Files insgesamt lesbarer und ein wenig übersichtlicher werden. Es können alle Textfiles geöffnet werden (txt,log,xml, json...)
  • Add PostGresql Tab [44] – Der File Analyzer wird mit einem PostGres Query Fenster geöffnet und wird für die Anzeige von PostGres Abfragen verwendet.

Abbildung 7: Der Tabs Reiter der PPD Tools Collection mit Befehlen

Artikel Update: 04/2024

Previous Artikel Ausführen, Hauptmenü und updaten
Next Artikel Funktionsweise Applications
Noch Fragen? Kontaktieren Sie uns!