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

1. Datei auswählen (export.xml, hardware.xml, Lizenzfile oder performance.csv).
2. Auf Analysieren klicken.
3. Oben die Dateityp-Erkennung prüfen (Konfigurationsfile, Lizenzfile oder Performance CSV).
4. Ü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.

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.

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.

10) DICOM-Services-ähnliches Seitenlayout

ConfigScope verwendet eine DICOM-Services-inspirierte Seitenstruktur mit durchgehender blauer Kopfzeile, horizontaler Navigation und ruhigem Inhaltsbereich. Die Upload- und Analysefunktion bleibt unverändert.

• Die obere Leiste enthält App-Name, Hauptnavigation, Theme-Umschalter und Version.
• Die Hauptnavigation bietet direkten Zugriff auf Upload, Auswertung, Anleitung, Deploy und Feedback.
• Der Arbeitsbereich darunter nutzt einfache Karten für Upload, Hinweise und Auswertungstabellen.

11) DICOM-Services-ähnliche Auswertungsoberfläche

Die Auswertungsbereiche verwenden eine flachere, DICOM-Services-inspirierte Darstellung. Ergebnis-Karten haben klare Kopfzeilen, Kennzahlen erscheinen als kompakte Kacheln und große Tabellen nutzen sticky Header, Zebra-Zeilen und Hover-Markierung.

• Vergleichs- und Performance-Bereiche bleiben funktional unverändert.
• Die optische Anpassung betrifft Karten, Tabellen, Toolbars, Kennzahlen, Kontext-Kacheln und Diagrammbereiche.
• Die Upload- und Analyseverarbeitung bleibt unverändert.

12) DU-ähnlicher Dunkelmodus und eckige Bedienelemente

Der Dunkelmodus wurde stärker an eine DeepUnity-/DU-ähnliche Oberfläche angenähert. Die Auswertung nutzt nun dunklere Flächen, kühlere Blauakzente und eckigere Steuerelemente.

• Buttons, Eingabefelder und Dateiauswahl sind nun bewusst eckiger statt rund.
• Tabellen, Karten und Kennzahlen wurden im Dunkelmodus kontrastreicher abgestimmt.
• Die Änderungen betreffen die Darstellung, nicht die Auswertungslogik.

13) Wiederhergestelltes Header-Blau und eckige Buttons

Die Kopfzeile verwendet wieder das Blau der vorherigen Version. Zusätzlich wurden die Bedienelemente bewusst eckig gehalten und die Rubriken-/Bereichsheader farblich an die Kopfzeile angeglichen.

• Dateiauswahlbutton im Uploadbereich farblich in derselben Blaufamilie
• Buttons und Eingabefelder eckig statt rund
• Rubrikenheader und Kontext-Header im gleichen Blau wie der Hauptheader
• Diese Anpassung betrifft nur die Oberfläche, nicht die Auswertungslogik

14) ConfigScope-Icon im Header

Das bisherige Kürzel „CS“ links oben wurde durch das ConfigScope-Icon ersetzt. Das Icon ist als statische Datei in der Webapp eingebunden und dient gleichzeitig als visuelle Markenkennung im Kopfbereich.

• Das Icon steht links oben anstelle der Textabkürzung „CS“.
• Zusätzlich wird dasselbe Icon als Browser-Favicon verwendet.
• Die Änderung betrifft nur die Oberfläche, nicht die Analysefunktionen.

15) Aktualisiertes ConfigScope-Icon

Das im Header und als Browser-Favicon verwendete ConfigScope-Icon wurde aktualisiert. Die Änderung betrifft nur das visuelle Branding und hat keinen Einfluss auf die Auswertungsfunktionen.

• Neues Icon links oben im Header
• Neues Icon als Browser-Favicon
• Keine Änderung an Upload, Analyse oder Export

16) Transparentes Header-Icon

Das ConfigScope-Icon im Header und als Browser-Favicon verwendet nun eine PNG-Datei mit transparentem Hintergrund. Dadurch entfällt der zuvor sichtbare dunkle Rand im App-Header.

• Aktualisierte Icon-Datei mit transparentem Hintergrund
• Gilt für Header-Icon und Browser-Favicon
• Keine Änderung an Upload, Analyse oder Export

17) Eckige Buttons und klarere Tabellenköpfe

In dieser Version wurden die Bedienelemente konsequent eckig umgesetzt. Zusätzlich wurden die Tabellenköpfe und Spaltenabgrenzungen verstärkt, damit die Zuordnung von Headern zu den jeweiligen Spalten klarer erkennbar ist.

• Alle wichtigen Buttons und Datei-Buttons ohne Rundung
• Suchfelder und Auswahlfelder ebenfalls ohne Rundung
• Vertikale Spaltentrenner in Tabellenkopf und Tabelleninhalt
• Verbesserung gilt für Hell- und Dunkelmodus

18) Sichtbare Toolbar-Buttons

Buttons in Toolbars innerhalb der Auswertungsrubriken werden wieder mit sichtbarem Text und Rahmen dargestellt. Zuvor konnte eine Header-Farbregel dazu führen, dass weiße Button-Schrift auf weißem Hintergrund erschien.

• Toolbar-Buttons unterhalb blauer Rubrikenheader wieder klar sichtbar
• Eigene Darstellung für Hell- und Dunkelmodus
• Buttons direkt innerhalb blauer Header behalten ihren passenden Header-Stil
• Keine Änderung an der Auswertungslogik