Anleitung zur Webapp

ConfigScope hilft dir, Konfigurationsdateien, Lizenzfiles und Performance-CSV-Dateien schnell auszuwerten und die Ergebnisse zu filtern sowie nach Excel/PDF zu exportieren.

Datenschutz, Speicherung und Nutzungshinweis

ConfigScope ist ausschließlich als Demonstrations- und Analysehilfe gedacht. Die Nutzung erfolgt auf eigenes Risiko; die Verantwortung für Bewertung, Weitergabe und Verwendung der Ergebnisse liegt beim Benutzer.

Hochgeladene XML-, Lizenz- und Performance-CSV-Dateien werden nur zur aktuellen Auswertung verarbeitet. Die Anwendung schreibt hochgeladene Dateien, Analyseergebnisse oder Reportdaten nicht absichtlich auf die Server-Festplatte, in eine Datenbank oder in eine persistente serverseitige Ablage.

Während Upload und Analyse befinden sich die Daten kurzzeitig im Arbeitsspeicher des Webprozesses. Nach dem Rendern der Antwort existiert die angezeigte Auswertung nur noch im Browser beziehungsweise in vom Benutzer aktiv erzeugten Downloads oder Exporten.

Exporte wie Excel, PDF/Druckausgabe, AGH/AGD-Dateien oder Deploy-Bundles werden bei Bedarf erzeugt und nur dort gespeichert, wo der Benutzer sie aktiv herunterlädt oder speichert.

Hinweis: Je nach Betriebsumgebung können Browser, Reverse Proxies, Webserver-, Container- oder Plattform-Logs technische Metadaten wie Zeitpunkt, URL-Pfad, IP-Adresse oder Statuscode protokollieren. Diese Infrastruktur-Logs sind nicht Bestandteil der fachlichen ConfigScope-Auswertung.

1) Schnellstart

Datei auswählen (.xml, performance.csv oder DIIT Reporting CSV).
Auf Analysieren klicken.
Oben die Dateityp-Erkennung prüfen (Konfigurationsfile, Lizenzfile oder Performance CSV).
Über die Sprungleiste zu den gewünschten Bereichen wechseln.

2) Bedienung der Tabellen

Horizontales Scrollen: Bei breiten Tabellen gibt es Scrollbalken oben und unten.
Spaltenfilter: Viele Tabellen haben Suchfelder oder Dropdowns in der 2. Kopfzeile.
Kombinierbare Filter: Mehrere Filter gleichzeitig sind möglich.
Zähler: Die Zahl im Titel zeigt die aktuell sichtbaren Treffer.

3) Bereich „Workstations Lizenzen“

Suche nach Workstation

Über die Felder Computer, AET und MAC kannst du gezielt einzelne Geräte suchen.

Filter nach Lizenzspalten

In jeder Lizenzspalte gibt es eine Checkbox ja. Ist sie aktiv, werden nur Zeilen angezeigt, die diese Lizenz enthalten.

Lizenzsuchfeld (rechts neben Excel Export)

Du kannst einen Lizenznamen eintippen. Die Eingabe bietet vorhandene Lizenznamen als Vorschläge an. Beim Suchen werden nur passende Lizenzspalten angezeigt; alle anderen werden ausgeblendet.

Tipp: Für große Datenmengen zuerst Lizenzfeld einschränken, danach optional Computer/AET/MAC ergänzen – das ist meist am schnellsten.

4) Bereich „Performance CSV“

Die Datei muss nicht manuell vorbereitet werden, wenn sie als performance.csv mit Semikolon-Trennung geliefert wird. Die App erkennt typische Spalten wie First Display, Full Study, Modality, Hanging, Hangup Type und User.

Übersicht: zeigt Anzahl Messungen, Zeitraum, langsame Messungen und zentrale Laufzeitwerte.
Gruppen: Auswertung nach Modalität, Hanging und User.
Details: filterbare Einzelzeilen mit Suche, Dropdowns und Button „Nur langsame anzeigen“.

5) Export

Excel Export: Exportiert den aktuell sichtbaren/gefilterten Zustand der Tabelle.
Auswertung (PDF): Exportiert ausgewählte Tabellen als PDF (ohne reine Bedienelemente wie Filterzeilen).

6) API-Schnittstelle (extern, z. B. SAP)

Für externe Aufrufe steht die API POST /api/v1/export-xml/analyze bereit.

Upload: multipart/form-data mit Feld file (empfohlen)
Alternativ: XML direkt im Body mit Content-Type: application/xml
Sicherheit: Wenn im Deployment API_KEY gesetzt ist, muss der Header X-API-Key mitgesendet werden.

Beispiel:

curl -X POST "https://<host>/api/v1/export-xml/analyze" \
  -H "X-API-Key: <secret>" \
  -F "file=@/pfad/export.xml;type=application/xml"

7) Hinweise zur Performance

Bei sehr vielen Workstations können breite Tabellen schwergewichtig sein.
Die App ist bereits auf große Listen optimiert (Debounce, weniger DOM-Updates, Vorindexierung).
Falls es trotzdem hakt: Filter zunächst grob setzen (z. B. Lizenz), dann weiter verfeinern.

8) Performance CSV Vergleich und Kundenreport

Vergleich von zwei Performance CSVs

Für Performance CSVs können in der Dateiauswahl maximal zwei CSV-Dateien ausgewählt werden. In diesem Fall zeigt ConfigScope eine Vergleichsansicht mit Kennzahlen nach Übersicht, Modalität, Hanging und User. Die Vergleichsdiagramme stehen bewusst nach den Vergleichstabellen, damit die UI leichter zu lesen bleibt.

Der Vergleich ist ausschließlich für Performance CSVs vorgesehen.
export.xml und Lizenzfile werden weiterhin einzeln analysiert.
Die Vergleichslabels werden automatisch aus den unterschiedlichen Teilen der beiden Dateinamen erkannt.
Der Namensunterschied kann am Anfang, in der Mitte oder am Ende vor der Dateiendung stehen.

Spaltenhilfe

In den Performance-CSV-Tabellen haben die Spaltenköpfe kurze Hover-Erklärungen. Wenn der Mauszeiger über einem Spaltenkopf steht, zeigt ConfigScope an, was der jeweilige Wert bedeutet, z. B. First Display, Full Study, Perzentile, langsam oder Δ im Vergleich.

Komplette PDF-Auswertung

In der Performance-CSV-Ansicht gibt es die Schaltfläche Komplette PDF-Auswertung. Sie erstellt einen vollständigen Kundenreport über den Browser-Druckdialog.

Bei einer einzelnen performance.csv enthält der Report die Übersicht, Tabellen nach Modalität, Hanging und User, die vollständige Detailtabelle sowie die Diagramme.
Beim Vergleich von zwei Performance CSVs enthält der Report die Vergleichsübersicht, alle Vergleichstabellen, die vollständigen Detailtabellen beider CSV-Dateien und die Vergleichsdiagramme.
Die PDF-Datei wird nicht serverseitig gespeichert, sondern nur dort abgelegt, wo der Benutzer sie im Browser aktiv speichert.

Fehlende erwartete Spalten

Beim Vergleich von zwei Performance CSVs zeigt ConfigScope fehlende erwartete Spalten pro Datei an. Dadurch ist direkt ersichtlich, in welcher CSV welche Spalte fehlt. In der Kontext-Kachel werden diese Hinweise in roter Schrift dargestellt.

Glättung im Performance-Vergleich

Beim Vergleich von zwei Performance CSVs kann die Glättung über den Button Glättung einschalten aktiviert oder wieder deaktiviert werden. Standardmäßig werden die Rohwerte angezeigt.

Bei aktiver Glättung werden First Display und Full Study anhand des Object count normalisiert. Formel: geglättete Zeit = gemessene Zeit × Referenz-Object-count / Object count der Messung. Als Referenz wird der Median der Object counts verwendet. Dadurch werden Unterschiede durch unterschiedlich große Studien reduziert; die Rohdaten selbst werden nicht verändert.

Performance CSV Kontext-Kachel

Im Vergleich von zwei Performance CSVs zeigt ConfigScope die Dateizuordnung, aktive Glättung inklusive Erklärung und Referenzgröße sowie fehlende erwartete Spalten in einer eigenen getrennten Kontext-Kachel direkt unterhalb der Titel-Kachel. Im vollständigen Kunden-PDF wird dieser Kontext als strukturierter Abschnitt mit getrennten Bereichen für Dateien, Glättung und Hinweise ausgegeben.

Tipp: Für Kundenberichte zuerst prüfen, ob die fehlenden Spalten fachlich relevant sind, dann bei Bedarf die Glättung aktivieren und anschließend die komplette PDF-Auswertung erzeugen.

9) ScriptAccess Code kopieren

Der versteckte ScriptAccess-Code-Dialog bietet eine Schaltfläche In Zwischenablage kopieren. Beim Öffnen wird zusätzlich versucht, den Code direkt in die Zwischenablage zu kopieren. Falls der automatische Kopiervorgang im Browser blockiert wird, bleibt der Code im Dialog sichtbar und kann über die Kopier-Schaltfläche erneut kopiert werden.